# Phase Handover — 12.8 Analytics

## Metadata

| Field | Value |
| --- | --- |
| Phase ID | hospitality-12.8 |
| Title | Analytics |
| Status | Complete |
| Service(s) | hospitality |
| Version | 0.12.8.0 |
| Date | 2026-07-26 |
| ADR(s) | ADR-017 (no new ADR) |

## Summary

Local analytics reporting shell on `hospitality_db`. Report definitions declare which local
`metric_keys` to track; snapshots refresh by counting rows in this service's own tables only
(no external analytics engine, no cross-service reads).

## Public APIs

| Method | Path |
| --- | --- |
| CRUD/list | `/api/v1/analytics-reports` |
| List/get | `/api/v1/analytics-snapshots` |
| Refresh | `POST /api/v1/analytics-snapshots/refresh` |

## Events

`hospitality.analytics_report_definition.created`, `analytics_snapshot.refreshed`

## Migration

`0009_phase_128_analytics` (additive)

## Known Limitations

- Metrics limited to simple local `COUNT(*)` per registered metric key
- No scheduled refresh jobs, dashboards, or cross-service warehouse joins

## Next Phase Entry

Phase **12.9 — AI Assistant**

## Service Snapshot

Regenerated: `docs/service-snapshots/hospitality.yaml`
