Architecture Overview
The Helvia Platform comprises 19 microservices organized into logical layers. Click any service node in the diagrams below to navigate to its documentation.
C4 Context Diagram
The system context shows how external actors interact with the platform.
C4 Container Diagram
The container diagram shows all 19 services and their primary communication paths. Click any service to see its detailed documentation.
Architectural Layers
| Layer | Services | Purpose |
|---|---|---|
| Core | hbf-core, hbf-core-api | Central API and shared client library |
| Bot Engine | hbf-bot, open-bot-framework | Workflow execution and message routing |
| AI / NLP | hbf-nlp, helvia-rag-pipelines | Intent classification, LLM orchestration, RAG |
| Live Chat | hbf-lcm, hbf-session-manager | Human agent routing and session state |
| Channels | hbf-broadcast, hbf-event-publisher, hbf-notifications, hbf-client-integrations | Multi-channel messaging and integrations |
| Analytics | hbf-stats, hbf-reports | Metrics aggregation and report generation |
| Data | hbf-media-manager, hbf-data-retention | File storage and GDPR compliance |
| Frontend | hbf-console, hbf-webchat | Admin UI and chat widget |
Deep Dives
- Auth Flows - Token types, guard patterns, RBAC
- Bot Nodes - Runtime pipeline and designer flow nodes
- Deployment - Docker, CI/CD, Kubernetes
- NLU Pipelines - LLM provider orchestration
- Resilience - Retry policies, timeouts, circuit breakers
- Service Communication - Inter-service dependency graph