Release Report — Stage Gamma · Sprint Gamma-1 · First Partner Pilot

Mục tiêu: xác minh một đối tác bên ngoài có thể tích hợp thành công trong điều kiện vận hành thực tế. Không phát triển tính năng. Ngày: 2026-07-06.

Ghi chú trung thực (đọc trước)

Trong phiên này chưa có kỹ sư đối tác bên ngoài thật tham gia, và tôi không mutate hạ tầng staging live (allowlist IP thật là thao tác ops trên VPS chung, cần IP đối tác thật). Vì vậy pilot được thực thi trung thực theo vai kỹ sư tích hợp trên sandbox local production-like — cùng code, cùng migration, cùng bộ tài liệu/examples như staging (đã đối chiếu đại diện ở Pilot Readiness). Kết quả chức năng là thật; con số thời gian thực-địa với đối tác thật còn chờ một lần chạy staging (xem GO WITH NOTES).

1. Những gì đã diễn ra

• Onboarding (BNG): provision partner → tenant → inventory → key qua ops CLI (không SQL) — ~2s.
• Tích hợp (đối tác): chạy battery đầy đủ chỉ bằng tài liệu + key — ~2s:
• Luồng lõi Availability→Booking→Confirm→Cancel + List reservations: 5/5 API chính = 100%, 0 sửa mã.
• Idempotency (replay cùng key → cùng reservationId): đúng.
• 6 kịch bản lỗi trả đúng mã Error Catalog (401/401/400/404/409/403 TENANT_INACTIVE): 6/6 = 100%.
• Suspend Tenant → 403, Reactivate → 200: đúng (gate vận hành).
• 3/3 bộ ví dụ (curl/JavaScript/Python) chạy độc lập, exit 0.
• 4 booking thành công, 0 lỗi 5xx.

Chi tiết số liệu: PILOT-SUCCESS-METRICS.md.

2. Những gì hoạt động tốt

• Contract ổn định & khớp thực tế: OpenAPI/examples/error-catalog đều đúng (drift TENANT_INACTIVE đã đóng ở Pilot Readiness).
• Examples chạy ngay cả 3 ngôn ngữ — bằng chứng đối tác tích hợp không cần sửa mã BNG.
• Error handling nhất quán (envelope ok/data, mã lỗi ổn định) — đối tác rẽ nhánh dễ.
• Provisioning + vòng đời (Partner/Tenant) + audit transactional (Beta-4/5/6) vận hành mượt, gate suspend/reactivate đúng.
• 0 blocker, 0 5xx.

3. Những gì gây khó khăn cho đối tác

• G1-02 (High, access): staging /api/booking/* = 403 nginx cho IP chưa allowlist → đối tác không tự kết nối được; cần BNG allowlist trước (đã tài liệu hoá, là bước onboarding).
• G1-03 (Low): examples mặc định base URL = staging → phải export biến khi test nơi khác.

4. Danh sách issue (đầy đủ: PILOT-ISSUE-LOG.md)

0 blocker sản phẩm.

5. Đánh giá: GO WITH NOTES

Nền tảng + bộ kit vượt qua pilot toàn diện (5/5 API chính, 6/6 error, idempotency, 3/3 SDK, gate vận hành, 0 blocker, 0 5xx). Đối tác tự tích hợp được chỉ bằng tài liệu, không sửa mã. ⇒ Sẵn sàng cho đối tác đầu tiên.

Notes (điều kiện & việc còn lại — không phải blocker chức năng):

1. Allowlist IP staging cho đối tác thật (G1-02) — bước ops onboarding, đã tài liệu hoá. Bắt buộc trước khi đối tác chạy /api/booking/* trên staging.
2. Một lần chạy staging thật với đối tác thật để chốt số thời gian thực-địa (chức năng đã chứng minh; kỳ vọng chỉ khác ở khâu con-người).
3. Self-serve (nếu muốn): cần Hardening sprint (sandbox auth-only / cấp key tự phục vụ) — đụng deployment, ngoài phạm vi.

Không NO-GO: không có lỗi hệ thống chặn. Không GO tuyệt đối: vì chưa có xác nhận staging-với-đối-tác-thật + phụ thuộc bước allowlist thủ công.

6. Đề xuất Sprint kế (Gamma-2 gợi ý)

1. Chạy pilot staging thật: allowlist IP một đối tác (hoặc IP nội bộ), thực thi PILOT-EXECUTION-PLAN trên staging, chốt metrics thực-địa.
2. Backlog Hardening — Self-serve sandbox (gỡ G1-02): sandbox auth-only + cấp key tự phục vụ có kiểm soát.
3. Process gate: giữ "cập nhật Partner Integration Kit" trong DoD mỗi sprint đổi error/contract (chặn tái diễn drift).

QA

Definition of Done

Kết luận: GO WITH NOTES. Platform sẵn sàng cho đối tác đầu tiên; điều kiện duy nhất còn lại là khâu onboarding vận hành (allowlist IP + chạy staging thật), không phải lỗi hệ thống. Chờ Founder quyết bước phát triển kế.