Commerce Phase A Built

Commerce là module cấu trúc doanh nghiệp: nó cho phép chủ doanh nghiệp thiết lập một Tổ chức (thương hiệu) và một hoặc nhiều Merchant (các đơn vị điểm bán hợp pháp nơi giao dịch diễn ra), mỗi đơn vị có kênh bán và danh mục sản phẩm riêng. Đây là thứ đầu tiên một người dùng mới chạm tới — onboarding tạo toàn bộ cấu trúc trong một bước nguyên tử — và mọi thứ khác (sản phẩm, đơn hàng, tồn kho, tài chính) đều móc vào merchant mà nó tạo.

1. Định danh

Thuộc tính	Giá trị
Mã module	CORE-03
Tier	Core
Trạng thái	Built
Phase	P1 (Onboarding) · P2 (Quản lý đầy đủ)
Mức ưu tiên	HIGH
Người dùng chính	Chủ doanh nghiệp · Quản lý · (quyền đọc cho Nhân viên)

2. Mục đích & Phạm vi

Bao gồm	Loại trừ
Onboarding doanh nghiệp một bước (org + merchant + kênh + truy cập)	Vòng đời và đăng nhập nhân viên (→ Quản lý Người dùng)
Hồ sơ tổ chức, phân cấp, cài đặt, đính kèm	Định nghĩa vai trò/quyền (→ Quyền hạn)
Tạo merchant (đơn, hàng loạt, aggregate) và hồ sơ	Nội dung catalog sản phẩm (→ Sản phẩm)
Phân loại loại hình kinh doanh (DEFAULT / TICKET / FNB / THEATER)	Mức tồn kho (→ Tồn kho)
Quản lý kênh bán	Xử lý đơn hàng / checkout (→ Đơn hàng)
Quản lý danh mục với cờ add-on	Xử lý thanh toán (→ Thanh toán)
Chính sách xóa theo từng merchant	Phát hành hóa đơn điện tử (→ Thuế & Hóa đơn)
Cấu hình merchant mã hóa (thông tin xác thực thanh toán/tích hợp)

Tổ chức vs Merchant. Tổ chức là lớp thương hiệu ảo (tên, logo, hồ sơ công khai) và không mang định danh pháp lý. Merchant là đơn vị vật lý/pháp lý — nó nắm mã số thuế (MST), hồ sơ hóa đơn điện tử và ví, và là nơi việc bán hàng thực sự diễn ra. Tạo một Tổ chức luôn tự tạo một Merchant mặc định.

3. Năng lực

Năng lực	Người dùng có thể làm gì	Trạng thái
Onboarding doanh nghiệp	Tạo toàn bộ cấu trúc (tổ chức + merchant mặc định + kênh bán + truy cập của chủ sở hữu) trong một bước	Built
Hồ sơ tổ chức	Sửa tên (đa ngôn ngữ), slug, liên hệ, địa chỉ, liên kết mạng xã hội, thông tin đăng ký	Built
Phân cấp tổ chức	Liên kết một tổ chức cha với các tổ chức con	Built
Cài đặt tổ chức	Lưu cấu hình khóa-giá trị đa hình trên một tổ chức	Built
Merchant — tạo đơn	Thêm một merchant vào một tổ chức	Built
Merchant — tạo hàng loạt	Thêm nhiều merchant trong một yêu cầu	Built
Merchant — tạo/cập nhật aggregate	Tạo hoặc cập nhật một merchant cùng danh mục và kênh trong một thao tác nguyên tử	Built
Loại hình kinh doanh	Đặt loại giao diện POS theo từng merchant (DEFAULT / TICKET / FNB / THEATER)	Built
Chính sách xóa	Cấu hình quy tắc cascade theo từng merchant cho việc xóa danh mục/sản phẩm	Built
Cấu hình merchant	Lưu thông tin xác thực nhà cung cấp thanh toán và tích hợp đã mã hóa	Built
Kênh bán	Quản lý kênh qua aggregate merchant; thêm hàng loạt vào merchant hiện có; phân cấp	Built
Danh mục	Quản lý danh mục qua aggregate merchant; đánh dấu là add-on	Built
Vòng đời trạng thái	Kích hoạt / vô hiệu hóa / lưu trữ tổ chức và merchant	Built
Tra cứu định danh	Tìm một tổ chức hoặc merchant theo ID hoặc theo slug	Built
Lọc theo vai trò	Chủ sở hữu thấy dữ liệu của mình; nhân viên chỉ thấy merchant được gán	Built
CRUD kênh/danh mục độc lập	Quản lý kênh/danh mục độc lập với aggregate merchant	Planned
Chuyển quyền sở hữu	Gán lại một tổ chức cho một chủ sở hữu khác	Planned

4. Phụ thuộc Module

Phụ thuộc vào	Lý do
Quản lý Người dùng	Chủ sở hữu và nhân viên thuộc về tổ chức / merchant
Quyền hạn	Vai trò giới hạn theo tổ chức hoặc merchant; onboarding cấp quyền truy cập cho chủ sở hữu

Được phụ thuộc bởi	Lý do
Sản phẩm	Sản phẩm giới hạn theo một merchant
Thiết bị	Thiết bị được gán cho merchant
Đơn hàng	Bán hàng diễn ra theo từng merchant và kênh bán
Thuế & Hóa đơn	Thông tin thuế được nắm trên merchant; hồ sơ hóa đơn theo từng merchant
Chi phí	Ví tài chính theo từng merchant

5. Backend Packages

Chi tiết triển khai nằm trong tài liệu developer — phần này chỉ ánh xạ module tới service vận hành nó.

Package	Vai trò	Tài liệu developer
@nx/commerce	Organizer, merchant, onboarding, kênh bán, danh mục, cài đặt, thiết bị, tích hợp mã hóa; nguồn chân lý CDC	commerce

6. Luồng Người dùng Chính

Onboarding (thiết lập nguyên tử)

Tạo/cập nhật aggregate merchant (cập nhật thông minh)

7. Vai trò & Quyền hạn

Vai trò	Có thể	Không thể
Chủ sở hữu	Onboard, tạo/cập nhật/vô hiệu hóa/lưu trữ tổ chức và merchant, quản lý kênh/danh mục/cài đặt, gán nhân viên	Truy cập tổ chức của chủ sở hữu khác
Quản lý	Quản lý merchant được gán và kênh/danh mục của chúng (theo phạm vi được cấp)	Tạo tổ chức; quản lý merchant ngoài phạm vi
Nhân viên	Xem merchant được gán và cấu trúc của chúng	Tạo hoặc sửa merchant; thấy merchant chưa được gán
Super Admin	Truy cập mọi tổ chức và merchant (bỏ qua lọc theo vai trò)	—

8. Trạng thái & Lộ trình

Phase	Năng lực
P1	Onboarding nguyên tử (tổ chức + merchant mặc định + kênh bán + truy cập của chủ sở hữu)
P2	Quản lý đầy đủ tổ chức & merchant: hồ sơ, phân cấp, tạo/cập nhật aggregate, loại hình kinh doanh, chính sách xóa, cấu hình mã hóa, lọc theo vai trò
P3	Dự kiến: CRUD kênh/danh mục độc lập, chuyển quyền sở hữu, vô hiệu hóa cascade, mặc định cài đặt toàn công ty, xác thực MST, hỗ trợ đa thương hiệu

9. Trang Liên quan

• URD
• Test Cases
• PRDs
• Tài liệu developer: @nx/commerce
• Module liên quan: Quản lý Người dùng · Quyền hạn · Sản phẩm · Thuế & Hóa đơn