Hamsun. Prototypes GitHub โ†—

Hamsun Prototypes

Design-stage mockups and locked specs for every Hamsun PMS module โ€” guest-facing portals, staff tools, configuration UIs. Each module has an interactive prototype and a paired DESIGN.md ready for backend handoff. Production code lives in hamsun-guest-manager.

8
Modules
Architecture spine
๐ŸŒ Master Portal Architecture Spine ยท read first

How the master guest portal ties every module together โ€” entry point, stay state machine, 8 sub-flows, data model ownership, edge function topology, notification topology, build sequence, and the 10 critical invariants every module must respect. Read this before any module spec.

Modules
๐Ÿฝ Menu Admin Locked

Multi-menu admin โ€” pricing modes, time slots, choice groups, KOT config. Manages breakfast / lunch / dinner / snacks etc.

๐Ÿฅ Breakfast Portal Locked

Guest-facing breakfast pre-order portal. Time slot picker, mains with choice groups, drinks, folio breakdown. Linked from WhatsApp.

๐Ÿ›’ Mini-shop Catalog Locked

Mini-shop / sundries item picker โ€” drinks, snacks, OTC meds, phone accessories, toiletries. 7 categories, 20 seeded items.

๐Ÿ“‹ Reception Inbox ยท Cards Iterating

Reception command center โ€” 4-tab inbox with cross-team peek cards, overdue alerts, undo toasts. Card-style rows (multi-line, narrative meta).

๐Ÿ“‹ Reception Inbox ยท Table A/B compare

Same inbox, table-style rows. Single-line per row, fixed columns, header labels โ€” denser scanning. Sibling of Cards version for direct comparison.

โš™ Workflows Admin Iterating

Editor for per-category workflows (statuses, actions, charge points, flags). Generates SQL migration directly from edits.

๐Ÿงน Housekeeping Module Spec'd

Auto-cleaning module โ€” daily cron, post-checkout trigger, WhatsApp opt-in, guest portal toggle. Q1โ€“Q8 awaiting operator decisions.

Running locally