Deployment
Local Startup
cp .env.example .env
docker compose up --build
Once the stack is up, the local gateway is available at http://localhost:8080.
Local Service Map
| Component | Port |
|---|---|
| Gateway | 8080 |
| Identity service | 8001 |
| Customer service | 8002 |
| Game service | 8003 |
| Chat service | 8004 |
| Staff console | 5173 |
Production Requirements
APP_ENV=production- Explicit application, JWT, service-to-service, and chat-encryption secrets
- Managed databases and automated migrations
- TLS, backup automation, monitoring, and alerting
- Approved secret manager and least-privilege service access
Release Gates
- All service test suites pass
docker compose configsucceeds- Secrets are injected from an approved secret manager
- App Store disclosures match the implemented retention model
- Backups, monitoring, restore drills, and rollback runbooks are validated
Docusaurus Handover Site
The handover site itself is a static documentation project:
cd handover-docs
npm install
npm run build
Generated static files are emitted to handover-docs/build/.