Source document: docs/knowledge-index/04-GLOSSARY.md
Source version: 0.0.0
Generated time: 2026-07-06T14:59:18.579Z
Owner: Engineering (Enablement)
Audience: Internal
Status: Approved

04 — GLOSSARY (canonical)

Nguồn canonical duy nhất cho thuật ngữ. Các doc khác dùng đúng những định nghĩa này; nếu mâu thuẫn → sửa về đây. Định nghĩa ngắn + dẫn nguồn chi tiết (không copy dài).

Phân biệt cốt lõi (bắt buộc dùng đúng)

Thuật ngữ	Định nghĩa canonical	Không nhầm với	Nguồn
Account	Khách hàng doanh nghiệp dùng nền tảng (OTA/khách sạn/medical provider). 1 Account ↔ 1 Tenant.	≠ Customer (khách du lịch); ≠ User (tài khoản đăng nhập)	business-os/00, business-os/03
Customer	Khách du lịch / end-user đặt dịch vụ qua một tenant.	≠ Account; ≠ Guest (Customer ẩn danh trong 1 đơn)	travel-os/03
Partner	Đơn vị lưu trú/nhà cung cấp đưa inventory (bên cung).	≠ Affiliate (kênh giới thiệu Customer); ≠ plugin đối tác kỹ thuật	travel-os/03
Tenant	Vùng dữ liệu/cấu hình SaaS cô lập của một Account (ranh giới isolation).	≠ Account (thực thể thương mại — cùng thực thể, khác góc nhìn)	travel-os/07

Định danh người (dễ nhầm)

User — tài khoản đăng nhập được (staff, partner-admin) thuộc ≥1 tenant qua membership + role. Nguồn: backend/AUTH-GATEWAY.
Guest — Customer ẩn danh trong một Reservation (chưa có tài khoản). Nguồn: travel-os/03.
Membership — quan hệ (User, Tenant, role) — một User nhiều Tenant.

Domain (Booking core — chi tiết travel-os/03)

Reservation — đơn giữ chỗ (aggregate root); giữ snapshot kỳ + tổng tiền.
Reservable / Listing / Unit — Booking không biết "Hotel/Room", chỉ biết Reservable; Listing = chỗ bán được; Unit = đơn vị đặt (phòng/bàn/ghế/gói).
Availability — tồn kho tổng theo Unit; điểm khoá chống overbook.
Pricing — giá mỗi Unit/kỳ (MVP phẳng).

Nền tảng & kiến trúc (chi tiết travel-os/02)

Bounded Context — ranh giới nghiệp vụ sở hữu dữ liệu riêng; không shared DB.
Spine — Identity + Tenant + Event Bus (nền tảng bắt buộc). Shared Kernel — thư viện chung không state (Money/IDs/TenantContext/event envelope). Module — một bounded context. Vertical — composition nhiều module cho một ngành (Medical). Intelligence — tầng AI consume-only.
Domain Event — fact đã xảy ra (past tense); envelope chuẩn (travel-os/04).
Outbox — pattern lưu event cùng transaction → phát at-least-once (backend/OUTBOX-HANDLERS).
TenantResolver — seam xác định tenant server-side (JWT/session/API key) (backend/AUTH-GATEWAY).
RLS — Row-Level Security (Postgres) cô lập theo tenantId (travel-os/07).

Thương mại & vận hành

North Star — Activated Account GMV (business-os/02).
Activation — Account có giao dịch thật đầu tiên (= provisioning.went_live).
GMV — tổng giá trị giao dịch (VND) qua nền tảng.
Account Lifecycle (thương mại) vs Tenant Lifecycle (kỹ thuật) — hai view một thực thể (business-os/03↔06).

Kỹ thuật (process)

RFC / ADR — đề xuất thay đổi lớn / ghi quyết định kiến trúc (engineering/06, 07).
Quality Gate / Definition of Done — điều kiện merge / điều kiện đóng (engineering/05, 04).
Release Train — nhịp phát hành Alpha→GA (engineering/08).

Quy tắc: mọi tài liệu tham chiếu glossary này, không tự định nghĩa lại Account/Customer/Partner/Tenant/Reservation. Sai lệch = lỗi cần sửa (06-KNOWLEDGE-LIFECYCLE).

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