v1.0.0 — Full PMS Release

The first complete release of HAIP (Hotel AI Platform) — an open-source, API-first hotel Property Management System where AI agents are first-class citizens.

Highlights

• All 8 phases complete — from scaffolding to production-ready admin dashboard
• ~90 REST API endpoints across 15 modules
• 16 Connect API endpoints for OTAIP agent integration
• 12-screen React dashboard with real-time WebSocket updates
• 320+ tests (Vitest + React Testing Library)
• Telivity Grand Hotel demo seed with 85 rooms, 20 guests, 30 reservations
• Docker production build — single multi-stage image serves API + dashboard
• Apache 2.0 license

Changelog by Phase

Phase 0 — Scaffolding & Data Model

• pnpm monorepo with apps/api, packages/database, packages/shared
• PostgreSQL 16 + Drizzle ORM schema for all core tables
• Multi-tenant design (property_id on every table)
• Docker Compose (PostgreSQL + Redis)
• GitHub Actions CI pipeline

Phase 1 — Core PMS (Property, Room, Guest, Rate Plan, Reservation)

• Property CRUD with timezone, currency, GDS codes
• Room types + inventory with status state machine
• Guest profiles with VIP levels, preferences, GDPR consent
• Rate plans: BAR, derived, negotiated with restrictions (MinLOS, CTA, CTD)
• Full reservation lifecycle state machine with availability engine
• Webhook event system (entity.action pattern)

Phase 2 — Folio & Billing

• Guest/master/city ledger folios
• Charge posting with department codes and revenue categories
• Charge routing, reversal, transfer, and city ledger transfer
• Folio settlement and close workflows

Phase 3 — Check-In/Check-Out & Front Desk

• Room assignment with automatic status transitions
• Check-in/check-out with folio and room status integration
• Group check-in (batch operations)
• Express checkout
• No-show processing

Phase 4 — Housekeeping

• Task CRUD with 6 task types and digital checklists
• Auto-task creation on checkout (event-driven)
• ADA and VIP-aware checklist augmentation
• Staff assignment + round-robin auto-assignment
• Inspection pass/fail with automatic re-clean
• Dashboard with room/task/housekeeper summaries
• Analytics: turn times, inspection rates, maintenance tracking

Phase 5 — Night Audit & Reporting

• Automated night audit: room posting, no-show processing, day close
• Daily revenue, occupancy, financial summary, and trend reports
• KPI dashboard

Phase 6 — Channel Manager & OTAIP Connect

• ARI push (availability, rates, inventory) to OTA channels
• Channel connection management with sync logging
• Rate parity monitoring and enforcement
• Inbound reservation processing from OTAs
• OTAIP Connect API: search, book, verify, modify, cancel
• Event subscriptions + polling for AI agents
• AI insights endpoints (revenue, guest triggers, housekeeping)

Phase 7 — Not applicable (OTAIP agent logic lives in OTAIP repo)

Phase 8 — Admin Dashboard

• React 19 + Vite + TanStack Query/Router + Tailwind CSS 4
• 12 pages: Dashboard, Reservations, Check-In/Out, Guests, Rooms, Housekeeping, Rate Plans, Folios, Night Audit, Reports, Channel Manager, Settings
• Calendar view (day/week/month) for reservations
• Housekeeping kanban board
• Real-time updates via WebSocket (Socket.IO)
• Responsive layout with mobile sidebar
• Toast notifications, skeleton loaders, error boundaries
• Multi-stage Docker build (API + Dashboard in single image)
• 39 component tests

Getting Started

:::bash
git clone https://github.com/telivity-otaip/haip.git
cd haip
docker compose up -d postgres redis
pnpm install && pnpm build
pnpm --filter @haip/api run migrate
pnpm --filter @haip/api run seed
pnpm dev

API at http://localhost:3000 · Swagger at http://localhost:3000/docs · Dashboard at http://localhost:5173