Thiết bị Phase A In-progress
Tài liệu nghiệp vụ (BA)
UC — Use Case · SRS — Đặc tả yêu cầu · UI — Đặc tả giao diện
Thiết bị cho phép một sân đăng ký, giám sát và điều khiển các điểm cuối phần cứng và phần mềm vận hành NexPickle - máy POS, ứng dụng di động và web tại quầy - và kết nối các thiết bị ngoại vi như máy in hoá đơn nhiệt, máy quét mã vạch và VNPAY SoundBox. Chủ sân theo dõi thiết bị của mình; thu ngân vận hành chúng hằng ngày tại quầy.
1. Định danh
| Thuộc tính | Giá trị |
|---|---|
| Mã module | CORE-04 |
| Tier | Core |
| Trạng thái | In-progress |
| Phase | P1 (Ứng dụng + SoundBox), P2 (POS + thiết bị ngoại vi), P3 (SoftPOS / nâng cao) |
| Mức ưu tiên | HIGH |
| Người dùng chính | Chủ sân, Quản lý ca, Thu ngân |
2. Mục đích & Phạm vi
| Bao gồm | Loại trừ |
|---|---|
| Đăng ký thiết bị, vòng đời trạng thái, tìm kiếm | Đấu nối backend VNPAY Terminal (bảng đã có, API chưa kết nối) |
| Theo dõi thông tin phần cứng / phần mềm / bảo trì | Tích hợp máy in nhãn (Dự kiến) |
| Ứng dụng client cho di động, web và máy POS tại quầy | Máy POS Windows (Dự kiến) |
| Tích hợp thiết bị ngoại vi (máy in hoá đơn nhiệt, máy quét, SoundBox, SoftPOS, màn hình phụ) | Màn hình hiển thị tại sân / bảng tỉ số (Dự kiến) |
| Giám sát tình trạng (heartbeat, online/offline, vô hiệu hóa từ xa) | Điều khiển ngăn kéo đựng tiền (Dự kiến) |
| Nhập/xuất CSV bản ghi thiết bị | Nội bộ cổng thanh toán (xem Thanh toán) |
3. Năng lực
| Năng lực | Người dùng có thể làm gì |
|---|---|
| Đăng ký & CRUD thiết bị | Đăng ký phần cứng với tên i18n, loại, tổ chức; sân + mã tùy chọn |
| Vòng đời trạng thái | Đưa thiết bị qua NEW → ACTIVATED → DEACTIVATED → SUSPENDED → ARCHIVED |
| Kiểm kê thiết bị | Ghi nhận chi tiết phần cứng, phần mềm và bảo trì cho từng thiết bị |
| Giám sát tình trạng | Xem trạng thái online/offline qua heartbeat 5 phút; offline sau 15 phút im lặng |
| Vô hiệu hóa từ xa | Vô hiệu hóa thiết bị và thu hồi phiên của nó từ xa |
| Ứng dụng di động | Chạy POS và quản lý trên iOS 14+ / Android 8+ (Tauri) |
| Ứng dụng web | Chạy back-office và POS cơ bản trên trình duyệt hiện đại |
| Ứng dụng máy POS | Chạy POS toàn màn hình tại quầy sân trên phần cứng Android chuyên dụng |
| In hóa đơn | In hóa đơn nhiệt ESC/POS qua USB / mạng, code page 28 tiếng Việt, 58/80mm |
| Quét mã vạch | Quét mã sản phẩm (đồ uống, dụng cụ) qua HID keyboard-wedge hoặc camera/QR di động |
| SoundBox | Nghe xác nhận thanh toán bằng giọng nói tiếng Việt/tiếng Anh qua Bluetooth |
| SoftPOS (NFC) | Chấp nhận thanh toán thẻ không tiếp xúc trên Android (VNPAY KYC) |
4. Phụ thuộc Module
| Phụ thuộc vào | Lý do |
|---|---|
| Commerce | Tổ chức sở hữu thiết bị; gán sân tùy chọn; sở hữu thực thể Device |
| Đơn hàng | Phiên POS chạy trên thiết bị tại quầy; tra cứu hóa đơn và biên nhận |
| Thanh toán | Xác nhận SoundBox và chấp nhận thẻ SoftPOS |
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 các service và ứng dụng vận hành nó.
| Package / App | Vai trò | Tài liệu developer |
|---|---|---|
@nx/commerce | Sở hữu thực thể Device, thông tin phần cứng/phần mềm, vòng đời trạng thái | commerce |
@nx/signal | Edge thời gian thực - đẩy sự kiện thanh toán/thiết bị tới client qua WebSocket mã hóa | signal |
client | Giao diện quản lý thiết bị & terminal trong back-office | client |
sale-renderer | Giao diện POS - luồng quét, in, SoundBox, SoftPOS | sale-renderer |
sale-main | Lớp native Tauri - plugin USB/NFC/máy in/máy quét, SQLite offline | sale-main |
Engineering Mapping (Feature ⇄ Package)
Trục ngang của Feature Spine - mỗi tính năng nghiệp vụ (
<AREA>trong URD) ánh xạ tới ngôi nhà kỹ thuật của nó. Đối ứng: tài liệu package liên kết ngược về đây.
| Tính năng | Package | Trạng thái |
|---|---|---|
MOB Ứng dụng Di động | sale-renderer | Built |
WEB Ứng dụng Web | client | Built |
SBX SoundBox | sale-renderer | Built |
DEV Đăng ký & Quản lý Thiết bị | @nx/commerce | In-progress |
POS Máy POS | sale-renderer | In-progress |
PRN Máy in | sale-main | In-progress |
SCN Máy quét Mã vạch | sale-main | In-progress |
DSX Ca làm việc theo Thiết bị & Liên kết Máy in | @nx/sale · @nx/commerce · @nx/core | Built |
MON Định danh & Giám sát Tình trạng Thiết bị | @nx/commerce · @nx/signal | In-progress |
NFC SoftPOS / NFC | sale-main | Planned |
6. Luồng Người dùng Chính
7. Vai trò & Quyền hạn
| Vai trò | Có thể | Không thể |
|---|---|---|
| Chủ sân | Đăng ký, sửa, kích hoạt, tạm ngưng, lưu trữ, vô hiệu hóa thiết bị từ xa; cấu hình thiết bị ngoại vi | - |
| Quản lý ca | Xem thiết bị, giám sát tình trạng, cấu hình thiết bị ngoại vi trong phạm vi | Lưu trữ hoặc vô hiệu hóa từ xa (tùy phạm vi) |
| Thu ngân | Vận hành POS trên thiết bị đã kích hoạt tại quầy; ghép nối và sử dụng thiết bị ngoại vi | Đăng ký, lưu trữ hoặc vô hiệu hóa thiết bị từ xa |
8. Trạng thái & Lộ trình
| Phase | Năng lực |
|---|---|
| P1 | Ứng dụng di động, ứng dụng web, SoundBox, chế độ offline, bắt buộc phiên bản tối thiểu |
| P2 | CRUD đăng ký thiết bị, thông tin phần cứng/phần mềm/bảo trì, ứng dụng máy POS, máy in hóa đơn nhiệt, máy quét mã vạch, giám sát tình trạng |
| P3 | SoftPOS (NFC), màn hình hiển thị tại sân, màn hình phụ cho khách, in nhãn, POS Windows |
9. Trang Liên quan
- URD
- PRDs
- Tính năng: Ứng dụng Di động · Ứng dụng Web · Thiết bị POS · Máy quét Mã vạch · Máy in · SoundBox
- Đơn hàng · Thanh toán · Commerce