# kkversile/rainwood architecture

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

- Interactive diagram: https://gitdiagram.com/kkversile/rainwood
- Repository: https://github.com/kkversile/rainwood

## Overview

RainWood is a hotel direct-booking and reservation platform with public discovery and booking, plus administrative, agent, and staff operations. The primary customer flow is hotel discovery, availability and pricing, inventory hold, reservation, payment, and voucher or cancellation. The frontend uses a shared API client to reach a NestJS backend backed by PostgreSQL. The README documents transactional inventory protection, idempotent payment handling, and AxisRooms integration; unsampled feature modules are included where their paths are present, but their internal calls are not assumed.

Main entry points: [`frontend/src/lib/api.ts`](https://github.com/kkversile/rainwood/blob/main/frontend/src/lib/api.ts) (API client), [`backend/src/modules/reservations/reservations.service.ts`](https://github.com/kkversile/rainwood/blob/main/backend/src/modules/reservations/reservations.service.ts) (Reservations), [`backend/src/common/prisma.service.ts`](https://github.com/kkversile/rainwood/blob/main/backend/src/common/prisma.service.ts) (Persistence access), [`frontend/src/app/page.tsx`](https://github.com/kkversile/rainwood/blob/main/frontend/src/app/page.tsx) (Web application)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_web["Web experience"]
  node_frontend["Web application<br/>[page.tsx]"]
  node_bookingflow["Booking flow<br/>[BookingFlow.tsx]"]
  node_api["API client<br/>[api.ts]"]
end

subgraph group_booking["Booking lifecycle"]
  node_hotels["Hotel catalog<br/>[hotels.service.ts]"]
  node_availability["Availability pricing"]
  node_holds["Inventory holds<br/>[holds.service.ts]"]
  node_reservations["Reservations"]
  node_reservationapi["Reservation routes"]
  node_payments["Payments"]
  node_vouchers["Vouchers"]
  node_groups["Group bookings<br/>[groups.service.ts]"]
end

subgraph group_hotelops["Hotel operations"]
  node_tax["Tax documents"]
  node_reports["Reports<br/>[reports.service.ts]"]
  node_housekeeping["Housekeeping"]
end

subgraph group_platform["Platform services"]
  node_auth["Authentication<br/>[auth.service.ts]"]
  node_agents["Agent management<br/>[agents.service.ts]"]
  node_axisrooms["AxisRooms adapter"]
  node_prisma["Persistence access<br/>[prisma.service.ts]"]
  node_database[("PostgreSQL")]
end

node_guest(("Guest"))
node_apiuser(("Admin / agent / staff"))

node_guest -->|"discovers hotels"| node_frontend
node_frontend -.->|"starts booking"| node_bookingflow
node_bookingflow -.->|"requests data"| node_api
node_api -.->|"calls API"| node_hotels
node_api -.->|"checks availability"| node_availability
node_api -.->|"creates hold"| node_holds
node_api -.->|"submits reservation"| node_reservationapi
node_reservationapi -->|"dispatches"| node_reservations
node_reservations -.->|"payment workflow"| node_payments
node_reservations -.->|"issues voucher"| node_vouchers
node_api -->|"refreshes session"| node_auth
node_apiuser -.->|"uses portal"| node_api
node_apiuser -.->|"manages blocks"| node_groups
node_apiuser -.->|"manages tax records"| node_tax
node_apiuser -.->|"views reports"| node_reports
node_apiuser -.->|"runs operations"| node_housekeeping
node_apiuser -.->|"manages agents"| node_agents
node_reservations -.->|"integration boundary"| node_axisrooms
node_hotels -.->|"uses persistence"| node_prisma
node_reservations -.->|"uses persistence"| node_prisma
node_prisma -.->|"accesses database"| node_database

click node_frontend "https://github.com/kkversile/rainwood/blob/main/frontend/src/app/page.tsx"
click node_bookingflow "https://github.com/kkversile/rainwood/blob/main/frontend/src/components/BookingFlow.tsx"
click node_api "https://github.com/kkversile/rainwood/blob/main/frontend/src/lib/api.ts"
click node_hotels "https://github.com/kkversile/rainwood/blob/main/backend/src/modules/hotels/hotels.service.ts"
click node_availability "https://github.com/kkversile/rainwood/blob/main/backend/src/modules/availability/availability.service.ts"
click node_holds "https://github.com/kkversile/rainwood/blob/main/backend/src/modules/holds/holds.service.ts"
click node_reservations "https://github.com/kkversile/rainwood/blob/main/backend/src/modules/reservations/reservations.service.ts"
click node_reservationapi "https://github.com/kkversile/rainwood/blob/main/backend/src/modules/reservations/reservations.controller.ts"
click node_payments "https://github.com/kkversile/rainwood/blob/main/backend/src/modules/payments/payments.service.ts"
click node_vouchers "https://github.com/kkversile/rainwood/blob/main/backend/src/modules/vouchers/vouchers.service.ts"
click node_auth "https://github.com/kkversile/rainwood/blob/main/backend/src/modules/auth/auth.service.ts"
click node_agents "https://github.com/kkversile/rainwood/blob/main/backend/src/modules/agents/agents.service.ts"
click node_groups "https://github.com/kkversile/rainwood/blob/main/backend/src/modules/groups/groups.service.ts"
click node_tax "https://github.com/kkversile/rainwood/blob/main/backend/src/modules/tax-documents/tax-documents.service.ts"
click node_reports "https://github.com/kkversile/rainwood/blob/main/backend/src/modules/reports/reports.service.ts"
click node_housekeeping "https://github.com/kkversile/rainwood/blob/main/backend/src/modules/housekeeping/housekeeping.service.ts"
click node_axisrooms "https://github.com/kkversile/rainwood/blob/main/backend/src/modules/axisrooms/axisrooms.service.ts"
click node_prisma "https://github.com/kkversile/rainwood/blob/main/backend/src/common/prisma.service.ts"

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_frontend,node_bookingflow,node_api toneBlue
class node_hotels,node_availability,node_holds,node_reservations,node_reservationapi,node_payments,node_vouchers,node_groups toneAmber
class node_tax,node_reports,node_housekeeping toneMint
class node_auth,node_agents,node_axisrooms,node_prisma,node_database toneRose
class node_guest,node_apiuser toneIndigo
```

## Components

### Web experience

- [Web application](https://github.com/kkversile/rainwood/blob/main/frontend/src/app/page.tsx): `frontend/src/app/page.tsx`
- [Booking flow](https://github.com/kkversile/rainwood/blob/main/frontend/src/components/BookingFlow.tsx): `frontend/src/components/BookingFlow.tsx`
- [API client](https://github.com/kkversile/rainwood/blob/main/frontend/src/lib/api.ts): `frontend/src/lib/api.ts`

### Booking lifecycle

- [Hotel catalog](https://github.com/kkversile/rainwood/blob/main/backend/src/modules/hotels/hotels.service.ts): `backend/src/modules/hotels/hotels.service.ts`
- [Availability pricing](https://github.com/kkversile/rainwood/blob/main/backend/src/modules/availability/availability.service.ts): `backend/src/modules/availability/availability.service.ts`
- [Inventory holds](https://github.com/kkversile/rainwood/blob/main/backend/src/modules/holds/holds.service.ts): `backend/src/modules/holds/holds.service.ts`
- [Reservations](https://github.com/kkversile/rainwood/blob/main/backend/src/modules/reservations/reservations.service.ts): `backend/src/modules/reservations/reservations.service.ts`
- [Reservation routes](https://github.com/kkversile/rainwood/blob/main/backend/src/modules/reservations/reservations.controller.ts): `backend/src/modules/reservations/reservations.controller.ts`
- [Payments](https://github.com/kkversile/rainwood/blob/main/backend/src/modules/payments/payments.service.ts): `backend/src/modules/payments/payments.service.ts`
- [Vouchers](https://github.com/kkversile/rainwood/blob/main/backend/src/modules/vouchers/vouchers.service.ts): `backend/src/modules/vouchers/vouchers.service.ts`
- [Group bookings](https://github.com/kkversile/rainwood/blob/main/backend/src/modules/groups/groups.service.ts): `backend/src/modules/groups/groups.service.ts`

### Hotel operations

- [Tax documents](https://github.com/kkversile/rainwood/blob/main/backend/src/modules/tax-documents/tax-documents.service.ts): `backend/src/modules/tax-documents/tax-documents.service.ts`
- [Reports](https://github.com/kkversile/rainwood/blob/main/backend/src/modules/reports/reports.service.ts): `backend/src/modules/reports/reports.service.ts`
- [Housekeeping](https://github.com/kkversile/rainwood/blob/main/backend/src/modules/housekeeping/housekeeping.service.ts): `backend/src/modules/housekeeping/housekeeping.service.ts`

### Platform services

- [Authentication](https://github.com/kkversile/rainwood/blob/main/backend/src/modules/auth/auth.service.ts): `backend/src/modules/auth/auth.service.ts`
- [Agent management](https://github.com/kkversile/rainwood/blob/main/backend/src/modules/agents/agents.service.ts): `backend/src/modules/agents/agents.service.ts`
- [AxisRooms adapter](https://github.com/kkversile/rainwood/blob/main/backend/src/modules/axisrooms/axisrooms.service.ts): `backend/src/modules/axisrooms/axisrooms.service.ts`
- [Persistence access](https://github.com/kkversile/rainwood/blob/main/backend/src/common/prisma.service.ts): `backend/src/common/prisma.service.ts`
- **PostgreSQL**

### Other components

- **Guest**
- **Admin / agent / staff**

## Connections

- Guest → Web application: discovers hotels (evidence: `README.md`)
- Web application → Booking flow: starts booking
- Booking flow → API client: requests data
- API client → Hotel catalog: calls API
- API client → Availability pricing: checks availability
- API client → Inventory holds: creates hold
- API client → Reservation routes: submits reservation
- Reservation routes → Reservations: dispatches (evidence: `backend/src/modules/reservations/reservations.controller.ts`)
- Reservations → Payments: payment workflow
- Reservations → Vouchers: issues voucher
- API client → Authentication: refreshes session (evidence: `frontend/src/lib/api.ts`)
- Admin / agent / staff → API client: uses portal
- Admin / agent / staff → Group bookings: manages blocks
- Admin / agent / staff → Tax documents: manages tax records
- Admin / agent / staff → Reports: views reports
- Admin / agent / staff → Housekeeping: runs operations
- Admin / agent / staff → Agent management: manages agents
- Reservations → AxisRooms adapter: integration boundary (evidence: `README.md`)
- Hotel catalog → Persistence access: uses persistence
- Reservations → Persistence access: uses persistence
- Persistence access → PostgreSQL: accesses database (evidence: `README.md`)
