TorbatYar/docs/phase-handover/phase-12-0.md
Mortezakoohjani 5c6a2e78cf feat(platform): seed service registry, deploy all modules, and fix homepage catalog.
Register all active platform services and base features in core DB so admin can manage them, add delivery/hospitality/sports-center backend phases, update apps catalog and production deploy tooling.

Co-authored-by: Cursor <cursoragent@cursor.com>
2026-07-27 12:39:51 +03:30

69 lines
2.4 KiB
Markdown

# Phase Handover — 12.0 Hospitality Platform Foundation
## Summary
Phase 12.0 delivered the independent **Hospitality Platform** microservice (`hospitality-service`, `hospitality_db`, port **8009**, version **0.12.0.0**, commercial product **Torbat Food**). Foundation aggregates, bundle/feature-toggle licensing shells, permissions, publish-only events, APIs, migration, and docs are in place. **No POS / kitchen / ordering / reservation engines** were implemented.
Evolves planned phase id `restaurant-foundation` into `hospitality-12.0`.
## What Changed
| Area | Change |
| --- | --- |
| Service | New `backend/services/hospitality` |
| Database | `hospitality_db` + Alembic `0001_initial` |
| ADR | ADR-017 Accepted |
| Runtime | docker-compose service on 8009; `.env.example` keys |
| Docs | Phase doc, roadmap, handover, registries, manifests |
## Public Surface
- `/health`, `/capabilities`
- `/api/v1/venues|branches|dining-areas|tables|menus|menu-categories|menu-items`
- `/api/v1/bundle-definitions|tenant-bundles|feature-toggles`
- `/api/v1/roles|permissions|configurations|events|settings`
- Events: `hospitality.*` (publish-only)
- Permissions: `hospitality.*`
## Migration Notes
New database `hospitality_db` (sole owner). No changes to Core/CRM/Loyalty/Communication/Delivery/Sports Center schemas.
## Quality Gates
| Gate | Result |
| --- | --- |
| Architecture | Pass |
| Dependency | Pass |
| Backward Compatibility | Pass (new service) |
| Health / Capability | Pass |
| Feature Toggle / Bundle | Pass |
| Permission | Pass |
| API | Pass |
| Repository / Service | Pass |
| Migration | Pass |
| Tenant Isolation | Pass |
| Security | Pass |
| Performance | Pass |
| Documentation | Pass |
| Integration (contracts only) | Pass |
| Self Audit | Pass |
## Known Follow-ups (not in this phase)
- Digital Menu / QR Menu depth (catalog engines)
- POS Lite / POS Pro
- Kitchen, Reservation, Table Service engines
- Connector implementations for Accounting / CRM / Loyalty / Communication / Delivery / Website
## Next Phase
Phase 12.1 — Digital Menu Catalog (per [hospitality-roadmap.md](../hospitality-roadmap.md)).
## Related Documents
- [hospitality-phase-12-0.md](../hospitality-phase-12-0.md)
- [hospitality-roadmap.md](../hospitality-roadmap.md)
- [ADR-017](../architecture/adr/ADR-017.md)
- [module-registry.md](../module-registry.md#hospitality)