Source document: docs/founder/VIEW-PLATFORM-GUIDE.md
Source version: 0.0.0
Generated time: 2026-07-06T14:59:18.993Z
Owner: Unassigned
Audience: Internal
Status: Approved

Xem & Dùng Nền Tảng — Hướng dẫn cho Founder

v1.0.0 Pilot Ready Backend/API LIVE (staging) Chưa có UI quản trị Cập nhật 2026-07-06

Tóm tắt một dòng: BNG Booking Platform hiện là backend/API-first platform chạy thật, chưa phải web app có giao diện để "bấm".
Muốn xem → dùng health/API/Postman/tài liệu. Muốn bấm dùng bằng chuột → cần mở sprint xây Admin Console MVP.
Source of truth = Markdown; HTML generate từ Markdown (không hand-edit HTML).

1. Nền tảng hiện tại xem ở đâu?

Đường dẫn https://staging-api.booking.bngagency.vn/health chỉ là health check của API — trả về {"status":"ok"} để xác nhận dịch vụ còn sống.
Đây CHƯA phải giao diện quản trị. Không có màn hình đăng nhập, không có dashboard bấm chuột.
Platform hiện là backend / API-first: mọi thứ chạy qua API (đối tác gọi) và CLI ops (nội bộ vận hành). Giao diện web sẽ là bước xây sau (xem §5).

Lưu ý URL: endpoint health chính xác là …/health trên host staging-api.booking.bngagency.vn. Các đường /api/booking/* cần API key và IP được allowlist (xem Pilot Runbook).

2. Hiện có những lớp nào?

Lớp	Trạng thái	Xem bằng gì
Booking API	<span class="badge b-go">Live</span>	curl / Postman / API docs (OpenAPI)
Partner Management	<span class="badge b-info">Backend/CLI</span>	`ops` command + docs
Tenant Management	<span class="badge b-info">Backend/CLI</span>	`ops` command + docs
Inventory	<span class="badge b-info">Backend/API</span>	seed/demo + API (availability)
Audit	<span class="badge b-info">Backend/Data</span>	`ops show-audit` + audit docs
Frontend Admin	<span class="badge b-nogo">Chưa có</span>	cần build sau
Partner Portal	<span class="badge b-nogo">Chưa có</span>	cần build sau
Customer Booking UI	<span class="badge b-nogo">Chưa có</span>	cần build sau

Đọc bảng: Live = chạy thật · Backend/CLI = có logic, dùng qua lệnh/API (không có nút bấm) · Chưa có = cần xây.

3. Founder muốn demo thì demo như nào?

A. Technical Demo (cho khách/đối tác có đội kỹ thuật) — Sẵn sàng

Dùng Postman Collection hoặc API call (curl).
Chạy trọn Availability → Booking → Confirm → Cancel trên sandbox (đã kiểm chứng thật ở Pilot).
Tài liệu: Sales Guide §4 · examples.

B. Business Demo (cho khách không kỹ thuật) — Dùng tài liệu

Dùng slide / tài liệu, giải thích luồng partner → tenant → inventory → booking.
Nhấn: trắng nhãn, đa đối tác, cách ly dữ liệu, audit. Tài liệu: V1.0.0-PILOT-READY.

C. Future UI Demo (bấm chuột trực quan) — Chưa có

Hiện chưa có giao diện để demo bằng chuột.
Nếu cần, phải mở sprint riêng xây Admin Console hoặc Partner Portal (xem §5).

4. Backend quản trị hiện tại có chưa?

Chưa có giao diện backend quản trị dạng web.
Hiện quản trị bằng CLI (npm run ops -- …) + tài liệu + API.
Các chức năng ĐÃ có logic nền (chạy được qua CLI, không có nút bấm):

Chức năng	Có logic nền?	Cách dùng hiện tại
Tạo partner	<span class="badge b-go">Có</span>	`ops create-partner`
Cấp API key	<span class="badge b-go">Có</span>	`ops issue-key --deliver`
Tạo tenant	<span class="badge b-go">Có</span>	`ops provision-tenant`
Seed inventory	<span class="badge b-go">Có</span>	`ops seed-inventory`
Suspend / reactivate	<span class="badge b-go">Có</span>	`ops suspend-* / reactivate-*`
Booking lifecycle	<span class="badge b-go">Có</span>	API (`/api/booking/*`)

Kết: logic đầy đủ ✅ — nhưng chưa có UI để bấm. Vận hành hiện qua Pilot Runbook + Operations guides.

5. Nếu muốn giao diện quản trị thì cần xây gì?

Đề xuất roadmap UI tối thiểu (mỗi cái là sprint xây mới, ngoài phạm vi hiện tại):

Admin Console MVP (cho Founder/Ops)

Login nội bộ · Dashboard · Partner list · Tenant list · API key management · Booking list · Audit log viewer · Pilot issue tracker.

Partner Portal MVP (cho đối tác)

Customer Booking UI (cho người dùng cuối)

Search availability · Select item · Create booking · Confirm/cancel booking.

Cả 3 đều chưa có và cần backend bổ sung (auth người dùng cuối/portal, endpoint đọc cho UI…). Ưu tiên thường là Admin Console MVP trước (giúp nội bộ dễ vận hành + demo trực quan).

6. Founder nên làm gì tiếp?

Option A — Pilot API-first ngay Nhanh nhất

Không cần UI. Phù hợp nếu đối tác có đội kỹ thuật. Nhanh nhất để kiểm chứng platform với đối tác thật.

Option B — Build Admin Console MVP trước Tốn thêm sprint

Có giao diện để Founder/Sale/Ops dễ dùng + demo trực quan cho khách. Tốn thêm sprint. Phù hợp nếu cần bán/demo cho khách không kỹ thuật.

Khuyến nghị:

Có đối tác kỹ thuật → chọn A (kiểm chứng nhanh, không chờ UI).
Cần bán/demo cho khách không kỹ thuật, hoặc Founder muốn tự bấm vận hành → chọn B.

7. Bảng quyết định

Câu hỏi	Nếu Có	Nếu Không
Đối tác có dev team không?	<span class="badge b-go">Pilot API-first</span>	cần UI demo
Founder cần tự thao tác không?	<span class="badge b-notes">Admin Console</span>	CLI/docs đủ
Sale cần demo hình ảnh không?	<span class="badge b-notes">UI prototype</span>	business deck đủ
Khách cần đặt thử trực tiếp không?	<span class="badge b-notes">Customer UI</span>	API demo đủ

8. Kết luận ngắn

BNG Booking Platform hiện đã là backend platform có thể chạy thật, nhưng chưa phải web app có giao diện quản trị.
Muốn "xem" → hiện xem qua health / API / Postman / docs.
Muốn "bấm dùng" → cần mở sprint xây Admin Console MVP.

<div class="nextaction"> ▶ Recommended Next Step: Nếu đối tác pilot đầu tiên có đội kỹ thuật → chạy Pilot API-first ngay (Option A) để kiểm chứng platform nhanh nhất, chưa cần UI. Song song, xếp Admin Console MVP (Option B) vào backlog — khởi động khi cần demo trực quan cho khách không kỹ thuật hoặc khi Founder/Ops muốn tự bấm vận hành. Xem: <a href="../pilot/html/PILOT-RUNBOOK.html">Pilot Runbook</a> · <a href="../releases/html/V1.0.0-PILOT-READY.html">V1.0.0 Pilot Ready</a> · <a href="../index.html">Founder Dashboard</a>. </div>

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