Menu
FlowMaster system overview and architecture
Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.
Based on SOC occupation classification
| name | flowmaster-overview |
| description | FlowMaster system overview and architecture |
| disable-model-invocation | false |
SNAPSHOT: 2026-02-08 11:00 Dubai Time (07:00 UTC) — likely changing soon
FlowMaster is a microservices-based business process automation platform for designing, executing, and monitoring workflows with AI integration. As of Feb 8 2026, 29 services are deployed and running on a K3S Kubernetes cluster (dev-01 server 65.21.153.235), covering all 79 requirements (R01-R79). Code is deployed but ALL services are UNTESTED — no integration, e2e, or health check testing has been performed.
Source Control: GitLab flow-master group (primary), mirrored to GitHub HCB-Consulting-ME.
Code locations: ~/projects/documentation (stale copies), ~/projects/flowmaster/ (working dir, not a git repo).
| Service | Port | Tech | Status |
|---|---|---|---|
| Process Design | 9003 | Python/FastAPI | Running, UNTESTED |
| Execution Engine | 9005 | Python/FastAPI | Running, UNTESTED |
| Human Task | 9006 | Python/FastAPI | Running, UNTESTED |
| AI Agent Orchestration | 9006 | Python/FastAPI | Running, UNTESTED |
| Document Intelligence | 9002 | Python/FastAPI | Running, UNTESTED |
| Authentication | 8002 | Python/FastAPI | Running, UNTESTED |
| API Gateway | 9000 | Python/FastAPI | Running, UNTESTED |
| Event Bus | 9013 | Python/FastAPI+Kafka | Running, UNTESTED |
| WebSocket Gateway | 9010 | Node.js/TypeScript | Running (4 restarts), UNTESTED |
| Notification | 9009 | Python/FastAPI | Running, UNTESTED |
| Scheduling | 9008 | Python/FastAPI | Running, UNTESTED |
| Service Registry | 8001 | Python/FastAPI | Running, UNTESTED |
| SSO | — | Integrated w/ Auth | Working on demo |
| Service | Port | Requirements | Status |
|---|---|---|---|
| Process Analytics | 9014 | R48-R50 | Running, UNTESTED |
| External Integration | 9014 | R51-R53 | Running, UNTESTED |
| MCP Server | 9000 | R54-R56 | Running, UNTESTED |
| Legal Entity | 8014 | R66-R68 | Running, UNTESTED |
| Business Rules Engine | 8018 | R69-R72 | Running, UNTESTED |
| BAC Marketplace | 9015 | R73-R76 | Running, UNTESTED |
| Service | Port | Requirements | Status |
|---|---|---|---|
| Agent Service | 9016 | R36-R47 | Running, UNTESTED |
| Prompt Engineering | 8012 | R39-R41 | Running, UNTESTED |
| Knowledge Hub | 8009 | R42-R46 | Running, UNTESTED |
| Service | Port | Requirements | Status |
|---|---|---|---|
| Frontend (Next.js) | 3000 | — | Running, UNTESTED |
| Engage App | 3001 | R25-R29, R45 | Running, UNTESTED |
| Manager App | 3001 | R30-R33 | Running, UNTESTED |
| Process Designer | 3002 | R77-R79 | Running, UNTESTED |
| DXG Service | 9011 | R34-R35 | Running, UNTESTED |
| Process Views | 8019 | R57-R59 | Running, UNTESTED |
| Process Versioning | 8020 | R60-R62 | Running, UNTESTED |
| Process Linking | 8021 | R63-R65 | Running, UNTESTED |
K3S Kubernetes on dev-01 server (65.21.153.235):
flowmaster namespacelocalhost:30500docker save/gzip/scp/docker load (NOT via CI/CD pipelines)Internet → Nginx (port 80) → K3S ClusterIPs
/ → frontend (10.43.185.219:3000)
/api/ → api-gateway (10.43.193.134:9000)
/ws/ → websocket-gateway (10.43.43.253:9010)
WARNING: ClusterIPs are hardcoded in nginx config, will change if services recreated.
HTTP REST via API Gateway (port 9000):
Kafka Event Bus:
task.created, execution.completed)WebSocket (Socket.io) + Redis:
| Server | IP | URL | Status (Feb 8) |
|---|---|---|---|
| Dev-01 | 65.21.153.235 | — | UP, K3S, 29 pods + SDX (Docker) |
| Dev-02 | 65.21.52.58 | — | High-perf dev, agent pods |
| Playground | 89.167.2.145 | — | Pilots, classic Docker |
| Production | 91.99.237.14 | app.flow-master.ai | UP (HTTP 200), Docker Compose |
| Staging/Dev (old) | 91.98.159.56 | staging.flow-master.ai, dev.flow-master.ai | DECOMMISSIONED |
Note: Dev-01 server has ONE FlowMaster environment (not separate dev/test/staging). SDX is part of FlowMaster (currently standalone Docker, should be in K3S). Plane CE is a separate project management tool, not part of the product.
Backend: 11/13 core services Python/FastAPI, 2 Node.js/TypeScript
Frontend: Next.js, React, TypeScript, Radix UI (shadcn/ui), TailwindCSS
Source Control: GitLab (primary), GitHub (mirror)
Container Orchestration: K3S (demo), Docker Compose (prod/staging/dev)
CI/CD: GitLab CI, runner flowmaster-demo-runner v18.8.0
All 79 requirements (R01-R79) have code written and deployed as Docker images. NONE are integration-tested. See deployment-snapshot-20260208.md for full mapping.
flowmaster-backend — API endpoints, service contractsflowmaster-server — Infrastructure, deployment, CI/CDflowmaster-frontend — UI components, patternsflowmaster-database — ArangoDB schema, collectionsflowmaster-environment — Service env vars, ports, configflowmaster-tools — MCP tools, integrations, SDXLoad CI/CD pipeline configuration and deployment information when working with automation or deployments
Load database relationships, shared resources, and schema information when working with data models or database configuration
Load development environment information including folder structure, OrbStack setup, and system configuration
Load port mappings for all projects when working with networking, docker-compose, or service configuration
Load GitHub/GitLab repository information when working with git, CI/CD, or repository management
Load server information, infrastructure details, and access patterns when working with deployment or server configuration