ProductCập nhật 2026-06-30 · product/README.md

BNG Booking Platform

Nền tảng OTA white-label cho ngành lưu trú Việt Nam. Tài liệu mở đầu của toàn bộ sản phẩm.

Sản phẩm là gì

Một nền tảng đặt phòng trực tuyến mang thương hiệu riêng cho khách sạn/chuỗi/homestay/resort — đẹp và đáng tin như Agoda/Booking nhưng 0% hoa hồng bên thứ ba, sở hữu dữ liệu khách, có 5 portal trong 1: Guest OTA · Partner · Platform Admin · Customer · Affiliate.

Chi tiết: PRODUCT-OVERVIEW.md.

Demo ở đâu (live)

	URL
Trang bán hàng + ROI + One-pager + Pitch	https://booking.bngagency.vn
Guest OTA	https://demo.booking.bngagency.vn
Partner	https://partner.booking.bngagency.vn
Platform Admin	https://admin.booking.bngagency.vn
Customer	https://customer.booking.bngagency.vn
Affiliate	https://affiliate.booking.bngagency.vn
ROI Calculator	https://booking.bngagency.vn/marketing#roi
One-pager	https://booking.bngagency.vn/marketing/one-pager
Pitch Deck	https://booking.bngagency.vn/marketing/pitch

Dữ liệu hiện tại là mock minh hoạ (tie-out từ 1 nguồn), chưa có backend.

Chạy thế nào (local)

# Yêu cầu: Node 20+ (đã build với Node 24 trên VPS)
npm install
npm run dev        # http://localhost:3000
npm run build      # production build (30+ routes)
npm run lint       # 0 error, 0 warning

Lưu ý: nếu vừa npm run build rồi muốn npm run dev, chạy rm -rf .next trước (xung đột cache turbopack).

Stack: Next.js 16 · React 19 · TypeScript · Tailwind v4 · shadcn/ui · motion · @phosphor-icons · next-themes. Frontend-only, mock data, không backend/DB/secret.

Kiến trúc (rút gọn)

Domain abstraction Listing / Inventory / Reservation (không khoá "Hotel/Room").
components/{ui,search,listing,booking,review,shared,admin} + features/{guest,partner,admin,customer,affiliate,marketing}.
Seam backend-ready: lib/domain/{models,ports} + lib/services + lib/view-models + lib/mock/{data,repositories}. Đổi sang API thật = thay repository, sửa lib/services/index.ts.
5 theme + ThemeProvider (theme-per-tenant sẵn).

Tài liệu ở đâu

Nhóm	File
Product	`PRODUCT-OVERVIEW` · `PRODUCT-ROADMAP` · `BACKLOG`
Go-to-market	`SALES-ASSETS` · `CUSTOMER-JOURNEY` · `IMPLEMENTATION-METHODOLOGY`
Sales (../sales)	`DEMO-SCRIPT-20-MIN.md` · `ONE-PAGER.md` · `PITCH-DECK.md`
Deploy/Vận hành	`../deploy/DEMO-DEPLOYMENT.md` · `../POLISH-BACKLOG.md`
UI/Component	`../UI-INVENTORY.md` · `../COMPONENT-INVENTORY.md` · `../REUSABLE-MATRIX.md`

Roadmap

Phase 1 (✅ xong): Frontend demo + sales assets, live. Phase 2: Backend thật (DB/auth/payment/booking engine) → MVP chạy thật. Phase 3: Multi-tenant SaaS (brand riêng, subscription, custom domain). Phase 4: AI + OTA sync. Chi tiết: PRODUCT-ROADMAP.md.

Sales assets

Live demo · Landing · ROI Calculator · One-pager · Pitch Deck · Demo Script — đủ để demo và chốt cọc. Chi tiết + còn thiếu: SALES-ASSETS.md.

Deploy (production demo)

VPS (Ubuntu) · 1 app PM2 bng-booking port 3013 · Nginx 6 vhost (1 landing + 5 portal) · Let's Encrypt SSL. Redeploy: rsync → npm ci && npm run build → pm2 restart bng-booking. Chi tiết: ../deploy/DEMO-DEPLOYMENT.md.

Trạng thái 2026-06-30: Phase 1 hoàn thành, đang ở giai đoạn Product Packaging + bán hàng. Bước kế: Proposal Generator. Chưa xây backend (chờ khách hàng đầu tiên).