Hotel Feature Packages — Packaged Functionality by Domain
Status: Product Specification (business-facing)
Vertical: Hotels & Hospitality
Substrate: Sovereign OS / Community Weave Platform
Version: 1.0.0 | Date: 2026-11-09
Sources: Comprehensive Business Processes Specification, Sovereign OS Playbook Architecture: Common Business Workflows, Playbook Catalog — Full Detail for Every Playbook
1. Packaging Philosophy
Every hotel capability is delivered as a feature package — a coherent set of functions, workflows, and integrations that a hotel can adopt independently. Packages are:
- Modular: adopt Front Desk first, add Maintenance later; no big-bang replacement
- Declarative: each package is configured via NATS KV lookups and scenario packs — zero bespoke database tables
- Integrated: packages share one state of record; a room status change in Housekeeping is visible to Front Desk, Maintenance, and Finance simultaneously
- Auditable: every state transition in every package produces a cryptographic PoCE receipt
- Soft-first: each package validates before going live (zero live writes until a live gate is passed)
2. Package Matrix
| Package | Hotel Domain | Core User Personas | Key External Integration | Entry Use Case |
|---|---|---|---|---|
| PK-01 Front Office & Reservations | Rooms / Front desk | Front desk agent, night auditor, revenue manager, cashier | PMS, ERPNext | Check a guest in and open a folio |
| PK-02 Housekeeping & Rooms Division | Housekeeping | Room attendant, housekeeping supervisor, inspector | — | Turn a room from dirty to clean with sign-off |
| PK-03 Engineering & Maintenance | Buildings / Assets | Engineering supervisor, technician, vendor, front desk (fault intake) | OpenMAINT, MinIO | Log an HVAC fault, dispatch a technician, close the work order |
| PK-04 Restaurant & F&B | Restaurant / Kitchen | Executive chef, F&B manager, procurement officer, steward | ERPNext, Solver Gateway | Order weekly produce, split basket across vendors, three-way match |
| PK-05 Events & Banquets | Events / Catering | Events manager, banquet chef, client, finance | Gotenberg, Synapse | Book a function space, design a menu, issue a BEO |
| PK-06 Staff & Workforce | Staff / HR | Department head, shift scheduler, HR, payroll | Keycloak, APF | Publish a shift roster, record attendance, resolve role permissions |
| PK-07 Procurement & Group Purchasing | Procurement / Corporate | Procurement officer, group sourcing lead, finance controller | ERPNext, federation (s184) | Aggregate F&B demand across properties for volume pricing |
| PK-08 Guest Experience & Identity | Guest facing | Front desk, guest relations, security, IT | Keycloak, BBS+ | Verify guest identity selectively, manage access permissions |
| PK-09 Compliance & Safety | Compliance / Risk | Compliance officer, GM, inspector, auditor | — | Fire safety inspection, expert sign-off, certificate issuance |
Each package maps to one or more hotel playbooks (H-1..H-10 in Playbooks for Hotels — Declarative Hotel Operations) and one or more canonical process families (03-PROCESSES-AND-WORKFLOWS.md).
3. Cross-Cutting Capabilities (in every package)
| Capability | What it means for the hotel |
|---|---|
| Single state of record | One record per room, guest, asset, requisition; every desk sees the same truth |
| Cryptographic audit (PoCE) | Every check-in, sign-off, approval, and work-order close is an immutable, verifiable receipt |
| Separation of duties | Cleaner cannot inspect their own room; approver cannot be the requester; configured via declarative lookup |
| Real-time status | Room turnover, fault status, and approval state stream via NATS WebSocket — no polling |
| Fail-closed operations | If ERPNext, OpenMAINT, or the solver is unavailable, the package refuses with a typed error — never invents a fake room, rate, or plan |
| No fake metrics | Dashboards show live data or honest empty states; no hardcoded occupancy or ADR numbers |
4. How to Adopt
- Pick 1–3 packages for the pilot property (recommended: PK-01 + PK-02 + PK-04)
- Run in Soft mode — validate workflows with test data, zero live writes
- Pass the live gate — named approver confirms, then go live
- Add packages as the property matures (maintenance, events, group procurement)
See Deployment & Starter Packs — Hotel Rollout for the bring-up sequence and Appendix C — Hotel Implementation Roadmap for the phased rollout.