🚀 8020

🔒 Identity Server

Identity server for authentication and authorization

GET /id/ → Identity Server (port 2999)

localhost /id/ → Identity Server (port 2999)

🎨 Employee Frontend (Portal)

React application for employee portal and administrative functions

NGINX /portal/ → Employee Frontend (port 8000)

localhost http://localhost:8000/ → Employee Frontend (port 8000)

📋 Quick Start

This nginx proxy routes traffic to different BFF services based on URL paths. Use ngrok to expose this gateway externally.

# Start nginx proxy
docker-compose -f devops/nginx/docker-compose.dev.yml up -d

# Expose with ngrok
ngrok http 3000

# Access via ngrok URL
curl https://your-ngrok-url.ngrok.io/bff/health
            

🎯 Customer GraphQL (BFF-Customer)

Main customer-facing GraphQL API with interactive UI for mobile apps and web clients

GET /bff/ → Customer API (port 3001)

👥 Employee GraphQL (BFF-Employee)

Internal employee portal GraphQL API with interactive UI for administrative functions

GET /bff-employee/ → Employee API (port 3002)

🔗 OpenAPI GraphQL (BFF-OpenAPI)

Public GraphQL gateway with interactive UI for third-party integrations

GET /bff-openapi/ → OpenAPI Gateway (port 3003)

🐍 TigerBeetle

TigerBeetle service for financial transactions

GET /svc-tigerbeetle/ → TigerBeetle (port 3000)

🔗 Webhook

Webhook service for handling webhooks

GET /svc-webhook/utila → Webhook Utila

🛠️ Troubleshooting

Common issues and solutions

# Check nginx logs
docker-compose -f devops/nginx/docker-compose.dev.yml logs nginx

# Restart nginx
docker-compose -f devops/nginx/docker-compose.dev.yml restart nginx

# Check if BFF services are running
docker ps | grep bff
            

Built with ❤️ for the fintech community

8020 Monorepo Architecture