Internal Staff Guide — BNG Booking Platform

<span class="badge b-info">v1.0.0 Pilot Ready</span> <span class="badge b-notes">Pilot phase</span> <span class="badge b-muted">Cập nhật 2026-07-06</span>

Dành cho nhân sự nội bộ (Founder / Tech / Sale / Ops) vận hành Pilot. Nguyên tắc: làm đúng vai, ghi nhận mọi việc, không tự ý hứa với khách.
Quy trình chi tiết: Pilot Runbook · Sự cố: Support Playbook · Bán hàng: Sales Guide.

1. Nhân sự nội bộ cần hiểu gì (tối thiểu)

• Platform đang ở Pilot trên sandbox/staging, chưa production, chưa thanh toán, chưa vé máy bay.
• Đối tác dùng API key (server-to-server) để chạy Availability → Booking → Confirm → Cancel.
• Có hai cổng chặn: Partner không active ⇒ 401; Tenant không active ⇒ 403 TENANT_INACTIVE. Suspend là thuận nghịch.
• Mọi thao tác quản trị (cấp/thu hồi key, provision, suspend) đều có audit.
• Trạng thái tổng: PROJECT-STATE.

2. Quy trình khi có partner pilot

Theo Pilot Runbook:

1. Chuẩn bị (kiểm sandbox /health, gom tài liệu).
2. Provision: create-partner → activate-partner → provision-tenant → activate-tenant → seed-inventory.
3. Allowlist IP đối tác trên staging (nếu không, /api/booking/* = 403 nginx).
4. Cấp API key (issue-key --deliver), giao một lần qua kênh an toàn.
5. Smoke check, bàn giao tài liệu.
6. Theo dõi → ghi Issue Log → hỗ trợ theo Playbook.
7. Kết thúc: Decision Log + (nếu dừng) thu hồi quyền.

3. Ai làm việc gì (RACI)

*(R = Responsible, A = Accountable, C = Consulted, I = Informed.)*

4. Cách ghi issue

Ghi vào Pilot Issue Log — mỗi issue gồm: Thời điểm · Người phát hiện · Mô tả · Mức độ · Workaround · Quyết định (Hotfix / Backlog / Won't Fix).

• Mức độ: Blocker (chặn luồng lõi, không workaround) · High · Medium · Low.
• Không sửa hệ thống tuỳ tiện — chỉ blocker mới mở Hotfix (Founder duyệt). Còn lại → Backlog.
• Kèm x-request-id, endpoint, status, error.code (ẩn PII, không kèm API key).

5. Khi nào báo lỗi kỹ thuật (escalate Tech / mở Hotfix)

Theo Support Playbook:

Lưu ý: Pilot Gamma-1 ghi nhận 0 lỗi 5xx. Nếu gặp 5xx tái hiện là bất thường ⇒ escalate.

6. Khi nào KHÔNG được tự ý hứa với khách

<div class="nextaction"> <strong>Sale/Ops/Tech KHÔNG tự cam kết những điều sau (phải qua Founder):</strong> <ul> <li>Production/GA sẵn sàng hoặc <strong>ngày go-live</strong>.</li> <li><strong>SLA / uptime / throughput</strong> bằng con số.</li> <li><strong>Giá / điều khoản hợp đồng</strong>.</li> <li>Tính năng <strong>chưa có</strong>: thanh toán, vé máy bay, thông báo production, cổng giao diện, tour/F&B như đã sẵn sàng.</li> <li>Bất kỳ con số/khách hàng <strong>không có thật</strong>.</li> </ul> Khách ép cam kết ngoài năng lực thật → lịch sự chuyển <strong>Founder</strong>. Danh sách năng lực thật: <a href="../releases/html/V1.0.0-PILOT-READY.html">V1.0.0-PILOT-READY</a>. </div>

Next Action

• Chưa có partner pilot: đọc tài liệu, sẵn sàng vai của mình.
• Có partner pilot: Tech mở Runbook §1; Ops chuẩn bị Issue Log + theo dõi metrics; Sale bám Sales Guide; Founder giữ quyền quyết GO/NO-GO.