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

2.4 KiB

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).