How kkversile/rainwood works
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: api.ts API client · reservations.service.ts Reservations · prisma.service.ts Persistence access · page.tsx Web application
Components 21
Web experience
- Web application
frontend/src/app/page.tsx - Booking flow
frontend/src/components/BookingFlow.tsx - API client
frontend/src/lib/api.ts
Booking lifecycle
- Hotel catalog
backend/src/modules/hotels/hotels.service.ts - Availability pricing
backend/src/modules/availability/availability.service.ts - Inventory holds
backend/src/modules/holds/holds.service.ts - Reservations
backend/src/modules/reservations/reservations.service.ts - Reservation routes
backend/src/modules/reservations/reservations.controller.ts - Payments
backend/src/modules/payments/payments.service.ts - Vouchers
backend/src/modules/vouchers/vouchers.service.ts - Group bookings
backend/src/modules/groups/groups.service.ts
Hotel operations
- Tax documents
backend/src/modules/tax-documents/tax-documents.service.ts - Reports
backend/src/modules/reports/reports.service.ts - Housekeeping
backend/src/modules/housekeeping/housekeeping.service.ts
Platform services
- Authentication
backend/src/modules/auth/auth.service.ts - Agent management
backend/src/modules/agents/agents.service.ts - AxisRooms adapter
backend/src/modules/axisrooms/axisrooms.service.ts - Persistence access
backend/src/common/prisma.service.ts - PostgreSQL
Other components
- Guest
- Admin / agent / staff
Connections 21
- Guest → Web application: discovers hotels
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
backend/src/modules/reservations/reservations.controller.ts - Reservations → Payments: payment workflow
- Reservations → Vouchers: issues voucher
- API client → Authentication: refreshes session
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
README.md - Hotel catalog → Persistence access: uses persistence
- Reservations → Persistence access: uses persistence
- Persistence access → PostgreSQL: accesses database
README.md