Deployment & Starter Packs — Hotel Rollout
Status: Implementation & Operations
Sources: S-07 — Starter Packs for Stakeholders, A-04 — Starter Packs for Administrators, D-05 — Starter Packs for Developers, D-07 — Starter Bundles for Developers, A-01 — Jijibora Deployment (Administrator Operations)
1. Deployment Posture — Soft First
Per AGENTS.md — Sovereign OS / Cosmic Circuit and the Jijibora deployment model, every hotel playbook ships Soft-first (validation + plan, zero live writes) until a live gate ritual is performed. A pack never self-declares live_gate_met. Rollout stays in Soft mode until the hotel confirms:
- Which 3–5 problems to solve first (e.g., housekeeping sign-off, procurement approval, maintenance work orders)
- Which citizen/staff languages and phone numbers receive reports and updates
- Who holds funds and who taps "Approve" on photo proof
- Which personal details are kept out of receipts/dashboards; how long emergency access lasts
- Service promises (max hours a room may stay out of order, max response time for faults)
2. Hotel Starter Packs
Starter packs bind to existing scenario/lookup keys (never invent new namespaces) and emerge as dictionary SKU rows.
| Starter Pack | Contents | Hotel Day-1 Scope |
|---|---|---|
| Front Desk Desk | H-1 Reservation & Folio, H-10 Identity | Reservations, check-in/check-out, folio, guest identity |
| Housekeeping Desk | H-2 Housekeeping, H-7 Staff Comms | Room turnover, checklists, inspector sign-off, staff chat |
| Maintenance Desk | H-3 Maintenance, H-8 Incident | Fault intake, OpenMAINT work orders, expert sign-off |
| Finance Desk | H-4 Procurement, ERPNext sync | Requisitions, approval tiers, PO sync, three-way match |
| Events Desk | H-5 Events, H-6 Mood Board | Function bookings, BEOs, event design, PDF export |
| Full Hotel Bundle | All H-1..H-10 + federation | Complete property operations backbone |
3. Bring-Up Sequence (Per Pack)
- Ensure lookups/scenarios exist in NATS KV (
datasets/lookups/,datasets/scenarios/are seed sources; runtime reads KV, never filesystem). - Seed one family at a time with its targeted seeder (
scripts/seed-nats-kv-declarative.mjs); record revision indatasets/lookups/kv-manifest.json. - Run the family verify script (NATS judge + Surreal cross-checks); never fabricate a passing verdict.
- Re-run
scripts/render-fragments-manifest.mjsafter any fragment change. - Perform the live gate ritual to move a pack from Soft to LIVE.
4. Technical Stack (Local Dev)
| Service | Port | Role |
|---|---|---|
| SurrealDB | :8000 | State of record (RocksDB, NS africa, DB community_os) |
| NATS | :4222 | Event spine / JetStream KV |
| Apache Camel | :8181 | Protocol mediation, EIP routes |
| Kestra | :8180 | Macro-DAG orchestration |
| Agent BFF | :3030 | Runtime BFF, playbook runner proxy |
| Truth BFF | :3031 | Truth graph / DDE proxy |
| ERPNext | :8000 (API) | Fiscal GL / PO |
| OpenMAINT | :8080 | CMMS / work orders |
| Synapse | :8008 | Matrix chat |
| Plane.io | :8091 | Task boards |
| MinIO | :9000 | Object storage |
| Gotenberg | :3094 | PDF generation |
| Keycloak | :8081 | Identity / OIDC |
| Solver Gateway | :3070 | Optimisation |
| Fleetbase | :9002 | Logistics |
Local start: surreal start --user root --pass root --bind 127.0.0.1:8000 rocksdb:/data/surreal-data; then DEV_SKIP_AUTH=1 SURREAL_URL=http://127.0.0.1:8000 node apps/agent-bff/src/index.js.
5. Phased Rollout (Hotel Group)
| Phase | Scope | Exit Criteria |
|---|---|---|
| Pilot (1 property) | Front Desk + Housekeeping starter packs, Soft mode | Live gate passed; PoCE receipts verified; staff trained |
| Expand (1 property) | Add Maintenance + Finance packs | ERPNext 3-way match live; OpenMAINT WOs synced |
| Group (multi-property) | Add Events + federation (H-9) | Cross-property procurement live; BBS+ selective disclosure |
| Scale (N properties) | Full bundle + optimisation | Solver-gateway use cases live; dashboards from live data only |