# ERP EDGE - Tối ưu Bán hàng & Quản trị Điểm bán Toàn diện

ERP EDGE là giải pháp điểm bán hiện đại, quy trình sẵn sàng và dễ sử dụng thuộc TDZ Group, giúp tối ưu hóa vận hành ngoại tuyến cho các quầy thu ngân và kho chi nhánh, đồng thời tự động đồng bộ dữ liệu khi có kết nối mạng.

## Các Tính Năng Nổi Bật

### 1. Quầy Bán Lẻ & Bán Buôn Siêu Tốc (POS Engine)
- Giao diện thu ngân tối ưu thao tác 2 cột, hỗ trợ súng quét mã vạch Barcode và Serial linh kiện với sự kiện phím tức thì.
- Phím tắt bán hàng nhanh chuyên nghiệp: F2 (Tìm kiếm SP), F4 (Khách hàng), F8 (Thanh toán), F9 (In hóa đơn).
- Tích hợp in nhiệt hóa đơn ESC/POS K80 trực tiếp qua cổng in nhiệt hoặc popup trình duyệt với độ trễ $< 5$ms.
- Tự động sinh mã hóa đơn bán hàng `SAL-` (hoặc `EXC-` đối với đơn đổi hàng).

### 2. Quản Lý Kho & Vòng Đời Serial/IMEI Chi Nhánh (WMS Edge)
- Theo dõi tồn kho thực tế của từng linh kiện, thiết bị và phụ kiện tại chi nhánh.
- Nhập kho từ nhà cung cấp với mã phiếu nhập `IMP-` và xuất trả hàng lỗi NCC với mã `RTN-`.
- Quản lý nghiêm ngặt vòng đời từng số Serial/IMEI qua các trạng thái: Trong kho (`available`), Đã bán (`sold`), Hỏng chờ bảo hành (`defective`), Đã hoàn trả NCC (`returned`), Đang bảo hành (`warranty`).
- Nhật ký bất biến `serial_logs` ghi nhận mọi biến động di chuyển của từng số Serial.

### 3. Ráp Máy & Nâng Cấu Hình PC (PC Build CFG)
- Chuyên biệt cho chuỗi cửa hàng máy tính, linh kiện PC Gaming và thiết bị công nghệ.
- Lắp ráp bộ máy PC hoàn chỉnh từ các linh kiện rời (Mainboard, CPU, RAM, SSD, VGA, Nguồn, Case), gán số Serial cho từng linh kiện con.
- Tự động khấu trừ tồn kho linh kiện và sinh phiếu cấu hình với mã `CFG-`.

### 4. Quản Lý Tiếp Nhận & Bảo Hành Kép (Warranty System)
- Tiếp nhận thiết bị và linh kiện bảo hành từ khách hàng với mã `BH-`.
- Quản lý quy trình kỹ thuật sửa chữa tại chỗ, xuất vật tư thay thế hoặc gửi bảo hành lên Hãng / Nhà cung cấp với mã `BHH-`.
- Tra cứu lịch sử bảo hành minh bạch đối chiếu theo số Serial/IMEI thiết bị.

### 5. Sổ Quỹ Giao Dịch & Thanh Toán Hỗn Hợp (Cash Book & Split Payment)
- Hạch toán dòng tiền thu chi tại quầy với mã phiếu giao dịch `TRA-`.
- Hỗ trợ thanh toán hỗn hợp linh hoạt trên cùng một đơn hàng: Tiền mặt, Chuyển khoản ngân hàng (VietQR động) và Ghi nợ công nợ đối tác.
- Chốt ca thu ngân và đối chiếu tiền mặt cuối ngày chính xác.

### 6. Kiểm Kê Kho Thực Tế (Stock Checks)
- Khởi tạo phiếu kiểm kê định kỳ hoặc đột xuất với mã `SC-`.
- Sử dụng súng quét mã vạch đối soát số lượng thực tế với số tồn trên hệ thống, tự động cân kho và lập biên bản kiểm kê minh bạch.

### 7. Điều Chuyển Hàng Nội Bộ & Cô Lập Subdomain (Transfer & Subdomain Isolation)
- Điều chuyển hàng hóa giữa các chi nhánh trong cùng chuỗi cửa hàng với mã `TRF-`.
- Ràng buộc an toàn Subdomain Isolation đảm bảo tính toàn vẹn dữ liệu, chống chuyển nhầm chi nhánh khác cụm hệ sinh thái.

### 8. Kiến Trúc Đồng Bộ Đa Tầng 2 Chiều (Sync Protocol Engine)
- **Transactional Outbox:** Mọi giao dịch được ghi nhận vào hàng đợi `sync_outbox` nguyên tử cùng transaction nghiệp vụ, đảm bảo 0% mất mát dữ liệu kể cả khi mất mạng hay sập nguồn.
- **Tự động đẩy (Push Worker):** Worker chạy ngầm tự động đẩy chứng từ lên Cloud ERP theo đúng trình tự thời gian ngay khi có mạng trở lại.
- **Fast Sync & Delta Cursor:** Kéo danh mục sản phẩm, bảng giá và dữ liệu từ Cloud bằng con trỏ thời gian (Cursor) hoặc lệnh `php artisan edge:fast-sync`.
- **Bảo mật Zero-Trust HMAC-SHA256:** Xác thực chữ ký số đối xứng kèm Timestamp 300s chống tấn công Replay Attack.
- **Cách ly gói tin lỗi (Poison Pill Quarantine):** Dead-Letter Queue tự động cách ly gói tin lỗi sau 5 lần thử, không bao giờ làm nghẽn luồng xử lý tại quầy.

---

## 📋 Quy Chuẩn Mã Chứng Từ Tự Sinh (DocumentCodeService)

Mọi chứng từ trong hệ thống ERP EDGE đều được cấp mã an toàn tuyệt đối chống trùng lặp:

| Phân Hệ Nghiệp Vụ | Tiền Tố | Định Dạng Mã Chuẩn | Ý Nghĩa Nghiệp Vụ |
| :--- | :--- | :--- | :--- |
| **Bán hàng tại quầy** | `SAL` | `SAL-000001` | Hóa đơn bán lẻ & bán buôn chi nhánh |
| **Đổi hàng** | `EXC` | `EXC-000001` | Hóa đơn đổi sản phẩm tại quầy |
| **Khách trả hàng** | `SRT` | `SRT-000001` | Phiếu tiếp nhận khách trả hàng hoàn tiền |
| **Nhập kho NCC** | `IMP` | `IMP-000001` | Phiếu nhập kho từ nhà cung cấp |
| **Xuất trả NCC** | `RTN` | `RTN-000001` | Phiếu xuất trả hàng lỗi cho nhà cung cấp |
| **Ráp máy PC** | `CFG` | `CFG-000001` | Phiếu lắp ráp / nâng cấu hình PC |
| **Bảo hành khách** | `BH` | `BH-000001` | Phiếu tiếp nhận bảo hành từ khách hàng |
| **Bảo hành Hãng** | `BHH` | `BHH-000001` | Phiếu gửi bảo hành lên Hãng / Nhà cung cấp |
| **Kiểm kê kho** | `SC` | `SC-000001` | Phiếu kiểm kê kho thực tế |
| **Điều chuyển kho** | `TRF` | `TRF-000001` | Phiếu điều chuyển hàng liên chi nhánh |
| **Sổ quỹ giao dịch** | `TRA` | `TRA-000001` | Phiếu thu / chi dòng tiền tại quầy |
| **Sản phẩm / Vật tư**| `SP` | `SP-000001` | Mã định danh sản phẩm, linh kiện |
| **Đối tác kinh doanh**| `KH` / `NCC` / `PAR` | `KH-000001` | Khách hàng, Nhà cung cấp hoặc Đối tác kép |

---

*Lưu ý bảo mật: ERP EDGE là trạm xử lý biên nội bộ. Mọi quyền truy cập trái phép đều bị nghiêm cấm và ghi nhật ký kiểm toán Action Log.*