# telivityai/haip architecture

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

- Interactive diagram: https://gitdiagram.com/telivityai/haip
- Repository: https://github.com/telivityai/haip

## Overview

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: [`packages/database/src/schema/booking-engine.ts`](https://github.com/telivityai/haip/blob/main/packages/database/src/schema/booking-engine.ts) (PostgreSQL), [`apps/api/src/modules/booking-engine/booking-engine.controller.ts`](https://github.com/telivityai/haip/blob/main/apps/api/src/modules/booking-engine/booking-engine.controller.ts) (Public Booking API), [`apps/api/src/modules/agent/agent.service.ts`](https://github.com/telivityai/haip/blob/main/apps/api/src/modules/agent/agent.service.ts) (AI Agent Framework), [`apps/api/src/modules/reservation/reservation.service.ts`](https://github.com/telivityai/haip/blob/main/apps/api/src/modules/reservation/reservation.service.ts) (Reservation Lifecycle)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_clients["Users and Clients"]
  node_dashboard["Staff Dashboard<br/>[App.tsx]"]
  node_booking_widget["Booking Widget<br/>[App.tsx]"]
  node_connect_gpt["ChatGPT Gateway<br/>[app.ts]"]
end

subgraph group_booking["Booking and Reservations"]
  node_booking_api["Public Booking API"]
  node_booking_service["Booking Engine"]
  node_booking_config["Booking Configuration"]
  node_booking_requests["Booking Requests"]
  node_request_payments["Request Payments"]
  node_reservations["Reservation Lifecycle"]
end

subgraph group_operations["Hotel Operations"]
  node_folio["Folio and Billing<br/>[folio.service.ts]"]
  node_accounting["Accounting and Cashier"]
  node_housekeeping["Housekeeping"]
  node_night_audit["Night Audit"]
  node_fiscal["Fiscal Compliance<br/>[fiscal.service.ts]"]
end

subgraph group_integrations["Distribution and Integrations"]
  node_channel["Channel Manager<br/>[channel.service.ts]"]
  node_connect_api["Connect API"]
  node_integration_registry["Integration Registry"]
  node_reviews["Review Ingest"]
end

subgraph group_intelligence["AI and Insights"]
  node_agents["AI Agent Framework<br/>[agent.service.ts]"]
  node_revenue_agent["Revenue Manager"]
end

node_guest(("Hotel Guest"))
node_staff(("Hotel Staff"))
node_external(("External Systems"))
node_database[("PostgreSQL<br/>[booking-engine.ts]")]

node_guest -->|"books through"| node_booking_widget
node_booking_widget -->|"sends booking requests"| node_booking_api
node_booking_api -->|"routes booking actions"| node_booking_service
node_booking_api -->|"reads public config"| node_booking_config
node_booking_api -.->|"supports request booking"| node_booking_requests
node_booking_requests -->|"delegates payment actions"| node_request_payments
node_staff -->|"manages hotel"| node_dashboard
node_dashboard -->|"uses REST API"| node_reservations
node_external -->|"uses chat booking"| node_connect_gpt
node_connect_gpt -->|"calls Connect API"| node_connect_api
node_external -->|"integrates by REST"| node_integration_registry
node_external -->|"exchanges channel data"| node_channel
node_channel -->|"persists hotel data"| node_database
node_reservations -->|"persists reservations"| node_database
node_folio -->|"persists billing"| node_database
node_accounting -->|"persists accounts"| node_database
node_housekeeping -->|"persists task state"| node_database
node_night_audit -->|"reads hotel records"| node_database
node_fiscal -->|"persists compliance data"| node_database
node_agents -->|"reads agent data"| node_database
node_agents -->|"orchestrates workflows"| node_reservations
node_revenue_agent -.->|"runs within framework"| node_agents
node_reviews -->|"stores deduplicated reviews"| node_database
node_reviews -->|"pulls review sources"| node_external

click node_dashboard "https://github.com/telivityai/haip/blob/main/apps/dashboard/src/App.tsx"
click node_booking_widget "https://github.com/telivityai/haip/blob/main/apps/booking/src/App.tsx"
click node_connect_gpt "https://github.com/telivityai/haip/blob/main/tools/haip-connect-gpt/src/app.ts"
click node_booking_api "https://github.com/telivityai/haip/blob/main/apps/api/src/modules/booking-engine/booking-engine.controller.ts"
click node_booking_service "https://github.com/telivityai/haip/blob/main/apps/api/src/modules/booking-engine/booking-engine.service.ts"
click node_booking_config "https://github.com/telivityai/haip/blob/main/apps/api/src/modules/booking-engine/booking-engine-config.service.ts"
click node_booking_requests "https://github.com/telivityai/haip/blob/main/packages/booking-requests/src/domain/booking-request.service.ts"
click node_request_payments "https://github.com/telivityai/haip/blob/main/packages/booking-requests/src/domain/booking-request-payment.service.ts"
click node_reservations "https://github.com/telivityai/haip/blob/main/apps/api/src/modules/reservation/reservation.service.ts"
click node_folio "https://github.com/telivityai/haip/blob/main/apps/api/src/modules/folio/folio.service.ts"
click node_accounting "https://github.com/telivityai/haip/blob/main/apps/api/src/modules/accounting/accounting.controller.ts"
click node_housekeeping "https://github.com/telivityai/haip/blob/main/apps/api/src/modules/housekeeping/housekeeping.service.ts"
click node_night_audit "https://github.com/telivityai/haip/blob/main/apps/api/src/modules/night-audit/night-audit.service.ts"
click node_fiscal "https://github.com/telivityai/haip/blob/main/apps/api/src/modules/fiscal/fiscal.service.ts"
click node_channel "https://github.com/telivityai/haip/blob/main/apps/api/src/modules/channel/channel.service.ts"
click node_connect_api "https://github.com/telivityai/haip/blob/main/apps/api/src/modules/connect/connect.controller.ts"
click node_integration_registry "https://github.com/telivityai/haip/blob/main/apps/api/src/modules/integrations/integrations.service.ts"
click node_reviews "https://github.com/telivityai/haip/blob/main/apps/api/src/modules/reviews/reviews-ingest.service.ts"
click node_agents "https://github.com/telivityai/haip/blob/main/apps/api/src/modules/agent/agent.service.ts"
click node_revenue_agent "https://github.com/telivityai/haip/blob/main/apps/api/src/modules/agent/revenue-manager/revenue-manager.agent.ts"
click node_database "https://github.com/telivityai/haip/blob/main/packages/database/src/schema/booking-engine.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_dashboard,node_booking_widget,node_connect_gpt toneBlue
class node_booking_api,node_booking_service,node_booking_config,node_booking_requests,node_request_payments,node_reservations,node_database toneAmber
class node_folio,node_accounting,node_housekeeping,node_night_audit,node_fiscal toneMint
class node_channel,node_connect_api,node_integration_registry,node_reviews toneRose
class node_agents,node_revenue_agent,node_guest,node_staff,node_external toneIndigo
```

## Components

### Users and Clients

- [Staff Dashboard](https://github.com/telivityai/haip/blob/main/apps/dashboard/src/App.tsx): `apps/dashboard/src/App.tsx`
- [Booking Widget](https://github.com/telivityai/haip/blob/main/apps/booking/src/App.tsx): `apps/booking/src/App.tsx`
- [ChatGPT Gateway](https://github.com/telivityai/haip/blob/main/tools/haip-connect-gpt/src/app.ts): `tools/haip-connect-gpt/src/app.ts`

### Booking and Reservations

- [Public Booking API](https://github.com/telivityai/haip/blob/main/apps/api/src/modules/booking-engine/booking-engine.controller.ts): `apps/api/src/modules/booking-engine/booking-engine.controller.ts`
- [Booking Engine](https://github.com/telivityai/haip/blob/main/apps/api/src/modules/booking-engine/booking-engine.service.ts): `apps/api/src/modules/booking-engine/booking-engine.service.ts`
- [Booking Configuration](https://github.com/telivityai/haip/blob/main/apps/api/src/modules/booking-engine/booking-engine-config.service.ts): `apps/api/src/modules/booking-engine/booking-engine-config.service.ts`
- [Booking Requests](https://github.com/telivityai/haip/blob/main/packages/booking-requests/src/domain/booking-request.service.ts): `packages/booking-requests/src/domain/booking-request.service.ts`
- [Request Payments](https://github.com/telivityai/haip/blob/main/packages/booking-requests/src/domain/booking-request-payment.service.ts): `packages/booking-requests/src/domain/booking-request-payment.service.ts`
- [Reservation Lifecycle](https://github.com/telivityai/haip/blob/main/apps/api/src/modules/reservation/reservation.service.ts): `apps/api/src/modules/reservation/reservation.service.ts`

### Hotel Operations

- [Folio and Billing](https://github.com/telivityai/haip/blob/main/apps/api/src/modules/folio/folio.service.ts): `apps/api/src/modules/folio/folio.service.ts`
- [Accounting and Cashier](https://github.com/telivityai/haip/blob/main/apps/api/src/modules/accounting/accounting.controller.ts): `apps/api/src/modules/accounting/accounting.controller.ts`
- [Housekeeping](https://github.com/telivityai/haip/blob/main/apps/api/src/modules/housekeeping/housekeeping.service.ts): `apps/api/src/modules/housekeeping/housekeeping.service.ts`
- [Night Audit](https://github.com/telivityai/haip/blob/main/apps/api/src/modules/night-audit/night-audit.service.ts): `apps/api/src/modules/night-audit/night-audit.service.ts`
- [Fiscal Compliance](https://github.com/telivityai/haip/blob/main/apps/api/src/modules/fiscal/fiscal.service.ts): `apps/api/src/modules/fiscal/fiscal.service.ts`

### Distribution and Integrations

- [Channel Manager](https://github.com/telivityai/haip/blob/main/apps/api/src/modules/channel/channel.service.ts): `apps/api/src/modules/channel/channel.service.ts`
- [Connect API](https://github.com/telivityai/haip/blob/main/apps/api/src/modules/connect/connect.controller.ts): `apps/api/src/modules/connect/connect.controller.ts`
- [Integration Registry](https://github.com/telivityai/haip/blob/main/apps/api/src/modules/integrations/integrations.service.ts): `apps/api/src/modules/integrations/integrations.service.ts`
- [Review Ingest](https://github.com/telivityai/haip/blob/main/apps/api/src/modules/reviews/reviews-ingest.service.ts): `apps/api/src/modules/reviews/reviews-ingest.service.ts`

### AI and Insights

- [AI Agent Framework](https://github.com/telivityai/haip/blob/main/apps/api/src/modules/agent/agent.service.ts): `apps/api/src/modules/agent/agent.service.ts`
- [Revenue Manager](https://github.com/telivityai/haip/blob/main/apps/api/src/modules/agent/revenue-manager/revenue-manager.agent.ts): `apps/api/src/modules/agent/revenue-manager/revenue-manager.agent.ts`

### Other components

- **Hotel Guest**
- **Hotel Staff**
- **External Systems**
- [PostgreSQL](https://github.com/telivityai/haip/blob/main/packages/database/src/schema/booking-engine.ts): `packages/database/src/schema/booking-engine.ts`

## Connections

- Hotel Guest → Booking Widget: books through (evidence: `README.md`)
- Booking Widget → Public Booking API: sends booking requests (evidence: `README.md`)
- Public Booking API → Booking Engine: routes booking actions (evidence: `apps/api/src/modules/booking-engine/booking-engine.controller.ts`)
- Public Booking API → Booking Configuration: reads public config (evidence: `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 (evidence: `packages/booking-requests/src/http/booking-request.controller.ts`)
- Hotel Staff → Staff Dashboard: manages hotel (evidence: `README.md`)
- Staff Dashboard → Reservation Lifecycle: uses REST API (evidence: `README.md`)
- External Systems → ChatGPT Gateway: uses chat booking (evidence: `README.md`)
- ChatGPT Gateway → Connect API: calls Connect API (evidence: `README.md`)
- External Systems → Integration Registry: integrates by REST (evidence: `README.md`)
- External Systems → Channel Manager: exchanges channel data (evidence: `README.md`)
- Channel Manager → PostgreSQL: persists hotel data (evidence: `README.md`)
- Reservation Lifecycle → PostgreSQL: persists reservations (evidence: `README.md`)
- Folio and Billing → PostgreSQL: persists billing (evidence: `README.md`)
- Accounting and Cashier → PostgreSQL: persists accounts (evidence: `README.md`)
- Housekeeping → PostgreSQL: persists task state (evidence: `README.md`)
- Night Audit → PostgreSQL: reads hotel records (evidence: `README.md`)
- Fiscal Compliance → PostgreSQL: persists compliance data (evidence: `README.md`)
- AI Agent Framework → PostgreSQL: reads agent data (evidence: `README.md`)
- AI Agent Framework → Reservation Lifecycle: orchestrates workflows (evidence: `README.md`)
- Revenue Manager → AI Agent Framework: runs within framework
- Review Ingest → PostgreSQL: stores deduplicated reviews (evidence: `apps/api/src/modules/reviews/reviews-ingest.service.ts`)
- Review Ingest → External Systems: pulls review sources
