Decision Log (ADR)
Các quyết định kiến trúc / chiến lược lớn đã thống nhất.
ADR-001
AcceptedDemo First
2026-06
- Bối cảnh
- Rủi ro xây backend trước khi có khách.
- Quyết định
- Xây frontend production-ready + sales assets trước, chốt khách rồi mới làm backend.
ADR-002
AcceptedGreenfield (Next.js + Prisma + Postgres)
2026-06
- Bối cảnh
- QloApps/PHP legacy khó SaaS; travel-intelligence là AI engine, đã LOCKED.
- Quyết định
- Build mới trên Next 16 + TS + Tailwind v4 + shadcn, nền sạch cho SaaS multi-tenant.
ADR-003
AcceptedFive Portal Architecture
2026-06
- Bối cảnh
- Cần phục vụ nhiều vai trò trên 1 nền tảng.
- Quyết định
- Guest/Partner/Platform Admin/Customer/Affiliate; domain abstraction Listing/Reservation; design-system dùng chung.
ADR-004
AcceptedBackend-ready seam (ports → mock-repo)
2026-06
- Bối cảnh
- Demo dùng mock nhưng phải dễ nối backend.
- Quyết định
- ports + services + view-models + mock repositories; swap API = thay repository, sửa 1 dòng.
ADR-005
AcceptedSingle-source tie-out data
2026-06
- Bối cảnh
- Số liệu lệch giữa portal gây nghi ngờ.
- Quyết định
- Mọi tiền dẫn từ 1 nguồn BOOKINGS (revenue-statuses), delta dùng so-với-TB-tháng.
ADR-006
AcceptedMarketing Landing + ROI Calculator
2026-06
- Bối cảnh
- Cần công cụ chốt sale, không chỉ demo.
- Quyết định
- Landing tại booking.bngagency.vn + ROI calculator nhúng (#roi).
ADR-007
AcceptedProduct Packaging + Customer Success Kit
2026-06
- Bối cảnh
- Biến project thành sản phẩm bán lặp lại.
- Quyết định
- docs/product + docs/customer-success: overview/roadmap/backlog + discovery→implementation.
ADR-008
AcceptedDeployment Architecture (1 app, nhiều subdomain)
2026-06
- Bối cảnh
- 1 Next app phục vụ tất cả portal.
- Quyết định
- PM2 :3013 + Nginx 6 vhost (root→portal path) + Let's Encrypt; KHÔNG đụng 15+ site khác trên VPS.