Openapi integration

.github/workflows/playwright.yml

@@ -0,0 +1,157 @@
+<<<<<<< HEAD
+name: Playwright E2E Tests
+
+on:
+  push:
+    branches: [main, dev, dev-angular-19]
+  pull_request:
+    branches: [main, dev, dev-angular-19]
+
+jobs:
+  playwright:
+    name: Run Playwright Tests
+    runs-on: ubuntu-latest
+    timeout-minutes: 30
+=======
+name: E2E Tests (Playwright + Fineract)
+
+on:
+  push:
+    branches: [main, dev]
+  pull_request:
+    branches: [main, dev]
+
+concurrency:
+  group: e2e-${{ github.ref }}
+  cancel-in-progress: true
+
+jobs:
+  e2e:
+    name: Playwright E2E
+    runs-on: ubuntu-latest
+    timeout-minutes: 45
+
+    env:
+      CI: true
+      E2E_BASE_URL: http://localhost:4200
+      E2E_FINERACT_URL: https://localhost:8443
+      E2E_USERNAME: mifos
+      E2E_PASSWORD: password
+      E2E_TENANT_ID: default
+      NODE_TLS_REJECT_UNAUTHORIZED: '0'
+>>>>>>> origin/dev
+
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v6
+
+<<<<<<< HEAD
+      - name: Use Node.js 22x
+=======
+      - name: Use Node.js 24
+>>>>>>> origin/dev
+        uses: actions/setup-node@v6
+        with:
+          node-version: '24.14.0'
+          cache: 'npm'
+
+      - name: Install dependencies
+        run: npm ci
+
+      - name: Install Playwright browsers
+        run: npx playwright install --with-deps chromium
+
+<<<<<<< HEAD
+      - name: Run Playwright tests
+        run: npx playwright test --reporter=html,github
+        env:
+          CI: true
+          FINERACT_API_URL: https://demo.mifos.community
+          E2E_USERNAME: mifos
+          E2E_PASSWORD: password
+=======
+      - name: Start E2E infrastructure
+        run: docker compose -f docker-compose.e2e.yml up -d --build
+
+      - name: Wait for PostgreSQL
+        run: |
+          timeout 60 bash -c '
+            until docker exec e2e-postgres pg_isready -U postgres 2>/dev/null; do
+              sleep 2
+            done
+          '
+          echo "✅ PostgreSQL ready"
+
+      - name: Wait for Fineract backend
+        run: |
+          timeout 300 bash -c '
+            until docker ps --filter "health=healthy" --filter "name=e2e-fineract" | grep -q healthy; do
+              echo "  … Fineract not healthy yet"
+              sleep 10
+            done
+          '
+          curl -fk --retry 30 --retry-all-errors --connect-timeout 10 --retry-delay 10 \
+            https://localhost:8443/fineract-provider/actuator/health
+          echo ""
+          echo "✅ Fineract ready"
+
+      - name: Verify Fineract initialization complete
+        run: |
+          AUTH_HEADER=$(echo -n "${E2E_USERNAME}:${E2E_PASSWORD}" | base64 | tr -d '\n')
+          timeout 120 bash -c "
+            until curl -fsk \
+              -H 'Fineract-Platform-TenantId: ${E2E_TENANT_ID}' \
+              -H 'Authorization: Basic ${AUTH_HEADER}' \
+              https://localhost:8443/fineract-provider/api/v1/offices 2>/dev/null | grep -q 'Head Office'; do
+              echo '  … waiting for seed data'
+              sleep 5
+            done
+          "
+          echo "✅ Fineract initialization complete"
+
+      - name: Wait for web-app
+        run: |
+          curl -f --retry 20 --retry-all-errors --connect-timeout 5 --retry-delay 5 \
+            http://localhost:4200 > /dev/null 2>&1
+          echo "✅ Web-app ready"
+
+      - name: Run Playwright tests
+        run: npx playwright test --reporter=html,github --workers=1
+
+      - name: Dump Docker logs on failure
+        if: failure()
+        run: |
+          echo "=== Fineract ==="
+          docker logs e2e-fineract --tail 100 2>&1 || true
+          echo "=== PostgreSQL ==="
+          docker logs e2e-postgres --tail 50 2>&1 || true
+          echo "=== Web-App ==="
+          docker logs e2e-web-app --tail 50 2>&1 || true
+          echo "=== Memory ==="
+          docker stats --no-stream || true
+>>>>>>> origin/dev
+
+      - name: Upload Playwright report
+        uses: actions/upload-artifact@v7
+        if: always()
+        with:
+          name: playwright-report
+          path: playwright-report/
+          retention-days: 7
+
+      - name: Upload test results
+        uses: actions/upload-artifact@v7
+        if: failure()
+        with:
+          name: test-results
+          path: test-results/
+          retention-days: 7
+<<<<<<< HEAD
+=======
+
+      - name: Tear down E2E infrastructure
+        if: always()
+        run: |
+          docker compose -f docker-compose.e2e.yml down -v --remove-orphans
+          docker system prune -f
+>>>>>>> origin/dev

.gitignore

@@ -55,14 +55,18 @@ testem.log
 .DS_Store
 Thumbs.db
 .vscode/
-cypress/
+
+# Cypress - only ignore downloads, screenshots, and videos
+cypress/downloads/
+cypress/screenshots/
+cypress/videos/
 
 src/assets/env.js
 src/environments/.env.ts
 
-# Node and build artifacts
-/node_modules
-/dist
-/out-tsc
-/openapitools.json
-
+# Playwright
+/test-results/
+/playwright-report/
+/blob-report/
+/playwright/.cache/
+/playwright/.auth/

Dockerfile

@@ -24,6 +24,8 @@ ENV PATH=/usr/src/app/node_modules/.bin:$PATH
 ENV PUPPETEER_DOWNLOAD_HOST=$PUPPETEER_DOWNLOAD_HOST_ARG
 ENV PUPPETEER_CHROMIUM_REVISION=$PUPPETEER_CHROMIUM_REVISION_ARG
 ENV PUPPETEER_SKIP_DOWNLOAD=$PUPPETEER_SKIP_DOWNLOAD_ARG
+ENV CYPRESS_INSTALL_BINARY=0
+ENV PLAYWRIGHT_SKIP_BROWSER_DOWNLOAD=1
 
 COPY ./ /usr/src/app/
 

README.md

@@ -10,6 +10,43 @@ Mifos X Web App is a modern single-page application (SPA) built on top of the Mi
 - Angular framework
 - Angular Material components
 
+## 📋 Table of Contents
+
+- [Overview](#overview)
+- [Quick Links](#quick-links)
+- [Installation Guide](#installation-guide)
+  - [Prerequisites](#prerequisites-for-all-methods)
+  - [Backend Setup](#backend-setup-required-first)
+  - [Frontend Setup](#frontend-setup-web-app)
+    - [Method 1: Manual Installation](#method-1-manual-installation)
+    - [Method 2: Docker](#method-2-docker-container-only)
+    - [Method 3: Docker Compose](#method-3-docker-compose-frontend--backend)
+- [Default Login Credentials](#default-login-credentials)
+- [Development Commands](#development-commands)
+- [Proxy Configuration](#proxy-configuration)
+  - [Sandbox Proxy](#using-the-sandbox-proxy-default)
+  - [Local Fineract](#using-a-local-fineract-instance)
+  - [Testing the Proxy](#testing-the-proxy)
+- [Configuration Options](#configuration-options)
+  - [Environment Variables for Docker](#environment-variables-for-docker)
+    - [Fineract Backend](#fineract-backend-settings)
+    - [Language Settings](#language-settings-i18n)
+    - [Date Formats](#date-and-datetime-format-settings)
+    - [Session & Performance](#session--performance-settings)
+    - [Password Policy](#password-policy-settings)
+    - [UI Display](#ui-display-settings)
+    - [OAUTH](#oauth-settings)
+    - [OIDC](#oidc-settings)
+    - [External National ID](#external-national-id-system-integration)
+    - [Interbank Transfers](#interbank-transfers-settings)
+    - [Remittance Module](#remittance-module-settings)
+  - [Client Data Masking](#client-data-masking-example)
+- [Interbank Transfer Menu](#interbank-transfer-menu)
+- [Role-Based Access Control](#role-based-access-control-rbac)
+- [Releases](#releases)
+- [Contributing](#contributing)
+- [Related Projects](#related-projects)
+
 ## Quick Links
 
 - [Live Demo](https://sandbox.mifos.community/#/login) (Updated nightly ** System is restored every 6 hours **)

config/e2e/fineract.env

@@ -0,0 +1,40 @@
+# Fineract E2E Environment — PostgreSQL-only
+
+# ── Spring Profiles ──
+SPRING_PROFILES_ACTIVE=test,diagnostics
+
+# ── PostgreSQL Connection (Docker service: "db") ──
+FINERACT_HIKARI_DRIVER_SOURCE_CLASS_NAME=org.postgresql.Driver
+FINERACT_HIKARI_JDBC_URL=jdbc:postgresql://db:5432/fineract_tenants
+FINERACT_HIKARI_USERNAME=postgres
+# Well-known Fineract E2E password — intentionally committed, not a secret.
+FINERACT_HIKARI_PASSWORD=skdcnwauicn2ucnaecasdsajdnizucawencascdca
+
+# ── Tenant Database ──
+FINERACT_DEFAULT_TENANTDB_HOSTNAME=db
+FINERACT_DEFAULT_TENANTDB_PORT=5432
+FINERACT_DEFAULT_TENANTDB_UID=postgres
+FINERACT_DEFAULT_TENANTDB_PWD=skdcnwauicn2ucnaecasdsajdnizucawencascdca
+FINERACT_DEFAULT_TENANTDB_NAME=fineract_default
+
+# ── SSL & HTTP ──
+FINERACT_SERVER_SSL_ENABLED=true
+FINERACT_INSECURE_HTTP_CLIENT=true
+
+# ── Node Identity ──
+FINERACT_NODE_ID=1
+
+# ── External Events (no ActiveMQ in E2E) ──
+FINERACT_EXTERNAL_EVENTS_ENABLED=false
+
+# ── HikariCP Pool (tuned for E2E) ──
+FINERACT_HIKARI_MINIMUM_IDLE=3
+FINERACT_HIKARI_MAXIMUM_POOL_SIZE=10
+
+# ── Data Seeding ──
+# INITIALIZATION_ENABLED is NOT a Fineract server env var (it belongs to
+# fineract-e2e-tests-runner's Gradle Cucumber runner). Do not set it here.
+#
+# Liquibase auto-seeds: Head Office, default tenant config, schema.
+# Domain data (products, GL accounts, clients) must be seeded via the
+# FineractApiClient fixture in test beforeAll hooks.

config/e2e/nginx-e2e.conf.template

@@ -0,0 +1,25 @@
+server {
+    listen 80;
+    server_name _;
+
+    root /usr/share/nginx/html;
+    index index.html;
+
+    # ${E2E_PROXY_TARGET} is replaced by envsubst; $host/$scheme etc. are
+    # safe because NGINX_ENVSUBST_FILTER restricts to ^(FINERACT_|MIFOS_|...).
+    location /fineract-provider/ {
+        proxy_pass ${E2E_PROXY_TARGET}/fineract-provider/;
+        proxy_ssl_verify off;
+        proxy_connect_timeout 30s;
+        proxy_read_timeout 120s;
+    }
+
+    location / {
+        try_files $uri $uri/ /index.html;
+    }
+
+    location ~* \.(js|css|png|jpg|jpeg|gif|ico|svg|woff|woff2|ttf|eot)$ {
+        expires 1y;
+        add_header Cache-Control "public, immutable";
+    }
+}

config/e2e/postgresql-init.sh

@@ -0,0 +1,11 @@
+#!/bin/bash
+# Creates the two databases Fineract requires at first boot.
+# POSTGRES_USER (postgres) is the default superuser — no CREATE USER needed.
+set -e
+
+psql -v ON_ERROR_STOP=1 --username "$POSTGRES_USER" <<-EOSQL
+    CREATE DATABASE fineract_tenants;
+    CREATE DATABASE fineract_default;
+EOSQL
+
+echo "✓ E2E databases created: fineract_tenants, fineract_default"