Glossary (DocHub V3)
Định nghĩa thống nhất các thuật ngữ dùng trong project. Khi mâu thuẫn, tham chiếu file này.
| Term | Definition | Notes |
|---|---|---|
| Tenant | Một đơn vị tổ chức/doanh nghiệp sử dụng hệ thống. User có thể thuộc nhiều tenant. | Mỗi tenant có data riêng biệt, RBAC riêng. |
| Workspace | UI concept = tenant selection screen. Portal route /workspace. | Chính là nơi user chọn/switch tenant (xem DEC-001). |
| User | Tài khoản đăng nhập. 1 user có thể thuộc nhiều tenant. | Defined in user.schema.ts. |
| Membership | Quan hệ giữa User và Tenant. Chứa role + permissions trong tenant đó. | Defined in membership.schema.ts. |
| Identity | External login provider gắn với user (Zalo, Google, ...). | Defined in identity.schema.ts. |
| Catalog | Danh mục sản phẩm của tenant. Tenant-scoped. | Module: libs/modules/catalog. |
| CatalogProfile | Profile cấu hình riêng cho danh mục (pricing, display, ...). | Không phải = Catalog. |
| SystemCatalog | Danh mục global (MDM). Quản lý bởi System Admin. | Khác với Catalog tenant-scoped. |
| Product | Sản phẩm trong Catalog. Có variants, attributes, pricing. | Entity: product.schema.ts. |
| Partner | Đối tác kinh doanh (customer hoặc vendor hoặc cả hai). CRM entity. | Module: libs/modules/partner. |
| Order | Đơn hàng. Lifecycle: Draft → Confirmed → Processing → Shipped → Delivered → Completed. | Module: libs/modules/ecommerce. |
| Voucher | Mã khuyến mãi / giảm giá. | Module: libs/modules/voucher. |
| StockQuant | Số lượng tồn kho tại 1 location cho 1 product. | Module: libs/modules/inventory. |
| StockPicking | Phiếu xuất/nhập kho. | Chứa nhiều StockMove. |
| StockMove | 1 dòng di chuyển hàng (product + qty + location). | Thuộc StockPicking. |
| PurchaseOrder | Đơn mua hàng từ vendor. | Module: libs/modules/procurement. |
| Permission | Quyền hạn chi tiết. Format: {DOMAIN}_{ACTION} (e.g., CAT_VIEW). | Xem DEC-003. |
| SystemRole | Role hệ thống (5 levels). | SYSTEM_ADMIN > TENANT_OWNER > TENANT_ADMIN > TENANT_OPERATOR > TENANT_MEMBER. |
| Guard | NestJS middleware kiểm tra auth/tenant/permission. | Stack: JwtAuth → Tenant → Permissions. |
| @SkipTenantCheck() | Decorator bỏ qua TenantGuard. Dùng cho endpoints không cần tenant (auth, admin). | Xem DEC-001. |
| @Public() | Decorator khiến JwtAuthGuard chấp nhận request anonymous (không cần JWT). Không bypass TenantGuard — nếu endpoint cần tenant context phải kết hợp @SkipTenantCheck(). Xem DEC-003. | login, register, refresh. |
| Living Doc | Tài liệu update-in-place. Không tạo bản v1/v2/v3. | Lịch sử = git history. |
| Baseline | Tài liệu frozen. Chỉ import, không sửa. | Đánh superseded qua mapping. |
| Generated | Output từ code/UI scan. Overwrite mỗi lần chạy. | Không tạo bản theo ngày. |
| OA | Official Account (Zalo). Kênh liên lạc doanh nghiệp. | |
| ZNS | Zalo Notification Service. Gửi template message. | |
| MiniApp | Zalo Mini App. Ứng dụng nhỏ chạy trong Zalo. |