메뉴
FlowMaster system overview and architecture
Codex 또는 Claude로 설치 이 Prompt를 복사해 Codex, Claude 또는 다른 어시스턴트에 붙여 넣으면 Skill 페이지를 검토하고 설치를 진행할 수 있습니다.
SOC 직업 분류 기준
| 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