Pilot Execution Plan

Kế hoạch chạy Pilot đối tác đầu tiên. Phản ánh đúng quy trình đã thực thi trong Gamma-1 (sandbox production-like).
Không thêm feature. Chi tiết kết quả: PILOT-SUCCESS-METRICS.md, PILOT-ISSUE-LOG.md.

0. Chuẩn bị (BNG)

• Bộ tài liệu onboarding sẵn sàng (docs/integration/ + docs/pilot/PARTNER-ONBOARDING-PACKAGE.md).
• Sandbox chạy: DB migrate (prisma migrate deploy), API api:start (health = 200).
• Xác định unitId sandbox cho đối tác (vd u_muongthanh_deluxe).

1. Onboarding

• Nhận từ đối tác: tên tổ chức, môi trường (sandbox), IP egress.
• Gửi đối tác bộ tài liệu (Integration Guide, OpenAPI, Postman, examples, Sandbox Checklist, Error Catalog).
• Tiêu chí: đối tác xác nhận đã nhận đủ tài liệu.

2. Sandbox access

• Allowlist IP egress của đối tác trên nginx staging *(bước ops bắt buộc — /api/booking/* trả 403 nếu chưa)*.
• Đối tác kiểm chứng: GET /health = 200 và GET /api/booking/availability không trả 403 nginx.
• Tiêu chí: đối tác gọi được endpoint (qua gate).

3. Cấp API Key

• BNG provision: create-partner → activate-partner → provision-tenant → activate-tenant → seed-inventory.
• issue-key --customer <partnerId> --env sandbox --deliver → giao raw key một lần (one-time secret link).
• Tiêu chí: đối tác nhận key + base URL + unit IDs; key auth thành công.

4. Kiểm thử (đối tác thực hiện theo Sandbox Checklist)

• Availability → 200, available:true + giá.
• Booking (kèm Idempotency-Key) → 201, status:pending.
• Confirm → 200, confirmed.
• Cancel → 200, cancelled.
• (khuyến nghị) List reservations, Idempotency replay, error handling theo Error Catalog.
• Tiêu chí: hoàn thành 4 bước lõi + hiểu ít nhất các mã lỗi chính.

5. Hỗ trợ

• Kênh support onboarding (BNG điền). Đối tác tự phục vụ bằng Error Catalog + Troubleshooting trước khi hỏi.
• Mọi vấn đề → ghi vào PILOT-ISSUE-LOG.md (phân loại Hotfix/Backlog/Won't Fix).
• Chỉ sửa blocker trong sprint; cải tiến khác → backlog.

6. Tiêu chí hoàn thành Pilot

• Đối tác hoàn thành Availability → Booking → Confirm → Cancel không sửa mã.
• Không còn blocker mở.
• Mọi issue được ghi nhận + phân loại.
• Metrics thu thập đủ (onboarding time, integration time, API success, booking count, feedback).
• Founder có đủ dữ liệu quyết định GO / GO WITH NOTES / NO-GO.

Ghi chú thực thi Gamma-1

Sprint này chạy toàn bộ Phase 0–6 trên sandbox local production-like (cùng code/migration/examples như staging), vì:

• Chưa có kỹ sư đối tác bên ngoài thật trong phiên;
• Không mutate hạ tầng staging live (allowlist IP thật cần IP đối tác thật + là thao tác ops trên VPS chung).

Bước allowlist IP trên staging thật là hành động ops sẽ thực hiện cho đối tác thật (đã tài liệu hoá). Kết quả chức năng trên local đại diện trung thực cho staging (đã đối chiếu hành vi ở Pilot Readiness).