Source document: docs/pilot/PILOT-CUSTOMER-PROFILE.md
Source version: 0.0.0
Generated time: 2026-07-06T14:59:19.836Z
Owner: Operations / Founder
Audience: Internal
Status: Approved

Pilot Customer Profile

Hồ sơ đối tác của Pilot đầu tiên. Không chứa thông tin nhạy cảm (không tên thật/PII/hợp đồng).
Ghi chú trung thực: trong sprint này chưa có kỹ sư đối tác bên ngoài thật tham gia phiên chạy — pilot được
thực thi trung thực theo vai kỹ sư tích hợp trên sandbox production-like. Hồ sơ dưới đây là archetype đại diện
cho đối tác đầu tiên; Founder điền thông tin đối tác thật khi ký kết.

Loại đối tác

Kênh: OTA reseller / đại lý du lịch (travel agency) bán lại inventory qua website/app của chính họ.
Mô hình tích hợp: server-to-server (backend của đối tác gọi BNG API bằng API key). Không nhúng key ở client.

Quy mô (archetype)

Đội kỹ thuật nhỏ (1–3 kỹ sư backend).
Lưu lượng pilot: thấp (thử nghiệm), vài chục–vài trăm booking/ngày khi go-live.
Một tenant duy nhất trong giai đoạn pilot.

Use case

Hiển thị tình trạng còn chỗ + giá (Availability) trên kênh của đối tác.
Tạo đơn (Booking) khi khách đặt, Confirm khi thanh toán/khoá giữ chỗ, Cancel khi khách huỷ.
Đối soát đơn qua danh sách reservation (keyset pagination).

Điểm tích hợp (integration points)

Chức năng	Endpoint	Ghi chú
Kiểm tra còn chỗ + giá	`GET /api/booking/availability`	Kiêm báo giá (Pricing)
Tạo đơn	`POST /api/booking/reservations`	Kèm `Idempotency-Key`
Xác nhận	`POST /api/booking/reservations/:id/confirm`
Huỷ	`POST /api/booking/reservations/:id/cancel`
Đối soát	`GET /api/booking/reservations`	cursor pagination

Xác thực: x-bng-api-key (sandbox).
Môi trường: sandbox/staging (production chưa public).

Mục tiêu của Pilot

Chứng minh đối tác tự tích hợp Availability→Booking→Confirm→Cancel chỉ bằng tài liệu, không sửa mã BNG, không cần dev BNG can thiệp (ngoài onboarding).
Xác nhận contract ổn định (OpenAPI/examples/error-catalog khớp thực tế).
Đo thời gian onboarding + tích hợp và tỷ lệ thành công API.
Thu thập friction/issue thực tế để quyết định lộ trình go-live.

Ngoài phạm vi Pilot

Payment, Notification production, Frontend portal, đa tenant, production traffic.

Nguồn sự thật (Source of Truth): docs/pilot/PILOT-CUSTOMER-PROFILE.md · v0.0.0 · sinh tự động lúc 2026-07-06T14:59:19.836Z. Trang này là view suy dẫn — không sửa trực tiếp.