Data Model: hbf-session-manager
Domain objects used by this service. Full schemas:
docs/domain-model.md
Objects This Service Uses
| Object | Access | Key Fields Used |
|---|---|---|
| Tenant | reads via hbf-core-api | id, settings, systemSettings, plugins |
| ChatSession | reads/writes via hbf-core-api | id, status, tenantId, lastInteraction, messages, liveChats |
| ChatSessionBatchSetStatusCompleted | writes via hbf-core-api | session IDs for batch status update |
| NLPPipeline | reads/writes via hbf-core-api | id, status, tenantId, autoTrain |
| NLPService | reads via hbf-core-api | pipeline configuration |
| NLPStatus | reads via hbf-core-api | TRAINING, FAILED, etc. |
| TenantUsageDto | reads via hbf-core-api | id, totalNumOfChatSessions, totalNumOfMessages |
| Survey | reads via HTTP to hbf-core | id, tenantId, organizationId |
| User | reads via HTTP to hbf-core (auth) | id, email, roles |
Local Entities
| Entity | Table | DB | Key Fields |
|---|---|---|---|
| SessionIntegration | hbf_sessions_integrations | MySQL | id, organization_id (unique), enabled, tenants (simple-array), url, error_email_recipient_list (simple-array) |
| SessionIntegrationHeader | hbf_sessions_headers | MySQL | id, integration_id (FK, CASCADE), name, value (longtext) |
| SessionIntegrationError | hbf_sessions_errors | MySQL | id, integration_id (FK, CASCADE), chat_session_id, exception (longtext), tenant_id, created_at |
Notes
- Manages session lifecycle: monitors active sessions, auto-completes stale ones, triggers NLP pipeline retraining.
- SessionIntegration stores per-organization webhook configurations for session events. Headers are stored separately for flexibility.
- Tracks integration errors per chat session for debugging webhook failures.
- Uses hbf-core-api for both the npm client (
HBFCoreApi) and direct HTTP calls. - Imports from deep path
@helvia/hbf-core-api/dist/src/datamodel/nlpforNLPPipelinetype. - Communicates with hbf-nlp service for NLP pipeline operations.
- Manages tenant usage limits (chat sessions and messages).