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