Product ManagementCập nhật 2026-06-30 · product-management/API-READINESS.md
API Readiness — Tình trạng API
Nguồn dữ liệu:
src/lib/founder/product-registry.ts→API_READINESS. Dashboard:ota.dainhatcorp.vn/founder/product-management/api.
State
live— API thật.mock— mock-repository (hiện tại đa số).none— chưa expose.
Tóm tắt (mọi nhóm hiện = mock/none)
| Nhóm | State | Ghi chú |
|---|---|---|
| Listing / Search | mock | port ListingRepository định nghĩa; đổi Http* (Phase 2) |
| Reservation / Booking | mock | engine thật (availability/giữ phòng) Phase 2 |
| Partner / Rates | mock | MockPartnerRepository |
| Platform / Admin | mock | MockPlatformRepository |
| Customer / CRM | mock | MockCustomerRepository |
| Affiliate / Commission | mock | MockAffiliateRepository (8% tie-out) |
| Payment | mock | PaymentGateway port; VNPay/Momo Phase 2 |
| Notification | mock | NotifierPort; email/Zalo/SMS Phase 2 |
| Public API / MCP | none | Phase 3-4 |
| Travel Intelligence | none | gateway định nghĩa (ReviewSource/LLM); nối Phase 4 |
Cơ chế "đổi mock → live"
Kiến trúc seam-first: Component → view-model → service → port → repository. Đổi sang API thật = hiện thực Http*Repository theo cùng port + sửa composition root (lib/services/index.ts). UI/feature không đổi.
Khi thêm API mới
- Định nghĩa port (interface) trước.
- Mock-repository để demo.
- Cập nhật
API_READINESS(state=mock). - Hiện thực Http* khi có backend → state=live.