How yahya-mohamoud/hms works
Staywell Hotel Desk is a local-first staff operations system, not a public booking platform. Staff use the web app to authenticate, manage guests and reservations, check guests into stays, handle room status and folios through checkout, and review daily reports and audit activity. The API routes these workflows to PostgreSQL; private ID images use a separate optional S3-compatible store. The graph includes documented capabilities whose implementation was not sampled, but their internal call paths are not inferred.
Main entry points: app.ts HTTP API · schema.prisma PostgreSQL · audit.ts Activity audit · documents-router.ts ID documents
Components 17
Staff interface
- Operations app
apps/web/src/App.tsx - API client
apps/web/src/lib/api.ts
API and access
- HTTP API
apps/api/src/app.ts - Authentication
apps/api/src/modules/auth/router.ts - Role checks
apps/api/src/middleware/auth.ts - Staff accounts
apps/api/src/modules/users/router.ts - Activity audit
apps/api/src/lib/audit.ts
Front desk operations
- Guest profiles
apps/api/src/modules/guests/router.ts - ID documents
apps/api/src/modules/guests/documents-router.ts - Reservations
apps/api/src/modules/reservations/router.ts - Room status
apps/api/src/modules/rooms/router.ts - Stay lifecycle
apps/api/src/modules/stays/router.ts
Finance and insights
- Folios and payments
apps/api/src/modules/billing/router.ts - Reports and insights
apps/api/src/modules/reports/router.ts
Data and documents
- PostgreSQL
apps/api/prisma/schema.prisma - Private object store
Other components
- Hotel staff
Connections 31
- Hotel staff → Operations app: uses
README.md - Operations app → API client: uses
apps/web/src/App.tsx - API client → HTTP API: requests
README.md - HTTP API → Authentication: routes
apps/api/src/app.ts - HTTP API → Role checks: authenticates
apps/api/src/app.ts - HTTP API → Room status: routes
apps/api/src/app.ts - HTTP API → Guest profiles: routes
apps/api/src/app.ts - HTTP API → ID documents: routes
apps/api/src/app.ts - HTTP API → Reservations: routes
apps/api/src/app.ts - HTTP API → Stay lifecycle: routes
apps/api/src/app.ts - HTTP API → Folios and payments: routes
apps/api/src/app.ts - HTTP API → Reports and insights: routes
apps/api/src/app.ts - HTTP API → Staff accounts: routes
apps/api/src/app.ts - Authentication → Role checks: checks roles
apps/api/src/modules/auth/router.ts - Reservations → PostgreSQL: reads and writes
apps/api/src/modules/reservations/router.ts - Guest profiles → PostgreSQL: reads and writes
apps/api/src/modules/guests/router.ts - ID documents → PostgreSQL: stores metadata
apps/api/src/modules/guests/documents-router.ts - ID documents → Private object store: uploads images
apps/api/src/modules/guests/documents-router.ts - Private object store → ID documents: signed downloads
apps/api/src/modules/guests/documents-router.ts - Room status → PostgreSQL: reads and writes
apps/api/src/modules/rooms/router.ts - Stay lifecycle → PostgreSQL: reads and writes
apps/api/src/modules/stays/router.ts - Folios and payments → PostgreSQL: reads and writes
apps/api/src/modules/billing/router.ts - Reports and insights → PostgreSQL: queries and saves
apps/api/src/modules/reports/router.ts - Staff accounts → PostgreSQL: manages accounts
apps/api/src/modules/users/router.ts - Authentication → PostgreSQL: checks accounts
apps/api/src/modules/auth/router.ts - Reservations → Activity audit: logs actions
apps/api/src/modules/reservations/router.ts - Stay lifecycle → Activity audit: logs actions
apps/api/src/modules/stays/router.ts - Folios and payments → Activity audit: logs actions
apps/api/src/modules/billing/router.ts - Reports and insights → Activity audit: logs close
apps/api/src/modules/reports/router.ts - ID documents → Activity audit: logs uploads
apps/api/src/modules/guests/documents-router.ts - Activity audit → PostgreSQL: writes activity
apps/api/src/lib/audit.ts