Deployment: hbf-lcg

Ports

Protocol	Port	Config
HTTP	1337	SERVICE_PORT
Redis microservice	Configurable	MICROSERVICE_REDIS_HOST / MICROSERVICE_REDIS_PORT

Docker

• Base image: node:22-slim (multi-stage build)
• Build stage: Installs npm packages, runs npm run build
• Runtime stage: Copies dist + node_modules, runs as node user (non-root)
• Start command: npm run start:prod (runs node dist/src/main)
• No docker-compose.yml: Standalone service, depends on shared MySQL and Redis from platform infra

Database

• Engine: MySQL/MariaDB (TypeORM)
• Database name: lcm (shared name with hbf-lcm, but different tables)
• Auto-migrate: TYPEORM_AUTORUN_MIGRATIONS=true by default (runs migrations on startup)
• Tables: live_chat_session, cisco_event

Environment Variables

Variable	Required	Description
SERVICE_URL	Yes	Service base URL
SERVICE_PORT	No	HTTP port (default: 1337)
HBF_CORE_URL	Yes	hbf-core API endpoint
HBF_CORE_API_TOKEN	Yes	Bearer token for hbf-core
HBF_LCM_URL	Yes	hbf-lcm endpoint
HBF_LCM_TOKEN	Yes	Bearer token for hbf-lcm
HBF_BOT_EVENT_URL	Yes	hbf-bot event callback URL
JWT_SECRET	Yes	JWT signing key for inbound auth
JWT_SUB	Yes	Required JWT subject claim
TYPEORM_CONNECTION	No	DB driver (default: mysql)
TYPEORM_HOST	Yes	Database host
TYPEORM_PORT	No	Database port (default: 3306)
TYPEORM_USERNAME	Yes	Database user
TYPEORM_PASSWORD	Yes	Database password
TYPEORM_DATABASE	No	Database name (default: lcm)
TYPEORM_AUTORUN_MIGRATIONS	No	Auto-migrate on startup (default: true)
CACHE_REDIS_ENABLE	No	Enable Redis cache (default: false)
CACHE_REDIS_URL	No	Redis URL for caching
CACHE_TTL	No	Cache TTL in seconds (default: 20)
MICROSERVICE_REDIS_HOST	Yes	Redis host for cluster coordination
MICROSERVICE_REDIS_PORT	No	Redis port for cluster (default: 6379)
MICROSERVICE_REDIS_DB	No	Redis DB index (default: 0)
MICROSERVICE_REDIS_USER	No	Redis user
MICROSERVICE_REDIS_PASSWORD	No	Redis password
MICROSERVICE_RESPONSE_TIMEOUT_MILLIS	No	RPC timeout (default: 5000)
MICROSERVICE_HEARTBEAT_TIMEOUT_MILLIS	No	Heartbeat timeout (default: 5000)
MICROSERVICE_INSTANCE_ID	No	Cluster instance ID (default: random UUID)
ELASTIC_APM_ACTIVE	No	Enable APM (default: false)
ELASTIC_APM_SERVER_URL	No	APM server URL
ELASTIC_APM_SERVICE_NAME	No	APM service name
HBF_EVENT_PUBLISHER_URL	Yes	URL for the hbf-event-publisher service (used in publisher-client.service.ts)

Notes

• Redis serves dual roles: optional cache (CACHE_REDIS_URL) and required cluster coordination (MICROSERVICE_REDIS_*). These can be separate Redis instances.
• The lcm database name is shared with hbf-lcm. Both services write to the same MySQL database but manage different tables.
• No CI/CD pipeline configured in the repo.