How telivityai/haip works
HAIP is an API-first hotel PMS with staff operations, direct guest booking, channel distribution, financial/compliance workflows, and built-in AI agents. A guest searches and books through the booking widget and public booking API; the API handles availability, quotes, and booking operations. Staff use the dashboard and API for reservations and hotel operations, while integrations and agents extend those workflows. The README documents broad module-to-database and integration relationships; sampled source confirms booking-engine routing and selected booking-request, configuration, and review behavior. Many domain internals were not sampled, so their detailed call links are omitted.
Main entry points: booking-engine.ts PostgreSQL · booking-engine.controller.ts Public Booking API · agent.service.ts AI Agent Framework · reservation.service.ts Reservation Lifecycle
Components 24
Users and Clients
- Staff Dashboard
apps/dashboard/src/App.tsx - Booking Widget
apps/booking/src/App.tsx - ChatGPT Gateway
tools/haip-connect-gpt/src/app.ts
Booking and Reservations
- Public Booking API
apps/api/src/modules/booking-engine/booking-engine.controller.ts - Booking Engine
apps/api/src/modules/booking-engine/booking-engine.service.ts - Booking Configuration
apps/api/src/modules/booking-engine/booking-engine-config.service.ts - Booking Requests
packages/booking-requests/src/domain/booking-request.service.ts - Request Payments
packages/booking-requests/src/domain/booking-request-payment.service.ts - Reservation Lifecycle
apps/api/src/modules/reservation/reservation.service.ts
Hotel Operations
- Folio and Billing
apps/api/src/modules/folio/folio.service.ts - Accounting and Cashier
apps/api/src/modules/accounting/accounting.controller.ts - Housekeeping
apps/api/src/modules/housekeeping/housekeeping.service.ts - Night Audit
apps/api/src/modules/night-audit/night-audit.service.ts - Fiscal Compliance
apps/api/src/modules/fiscal/fiscal.service.ts
Distribution and Integrations
- Channel Manager
apps/api/src/modules/channel/channel.service.ts - Connect API
apps/api/src/modules/connect/connect.controller.ts - Integration Registry
apps/api/src/modules/integrations/integrations.service.ts - Review Ingest
apps/api/src/modules/reviews/reviews-ingest.service.ts
AI and Insights
- AI Agent Framework
apps/api/src/modules/agent/agent.service.ts - Revenue Manager
apps/api/src/modules/agent/revenue-manager/revenue-manager.agent.ts
Other components
- Hotel Guest
- Hotel Staff
- External Systems
- PostgreSQL
packages/database/src/schema/booking-engine.ts
Connections 24
- Hotel Guest → Booking Widget: books through
README.md - Booking Widget → Public Booking API: sends booking requests
README.md - Public Booking API → Booking Engine: routes booking actions
apps/api/src/modules/booking-engine/booking-engine.controller.ts - Public Booking API → Booking Configuration: reads public config
apps/api/src/modules/booking-engine/booking-engine.controller.ts - Public Booking API → Booking Requests: supports request booking
- Booking Requests → Request Payments: delegates payment actions
packages/booking-requests/src/http/booking-request.controller.ts - Hotel Staff → Staff Dashboard: manages hotel
README.md - Staff Dashboard → Reservation Lifecycle: uses REST API
README.md - External Systems → ChatGPT Gateway: uses chat booking
README.md - ChatGPT Gateway → Connect API: calls Connect API
README.md - External Systems → Integration Registry: integrates by REST
README.md - External Systems → Channel Manager: exchanges channel data
README.md - Channel Manager → PostgreSQL: persists hotel data
README.md - Reservation Lifecycle → PostgreSQL: persists reservations
README.md - Folio and Billing → PostgreSQL: persists billing
README.md - Accounting and Cashier → PostgreSQL: persists accounts
README.md - Housekeeping → PostgreSQL: persists task state
README.md - Night Audit → PostgreSQL: reads hotel records
README.md - Fiscal Compliance → PostgreSQL: persists compliance data
README.md - AI Agent Framework → PostgreSQL: reads agent data
README.md - AI Agent Framework → Reservation Lifecycle: orchestrates workflows
README.md - Revenue Manager → AI Agent Framework: runs within framework
- Review Ingest → PostgreSQL: stores deduplicated reviews
apps/api/src/modules/reviews/reviews-ingest.service.ts - Review Ingest → External Systems: pulls review sources