5c6a2e78cf
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>
46 lines
1.5 KiB
Markdown
46 lines
1.5 KiB
Markdown
# Phase 12.8 — Analytics
|
|
|
|
| Field | Value |
|
|
| --- | --- |
|
|
| Status | Complete |
|
|
| Module | hospitality |
|
|
| Commercial Product | Torbat Food |
|
|
| Version | 0.12.8.0 |
|
|
| Database | `hospitality_db` |
|
|
| API Port | 8009 |
|
|
| ADR | ADR-001, ADR-003, ADR-006, ADR-017 |
|
|
| Prior phase | [12.7 Connectors](hospitality-phase-12-7.md) |
|
|
|
|
## Goal
|
|
|
|
Add a local analytics reporting shell that counts rows in this service's own tables only
|
|
(venues, menus, POS tickets, reservations, kitchen tickets, connector activity) — no external
|
|
analytics engine and no cross-service reads.
|
|
|
|
## Scope (In)
|
|
|
|
- Aggregates: AnalyticsReportDefinition, AnalyticsSnapshot
|
|
- APIs under `/api/v1/analytics-reports`, `/api/v1/analytics-snapshots` (+ `/refresh`)
|
|
- `POST /analytics-snapshots/refresh` computes a `metrics` JSON payload via simple local
|
|
`COUNT(*)` queries for each `metric_key` on the report definition
|
|
- Permissions + publish-only events
|
|
- Alembic `0009_phase_128_analytics`
|
|
- Capability `analytics`; version `0.12.8.0`
|
|
|
|
## Out of Scope
|
|
|
|
- AI Assistant (12.9)
|
|
- Cross-service / warehouse analytics, BI dashboards, scheduled jobs
|
|
|
|
## Quality Gates
|
|
|
|
Passed (architecture, dependency, migration, tenant, API, permissions, docs). See handover.
|
|
|
|
## Related Documents
|
|
|
|
- [Hospitality Roadmap](hospitality-roadmap.md)
|
|
- [Phase Handover 12.8](phase-handover/phase-12-8.md)
|
|
- [ADR-017](architecture/adr/ADR-017.md)
|
|
- [Module Registry](module-registry.md#hospitality)
|
|
- [Service Snapshot](service-snapshots/hospitality.yaml)
|