WEB-547 feat(proxy): forward fineract provider requests to sandbox for local dev

Author: priyans11

README.md

@@ -132,6 +132,52 @@ When using the development server with basic authentication:
 - **Build for production:** `ng build --configuration production` or `npm run build:prod`
 - **Get Angular CLI help:** `ng help`
 
+## Proxy Configuration
+
+The web app includes a proxy configuration (`proxy.conf.js`) that allows you to forward API requests to a remote Fineract backend during local development. This helps avoid CORS issues and enables you to work against production-like environments.
+
+### Using the Sandbox Proxy (Default)
+
+By default, the proxy forwards `/fineract-provider` requests to the Mifos sandbox environment:
+
+- **Target:** `https://sandbox.mifos.community`
+- **API Endpoint:** `https://apis.mifos.community` (exposed in the sandbox)
+- **System Reset:** Every 6 hours
+
+**Sandbox Environment Variables:**
+
+```bash
+FINERACT_API_URLS=https://apis.mifos.community
+FINERACT_API_URL=https://apis.mifos.community
+FINERACT_API_PROVIDER=/1.0/core/api
+FINERACT_API_ACTUATOR=/1.0/core
+FINERACT_API_VERSION=/v1
+FINERACT_PLATFORM_TENANT_IDENTIFIER=default
+MIFOS_DEFAULT_LANGUAGE=en-US
+MIFOS_SUPPORTED_LANGUAGES=cs-CS,de-DE,en-US,es-MX,fr-FR,it-IT,ko-KO,li-LI,lv-LV,ne-NE,pt-PT,sw-SW
+MIFOS_PRELOAD_CLIENTS=true
+MIFOS_DEFAULT_CHAR_DELIMITER=,
+```
+
+### Using a Local Fineract Instance
+
+To proxy to a local Fineract server instead:
+
+1. Open `proxy.conf.js`
+2. Comment out the sandbox proxy configuration
+3. Uncomment the localhost proxy configuration (lines marked with `// Uncomment this configuration...`)
+4. Ensure your local Fineract instance is running on `http://localhost:8443`
+5. Restart the development server
+
+### Proxy Features
+
+- **CORS Avoidance:** Eliminates cross-origin issues during local development
+- **Error Handling:** Gracefully handles proxy failures with detailed logging
+- **Corporate Proxy Support:** Maintains support for corporate proxy agents via `HTTP_PROXY` environment variable
+- **Debug Logging:** All proxy requests are logged for troubleshooting
+
+For more details on proxy configuration, see the [backend proxy documentation](./docs/backend-proxy.md).
+
 ## Configuration Options
 
 ### Environment Variables for Docker

proxy.conf.js

@@ -10,12 +10,51 @@ const { HttpsProxyAgent } = require('https-proxy-agent');
  */
 const proxyConfig = [
   {
-    context: '/api',
-    pathRewrite: { '^/api': '' },
-    target: 'https://api.chucknorris.io',
+    context: ['/fineract-provider'],
+    target: 'https://sandbox.mifos.community',
+    pathRewrite: { '^/fineract-provider': '' },
     changeOrigin: true,
-    secure: false
+    secure: true,
+    logLevel: 'debug',
+    onProxyReq: function (proxyReq, req, res) {
+      const rewrittenPath = (req.url || '').replace(/^\/fineract-provider/, '');
+      console.log('[Proxy] Proxying:', req.method, req.url, '->', this.target + rewrittenPath);
+    },
+    onError: function (err, req, res) {
+      console.error(
+        '[Proxy] Error while proxying request:',
+        req && req.method,
+        req && req.url,
+        '->',
+        this.target,
+        '-',
+        err && err.message
+      );
+      if (res && !res.headersSent) {
+        res.writeHead(502, { 'Content-Type': 'text/plain' });
+        res.end('Proxy error: ' + (err && err.message ? err.message : 'Unknown error'));
+      }
+    }
   }
+  // Uncomment this configuration to proxy to a local Fineract instance instead
+  // {
+  //   context: ['/fineract-provider'],
+  //   target: 'http://localhost:8443',
+  //   pathRewrite: { '^/fineract-provider': '' },
+  //   changeOrigin: true,
+  //   secure: false,
+  //   logLevel: 'debug',
+  //   onProxyReq: function(proxyReq, req, res) {
+  //     console.log('[Proxy] Proxying:', req.method, req.url, '->', this.target + req.url);
+  //   },
+  //   onError: function(err, req, res) {
+  //     console.error('[Proxy] Error while proxying request:', req && req.method, req && req.url, '->', this.target, '-', err && err.message);
+  //     if (res && !res.headersSent) {
+  //       res.writeHead(502, { 'Content-Type': 'text/plain' });
+  //       res.end('Proxy error: ' + (err && err.message ? err.message : 'Unknown error'));
+  //     }
+  //   }
+  // }
 ];
 
 /*