Đặc tả Kỹ thuật

Thông tin Tài liệu

Phiên bản	1.3
Tác giả	Nexpando
Cập nhật lần cuối	Tháng 2 năm 2026
Chiến lược	F&B + Bán lẻ | Xây dựng | Freemium
Tham khảo	Nghiên cứu Thị trường

Mục lục

Tổng quan

• Tóm tắt Điều hành
• Lộ trình Phát hành
• Định nghĩa Gói Freemium

Modules

1. Bảo mật & Phân quyền
2. Xử lý Dữ liệu & Nền tảng
3. Cổng Thanh toán (Tích hợp VNPAY)
4. Hệ thống SELL Cốt lõi
5. Hệ thống Mua hàng
6. Hệ thống Marketing
7. API Gateway
8. Cổng Quản trị (BO)
9. Cổng Khách hàng
10. Tích hợp Trí tuệ Nhân tạo

Phụ lục

• A. Bảng tham chiếu nhanh Đối thủ cạnh tranh
• B. Ngăn xếp Công nghệ
• C. Lịch sử Tài liệu

Tóm tắt Điều hành

Định vị Chiến lược

                    Độ sâu Tính năng
                         ▲
                         │
              Haravan    │    CukCuk
            (Thương mại  │    (Chuyên sâu F&B)
             điện tử)    │         ★ MỤC TIÊU CỦA CHÚNG TÔI
                         │           (F&B + Bán lẻ + Offline-First)
         ────────────────┼────────────────────────►
                         │                    Chuyên biệt ngành dọc
              KiotViet   │    iPOS
            (SMB rộng)   │  (Nhà hàng)
                         │

Điểm khác biệt Chính

Điểm khác biệt	Khoảng trống Đối thủ	Lợi thế của Chúng tôi
Offline-First	Tất cả đối thủ ⚠️ yếu	Kiến trúc local-first toàn diện
F&B + Bán lẻ	CukCuk yếu bán lẻ, KiotViet yếu F&B	Chuyên sâu cả hai ngành dọc
Tích hợp AI	Chỉ MISA có giọng nói	Phân tích dự đoán, gợi ý thông minh

Lộ trình Phát hành

Tổng quan Giai đoạn

Phát hành	Thời gian	Trọng tâm	Công sức
R1 - MVP	Tháng 1-4	POS Cốt lõi + Thiết yếu F&B	40%
R2 - Core+	Tháng 5-7	Quản trị + Tuân thủ + Báo cáo	25%
R3 - Tăng trưởng	Tháng 8-10	Trực tuyến + Marketing	20%
R4 - Khác biệt hóa	Tháng 11-14	AI + Nâng cao	15%

Phát hành 1 - MVP (Tháng 1-4)

Module	Tính năng	Tiêu chuẩn Đối thủ
1. Bảo mật & Phân quyền	Xác thực, phân quyền cơ bản	Tất cả đều có
3. Cổng Thanh toán	Tiền mặt, VietQR, VNPAY, PhonePOS	Tất cả đều có (PhonePOS là điểm khác biệt)
4. SELL Cốt lõi	Sản phẩm, Danh mục, Kho, BOM	KiotViet, CukCuk
4.12 Quản lý Bàn	Sơ đồ mặt bằng, gộp/tách bàn	CukCuk ✅, iPOS ✅
4.13 KDS	Màn hình bếp, định tuyến	CukCuk ✅, iPOS ✅
4.9 Hóa đơn điện tử	Tuân thủ Nghị định 70/2025	Bắt buộc
5. Hệ thống Mua hàng	Giỏ hàng, Đơn hàng, Thanh toán	Tất cả đều có
2.6 Đồng bộ Offline	Local-first, đồng bộ nền	Không ai có - lợi thế của chúng tôi

Phát hành 2 - Core+ (Tháng 5-7)

Module	Tính năng	Tiêu chuẩn Đối thủ
2. Xử lý Dữ liệu	Ghi log, Cấu hình, Thông báo	Tất cả đều có
4.10 Quản lý Tài chính	Doanh thu, Đối soát	MISA dẫn đầu
8. Cổng Quản trị	Dashboard, Quản lý sản phẩm, Đơn hàng	Tất cả đều có
2.3 Báo cáo	Bán hàng, Kho, Tài chính	KiotViet 80%

Phát hành 3 - Tăng trưởng (Tháng 8-10)

Module	Tính năng	Tiêu chuẩn Đối thủ
9. Cổng Khách hàng	Đặt hàng web, Tài khoản khách hàng	Haravan dẫn đầu
7. API Gateway	Cân bằng tải, Giới hạn tần suất	Nhu cầu Enterprise
6. Marketing	Voucher, Khách hàng thân thiết	Haravan 80%
4.14 Đặt hàng QR	Quét mã đặt hàng	CukCuk ✅

Phát hành 4 - Khác biệt hóa (Tháng 11-14)

Module	Tính năng	Tiêu chuẩn Đối thủ
10. Tích hợp AI	Trợ lý, Gợi ý	MISA chỉ có giọng nói
Phân tích Nâng cao	Dự báo, Dự đoán	Không ai có - khoảng trống

Định nghĩa Gói Freemium

Tính năng	Miễn phí (Micro)	Pro (SMB)	Enterprise
Giới hạn
Giới hạn SKU	100	1.000	Không giới hạn
Địa điểm	1	3	Không giới hạn
Người dùng	1	5	Không giới hạn
Giao dịch/tháng	500	5.000	Không giới hạn
Tính năng Cốt lõi
POS Cơ bản (tiền mặt/QR)	✅	✅	✅
Hóa đơn điện tử (Nghị định 70)	✅	✅	✅
Quản lý kho cơ bản	✅	✅	✅
Báo cáo cơ bản	✅	✅	✅
Tính năng F&B
Quản lý bàn	❌	✅	✅
KDS	❌	✅	✅
BOM/Công thức	❌	✅	✅
Đặt hàng QR	❌	✅	✅
Nâng cao
Cảnh báo tồn kho	❌	✅	✅
Đa địa điểm	❌	❌	✅
Voucher/Khách hàng thân thiết	❌	✅	✅
Phân tích nâng cao	❌	❌	✅
Cổng Khách hàng	❌	❌	✅
Trợ lý AI	❌	❌	✅
Truy cập API	❌	❌	✅
Giá	Miễn phí	299K/tháng	Tùy chỉnh

Tham khảo Đối thủ:

• KiotViet: Gói miễn phí, Standard 200K, Pro 400K
• MISA: Miễn phí (2 triệu giấy phép), Standard 100K, Pro 250K
• CukCuk: Không có gói miễn phí, Basic 150K, Standard 300K

1. Bảo mật & Phân quyền

Phát hành: R1 (MVP) | Ưu tiên: Bắt buộc

Trạng thái Triển khai

Package: @nx/identity | Framework: IGNIS (Hono + Drizzle ORM)

• Xác thực: JWT với Bun.password (Argon2id) để hash
• 5 vai trò tích hợp sẵn: super-admin (100), admin (200), owner (300), employee (400), customer (897)
• Quản lý Khách hàng: CRUD khách hàng phạm vi merchant với tự động gán vai trò
• Phát sóng sự kiện WebSocket cho đăng ký seller
• Xem Dịch vụ Identity để biết chi tiết kỹ thuật.

Tham khảo Đối thủ: Tất cả đối thủ đều có xác thực cơ bản; KiotViet và Haravan có RBAC nâng cao

1.1 Xác thực

Mô tả: Xác minh danh tính người dùng an toàn, hỗ trợ nhiều phương thức xác thực với quản lý phiên và kiểm soát bảo mật tài khoản.

• Xác thực bằng Thông tin đăng nhập: Đăng nhập bằng tên người dùng/mật khẩu với hash mật khẩu an toàn và bảo vệ brute-force (khóa tài khoản sau nhiều lần thất bại)
• Phiên dựa trên Token: JWT access token cho ủy quyền API với luân chuyển refresh token cho phiên kéo dài
• Xác thực Đa yếu tố: OTP tùy chọn qua email/SMS cho các thao tác nhạy cảm và tài khoản rủi ro cao
• Xác minh Email: Luồng xác nhận email tài khoản mới với liên kết xác minh có thời hạn
• Kiểm soát Phiên: Giới hạn phiên đồng thời, đăng xuất từ xa và thu hồi token khi đổi mật khẩu

Tính năng	KiotViet	Haravan	Mục tiêu
Tên người dùng/Mật khẩu	✅	✅	✅
OTP qua Điện thoại	✅	✅	✅
MFA	⚠️	✅	✅
SSO	❌	⚠️	✅ (Enterprise)

1.2 Phân quyền

Mô tả: Kiểm soát Truy cập dựa trên Vai trò (RBAC) với quyền chi tiết ở cấp tài nguyên và hành động, hỗ trợ cách ly đa tenant.

• Quản lý Vai trò: Tạo vai trò tùy chỉnh cho mỗi merchant với tên mô tả và gói quyền (ví dụ: Thu ngân, Quản lý, Nhân viên Kho)
• Quyền Chi tiết: Quyền dạng cặp tài nguyên:hành động (ví dụ: product:create, order:refund, report:export)
• Gán Vai trò: Gán nhiều vai trò cho người dùng; quyền được tổng hợp từ tất cả vai trò được gán
• Vai trò Tích hợp: Các vai trò hệ thống được cấu hình sẵn (Owner, Admin, Staff) với mặc định hợp lý để khởi tạo nhanh
• Cách ly Tenant: Người dùng có thể có vai trò khác nhau trên các merchant/địa điểm khác nhau mà họ thuộc về

1.3 Quản lý Người dùng

Mô tả: Quản lý toàn bộ vòng đời người dùng từ đăng ký đến vô hiệu hóa, với quản lý hồ sơ và hỗ trợ đa tenant.

• Hồ sơ Người dùng: Lưu trữ thông tin cá nhân (tên, điện thoại, email, ảnh đại diện), tùy chọn và cài đặt thông báo
• Trạng thái Tài khoản: Các trạng thái hoạt động, tạm ngưng hoặc bị khóa với chuyển đổi trạng thái do quản trị viên kiểm soát
• Hồ sơ Nhân viên: Liên kết người dùng với hồ sơ nhân viên bao gồm chức danh, phòng ban, ngày nhận việc và tình trạng công việc
• Truy cập Đa Merchant: Một tài khoản người dùng có thể truy cập nhiều merchant với vai trò khác nhau cho mỗi merchant
• Cài đặt Người dùng: Cấu hình theo người dùng cho ngôn ngữ, múi giờ, địa điểm mặc định và tùy chọn giao diện

1.4 Quản lý Khách hàng - MỚI

Phát hành: R1 | Ưu tiên: Bắt buộc

Đã Triển khai

Controller: /customers (8 endpoint) | Service: CustomerService Xem Quản lý Khách hàng để biết chi tiết API.

Mô tả: Quản lý vòng đời khách hàng phạm vi merchant với tự động cung cấp tài khoản và gán vai trò.

• CRUD Khách hàng: Tạo, liệt kê, cập nhật và xóa khách hàng với kiểm soát truy cập phạm vi merchant
• Cung cấp Tự động: Tạo khách hàng tự động tạo User + UserProfile + gán vai trò customer (897) + thiết lập UserMapping merchant trong một giao dịch duy nhất
• Cách ly Merchant: Khách hàng được tạo bởi Merchant A không hiển thị cho Merchant B
• Thao tác Hàng loạt: Xóa hàng loạt khách hàng với bộ lọc phạm vi merchant
• Tìm kiếm & Lọc: Liệt kê khách hàng với phân trang, endpoint đếm và findOne cho tra cứu cụ thể

1.5 Quản lý Thiết bị

Mô tả: Đăng ký, giám sát và kiểm soát các thiết bị đầu cuối POS và thiết bị di động trên tất cả địa điểm merchant.

• Đăng ký Thiết bị: Ghép nối thiết bị với tài khoản merchant qua quét mã QR hoặc mã PIN kích hoạt
• Danh mục Thiết bị: Theo dõi loại thiết bị, model, phiên bản OS, phiên bản ứng dụng và định danh phần cứng
• Giám sát Trạng thái: Trạng thái trực tuyến/ngoại tuyến thời gian thực với dấu thời gian hoạt động cuối và theo dõi heartbeat
• Điều khiển Từ xa: Đẩy cập nhật cấu hình, buộc đăng xuất hoặc xóa dữ liệu thiết bị từ xa
• Gắn kết Địa điểm: Tùy chọn giới hạn thiết bị tại địa điểm cửa hàng cụ thể để bảo mật

2. Xử lý Dữ liệu & Nền tảng

Phát hành: R1 (Đồng bộ Offline) + R2 (Còn lại) | Ưu tiên: Bắt buộc

2.1 Ghi log & Kiểm toán

Phát hành: R2

Mô tả: Hệ thống dấu vết kiểm toán toàn diện ghi lại tất cả hành động người dùng phục vụ tuân thủ, gỡ lỗi và phân tích kinh doanh.

• Ghi log Hành động: Ghi nhận các thao tác tạo/cập nhật/xóa với ảnh chụp dữ liệu trước/sau
• Quy kết Người dùng: Mỗi hành động liên kết với ID người dùng, thiết bị, địa chỉ IP và dấu thời gian
• Phân loại Log: Các luồng riêng biệt cho xác thực, giao dịch, kho hàng và hành động quản trị
• Lưu trữ Tuân thủ: Lưu trữ 10 năm cho giao dịch tài chính theo yêu cầu Nghị định 70/2025
• Tìm kiếm & Xuất: Truy vấn log theo khoảng thời gian, người dùng, loại hành động hoặc tài nguyên; xuất sang CSV/Excel

2.2 Quản lý Cấu hình

Phát hành: R2

Mô tả: Quản lý cài đặt tập trung với ghi đè phân cấp từ cấp hệ thống đến merchant đến người dùng.

• Phạm vi Cài đặt: Mặc định toàn hệ thống, ghi đè theo merchant và tùy chọn theo người dùng
• Feature Flag: Bật/tắt tính năng theo merchant để triển khai dần hoặc thử nghiệm A/B
• Danh mục Cấu hình: Cài đặt thuế, mẫu hóa đơn, phương thức thanh toán, tùy chọn thông báo, giao diện
• Lịch sử Thay đổi: Theo dõi ai thay đổi cài đặt nào và khi nào, với khả năng hoàn tác
• Đồng bộ Thời gian thực: Thay đổi cấu hình lan truyền đến tất cả thiết bị kết nối trong vài giây

2.3 Báo cáo & Phân tích

Phát hành: R2

Tham khảo Đối thủ: KiotViet 80%, Haravan 85%, CukCuk 70%

Mô tả: Nền tảng phân tích kinh doanh với dashboard thời gian thực, báo cáo tùy chỉnh và khả năng xuất dữ liệu.

• Widget Dashboard: Thẻ KPI tùy chỉnh hiển thị doanh thu, đơn hàng, sản phẩm bán chạy và hiệu suất nhân viên
• Trình tạo Báo cáo: Mẫu báo cáo sẵn có cộng với tạo báo cáo tùy chỉnh bằng chọn trường kéo-thả
• So sánh Thời gian: So sánh kỳ hiện tại với kỳ trước/cùng kỳ năm trước
• Phân tích Chi tiết: Nhấp từ tổng quan đến dữ liệu chi tiết cấp giao dịch
• Tổng hợp Đa Địa điểm: Báo cáo tổng hợp qua các địa điểm hoặc lọc theo cửa hàng/thiết bị cụ thể
• Báo cáo Theo lịch: Tự động tạo và gửi email báo cáo hàng ngày/tuần/tháng cho các bên liên quan
• Định dạng Xuất: Tải về dạng Excel, PDF hoặc CSV; xuất Excel giữ nguyên công thức để phân tích thêm

Loại Báo cáo	KiotViet	Haravan	CukCuk	Mục tiêu
Tổng hợp bán hàng	✅	✅	✅	✅
Theo sản phẩm	✅	✅	✅	✅
Theo nhân viên	✅	✅	✅	✅
Theo khoảng thời gian	✅	✅	✅	✅
Báo cáo kho	✅	✅	⚠️	✅
Báo cáo tài chính	✅	✅	⚠️	✅
Báo cáo tùy chỉnh	⚠️	✅	❌	✅
Xuất (Excel/PDF)	✅	✅	✅	✅

2.4 Quản lý Tệp/Phương tiện

Phát hành: R2

Mô tả: Quản lý tài nguyên thống nhất cho hình ảnh sản phẩm, tài liệu, hóa đơn và tệp phương tiện với tối ưu hóa và phân phối CDN.

• Xử lý Tải lên: Kéo-thả hoặc chụp camera cho hình ảnh; hỗ trợ JPEG, PNG, WebP, PDF tối đa 10MB
• Xử lý Hình ảnh: Tự động thay đổi kích thước và nén hình ảnh sản phẩm; tạo thumbnail cho danh sách
• Tổ chức Lưu trữ: Tệp được tổ chức theo merchant, danh mục (sản phẩm, hóa đơn, tài liệu)
• Phân phối CDN: Phục vụ hình ảnh qua CDN để tải nhanh trên thiết bị POS và web
• Liên kết Meta: Liên kết tệp với sản phẩm, đơn hàng hoặc các thực thể khác qua hệ thống liên kết linh hoạt
• Thao tác Hàng loạt: Tải lên nhiều hình ảnh sản phẩm cùng lúc; tải hàng loạt để sao lưu

2.5 Hệ thống Thông báo

Phát hành: R2

Mô tả: Phân phối thông báo đa kênh cho cảnh báo giao dịch, chiến dịch marketing và thông báo hệ thống.

• Kênh: Email, SMS, thông báo đẩy (di động/desktop) và trung tâm thông báo trong ứng dụng
• Kích hoạt Giao dịch: Tự động gửi khi xác nhận đơn hàng, nhận thanh toán, trạng thái giao hàng, cảnh báo tồn kho thấp
• Công cụ Mẫu: Mẫu tùy chỉnh với trường hợp nhất (tên khách hàng, chi tiết đơn hàng, số tiền)
• Theo dõi Gửi: Theo dõi trạng thái đã gửi/đã nhận/đã đọc; tự động thử lại khi gửi thất bại
• Quản lý Tùy chọn: Người dùng kiểm soát thông báo nào họ nhận và qua kênh nào
• Gửi Hàng loạt: Lên lịch thông báo hàng loạt cho khuyến mãi hoặc thông báo

Lưu ý: Hợp nhất các chức năng gửi thư từ SELL Core (4.8), Hệ thống Mua hàng (5.5) và Marketing (6.3) vào một dịch vụ dùng chung duy nhất.

2.6 Đồng bộ Offline - MỚI

Phát hành: R1 (MVP) | Ưu tiên: Bắt buộc | Điểm khác biệt

Tham khảo Đối thủ: TẤT CẢ ĐỐI THỦ YẾU ⚠️ - Đây là lợi thế cạnh tranh của chúng tôi

Đối thủ	Khả năng Offline	Triển khai
KiotViet	⚠️ Cơ bản	Chỉ giao dịch, không đồng bộ đầy đủ
Haravan	⚠️ Cơ bản	Hạn chế, phụ thuộc web
CukCuk	⚠️	F&B offline một phần
iPOS	⚠️	Nhà hàng offline một phần
MISA	⚠️	Chỉ cơ bản
Của chúng tôi	✅ Đầy đủ	Kiến trúc local-first

Mô tả: Xây dựng kiến trúc offline-first mạnh mẽ đảm bảo POS hoạt động đầy đủ mà không cần kết nối internet, với đồng bộ nền thông minh khi kết nối được khôi phục.

• Cơ sở dữ liệu Local-First: Tất cả dữ liệu quan trọng (sản phẩm, giá, khách hàng, đơn hàng chờ) được lưu cục bộ trên thiết bị
• Giao dịch Offline: Hoàn tất các thao tác POS mà không cần internet - bán hàng, điều chỉnh kho, tra cứu khách hàng
• Đồng bộ Nền: Tự động đồng bộ khi kết nối được khôi phục, với chỉ báo tiến trình
• Giải quyết Xung đột: Chiến lược hợp nhất thông minh cho chỉnh sửa đồng thời (ghi cuối thắng, giải quyết thủ công cho xung đột)
• Quản lý Hàng đợi Đồng bộ: Hàng đợi bền vững các thay đổi chờ xử lý với logic thử lại
• Chỉ báo Trạng thái: Giao diện rõ ràng hiển thị trạng thái trực tuyến/ngoại tuyến và tiến trình đồng bộ

Tại sao Điều này Quan trọng:

• Việt Nam có internet không ổn định ở vùng nông thôn/ngoại thành
• Giờ cao điểm kinh doanh thường trùng với tắc nghẽn mạng
• Phân tích đối thủ xác định đây là cơ hội Top 4 với mức độ khẩn cấp Cao

3. Cổng Thanh toán (Tích hợp VNPAY)

Phát hành: R1 (MVP) | Ưu tiên: Bắt buộc

Tham khảo Đối thủ: Tất cả đối thủ đều hỗ trợ VNPay, MoMo, ZaloPay

3.1 Tích hợp Thanh toán VNPAY bằng Tiền mặt / QR / Thẻ / PhonePOS

Mô tả: Giải pháp thanh toán tích hợp:

• Tiền mặt - Xử lý tiền mặt truyền thống với quản lý ngăn tiền
• Mã QR - VietQR, VNPAY QR, MoMo, ZaloPay
• Thẻ - Thẻ Tín dụng/Ghi nợ qua thiết bị đầu cuối VNPAY
• PhonePOS - Giải pháp thanh toán không tiếp xúc kiểu Apple Pay của VNPAY (chạm NFC để thanh toán)

Tích hợp với VNPAY Payment SDK để luồng thanh toán App-to-App mượt mà.

• Thanh toán Chia nhỏ: Chấp nhận nhiều phương thức thanh toán trên một giao dịch (ví dụ: 50% tiền mặt + 50% thẻ)
• Thanh toán Offline: Xếp hàng giao dịch thanh toán khi offline; xử lý tự động khi trực tuyến trở lại
• Đối soát Thanh toán: Tự động khớp thanh toán với đơn hàng; đánh dấu chênh lệch để xem xét
• Xử lý Tiền tip: Nhắc tiền tip tùy chọn với số tiền đặt sẵn hoặc nhập tùy chỉnh
• Ngăn Tiền: Theo dõi số dư ngăn tiền; yêu cầu kiểm đếm khi mở/đóng ca

Phương thức Thanh toán	KiotViet	Haravan	CukCuk	Mục tiêu
Tiền mặt	✅	✅	✅	✅
VietQR	✅	✅	✅	✅
VNPAY QR	✅	✅	✅	✅
MoMo	✅	✅	✅	✅
ZaloPay	✅	✅	⚠️	✅
Thiết bị đầu cuối Thẻ	✅	✅	✅	✅
PhonePOS (NFC)	❌	❌	❌	✅
Thanh toán chia nhỏ	⚠️	⚠️	✅	✅
Thanh toán offline	⚠️	⚠️	⚠️	✅

Lợi thế PhonePOS: VNPAY PhonePOS cho phép merchant chấp nhận thanh toán không tiếp xúc trực tiếp trên điện thoại thông minh mà không cần phần cứng bổ sung. Trải nghiệm kiểu Apple Pay này giúp chúng tôi khác biệt với đối thủ và giảm chi phí phần cứng cho merchant.

4. Hệ thống SELL Cốt lõi

Phát hành: R1 (MVP) | Ưu tiên: Bắt buộc

4.1 Quản lý Tổ chức

Mô tả: Chức năng này cung cấp công cụ để thiết lập và quản lý cơ cấu tổ chức, bao gồm định nghĩa đơn vị kinh doanh, chi nhánh hoặc đối tác liên quan, nhằm thiết lập hệ thống phân cấp rõ ràng cho hoạt động bán hàng và quản lý.

• Định nghĩa và Phân cấp Tổ chức: Cho phép tạo, chỉnh sửa và phân cấp các đơn vị tổ chức (ví dụ: Công ty Mẹ, Chi nhánh, Cửa hàng, Kho) trong hệ thống.
• Quản lý Vùng và Khu vực: Gán đơn vị tổ chức cho các khu vực địa lý cụ thể để hỗ trợ phân phối, quản lý bán hàng và báo cáo theo địa điểm.

4.2 Quản lý Merchant

Mô tả: Chức năng này tập trung vào đăng ký, quản lý hồ sơ và duy trì quan hệ đối tác với các Merchant (người bán/đơn vị kinh doanh) tham gia hệ thống POS hoặc nền tảng bán hàng.

• Hồ sơ Merchant: Quản lý thông tin chi tiết Merchant, bao gồm thông tin pháp lý, thông tin liên hệ và tài liệu liên quan đến hợp đồng.
• Thiết lập Tài chính & Chiết khấu: Định nghĩa điều khoản thanh toán, tỷ lệ chiết khấu áp dụng và cấu hình thông tin tài khoản ngân hàng.
• Trạng thái và Kích hoạt: Quản lý trạng thái hoạt động của Merchant (hoạt động, tạm ngưng, khóa).

4.3 Quản lý Sản phẩm

Tham khảo Đối thủ: KiotViet 85%, Haravan 90%, CukCuk 70%

Mô tả: Chịu trách nhiệm quản lý toàn bộ vòng đời thông tin sản phẩm, từ tạo sản phẩm mới, định nghĩa thuộc tính, đến cập nhật giá và trạng thái bán trên các kênh khác nhau.

• Định nghĩa Sản phẩm: Cho phép nhập và chỉnh sửa thông tin sản phẩm cơ bản (SKU, tên, mô tả, hình ảnh) và quản lý biến thể sản phẩm (ví dụ: kích cỡ, màu sắc).
• Quản lý Giá và Thuế: Thiết lập giá tiêu chuẩn và khuyến mãi, và cấu hình thuế suất cho từng sản phẩm hoặc danh mục sản phẩm.
• Cấu hình Kênh Bán: Định nghĩa sản phẩm nào được phép hiển thị và bán trên các kênh khác nhau (ví dụ: POS, Kênh Web).

Tính năng	KiotViet	Haravan	CukCuk	Mục tiêu
Thông tin sản phẩm cơ bản	✅	✅	✅	✅
Biến thể (kích cỡ/màu sắc)	✅	✅	⚠️	✅
Hình ảnh sản phẩm	✅	✅	✅	✅
Mã vạch/SKU	✅	✅	✅	✅
Nhiều bảng giá	✅	✅	⚠️	✅
Cấu hình thuế	✅	✅	✅	✅
Gán kênh	⚠️	✅	⚠️	✅
Nhập/xuất hàng loạt	✅	✅	⚠️	✅

4.4 Quản lý Danh mục

Mô tả: Cung cấp khả năng tổ chức và phân loại sản phẩm một cách logic thông qua việc tạo và quản lý danh mục và danh mục con.

• Cấu trúc Danh mục: Cho phép tạo, chỉnh sửa và quản lý hệ thống phân cấp danh mục sản phẩm (danh mục cha và con).
• Phân loại Sản phẩm: Gán sản phẩm vào một hoặc nhiều danh mục liên quan.
• Quản lý Thuộc tính Danh mục: Thiết lập thuộc tính và bộ lọc riêng cho từng danh mục.

4.5 Quản lý Kho

Tham khảo Đối thủ: KiotViet 85%, Haravan 90%, CukCuk 70%

Mô tả: Chức năng này chịu trách nhiệm theo dõi số lượng tồn kho thời gian thực tại các vị trí lưu trữ (kho, cửa hàng).

• Theo dõi Tồn kho theo Địa điểm: Theo dõi số lượng tồn kho chính xác cho từng SKU tại các kho hoặc điểm bán hàng khác nhau.
• Điều chỉnh & Kiểm kê: Hỗ trợ điều chỉnh tồn kho thủ công (ví dụ: mất mát, hư hỏng) và quy trình kiểm kê định kỳ.
• Cảnh báo Tồn kho: Thiết lập ngưỡng cảnh báo tự động khi số lượng tồn kho đạt mức tối thiểu hoặc tối đa.

Tính năng	KiotViet	Haravan	CukCuk	Mục tiêu
Theo dõi đa địa điểm	✅	✅	⚠️	✅
Điều chỉnh tồn kho	✅	✅	✅	✅
Kiểm kê	✅	✅	⚠️	✅
Cảnh báo tồn kho thấp	✅	✅	⚠️	✅
Chuyển kho	✅	✅	⚠️	✅
Theo dõi lô/batch	⚠️	✅	❌	✅
Theo dõi hạn sử dụng	⚠️	⚠️	⚠️	✅
Kho offline	⚠️	⚠️	⚠️	✅

4.6 Hệ thống Giá & Biểu phí

Trạng thái Triển khai

Package: @nx/pricing (tách từ @nx/commerce thành dịch vụ độc lập)

• 9 controller: Promotions, PromotionMethods, Rules, Fares, FareSets, Costs, Taxes, TaxSets, TaxTypes
• 7 service: 4 tính toán + 3 quản lý
• Engine Rule đa hình (thuộc về Fare, Promotion, hoặc PromotionMethod)
• Xem Dịch vụ Pricing để biết chi tiết kỹ thuật.

Mô tả: Engine giá linh hoạt hỗ trợ nhiều bảng giá, quy tắc động, theo dõi chi phí và chiết khấu khuyến mãi.

• Nhiều Bảng giá: Tạo bảng giá riêng cho bán lẻ, bán sỉ, VIP, chiết khấu nhân viên hoặc giá theo kênh cụ thể
• Bộ Biểu phí: Nhóm các giá liên quan (ví dụ: "Happy Hour", "Cuối tuần Đặc biệt") để dễ dàng kích hoạt/vô hiệu hóa
• Quy tắc Giá: Giá có điều kiện dựa trên mức số lượng, phân khúc khách hàng, thời gian trong ngày hoặc địa điểm
• Theo dõi Chi phí: Ghi nhận chi phí sản phẩm từ đơn mua hàng; tính biên lợi nhuận thời gian thực theo sản phẩm
• Lên lịch Giá: Thiết lập thay đổi giá tương lai tự động kích hoạt vào ngày chỉ định
• Lịch sử Giá: Dấu vết kiểm toán đầy đủ cho tất cả thay đổi giá với dấu thời gian và quy kết người dùng
• Tiền tệ & Làm tròn: Xử lý VND với quy tắc làm tròn có thể cấu hình (làm tròn đến 100/500/1000 gần nhất)

4.6.1 Engine Khuyến mãi - MỚI

Đã Triển khai

Hoạt động đầy đủ trong @nx/pricing với REST API.

Mô tả: Hệ thống chiến dịch chiết khấu với các phương thức cấu hình và quy tắc có điều kiện cho khuyến mãi có mục tiêu.

• Loại Khuyến mãi: Chiết khấu tiêu chuẩn (STANDARD) và mua-X-tặng-Y (BUY_GET)
• Vòng đời Khuyến mãi: DRAFT → ACTIVATED → DEACTIVATED / EXPIRED → ARCHIVED
• Phương thức Khuyến mãi: Chiết khấu số tiền cố định (FIXED) hoặc phần trăm (PERCENTAGE) nhắm vào mặt hàng, tổng đơn hàng hoặc vận chuyển
• Phương thức Phân bổ: Áp dụng chiết khấu cho mỗi mặt hàng đủ điều kiện (EACH), phân bổ qua các mặt hàng (ACROSS), hoặc áp dụng một lần (ONCE)
• Quy tắc Đa hình: Logic có điều kiện (thời gian, số lượng, kênh, tùy chỉnh) có thể gắn vào Fare, Promotion hoặc PromotionMethod
• Kích hoạt theo Thời gian: Lên lịch khuyến mãi với dấu thời gian bắt đầu/kết thúc để tự động kích hoạt/hết hạn

Tính năng	Kế hoạch	Đã Triển khai
Bộ Biểu phí & Biểu phí	✅	✅
Quy tắc Có điều kiện (thời gian/số lượng/kênh)	✅	✅
Theo dõi Chi phí	✅	✅
Quản lý Thuế	✅	✅
Khuyến mãi (Tiêu chuẩn)	✅	✅
Khuyến mãi (Mua X Tặng Y)	✅	✅
Phương thức Khuyến mãi (Cố định/Phần trăm)	✅	✅
Lên lịch Giá	✅	Kế hoạch
Lịch sử Giá / Dấu vết Kiểm toán	✅	Kế hoạch

4.7 Công cụ Tìm kiếm

Phát hành: R2 (Cơ bản) / R3 (Nâng cao)

Mô tả: Tìm kiếm nhanh, chịu lỗi chính tả được hỗ trợ bởi Typesense cho tra cứu sản phẩm tức thì, quét mã vạch và tìm kiếm toàn cục.

• Tìm kiếm Tức thì: Thời gian phản hồi dưới 50ms với gợi ý tự động khi người dùng gõ
• Khớp Mờ: Chịu lỗi chính tả và sai chính tả (ví dụ: "cofee" tìm thấy "coffee")
• Tìm kiếm Đa Bộ sưu tập: Tìm kiếm trên sản phẩm, danh mục, khách hàng và đơn hàng từ một truy vấn duy nhất
• Tra cứu Mã vạch/SKU: Tra cứu khớp chính xác tức thì cho đầu vào máy quét mã vạch
• Bộ lọc Facet: Lọc kết quả theo danh mục, khoảng giá, trạng thái tồn kho, thương hiệu
• Từ đồng nghĩa: Cấu hình từ đồng nghĩa sản phẩm (ví dụ: "soda" = "soft drink" = "nước ngọt")
• Phân tích Tìm kiếm: Theo dõi tìm kiếm phổ biến, truy vấn không có kết quả để cải thiện danh mục
• Đánh chỉ mục Thời gian thực: Thay đổi sản phẩm được phản ánh trong tìm kiếm trong vài giây qua change data capture

4.8 Email Giao dịch

Phát hành: R2

Mô tả: Khả năng email tự động để hỗ trợ các chức năng kinh doanh cốt lõi như thông báo giao dịch và xác nhận đơn hàng.

Lưu ý: Đã hợp nhất vào Hệ thống Thông báo thống nhất (2.5). Phần này được giữ lại để tương thích ngược.

4.9 Tích hợp Bên ngoài

Phát hành: R1 (Hóa đơn điện tử) + R2 (Còn lại)

4.9.1 Tích hợp Hóa đơn Điện tử - Nghị định 70/2025 (QUAN TRỌNG)

Phát hành: R1 (MVP) | Ưu tiên: BẮT BUỘC - Yêu cầu Pháp quy

Tham khảo Đối thủ: Tất cả đối thủ đều tuân thủ - đây là yêu cầu cơ bản

Đối thủ	Hóa đơn ĐT	Nhà cung cấp	Ghi chú
KiotViet	✅	VNPT, Viettel	Chương trình giảm giá 30%
Haravan	✅	VNPT, FPT	Nhiều tùy chọn
CukCuk	✅	MISA meInvoice	Tích hợp MISA gốc
iPOS	⚠️	Đa dạng	Đã chứng nhận
MISA	✅	meInvoice	Nhà cung cấp riêng

Mô tả: Xây dựng API/kết nối để tự động truyền dữ liệu giao dịch đến hệ thống hóa đơn điện tử bên ngoài (nhà cung cấp T-VAN) để phát hành hóa đơn theo quy định Nghị định 70/2025.

Triển khai:

• Tích hợp Chính: VNPAY Invoice - Tận dụng hệ sinh thái VNPAY cho luồng thanh toán-đến-hóa đơn liền mạch
• Tích hợp với 2+ nhà cung cấp T-VAN (Chính: VNPAY Invoice, Dự phòng: VNPT, MISA meInvoice)
• Tự động tạo hóa đơn điện tử khi hoàn tất giao dịch
• Tải lên hàng loạt cho giao dịch offline khi trực tuyến trở lại
• Tra cứu và xác thực mã số thuế
• Luồng hủy và điều chỉnh hóa đơn
• Lưu trữ và truy xuất theo yêu cầu cơ quan thuế

Tính năng Quản lý Hóa đơn (Điểm khác biệt):

• Theo dõi Hóa đơn Thời gian thực - Hiển thị tức thì trạng thái hóa đơn trong ứng dụng
• Dashboard Thống nhất - Trạng thái thanh toán + hóa đơn trong một giao diện
• Tự động Đối soát - Không cần khớp thủ công giữa thanh toán và hóa đơn
• Điều chỉnh Một chạm - Một thao tác cập nhật cả bản ghi thanh toán và hóa đơn
• Dấu vết Kiểm toán Hoàn chỉnh - Toàn bộ lịch sử giao dịch-đến-hóa đơn trong một nơi

Khả năng	Đối thủ	Giải pháp Của chúng tôi
Luồng Thanh toán-đến-Hóa đơn	Hệ thống riêng biệt, đối soát thủ công	Luồng tự động thống nhất
Theo dõi Hóa đơn	Chậm trễ, qua cổng T-VAN bên thứ ba	Thời gian thực, hiển thị trong ứng dụng
Đối soát	Yêu cầu khớp thủ công	Tự động khớp, không tốn công sức

Lợi thế VNPAY Invoice: Đối thủ tích hợp với nhà cung cấp T-VAN bên ngoài (VNPT, Viettel, MISA meInvoice), tạo ra luồng công việc rời rạc. Tích hợp VNPAY Invoice của chúng tôi cho phép tạo hóa đơn tức thì, theo dõi thời gian thực và đối soát tự động - tất cả trong một nền tảng duy nhất.

4.9.2 Tích hợp Dịch vụ Vận chuyển

Phát hành: R3

Mô tả: Kết nối với đối tác giao hàng (Logistics) để tự động tạo đơn vận chuyển, theo dõi trạng thái giao hàng.

Đối tác Giao hàng	Ưu tiên	Ghi chú
GrabExpress	Cao	Phổ biến nhất
Giao Hàng Nhanh	Cao	Phổ biến
Giao Hàng Tiết Kiệm	Trung bình	Tùy chọn tiết kiệm
Viettel Post	Trung bình	Phủ sóng rộng

4.9.3 Tích hợp Kế toán

Phát hành: R2

Mô tả: Kết nối với hệ thống kế toán để xuất dữ liệu tài chính.

Hệ thống Kế toán	Ưu tiên
MISA	Cao
Fast Accounting	Trung bình
Xuất chung (Excel)	Cao

4.10 Quản lý Tài chính

Phát hành: R2

Tham khảo Đối thủ: MISA dẫn đầu với tích hợp kế toán

Mô tả: Quản lý và ghi nhận dữ liệu tài chính cốt lõi phát sinh từ bán hàng, thanh toán và chi phí.

• Ghi nhận Doanh thu: Tự động ghi nhận và phân loại doanh thu từ các giao dịch bán hàng hoàn tất.
• Đối soát Thanh toán: Đối chiếu dữ liệu giao dịch với báo cáo từ cổng thanh toán (VNPAY) hoặc ngân hàng.
• Quản lý Dữ liệu Kế toán: Chuẩn hóa và tổng hợp bút toán tài chính để xuất sang hệ thống kế toán.

4.11 BOM - Định mức Nguyên vật liệu

Phát hành: R1 (MVP) | Ưu tiên: Bắt buộc cho F&B

Tham khảo Đối thủ: CukCuk dẫn đầu về BOM F&B

Tính năng	KiotViet	Haravan	CukCuk	MISA	Mục tiêu
Tạo công thức/BOM	❌	⚠️	✅	⚠️	✅
Danh sách nguyên liệu	❌	⚠️	✅	⚠️	✅
Sản lượng/khẩu phần	❌	⚠️	✅	⚠️	✅
Tự động trừ kho	❌	⚠️	✅	⚠️	✅
Tính giá thành	❌	⚠️	✅	⚠️	✅
BOM đơn cấp	❌	⚠️	✅	⚠️	✅
BOM đa cấp	❌	❌	⚠️	⚠️	✅ (vượt đối thủ)
Theo dõi % chi phí thực phẩm	❌	❌	⚠️	⚠️	✅

Mô tả: Quản lý công thức hoặc danh sách thành phần (nguyên liệu, bán thành phẩm) cần thiết để sản xuất hoặc lắp ráp một đơn vị sản phẩm cuối cùng.

• Định nghĩa Cấu trúc BOM: Tạo và duy trì công thức sản phẩm đa cấp, chỉ định số lượng và loại nguyên liệu cho từng sản phẩm cuối.
• Tính Giá thành Sản xuất: Tự động tổng hợp chi phí tất cả thành phần để xác định giá vốn hàng bán (COGS) của sản phẩm cuối.
• Quản lý Tồn kho Thành phần: Tính toán nhu cầu nguyên liệu (MRP) dựa trên BOM và dự báo đơn hàng.

4.12 Quản lý Bàn & Mặt bằng - MỚI

Phát hành: R1 (MVP) | Ưu tiên: Bắt buộc cho F&B

Tham khảo Đối thủ: CukCuk ✅, iPOS ✅, KiotViet ⚠️, Haravan ❌

Tính năng	CukCuk	iPOS	KiotViet	Mục tiêu
Sơ đồ mặt bằng trực quan	✅	✅	⚠️	✅
Kéo-thả định vị	✅	⚠️	❌	✅
Gộp bàn	✅	✅	❌	✅
Tách bàn	✅	✅	❌	✅
Chỉ báo trạng thái	✅	✅	⚠️	✅
Tích hợp đặt chỗ	⚠️	✅	❌	✅ (vượt CukCuk)
Mặt hàng mặc định khi mở bàn	✅	⚠️	❌	✅
Nhiều tầng/khu vực	⚠️	✅	❌	✅

Mô tả: Cung cấp công cụ để thiết lập và quản lý sơ đồ mặt bằng nhà hàng với bố cục bàn trực quan, theo dõi trạng thái thời gian thực và các thao tác bàn.

• Thiết kế Sơ đồ Mặt bằng: Giao diện kéo-thả trực quan để tạo và sắp xếp bố cục bàn theo khu vực/tầng
• Quản lý Trạng thái Bàn: Chỉ báo trạng thái thời gian thực (Trống, Có khách, Đã đặt, Đang dọn, Bị chặn)
• Thao tác Bàn: Gộp bàn cho nhóm lớn, tách bàn cho hóa đơn riêng
• Liên kết Đơn hàng: Liên kết đơn hàng với bàn cụ thể, chuyển đơn hàng giữa các bàn
• Mặt hàng Mặc định: Tự động thêm mặt hàng (nước, phí dịch vụ) khi mở bàn
• Quản lý Sức chứa: Theo dõi số khách, thời gian quay vòng và tỷ lệ sử dụng bàn

4.13 Hệ thống Hiển thị Bếp - KDS - MỚI

Phát hành: R1 (MVP) | Ưu tiên: Bắt buộc cho F&B

Tham khảo Đối thủ: CukCuk ✅, iPOS ✅, các đối thủ khác ❌

Tính năng	CukCuk	iPOS	KiotViet	Mục tiêu
Hiển thị bếp	✅	✅	❌	✅
Hàng đợi đơn hàng	✅	✅	❌	✅
Định tuyến trạm	⚠️	⚠️	❌	✅ (cải thiện)
Theo dõi thời gian chuẩn bị	⚠️	⚠️	❌	✅ (cải thiện)
Hoàn thành đơn	✅	✅	❌	✅
Đánh dấu ưu tiên	✅	⚠️	❌	✅
Thu hồi đơn	✅	✅	❌	✅
Thông báo thay đổi	✅	✅	❌	✅
Mã màu theo thời gian	⚠️	⚠️	❌	✅

Mô tả: Hệ thống hiển thị kỹ thuật số cho nhân viên bếp xem và quản lý đơn hàng đến, cải thiện hiệu quả bếp và độ chính xác đơn hàng.

• Hiển thị Hàng đợi Đơn hàng: Hiển thị đơn hàng đến theo thứ tự thời gian với chi tiết mặt hàng
• Định tuyến Trạm: Định tuyến mặt hàng đến trạm phù hợp (nướng, bar, chế biến lạnh, v.v.)
• Theo dõi Thời gian Chuẩn bị: Theo dõi thời gian từ đặt đến hoàn thành, đánh dấu đơn chậm trễ
• Hoàn thành Đơn: Đánh dấu mặt hàng/đơn hàng đã hoàn thành, thông báo quầy phục vụ
• Đơn Ưu tiên: Đánh dấu trực quan cho đơn gấp, bàn VIP
• Chức năng Thu hồi: Gọi lại đơn đã hoàn thành nếu cần
• Mã Màu: Xanh lá (mới) → Vàng (đang chờ) → Đỏ (quá hạn)
• Tích hợp Máy in Bếp: In phiếu làm bản sao lưu/bổ sung cho màn hình

4.14 Đặt hàng QR tại Bàn - MỚI

Phát hành: R3 | Ưu tiên: Nên có

Tham khảo Đối thủ: CukCuk ✅, iPOS ⚠️, các đối thủ khác ❌

Tính năng	CukCuk	iPOS	Haravan	Mục tiêu
Mã QR theo bàn	✅	⚠️	⚠️	✅
Quét để xem menu	✅	⚠️	⚠️	✅
Đặt hàng từ điện thoại	✅	⚠️	⚠️	✅
Thêm vào đơn đang mở	✅	✅	❌	✅
Thanh toán từ điện thoại	⚠️	⚠️	⚠️	✅
Gọi phục vụ	⚠️	⚠️	❌	✅ (cải thiện)
Yêu cầu thanh toán	⚠️	⚠️	❌	✅ (cải thiện)

Mô tả: Cho phép khách hàng quét mã QR tại bàn để xem menu, đặt hàng và yêu cầu dịch vụ mà không cần nhân viên phục vụ.

• Tạo QR: Mã QR duy nhất cho mỗi bàn, có thể tạo lại
• Menu Kỹ thuật số: Menu tối ưu cho di động với hình ảnh, mô tả, giá
• Tự Đặt hàng: Thêm mặt hàng vào đơn, tùy chỉnh (modifier), gửi đến bếp
• Thêm vào Đơn Đang mở: Thêm mặt hàng vào đơn hàng đang mở cho bàn
• Yêu cầu Dịch vụ: Gọi phục vụ, yêu cầu hóa đơn, yêu cầu hỗ trợ
• Tùy chọn Thanh toán: Tùy chọn thanh toán qua QR (liên kết cổng thanh toán)

5. Hệ thống Mua hàng

Phát hành: R1 (MVP) | Ưu tiên: Bắt buộc

Trạng thái Triển khai

Package: @nx/sale | Framework: IGNIS (Hono + Drizzle ORM)

• Vòng đời SaleOrder: DRAFT → PROCESSING → COMPLETED / PARTIAL / CANCELLED
• CheckoutService với khả năng xác thực và hoàn tác
• PaymentWebhookService cho tích hợp VNPAY (thành công, thất bại, hết hạn, hủy)
• Sự kiện WebSocket thời gian thực qua Redis pub/sub → dịch vụ Signal
• Xem Dịch vụ Sale để biết chi tiết kỹ thuật.

5.1 Quản lý Giỏ hàng

Mô tả: Quản lý tất cả hoạt động liên quan đến giỏ hàng của khách hàng, đảm bảo trải nghiệm mua sắm mượt mà.

• Thêm/Xóa/Cập nhật Sản phẩm: Cho phép người dùng thêm sản phẩm, điều chỉnh số lượng hoặc xóa mặt hàng.
• Lưu trữ Giỏ hàng: Đảm bảo giỏ hàng được lưu liên tục qua các phiên và thiết bị.
• Áp dụng Khuyến mãi Sơ bộ: Tính toán chiết khấu và voucher sơ bộ trước khi thanh toán.

5.2 Quản lý Đơn hàng

Tham khảo Đối thủ: Tất cả đối thủ đều có quản lý đơn hàng cơ bản

Mô tả: Quản lý toàn bộ vòng đời đơn hàng, từ tạo qua xử lý đến hoàn thành.

• Tạo và Cập nhật Đơn hàng: Chuyển đổi giỏ hàng thành đơn hàng, cho phép cập nhật trước khi xác nhận.
• Quản lý Trạng thái Đơn hàng: Theo dõi vòng đời trạng thái: DRAFT → PROCESSING (thanh toán) → COMPLETED (thanh toán đầy đủ) / PARTIAL (thanh toán một phần) / CANCELLED (thủ công, thanh toán thất bại/hết hạn/bị hủy).
• Xử lý Hoàn tiền và Hủy đơn: Xử lý luồng hủy và hoàn tiền.

Tính năng	KiotViet	CukCuk	iPOS	Mục tiêu
Tạo đơn hàng	✅	✅	✅	✅
Theo dõi trạng thái	✅	✅	✅	✅
Sửa đơn hàng	✅	✅	✅	✅
Hoàn thành một phần	⚠️	✅	✅	✅
Hoàn tiền	✅	✅	✅	✅
Ghi chú đơn hàng	✅	✅	✅	✅
Tách hóa đơn	⚠️	✅	✅	✅
Gộp đơn hàng	❌	✅	✅	✅

5.3 Quản lý Thanh toán

Mô tả: Điều phối xử lý thanh toán cho đơn hàng, tương tác với cổng thanh toán (đặc biệt là VNPAY).

• Khởi tạo Giao dịch: Tạo yêu cầu thanh toán và chuyển hướng đến cổng thanh toán.
• Xác nhận Kết quả Thanh toán: Nhận và xử lý phản hồi (callback) từ cổng thanh toán.
• Quản lý Phương thức Thanh toán: Cho phép khách hàng chọn và lưu phương thức thanh toán.

5.4 Quản lý Giao dịch

Mô tả: Quản lý chi tiết tất cả giao dịch phát sinh từ đơn hàng và thanh toán.

• Ghi nhận Giao dịch Chi tiết: Ghi lại tất cả giao dịch tài chính với đầy đủ chi tiết.
• Tra cứu và Báo cáo Giao dịch: Công cụ tìm kiếm và báo cáo mạnh mẽ.
• Theo dõi Trạng thái Thanh toán/Hoàn tiền: Đồng bộ trạng thái chính xác với trạng thái đơn hàng.

5.5 Thông báo Mua hàng

Phát hành: R2

Lưu ý: Đã hợp nhất vào Hệ thống Thông báo thống nhất (2.5).

6. Hệ thống Marketing

Phát hành: R3 | Ưu tiên: Nên có (Có thể có cho gói Miễn phí)

Triển khai Một phần

Engine Khuyến mãi hiện đã được triển khai trong @nx/pricing (xem Mục 4.6.1), cung cấp nền tảng cho chức năng voucher và chiết khấu. Các loại khuyến mãi (Tiêu chuẩn, Mua X Tặng Y) với phương thức chiết khấu cố định/phần trăm đang hoạt động. Quản lý chiến dịch marketing đầy đủ, chương trình khách hàng thân thiết và chiến dịch email vẫn được lên kế hoạch cho R3.

Tham khảo Đối thủ: Haravan dẫn đầu (80%), KiotViet (70%)

6.1 Hệ thống Voucher

Tính năng	KiotViet	Haravan	CukCuk	Mục tiêu
Chiết khấu cố định	✅	✅	✅	✅
Chiết khấu phần trăm	✅	✅	✅	✅
Miễn phí vận chuyển	⚠️	✅	❌	✅
Mua X Tặng Y	✅	✅	⚠️	✅
Giới hạn sử dụng	✅	✅	⚠️	✅
Ngày hết hạn	✅	✅	✅	✅
Giới hạn sản phẩm	✅	✅	⚠️	✅
Giới hạn khách hàng	⚠️	✅	⚠️	✅
Theo dõi sử dụng	✅	✅	⚠️	✅

Mô tả: Quản lý toàn bộ vòng đời của khuyến mãi dựa trên voucher/mã giảm giá.

• Tạo và Quản lý Voucher: Thiết lập các loại khác nhau (cố định, phần trăm, miễn phí vận chuyển) với quy tắc.
• Áp dụng và Xác thực: Xử lý nhập mã, kiểm tra tính hợp lệ, tính chiết khấu.
• Theo dõi và Báo cáo: Báo cáo về tỷ lệ sử dụng, hiệu quả của chiến dịch.

6.2 Hệ thống Khách hàng Thân thiết

Tham khảo Đối thủ: Haravan dẫn đầu với chương trình thân thiết phân hạng

Tính năng	KiotViet	Haravan	CukCuk	Mục tiêu
Tích điểm	⚠️	✅	⚠️	✅
Đổi điểm	⚠️	✅	⚠️	✅
Hạng thành viên	❌	✅	⚠️	✅
Tự động nâng hạng	❌	✅	❌	✅
Quyền lợi theo hạng	❌	✅	⚠️	✅
Thưởng sinh nhật	⚠️	✅	⚠️	✅
Hết hạn điểm	⚠️	✅	❌	✅

Mô tả: Quản lý chương trình khách hàng thân thiết với điểm thưởng, phân hạng và ưu đãi độc quyền.

• Tích lũy và Đổi Điểm: Thiết lập quy tắc tích và sử dụng điểm.
• Quản lý Hạng Thành viên: Định nghĩa các cấp (Đồng, Bạc, Vàng) với tự động nâng/hạ hạng.
• Ưu đãi Độc quyền: Ưu đãi đặc biệt cho từng hạng thành viên cụ thể.

6.3 Email Marketing

Phát hành: R3

Lưu ý: Đã hợp nhất vào Hệ thống Thông báo thống nhất (2.5) với khả năng chiến dịch.

7. API Gateway

Phát hành: R3 | Ưu tiên: Nên có (Tập trung Enterprise)

Bao gồm: API GW - Hệ thống Nội bộ, API GW - Kênh WEB, API GW - Kênh POS

7.1 Cổng Cân bằng Tải

Mô tả: Chịu trách nhiệm phân phối lưu lượng mạng hiệu quả đến các server và dịch vụ backend khác nhau.

• Phân phối Yêu cầu: Sử dụng thuật toán cân bằng tải (Round Robin, Least Connections).
• Đảm bảo Khả dụng: Kiểm tra sức khỏe liên tục, tự động chuyển đổi dự phòng.
• Xử lý Lưu lượng Cao: Xử lý đột biến lưu lượng bất ngờ.
• Giới hạn Tần suất: Bảo vệ hệ thống khỏi DDoS và lạm dụng tài nguyên.
• Ghi log: Ghi lại tất cả yêu cầu và phản hồi để giám sát.

Lưu ý: Cho MVP/R1, sử dụng reverse proxy đơn giản. API gateway đầy đủ hoãn đến R3 khi có yêu cầu mở rộng.

8. Cổng Quản trị (BO)

Phát hành: R2 | Ưu tiên: Nên có

Bao gồm: BO - Hệ thống Nội bộ, BO - Kênh WEB, BO - Kênh POS

Trạng thái Triển khai

Hai ứng dụng Back Office hiện đã được triển khai:

• Back Office (Client) — @nx-app/client (cổng 3001) — Dashboard quản trị chung cho quản lý/chủ sở hữu
• Back Office (Merchant) — @nx-app/bo (cổng 3000) — Dashboard B2B dành cho merchant phục vụ vận hành cửa hàng, khách hàng, tài chính, đơn mua hàng và nhà cung cấp

Cả hai dùng chung thư viện @nx-app/core và @nx-app/ui-kit. Ngăn xếp: React 19 + Vite + Tailwind CSS + React Admin + Redux Toolkit. Xem Tổng quan Ứng dụng và Back Office (Merchant) để biết chi tiết kỹ thuật.

8.1 Dashboard

Mô tả: Màn hình chính tùy chỉnh với KPI thời gian thực, biểu đồ và widget hành động nhanh để giám sát kinh doanh.

• Thẻ KPI: Doanh thu, đơn hàng, trung bình hóa đơn, sản phẩm bán chạy - tất cả cập nhật thời gian thực
• Bộ chọn Khoảng thời gian: Xem hôm nay, tuần này, tháng này hoặc khoảng ngày tùy chỉnh
• Chế độ So sánh: Bật hiển thị % thay đổi so với kỳ trước hoặc cùng kỳ năm trước
• Widget Biểu đồ: Biểu đồ đường cho xu hướng, biểu đồ cột cho so sánh, biểu đồ tròn cho phân bổ
• Bố cục Kéo-Thả: Sắp xếp widget để cá nhân hóa dashboard theo tùy chọn người dùng
• Xem Đa Địa điểm: Tổng hợp tất cả địa điểm hoặc chi tiết theo cửa hàng/thiết bị cụ thể
• Bảng Cảnh báo: Hiển thị cảnh báo tồn kho thấp, đơn hàng chờ xử lý và thông báo hệ thống

8.2 Quản lý Người dùng

Mô tả: Quản trị người dùng đầy đủ bao gồm tạo, chỉnh sửa hồ sơ, kiểm soát trạng thái và gán vai trò.

• Danh mục Người dùng: Danh sách có thể tìm kiếm với bộ lọc theo vai trò, trạng thái và gán địa điểm
• Tạo Người dùng: Thêm người dùng mới với chi tiết hồ sơ; gửi email kích hoạt để thiết lập mật khẩu
• Nhập Hàng loạt: Tải CSV để tạo nhiều người dùng cùng lúc cho khai trương cửa hàng mới
• Hành động Trạng thái: Kích hoạt, tạm ngưng hoặc vô hiệu hóa vĩnh viễn tài khoản người dùng
• Gán Vai trò: Gán vai trò cho người dùng; hỗ trợ nhiều vai trò mỗi người dùng
• Nhật ký Hoạt động: Xem lịch sử đăng nhập gần đây và hành động thực hiện bởi mỗi người dùng

8.3 Quản lý Vai trò

Mô tả: Định nghĩa và quản lý vai trò với gói quyền chi tiết kiểm soát truy cập tính năng và dữ liệu.

• Trình tạo Vai trò: Tạo vai trò tùy chỉnh bằng cách chọn quyền từ danh sách phân loại
• Xem trước Quyền: Xem chính xác mỗi vai trò có thể truy cập gì trước khi lưu
• Nhân bản Vai trò: Sao chép vai trò hiện có làm điểm bắt đầu cho biến thể mới
• Số Người dùng: Xem bao nhiêu người dùng được gán cho mỗi vai trò
• Vai trò Hệ thống: Xem (nhưng không chỉnh sửa) vai trò tích hợp như Owner và Admin
• Dấu vết Kiểm toán: Theo dõi khi vai trò được sửa đổi và bởi ai

8.4 Quản lý Tổ chức

Mô tả: Quản lý tài khoản merchant, địa điểm cửa hàng và phân cấp tổ chức.

• Hồ sơ Merchant: Tên doanh nghiệp, mã số thuế, địa chỉ, thông tin liên hệ, logo và tài liệu pháp lý
• Địa điểm Cửa hàng: Thêm/sửa địa điểm vật lý với địa chỉ, giờ hoạt động và chi tiết liên hệ
• Xem Phân cấp: Trực quan hóa cấu trúc tổ chức (Trụ sở → Vùng → Cửa hàng)
• Trạng thái Đăng ký: Xem gói hiện tại, giới hạn sử dụng và ngày gia hạn
• Thông tin Thanh toán: Quản lý phương thức thanh toán và xem lịch sử hóa đơn
• Xuất Dữ liệu: Xuất tất cả dữ liệu merchant để sao lưu hoặc di chuyển

8.5 Quản lý Thiết bị

Mô tả: Giám sát và kiểm soát tất cả thiết bị đầu cuối POS và thiết bị trên các địa điểm merchant.

• Danh sách Thiết bị: Xem tất cả thiết bị đã đăng ký với trạng thái (trực tuyến/ngoại tuyến), lần cuối thấy, phiên bản ứng dụng
• Chi tiết Thiết bị: Thông tin phần cứng, địa điểm gán, người dùng gán, ngày kích hoạt
• Hành động Từ xa: Buộc đồng bộ, đẩy cập nhật cấu hình, đăng xuất từ xa hoặc vô hiệu hóa thiết bị
• Cảnh báo Sức khỏe: Thông báo khi thiết bị ngoại tuyến hoặc phiên bản ứng dụng đã lỗi thời
• Mã Kích hoạt: Tạo mã PIN kích hoạt mới để ghép nối thiết bị
• Quản lý Giấy phép: Theo dõi số lượng thiết bị so với giới hạn đăng ký

8.6 Quản lý Sản phẩm

Mô tả: Quản lý danh mục sản phẩm toàn diện với biến thể, giá, hình ảnh và gán kênh bán.

• Danh sách Sản phẩm: Xem dạng lưới hoặc bảng với hành động hàng loạt (sửa, nhân bản, lưu trữ, xóa)
• Trình sửa Sản phẩm: Biểu mẫu đầy đủ cho tên, mô tả, SKU, mã vạch, hình ảnh và thuộc tính
• Quản lý Biến thể: Tạo biến thể kích cỡ/màu sắc/hương vị với SKU và giá riêng
• Gán Danh mục: Gán sản phẩm vào một hoặc nhiều danh mục; kéo để sắp xếp
• Tab Giá: Đặt giá gốc, giá vốn, giá so sánh; gán vào bảng giá
• Tab Kho: Xem/điều chỉnh mức tồn kho theo địa điểm; đặt ngưỡng tồn kho thấp
• Gán Kênh: Kiểm soát sản phẩm nào hiển thị trên POS, cửa hàng web hoặc địa điểm cụ thể
• Thao tác Hàng loạt: Nhập/xuất sản phẩm qua Excel; cập nhật giá hàng loạt

8.7 Quản lý Cung ứng

Mô tả: Quản lý đơn mua hàng, danh mục nhà cung cấp và luồng nhận hàng tồn kho.

• Danh mục Nhà cung cấp: Quản lý thông tin liên hệ nhà cung cấp, điều khoản thanh toán và lịch sử đặt hàng
• Đơn Mua hàng: Tạo PO với chi tiết mặt hàng, ngày giao dự kiến và luồng phê duyệt
• Nhận hàng: Nhận hàng tồn kho theo PO; xử lý nhận hàng một phần và chênh lệch
• Theo dõi Chi phí: Ghi nhận chi phí thực tế từ PO; tự động cập nhật trung bình giá vốn sản phẩm
• Chuyển Kho: Di chuyển hàng tồn kho giữa các địa điểm bằng lệnh chuyển kho
• Điều chỉnh Kho: Ghi nhận chỉnh sửa tồn kho cho hư hỏng, mất mát hoặc phát hiện kiểm toán
• Báo cáo: Lịch sử luân chuyển kho, trạng thái PO, phân tích hiệu suất nhà cung cấp

8.8 Quản lý Đơn Bán hàng

Mô tả: Giám sát đơn hàng, theo dõi hoàn thành và công cụ chăm sóc khách hàng để xử lý vấn đề.

• Danh sách Đơn hàng: Có thể lọc theo trạng thái, ngày, kênh, địa điểm, phương thức thanh toán hoặc khách hàng
• Chi tiết Đơn hàng: Xem mặt hàng, thông tin thanh toán, chi tiết khách hàng và trạng thái hoàn thành
• Cập nhật Trạng thái: Thay đổi trạng thái đơn hàng với thông báo khách hàng tùy chọn
• Hoàn tiền: Xử lý hoàn tiền toàn phần hoặc một phần với theo dõi lý do
• Ghi chú Đơn hàng: Ghi chú nội bộ cho nhân viên; ghi chú hiển thị cho khách hàng
• In/In lại: Tạo biên nhận, hóa đơn hoặc phiếu đóng gói
• Dòng thời gian Đơn hàng: Dấu vết kiểm toán hiển thị tất cả thay đổi trạng thái và hành động đã thực hiện

8.9 Quản lý Marketing

Phát hành: R3

Mô tả: Tạo chiến dịch, quản lý voucher và lên lịch khuyến mãi để thu hút khách hàng.

• Trình tạo Voucher: Tạo mã giảm giá với quy tắc (số tiền cố định, phần trăm, mua 1 tặng 1)
• Kiểm soát Sử dụng: Đặt giới hạn theo khách hàng, tổng giới hạn sử dụng và thời hạn hiệu lực
• Nhắm mục tiêu Sản phẩm: Áp dụng chiết khấu cho sản phẩm cụ thể, danh mục hoặc toàn bộ danh mục
• Nhắm mục tiêu Khách hàng: Giới hạn voucher cho phân khúc khách hàng (mới, VIP, sinh nhật)
• Lịch Chiến dịch: Dòng thời gian trực quan của tất cả khuyến mãi đang hoạt động và đã lên lịch
• Theo dõi Hiệu suất: Theo dõi tỷ lệ sử dụng, tác động doanh thu và ROI theo chiến dịch

8.10 Quản lý Khách hàng

Đã Triển khai (Backend)

CRUD khách hàng đã được triển khai trong @nx/identity qua CustomerController với quyền truy cập phạm vi merchant. Ứng dụng Back Office (Merchant) cung cấp giao diện frontend. Xem Mục 1.4 và API Quản lý Khách hàng.

Mô tả: Cơ sở dữ liệu khách hàng với lịch sử mua hàng, trạng thái thân thiết và công cụ giao tiếp.

• Danh mục Khách hàng: Tìm kiếm theo tên, điện thoại, email hoặc số thẻ thân thiết
• Hồ sơ Khách hàng: Thông tin liên hệ, địa chỉ, tùy chọn, thẻ và ghi chú
• Lịch sử Mua hàng: Tất cả đơn hàng với liên kết nhanh đến chi tiết đơn hàng
• Dashboard Thân thiết: Số dư điểm, trạng thái hạng, và lịch sử đổi điểm
• Nhật ký Giao tiếp: Ghi lại tất cả email, SMS và tương tác hỗ trợ
• Gộp Trùng lặp: Kết hợp hồ sơ khách hàng trùng lặp thành một hồ sơ duy nhất

8.11 Quản lý Trang

Phát hành: R3

Mô tả: Trình tạo trang trực quan để tạo và tùy chỉnh trang cửa hàng mà không cần lập trình.

• Mẫu Trang: Mẫu sẵn cho trang chủ, danh sách sản phẩm, giới thiệu, liên hệ
• Trình sửa Kéo-Thả: Thêm phần, sắp xếp lại khối, tùy chỉnh kiểu dáng
• Thư viện Thành phần: Banner, lưới sản phẩm, carousel, đánh giá, CTA
• Cài đặt SEO: Chỉnh sửa tiêu đề trang, mô tả meta và slug URL
• Chế độ Xem trước: Xem bản xem trước desktop và di động trước khi xuất bản
• Lịch sử Phiên bản: Khôi phục phiên bản trước nếu cần

8.12 Trợ lý AI

Phát hành: R4

Tham khảo Đối thủ: MISA có đặt hàng bằng giọng nói (2025); không đối thủ nào có AI phân tích

Mô tả: AI hội thoại cho truy vấn ngôn ngữ tự nhiên về dữ liệu kinh doanh, thông tin chi tiết và gợi ý.

• Truy vấn Ngôn ngữ Tự nhiên: Đặt câu hỏi như "Sản phẩm bán chạy nhất tuần này là gì?"
• Thông tin Chi tiết Dữ liệu: AI hiển thị xu hướng, bất thường và cơ hội mà không cần hỏi
• Tạo Báo cáo: "Tạo báo cáo bán hàng tháng trước" tạo ra báo cáo có thể tải về
• Gợi ý Dự đoán: "Bạn thường hết sữa vào thứ Sáu - đặt thêm nhé?"
• Hỗ trợ Giọng nói: Đầu vào giọng nói tùy chọn cho truy vấn rảnh tay trên thiết bị POS (R4+)
• Nhận biết Ngữ cảnh: AI hiểu giao diện hiện tại và có thể trả lời câu hỏi về dữ liệu đang hiển thị

9. Cổng Khách hàng

Phát hành: R3 | Ưu tiên: Nên có

9.1 Trang Chủ

Mô tả: Trang chủ cửa hàng hấp dẫn với khuyến mãi, sản phẩm nổi bật và gợi ý cá nhân hóa.

• Banner Chính: Banner khuyến mãi xoay vòng với liên kết đến chiến dịch hoặc danh mục
• Sản phẩm Nổi bật: Phần sản phẩm được chọn lọc (hàng mới, bán chạy, đang giảm giá)
• Điều hướng Danh mục: Thẻ danh mục trực quan để duyệt nhanh
• Thanh Tìm kiếm: Tìm kiếm nổi bật với tự động hoàn thành và tìm kiếm gần đây
• Cá nhân hóa: "Gợi ý cho bạn" dựa trên lịch sử duyệt web và mua hàng
• Hành động Nhanh: Nút thêm nhanh sản phẩm phổ biến cho khách hàng thường xuyên

9.2 Trang Sản phẩm

Mô tả: Danh mục sản phẩm với bộ lọc phong phú, sắp xếp và cuộn vô hạn cho trải nghiệm duyệt mượt mà.

• Lưới Sản phẩm: Lưới responsive với thumbnail, tên, giá và nút thêm nhanh
• Bộ lọc: Lọc theo danh mục, khoảng giá, thương hiệu, tình trạng còn hàng, đánh giá
• Tùy chọn Sắp xếp: Sắp xếp theo liên quan, giá (thấp/cao), mới nhất, bán chạy nhất
• Cuộn Vô hạn: Tự động tải thêm sản phẩm khi người dùng cuộn
• Xem Nhanh: Popup modal với chi tiết sản phẩm mà không rời khỏi danh sách
• So sánh: Chọn sản phẩm để so sánh thông số cạnh nhau

9.3 Trang Giỏ hàng

Mô tả: Giỏ hàng với quản lý mặt hàng, mã khuyến mãi và tóm tắt đơn hàng trước khi thanh toán.

• Mặt hàng Giỏ hàng: Hình ảnh sản phẩm, tên, biến thể, bộ chọn số lượng, tổng dòng
• Sửa Số lượng: Tăng/giảm hoặc xóa mặt hàng; cập nhật tổng tức thì
• Mã Khuyến mãi: Nhập mã giảm giá với xác thực và hiển thị chiết khấu áp dụng
• Tóm tắt Đơn hàng: Tạm tính, chiết khấu, ước tính vận chuyển, thuế và tổng cộng
• Cảnh báo Tồn kho: Thông báo nếu số lượng mặt hàng vượt quá tồn kho có sẵn
• Giỏ hàng Đã lưu: Giỏ hàng lưu liên tục qua các phiên và thiết bị cho người dùng đã đăng nhập

9.4 Trang Thanh toán

Mô tả: Luồng thanh toán gọn gàng với tùy chọn giao hàng, chọn phương thức thanh toán và xác nhận đơn hàng.

• Khách hoặc Đăng nhập: Cho phép thanh toán khách hoặc nhắc đăng nhập để đặt hàng nhanh hơn trong tương lai
• Địa chỉ Giao hàng: Biểu mẫu địa chỉ với xác thực; địa chỉ đã lưu cho khách hàng quay lại
• Tùy chọn Giao hàng: Chọn nhận tại cửa hàng, giao hàng tiêu chuẩn hoặc nhanh với ngày dự kiến
• Phương thức Thanh toán: Chọn từ thẻ đã lưu, VietQR, ví điện tử hoặc thanh toán khi nhận hàng
• Xem lại Đơn hàng: Tóm tắt cuối cùng với danh sách chi tiết và tất cả phí trước khi xác nhận
• Xác nhận: Trang thành công với mã đơn hàng, xác nhận email và liên kết theo dõi

9.5 Thanh toán Cổng VNPAY

Mô tả: Xử lý thanh toán an toàn với tích hợp VNPAY cho mã QR, thẻ và ví điện tử.

• Phương thức Thanh toán: VietQR, VNPAY QR, thẻ nội địa/quốc tế, ví điện tử
• Luồng Chuyển hướng: Chuyển hướng liền mạch đến trang thanh toán hosted VNPAY và quay lại
• Hiển thị QR: Tạo và hiển thị mã QR thanh toán cho thanh toán tại cửa hàng hoặc trực tuyến
• Callback Trạng thái: Cập nhật trạng thái thanh toán thời gian thực qua tích hợp webhook
• Xử lý Thử lại: Xử lý nhẹ nhàng thanh toán thất bại với tùy chọn thử lại
• Tạo Biên nhận: Tự động tạo biên nhận kỹ thuật số khi thanh toán thành công

9.6 Trang Khách hàng

Mô tả: Khu vực tài khoản khách hàng để quản lý hồ sơ, theo dõi đơn hàng và thông tin thân thiết.

• Cài đặt Hồ sơ: Chỉnh sửa tên, email, điện thoại, mật khẩu và tùy chọn thông báo
• Sổ Địa chỉ: Lưu nhiều địa chỉ giao hàng/thanh toán để thanh toán nhanh
• Lịch sử Đơn hàng: Danh sách đơn hàng trước với trạng thái, theo dõi và tùy chọn đặt lại
• Chi tiết Đơn hàng: Phân tích đơn hàng đầy đủ với tải hóa đơn và yêu cầu đổi trả
• Dashboard Thân thiết: Số dư điểm, trạng thái hạng, phần thưởng có sẵn và lịch sử
• Danh sách Yêu thích: Lưu sản phẩm để mua sau; nhận thông báo khi mặt hàng giảm giá

10. Tích hợp Trí tuệ Nhân tạo

Phát hành: R4 | Ưu tiên: Có thể có (Điểm khác biệt)

Tham khảo Đối thủ: Chỉ MISA có AI (đặt hàng giọng nói 2025); Khoảng trống cho phân tích dự đoán

10.1 Quản lý Cơ sở Tri thức

Mô tả: Quản lý và duy trì cơ sở tri thức kinh doanh cung cấp cho phản hồi và gợi ý AI.

• Nguồn Dữ liệu: Kết nối danh mục sản phẩm, lịch sử đơn hàng, kho và dữ liệu khách hàng với AI
• Quy tắc Kinh doanh: Định nghĩa quy tắc giá, chính sách đổi trả và FAQ để AI tham chiếu
• Dữ liệu Huấn luyện: Tải lên dữ liệu lịch sử cho dự báo nhu cầu và nhận dạng mẫu
• Cập nhật Tri thức: Đồng bộ thời gian thực đảm bảo AI luôn có thông tin sản phẩm và kho hiện tại
• Thuật ngữ Tùy chỉnh: Dạy AI các thuật ngữ chuyên ngành, biệt danh sản phẩm và viết tắt

10.2 Cơ chế Giao tiếp

Mô tả: Giao diện ngôn ngữ tự nhiên để tương tác với AI qua văn bản hoặc giọng nói trên tất cả điểm tiếp xúc.

• Giao diện Chat: Widget chat văn bản trong Cổng Quản trị và POS cho truy vấn nhanh
• Đầu vào Giọng nói: Chuyển đổi giọng nói sang văn bản cho tương tác rảnh tay trên thiết bị POS
• Đa Ngôn ngữ: Hỗ trợ tiếng Việt và tiếng Anh với phát hiện tự động
• Giữ Ngữ cảnh: AI nhớ ngữ cảnh hội thoại cho câu hỏi tiếp theo
• Hành động Gợi ý: AI đề xuất hành động có thể nhấp (xem báo cáo, tạo đơn hàng, điều chỉnh kho)
• Chuyển tiếp cho Người: Chuyển vấn đề phức tạp cho hỗ trợ nhân viên khi AI không thể giải quyết

10.3 Xác thực & Phân quyền AI

Mô tả: Kiểm soát dữ liệu và hành động AI có thể truy cập dựa trên quyền người dùng và rào cản an toàn.

• Ngữ cảnh Người dùng: AI kế thừa quyền của người dùng đang đăng nhập thực hiện yêu cầu
• Phạm vi Dữ liệu: AI chỉ truy cập dữ liệu trong phạm vi địa điểm và merchant được phép của người dùng
• Chế độ Chỉ đọc: Theo mặc định, AI có thể truy vấn nhưng không sửa đổi dữ liệu mà không có xác nhận rõ ràng
• Phê duyệt Hành động: Yêu cầu xác nhận người dùng trước khi AI thực hiện thao tác ghi
• Ghi log Kiểm toán: Tất cả truy vấn và hành động AI được ghi log với quy kết người dùng
• Giới hạn Tần suất: Ngăn sử dụng AI quá mức để kiểm soát chi phí và đảm bảo truy cập công bằng

10.4 Phân tích Dự đoán (MỚI) - Điểm Khác biệt Tương lai

Tham khảo Đối thủ: KHÔNG ĐỐI THỦ NÀO CÓ - cơ hội lớn

Mô tả: Dự đoán và gợi ý dựa trên AI để tối ưu hóa kinh doanh.

• Dự báo Doanh số: Dự đoán nhu cầu theo sản phẩm, ngày, thời gian
• Tối ưu Kho: Tự động gợi ý số lượng và thời điểm đặt hàng lại
• Kỹ thuật Menu: Xác định mặt hàng biên lợi nhuận cao so với lượng bán cao (F&B)
• Lên lịch Nhân viên: Dự đoán giờ cao điểm để bố trí nhân sự tối ưu
• Tối ưu Giá: Gợi ý giá động

Phụ lục A: Bảng tham chiếu nhanh Đối thủ cạnh tranh

Đối thủ	Điểm mạnh	Điểm yếu	Cơ hội Của chúng tôi
KiotViet	Nhiều merchant, giá phải chăng	UX cũ, F&B yếu	F&B tốt hơn + UX hiện đại
Haravan	Thương mại điện tử, đa kênh	Phức tạp, đắt, offline yếu	Đơn giản hơn + offline-first
CukCuk	Chuyên sâu F&B, KDS, quản lý bàn	Bán lẻ yếu, không thương mại điện tử	Bao phủ cả hai ngành dọc
iPOS	Vận hành nhà hàng	Phạm vi hẹp	F&B + bán lẻ rộng hơn
MISA	Kế toán, tuân thủ	UX cũ	UX hiện đại + tuân thủ

Phụ lục B: Ngăn xếp Công nghệ

Tầng	Công nghệ	Chi tiết
Ứng dụng POS	Tauri + React 19	Framework desktop dựa trên Rust; quét mã vạch/QR; tích hợp máy in; hỗ trợ offline
Cổng Quản trị	React 19 + Vite 6	React Router 7, Redux Toolkit, TailwindCSS 4, React Admin
Backend Framework	IGNIS 0.0.7-7 (Hono 4.11.3)	DI container, lớp cơ sở, xác thực JWT, chiến lược auth
Runtime	Bun	Runtime gốc TypeScript; Bun.password (Argon2id) cho hash
Cơ sở dữ liệu	PostgreSQL + Drizzle ORM 0.45.1	ORM type-safe với migration; cơ sở dữ liệu riêng cho mỗi microservice
Redis	Redis (5 instance/dịch vụ)	Cache, BullMQ, pub/sub publisher, pub/sub subscriber, WebSocket emitter
Hàng đợi	BullMQ + Redis	Xử lý tác vụ nền cho thanh toán, đồng bộ, sự kiện commerce
WebSocket	Signal Service + WebSocketEmitter	Redis pub/sub cho sự kiện thời gian thực; mã hóa ECDH E2E; định tuyến dựa trên room
Tìm kiếm	Typesense	Tìm kiếm dưới 50ms; khớp mờ; đánh chỉ mục thời gian thực qua Debezium CDC
Xác thực	Zod	Xác thực kiểu runtime cho yêu cầu/phản hồi API
Thành phần UI	shadcn/ui + Radix	Thư viện thành phần có thể truy cập, tùy chỉnh
Core Dùng chung	@nx/core	Schema cơ sở dữ liệu, tiện ích, lớp cơ sở dùng chung trên tất cả dịch vụ backend

Phụ lục C: Lịch sử Tài liệu

Phiên bản	Ngày	Thay đổi
0.1	Tháng 1 năm 2026	Đề xuất ban đầu
1.0	Tháng 1 năm 2026	Thêm: Lộ trình phát hành, Gói Freemium, Tính năng F&B (Bàn, KDS, QR), Offline-first, Tham khảo đối thủ
1.1	Tháng 1 năm 2026	Thêm: Tích hợp VNPAY Invoice, Hỗ trợ thanh toán PhonePOS (NFC), Tauri cho Mobile POS, Typesense từ MVP, Bun + Hono cho backend
1.2	Tháng 2 năm 2026	Cải thiện: Mô tả kỹ thuật chi tiết cho tất cả module phản ánh triển khai thực tế; Cập nhật ngăn xếp công nghệ khớp với codebase
1.3	Tháng 2 năm 2026	Thêm: Chú thích trạng thái triển khai xuyên suốt; Mục 1.4 mới Quản lý Khách hàng (triển khai trong @nx/identity); Mục 4.6.1 Engine Khuyến mãi (tách sang @nx/pricing); Trạng thái vòng đời đơn hàng dịch vụ Sale; Tham chiếu ứng dụng Back Office (Merchant) trong Mục 8; Cập nhật ngăn xếp công nghệ với IGNIS, Signal, kiến trúc Redis; Tham chiếu chéo đến tài liệu developer