Bỏ qua tới nội dung
Kiên

Jumeirah Direct Connect trên Travel Hub — qua chứng nhận bằng Python

Một adapter nhà cung cấp khách sạn trên nền tảng supplier thế hệ mới, viết bằng Python: map API của nhà cung cấp sang hợp đồng của hub trên giấy trước, rồi mới dựng trọn luồng booking và đưa qua UAT của chính nhà cung cấp — 10/10 kịch bản PASS.

Thời gian
10/2026
Vai trò
Làm adapter — tài liệu mapping, code, Postman collection, hướng dẫn chạy local

Công nghệ

  • Python
  • FastAPI
  • uv
  • pytest
  • Docker
  • Helm
  • Postman

Vấn đề

Travel Hub là nền tảng supplier thế hệ mới: mỗi nhà cung cấp một adapter Python, tất cả cùng trả lời một hợp đồng của hub. Jumeirah Direct Connect cần được nối vào đó — và một supplier khách sạn chỉ thật sự "nối xong" khi đã qua bài chứng nhận của chính nhà cung cấp, chứ không phải khi code chạy được.

Cách làm

Mapping đi trước code. Giai đoạn đầu (B1) là bộ tài liệu mapping từ API của nhà cung cấp sang hợp đồng của hub, từng bước một — search, phòng, prebook, book, đọc lại, huỷ — gom xong bảng mapping lỗi và phân loại các câu hỏi còn mở trước khi có dòng code adapter nào dựa vào chúng.

Giai đoạn hai (B2) là chính adapter, viết trên FastAPI, chạy với uv, pytest, Docker và Helm: search → getrooms → prebook → book → đọc lại booking → huỷ. Prebook có kiểm giá: giá sắp book được hỏi lại nhà cung cấp trước khi chốt bất cứ thứ gì.

Đi kèm code: một Postman collection phủ cả luồng, và tài liệu LOCAL-DEV để người sau tự chạy được mà không phải hỏi.

Kết quả

Bài UAT chứng nhận của Jumeirah gồm 10 kịch bản — 4 availability, 3 một phòng và 3 nhiều phòng — và cả 10 đều PASS trong hai ngày 21–22/10/2026.

Hold chưa làm, và điều đó được ghi rõ ra chứ không để người khác tự phát hiện.