Thiết bị Phase A In-progress
Thiết bị cho phép một tổ chức đă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 BANA — máy POS, ứng dụng di động và web — và kết nối các thiết bị ngoại vi như máy in hóa đơn, máy quét mã vạch và VNPAY SoundBox. Chủ sở hữu theo dõi thiết bị của mình; thu ngân vận hành chúng hằng ngà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ở hữu, Quản lý, 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 | Máy POS Windows (Dự kiến) |
| Tích hợp thiết bị ngoại vi (máy in, máy quét, SoundBox, SoftPOS, màn hình phụ) | Ứng dụng màn hình bếp / phục vụ / giao hàng (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ì | Trạng thái |
|---|---|---|
| Đăng ký & CRUD thiết bị | Đăng ký phần cứng với tên i18n, loại, tổ chức; merchant + mã tùy chọn | In-progress |
| Vòng đời trạng thái | Đưa thiết bị qua NEW → ACTIVATED → DEACTIVATED → SUSPENDED → ARCHIVED | In-progress |
| 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ị | Built |
| 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 | In-progress |
| 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 | In-progress |
| Ứng dụng di động | Chạy POS và quản lý trên iOS 14+ / Android 8+ (Tauri) | Built |
| Ứng dụng web | Chạy back-office và POS cơ bản trên trình duyệt hiện đại | Built |
| Ứng dụng máy POS | Chạy POS toàn màn hình trên phần cứng Android chuyên dụng | In-progress |
| In hóa đơn | In hóa đơn ESC/POS qua USB / mạng, code page 28 tiếng Việt, 58/80mm | In-progress |
| Quét mã vạch | Quét qua HID keyboard-wedge hoặc camera/QR di động | In-progress |
| SoundBox | Nghe xác nhận thanh toán bằng giọng nói tiếng Việt/tiếng Anh qua Bluetooth | Built |
| SoftPOS (NFC) | Chấp nhận thanh toán thẻ không tiếp xúc trên Android (VNPAY KYC) | Planned |
4. Phụ thuộc Module
| Phụ thuộc vào | Lý do |
|---|---|
| Commerce | Tổ chức sở hữu thiết bị; gán merchant tùy chọn; sở hữu thực thể Device |
| Đơn hàng | Phiên POS chạy trên thiết bị; 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 |
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ở hữu | Đă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ý | 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; 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, máy quét mã vạch, giám sát tình trạng |
| P3 | SoftPOS (NFC), màn hình bếp, màn hình phụ cho khách, in nhãn, POS Windows |
9. Trang Liên quan
- URD
- Test Cases
- 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