Phase 1 Mobile Scope Decision — 2026-04-28
Status: APPROVED
Authors: KeyNova Eng Lead + PM
Companion doc: property-1-gold-standard-fix-plan-2026-04-28.md (Track 8)
Decision
IN-SCOPE for Phase 1
| Surface | App | Status | Notes |
|---|---|---|---|
| Manager Dashboard (KPIs + metrics) | apps/manager | IMPLEMENTED | dashboardApi.getMetrics URL fixed (AP-T10-004) |
| F&B Order Entry (staff POS) | apps/staff | IMPLEMENTED | posApi prefix fixed (AP-T07-003) |
| Housekeeping Tasks (list + status update) | apps/staff | IMPLEMENTED | HK realtime via /housekeeping WS |
| Real-time Kitchen Orders (KDS companion) | apps/staff | IMPLEMENTED | /kitchen WS gateway |
DEFERRED to Phase 2
| Surface | Rationale |
|---|---|
| Mobile Frontdesk (check-in/check-out on phone) | Requires hardware integration (key encoder, ID scanner) — not feasible on mobile Phase 1. Staff use dashboard instead. |
| Mobile Reservations Browse | Low priority: staff use dashboard web app. Mobile browse adds complexity without Phase 1 revenue impact. |
| Manager Night Audit Widget | NA runs from dashboard. Mobile widget deferred until NA flow is fully stable post-go-live. |
| Kiosk Self Check-In (hmp-kds-kiosk) | Guest-facing kiosk requires stable hardware deployment + guest portal. Deferred until kiosk app is rebuilt (AP-T07-001). |
| Mobile Reporting | Reports engine solidifying in Wave 2. Mobile view deferred to Phase 2. |
Removed from codebase (Phase 1 cleanup)
The following placeholder/stub screens in hmp-mobile-apps are not needed for Phase 1 and should be deleted to prevent confusion:
apps/staff/app/(tabs)/checkin.tsx— if this is a placeholder screen, delete it OR replace with a clear "Use dashboard for check-in" message component.
If the file does not exist, skip deletion.
Consequences
- Wave 2 mobile items (AP-T06-003, AP-T06-004) are DEFERRED — these action items are removed from Wave 2 scope.
- AP-T07-001 (KDS Electron rebuild) remains in Wave 2 as it is a standalone app, not the mobile app.
- Detox/Maestro e2e coverage is scoped to the IN-SCOPE surfaces above.
Review Sign-off
This document serves as the authoritative scope decision for all Phase 1 mobile work. Changes to scope require a new ADR-style update to this document.