How shashwat1213/the-living-canvas-pms works
The Living Canvas is a multi-tenant hospitality PMS. Staff sign in, select a property, and use the SPA to manage bookings and day-to-day operations; property-scoped API handlers authorize requests and serve domain workflows. Reservations, folios and payments form a central business path, alongside property setup, operations, reporting, CRM, audit and notifications. AI marketing and the read-only assistant are additional capabilities. The README documents overall architecture; some domain modules were not sampled, so their internal call paths are not asserted.
Main entry points: routes.ts Reservations · prisma.ts PostgreSQL data · AppRouter.tsx React SPA · api.ts API client
Components 26
Staff application
- React SPA
frontend/src/AppRouter.tsx - Session UI
frontend/src/auth/session.ts - API client
frontend/src/lib/api.ts - Reservations UI
frontend/src/features/reservations/ReservationsPage.tsx - Calendar UI
frontend/src/features/calendar/CalendarPage.tsx
Identity and tenancy
- Authentication
backend/src/modules/auth/routes.ts - Session service
backend/src/platform/auth/session-service.ts - Tenant authentication
backend/src/platform/tenancy/middleware.ts - Permission guards
backend/src/platform/rbac/guard.ts
Property workflows
- Property setup
backend/src/modules/properties/routes.ts - Rooms and rates
backend/src/modules/rooms - Reservations
backend/src/modules/reservations/routes.ts - Folios and payments
backend/src/modules/folios/routes.ts - Guest CRM
backend/src/modules/guests - Availability and calendar
backend/src/modules/calendar
Operations and insight
- Hotel operations
backend/src/modules/housekeeping - Point of sale
backend/src/modules/pos - Dashboard and reports
backend/src/modules/reports - AI marketing
backend/src/modules/marketing - AI assistant
backend/src/modules/assistant - Audit and notifications
backend/src/modules/audit
Shared platform
- PostgreSQL data
backend/src/lib/prisma.ts - Payment gateway
backend/src/platform/payments/razorpay-provider.ts - AI provider seam
backend/src/platform/ai/registry.ts - Background jobs
backend/src/platform/jobs/queue.ts
Other components
- Hotel staff
Connections 28
- Hotel staff → React SPA: uses
- React SPA → Session UI: derives session
frontend/src/auth/session.ts - React SPA → Reservations UI: routes to
frontend/src/AppRouter.tsx - React SPA → Calendar UI: routes to
frontend/src/AppRouter.tsx - Reservations UI → API client: requests data
frontend/src/features/reservations/ReservationsPage.tsx - Calendar UI → API client: requests data
frontend/src/features/calendar/CalendarPage.tsx - API client → Authentication: refreshes token
frontend/src/lib/api.ts - API client → Reservations: calls API
- Hotel staff → Authentication: signs in
- Authentication → Session service: manages sessions
backend/src/modules/auth/routes.ts - Session service → PostgreSQL data: reads and writes
backend/src/platform/auth/session-service.ts - Tenant authentication → Permission guards: sets request context
backend/src/platform/tenancy/middleware.ts - Reservations → Permission guards: guards routes
backend/src/modules/reservations/routes.ts - Reservations → PostgreSQL data: scoped persistence
- Folios and payments → Permission guards: guards routes
backend/src/modules/folios/routes.ts - Folios and payments → Payment gateway: opens payment intents
backend/src/modules/folios/routes.ts - Reservations → Folios and payments: bills stays
- Point of sale → Folios and payments: settles to room folios
- Rooms and rates → Property setup: belongs to property
- Availability and calendar → Reservations: shows booking timeline
- Dashboard and reports → PostgreSQL data: reads business data
- AI marketing → AI provider seam: generates copy
- AI assistant → AI provider seam: answers questions
- AI assistant → Dashboard and reports: grounds responses
- Audit and notifications → Background jobs: uses queued jobs
- Reservations → Audit and notifications: audits mutations
- Hotel operations → PostgreSQL data: persists operations
- Guest CRM → PostgreSQL data: persists guest records