# tendulkark/sln-residency architecture

> Architecture diagram of the GitHub repository tendulkark/sln-residency, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-02). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/tendulkark/sln-residency
- Repository: https://github.com/tendulkark/sln-residency

## Overview

SLN Residency is a staff-only, multi-tenant hotel operations console: staff manage rooms and reservations, record desk-collected payments, and handle invoices and reporting. The web app routes staff through protected business modules; the Fastify API exposes resource handlers backed by Prisma and shared validation schemas. The graph highlights reservation availability/billing, administration, and reporting alongside the wider documented modules. Some frontend-to-API wiring and unsampled handlers are not shown, so those relationships are omitted rather than inferred.

Main entry points: [`apps/web/src/app`](https://github.com/tendulkark/sln-residency/tree/main/apps/web/src/app) (Routes and shell), [`apps/api/src/app.js`](https://github.com/tendulkark/sln-residency/blob/main/apps/api/src/app.js) (Fastify API), [`apps/api/src/routes/bookings.routes.js`](https://github.com/tendulkark/sln-residency/blob/main/apps/api/src/routes/bookings.routes.js) (Booking handlers), [`apps/api/src/lib/audit.js`](https://github.com/tendulkark/sln-residency/blob/main/apps/api/src/lib/audit.js) (Audit recording)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_web["Staff console"]
  node_webapp["Web application<br/>[main.jsx]"]
  node_webshell["Routes and shell"]
  node_authui["Sign-in and session"]
end

subgraph group_booking["Stay operations"]
  node_reservations["Reservations"]
  node_invoices["Invoices"]
end

subgraph group_admin["Hotel administration"]
  node_roomsui["Rooms and housekeeping"]
  node_dashboard["Dashboard"]
  node_reportsui["Reports"]
  node_settingsui["Settings and staff"]
  node_auditui["Audit log"]
end

subgraph group_api["API services"]
  node_apiapp["Fastify API<br/>[app.js]"]
  node_bookingapi["Booking handlers<br/>[bookings.routes.js]"]
  node_invoiceapi["Invoice handlers<br/>[invoices.routes.js]"]
  node_roomsapi["Room handlers<br/>[rooms.routes.js]"]
  node_rolesapi["Role handlers<br/>[roles.routes.js]"]
  node_taxapi["Tax rule handlers"]
  node_availability["Availability checks<br/>[availability.js]"]
  node_billing["Stay billing<br/>[billing.js]"]
  node_audit["Audit recording<br/>[audit.js]"]
  node_reportsapi["Report services<br/>[reports.js]"]
end

subgraph group_shared["Shared contracts"]
  node_schemas["Zod schemas and permissions"]
end

node_staff(("Hotel staff"))
node_postgres[("PostgreSQL")]

node_staff -->|"uses"| node_webapp
node_webapp -->|"mounts router"| node_webshell
node_webshell -->|"routes to"| node_authui
node_webshell -->|"routes to"| node_reservations
node_webshell -->|"routes to"| node_invoices
node_webshell -->|"routes to"| node_roomsui
node_webshell -->|"routes to"| node_dashboard
node_webshell -->|"routes to"| node_reportsui
node_webshell -->|"routes to"| node_settingsui
node_webshell -->|"routes to"| node_auditui
node_apiapp -->|"registers"| node_bookingapi
node_apiapp -->|"registers"| node_invoiceapi
node_apiapp -->|"registers"| node_roomsapi
node_apiapp -->|"registers"| node_rolesapi
node_apiapp -->|"registers"| node_taxapi
node_bookingapi -->|"checks conflicts"| node_availability
node_bookingapi -->|"computes stay"| node_billing
node_bookingapi -->|"records actions"| node_audit
node_invoiceapi -->|"computes invoice"| node_billing
node_invoiceapi -->|"records actions"| node_audit
node_roomsapi -->|"checks conflicts"| node_availability
node_roomsapi -->|"records actions"| node_audit
node_rolesapi -->|"records actions"| node_audit
node_taxapi -->|"records actions"| node_audit
node_bookingapi -->|"validates payloads"| node_schemas
node_roomsapi -->|"validates payloads"| node_schemas
node_rolesapi -->|"validates payloads"| node_schemas
node_taxapi -->|"validates payloads"| node_schemas
node_reportsui -.->|"requests reports"| node_reportsapi
node_apiapp -.->|"serves persisted data"| node_postgres

click node_webapp "https://github.com/tendulkark/sln-residency/blob/main/apps/web/src/main.jsx"
click node_webshell "https://github.com/tendulkark/sln-residency/tree/main/apps/web/src/app"
click node_authui "https://github.com/tendulkark/sln-residency/tree/main/apps/web/src/modules/auth"
click node_reservations "https://github.com/tendulkark/sln-residency/tree/main/apps/web/src/modules/reservations"
click node_invoices "https://github.com/tendulkark/sln-residency/tree/main/apps/web/src/modules/invoices"
click node_roomsui "https://github.com/tendulkark/sln-residency/tree/main/apps/web/src/modules/rooms"
click node_dashboard "https://github.com/tendulkark/sln-residency/tree/main/apps/web/src/modules/dashboard"
click node_reportsui "https://github.com/tendulkark/sln-residency/tree/main/apps/web/src/modules/reports"
click node_settingsui "https://github.com/tendulkark/sln-residency/tree/main/apps/web/src/modules/settings"
click node_auditui "https://github.com/tendulkark/sln-residency/tree/main/apps/web/src/modules/audit"
click node_apiapp "https://github.com/tendulkark/sln-residency/blob/main/apps/api/src/app.js"
click node_bookingapi "https://github.com/tendulkark/sln-residency/blob/main/apps/api/src/routes/bookings.routes.js"
click node_invoiceapi "https://github.com/tendulkark/sln-residency/blob/main/apps/api/src/routes/invoices.routes.js"
click node_roomsapi "https://github.com/tendulkark/sln-residency/blob/main/apps/api/src/routes/rooms.routes.js"
click node_rolesapi "https://github.com/tendulkark/sln-residency/blob/main/apps/api/src/routes/roles.routes.js"
click node_taxapi "https://github.com/tendulkark/sln-residency/blob/main/apps/api/src/routes/tax-rules.routes.js"
click node_availability "https://github.com/tendulkark/sln-residency/blob/main/apps/api/src/lib/availability.js"
click node_billing "https://github.com/tendulkark/sln-residency/blob/main/apps/api/src/lib/billing.js"
click node_audit "https://github.com/tendulkark/sln-residency/blob/main/apps/api/src/lib/audit.js"
click node_reportsapi "https://github.com/tendulkark/sln-residency/blob/main/apps/api/src/lib/reports.js"
click node_schemas "https://github.com/tendulkark/sln-residency/tree/main/packages/shared-schemas/src"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_webapp,node_webshell,node_authui toneBlue
class node_reservations,node_invoices,node_postgres toneAmber
class node_roomsui,node_dashboard,node_reportsui,node_settingsui,node_auditui toneMint
class node_apiapp,node_bookingapi,node_invoiceapi,node_roomsapi,node_rolesapi,node_taxapi,node_availability,node_billing,node_audit,node_reportsapi toneRose
class node_schemas,node_staff toneIndigo
```

## Components

### Staff console

- [Web application](https://github.com/tendulkark/sln-residency/blob/main/apps/web/src/main.jsx): `apps/web/src/main.jsx`
- [Routes and shell](https://github.com/tendulkark/sln-residency/tree/main/apps/web/src/app): `apps/web/src/app`
- [Sign-in and session](https://github.com/tendulkark/sln-residency/tree/main/apps/web/src/modules/auth): `apps/web/src/modules/auth`

### Stay operations

- [Reservations](https://github.com/tendulkark/sln-residency/tree/main/apps/web/src/modules/reservations): `apps/web/src/modules/reservations`
- [Invoices](https://github.com/tendulkark/sln-residency/tree/main/apps/web/src/modules/invoices): `apps/web/src/modules/invoices`

### Hotel administration

- [Rooms and housekeeping](https://github.com/tendulkark/sln-residency/tree/main/apps/web/src/modules/rooms): `apps/web/src/modules/rooms`
- [Dashboard](https://github.com/tendulkark/sln-residency/tree/main/apps/web/src/modules/dashboard): `apps/web/src/modules/dashboard`
- [Reports](https://github.com/tendulkark/sln-residency/tree/main/apps/web/src/modules/reports): `apps/web/src/modules/reports`
- [Settings and staff](https://github.com/tendulkark/sln-residency/tree/main/apps/web/src/modules/settings): `apps/web/src/modules/settings`
- [Audit log](https://github.com/tendulkark/sln-residency/tree/main/apps/web/src/modules/audit): `apps/web/src/modules/audit`

### API services

- [Fastify API](https://github.com/tendulkark/sln-residency/blob/main/apps/api/src/app.js): `apps/api/src/app.js`
- [Booking handlers](https://github.com/tendulkark/sln-residency/blob/main/apps/api/src/routes/bookings.routes.js): `apps/api/src/routes/bookings.routes.js`
- [Invoice handlers](https://github.com/tendulkark/sln-residency/blob/main/apps/api/src/routes/invoices.routes.js): `apps/api/src/routes/invoices.routes.js`
- [Room handlers](https://github.com/tendulkark/sln-residency/blob/main/apps/api/src/routes/rooms.routes.js): `apps/api/src/routes/rooms.routes.js`
- [Role handlers](https://github.com/tendulkark/sln-residency/blob/main/apps/api/src/routes/roles.routes.js): `apps/api/src/routes/roles.routes.js`
- [Tax rule handlers](https://github.com/tendulkark/sln-residency/blob/main/apps/api/src/routes/tax-rules.routes.js): `apps/api/src/routes/tax-rules.routes.js`
- [Availability checks](https://github.com/tendulkark/sln-residency/blob/main/apps/api/src/lib/availability.js): `apps/api/src/lib/availability.js`
- [Stay billing](https://github.com/tendulkark/sln-residency/blob/main/apps/api/src/lib/billing.js): `apps/api/src/lib/billing.js`
- [Audit recording](https://github.com/tendulkark/sln-residency/blob/main/apps/api/src/lib/audit.js): `apps/api/src/lib/audit.js`
- [Report services](https://github.com/tendulkark/sln-residency/blob/main/apps/api/src/lib/reports.js): `apps/api/src/lib/reports.js`

### Shared contracts

- [Zod schemas and permissions](https://github.com/tendulkark/sln-residency/tree/main/packages/shared-schemas/src): `packages/shared-schemas/src`

### Other components

- **Hotel staff**
- **PostgreSQL**

## Connections

- Hotel staff → Web application: uses (evidence: `README.md`)
- Web application → Routes and shell: mounts router (evidence: `apps/web/src/main.jsx`)
- Routes and shell → Sign-in and session: routes to (evidence: `README.md`)
- Routes and shell → Reservations: routes to (evidence: `README.md`)
- Routes and shell → Invoices: routes to (evidence: `README.md`)
- Routes and shell → Rooms and housekeeping: routes to (evidence: `README.md`)
- Routes and shell → Dashboard: routes to (evidence: `README.md`)
- Routes and shell → Reports: routes to (evidence: `README.md`)
- Routes and shell → Settings and staff: routes to (evidence: `README.md`)
- Routes and shell → Audit log: routes to (evidence: `README.md`)
- Fastify API → Booking handlers: registers (evidence: `apps/api/src/app.js`)
- Fastify API → Invoice handlers: registers (evidence: `apps/api/src/app.js`)
- Fastify API → Room handlers: registers (evidence: `apps/api/src/app.js`)
- Fastify API → Role handlers: registers (evidence: `apps/api/src/app.js`)
- Fastify API → Tax rule handlers: registers (evidence: `apps/api/src/app.js`)
- Booking handlers → Availability checks: checks conflicts (evidence: `apps/api/src/routes/bookings.routes.js`)
- Booking handlers → Stay billing: computes stay (evidence: `apps/api/src/routes/bookings.routes.js`)
- Booking handlers → Audit recording: records actions (evidence: `apps/api/src/routes/bookings.routes.js`)
- Invoice handlers → Stay billing: computes invoice (evidence: `apps/api/src/routes/invoices.routes.js`)
- Invoice handlers → Audit recording: records actions (evidence: `apps/api/src/routes/invoices.routes.js`)
- Room handlers → Availability checks: checks conflicts (evidence: `apps/api/src/routes/rooms.routes.js`)
- Room handlers → Audit recording: records actions (evidence: `apps/api/src/routes/rooms.routes.js`)
- Role handlers → Audit recording: records actions (evidence: `apps/api/src/routes/roles.routes.js`)
- Tax rule handlers → Audit recording: records actions (evidence: `apps/api/src/routes/tax-rules.routes.js`)
- Booking handlers → Zod schemas and permissions: validates payloads (evidence: `apps/api/src/routes/bookings.routes.js`)
- Room handlers → Zod schemas and permissions: validates payloads (evidence: `apps/api/src/routes/rooms.routes.js`)
- Role handlers → Zod schemas and permissions: validates payloads (evidence: `apps/api/src/routes/roles.routes.js`)
- Tax rule handlers → Zod schemas and permissions: validates payloads (evidence: `apps/api/src/routes/tax-rules.routes.js`)
- Reports → Report services: requests reports
- Fastify API → PostgreSQL: serves persisted data
