Giao diện
Đặc tả yêu cầu chức năng
Tài liệu này mô tả những gì hệ thống phải làm: quy tắc nghiệp vụ, công thức tính, trạng thái, phân quyền và cách kết nối với phần mềm bên ngoài. Cách thao tác trên từng màn hình đã có trong Hướng dẫn GreenCoco Portal và Hướng dẫn Trạm cân, tài liệu này không nhắc lại.
Phạm vi
| Thành phần | Trong phạm vi |
|---|---|
| GreenCoco Portal (web, máy tính và điện thoại) | Có |
| Các dịch vụ backend sau API gateway | Có |
| Ứng dụng Trạm cân (Windows, cân bàn) | Có |
| Truck Scale Data Tracker (Windows, cân xe) | Có |
| Phần mềm cân xe của nhà cung cấp cân, Keycloak, hạ tầng | Chỉ phần giao tiếp |
Đối tượng đọc
| Đối tượng | Mục đích |
|---|---|
| Quản lý, người phụ trách nghiệp vụ | Kiểm tra quy tắc nghiệp vụ có khớp với thực tế không |
| Lập trình viên | Nắm các hành vi cần giữ nguyên khi sửa code |
| Kiểm thử viên | Viết test case cho từng mã yêu cầu |
Quy ước
- Mỗi yêu cầu có mã
FR-<MODULE>-<số>, ví dụFR-TKT-12. Yêu cầu phi chức năng dùngNFR-<số>. Mã đã cấp không đổi, không dùng lại; yêu cầu bị bỏ thì ghi Đã bỏ. - Phải là bắt buộc. Không được là cấm. Không dùng "nên".
- Tên màn hình, nút, ô viết đậm, đúng như trên portal tiếng Việt.
- Trường dữ liệu viết
monospace, đúng tên trong API. - Khối lượng tính bằng kg. Ngày theo giờ Việt Nam (ICT, UTC+07).
| Module | Mã | Trang |
|---|---|---|
| Đăng nhập, phân quyền | AUT | Vai trò và phân quyền |
| Đối tác, HTX, xe tải, phân công | VEN | Đối tác, HTX, xe tải |
| Sản phẩm | PRD | Sản phẩm |
| Kế hoạch thu mua | PPL | Kế hoạch thu mua |
| Bảng giá | PRC | Bảng giá |
| Kế hoạch sơ chế | PSP | Kế hoạch sơ chế |
| Phiếu mua dừa | TKT | Phiếu mua dừa |
| Tính toán phiếu mua dừa | CAL | Tính toán phiếu mua dừa |
| Phiếu mua cơm dừa | MTK | Phiếu mua cơm dừa |
| Dữ liệu TC | TCD | Dữ liệu TC |
| Phân bổ sơ chế | ALC | Phân bổ sơ chế |
| Theo dõi nhận về | RCP | Theo dõi nhận về |
| Tổng hợp ngày, biên bản gia công | BBG | Tổng hợp ngày và biên bản |
| Cân xe | TSC | Cân xe |
| Trạm cân, nhân công | WSA | Trạm cân và nhân công |
| Tổng quan, báo cáo | RPT | Tổng quan và báo cáo |
| Quản trị hệ thống | ADM | Quản trị hệ thống |
| Tích hợp | INT | Tích hợp và sự kiện |
| Phi chức năng | NFR | Yêu cầu phi chức năng |
Thay đổi yêu cầu
Muốn đổi quy tắc nghiệp vụ thì sửa yêu cầu ở đây trước, rồi mới sửa code. Code làm khác yêu cầu là lỗi của code.
| Ngày | Nội dung |
|---|---|
| 09/11/2026 | Bản đầu |
| 12/11/2026 | Khớp với code: mã lỗi viết hoa (FR-ADM-3, FR-ADM-15, FR-WSA-14), outbox 200 ms (FR-INT-8), gợi ý cân theo biển số (FR-TKT-29), thông báo FR-RCP-10 |
| 12/11/2026 | Bản ghi cân được ánh xạ ngay khi lưu và khi lưu tên, bỏ quét định kỳ (FR-TSC-9, FR-TSC-12); truck-scale-service không đọc MSSQL, local dùng truck-scale-tracker-local (FR-TSC-19) |
| 12/11/2026 | Xuất Excel bản ghi cân xe có trên điện thoại (FR-TSC-17); thẻ Mua hàng hiện thực tế ngày không có kế hoạch, tab và ngày trên URL (FR-RPT-5) |
| 12/11/2026 | Kiểm tra dữ liệu: số trái là số nguyên (FR-TKT-12), cần họ hoặc tên khi sửa (FR-ADM-1), sao chép kế hoạch cùng loại, tuần liền trước (FR-PPL-11), phiếu cơm dừa chỉ nhận Phiếu cân (FR-MTK-10), tên hiển thị ≤ 250 (FR-VEN-3), mã lỗi FR-TKT-5 |
| 12/11/2026 | Khớp với code: version của thẻ (FR-ALC-35), Khách hàng ở Dữ liệu TC chỉ xem (FR-TCD-8), Nước dừa có dòng inhouse, xe tải theo vai trò, Nhân viên kho ở Trạm cân, /ready (NFR-15), khoá bên nhận ở bảng sự kiện. QC không còn quyền phiếu mua cơm dừa |
| 12/11/2026 | Quyết định: Hoàn thành khi đủ số liệu (FR-TKT-22); server tự điền nhân viên thu mua (FR-TKT-5); # Xe trước mọi dòng (FR-ALC-14, FR-ALC-25); Trả về khi hết dòng (FR-ALC-32); server tính Thành phẩm (FR-RCP-14); quyền ánh xạ tên (FR-TSC-13); Loại gia công mặc định đặt trong CSDL, hệ số giữ từ dòng đầu (FR-PRD-6, FR-CAL-7); đồng bộ tệp đính kèm, danh mục (FR-ADM-12); độ chính xác % (FR-RPT-3); 4 lần đọc cân (FR-WSA-3) |
| 13/11/2026 | Bỏ Đưa tất cả vào: đưa vào từng phiếu, server luôn đánh # Xe (FR-ALC-11) |
| 13/11/2026 | Đối tác, HTX bỏ email; đối tác có Mã số thuế không trùng, tìm được theo mã số thuế, ô nằm cạnh Điện thoại, trên Vai trò (FR-VEN-22); HTX không có người đại diện (FR-VEN-11) |
| 14/11/2026 | Cấu hình hệ thống có tab Chung; chức danh Thủ kho, Bộ Phận Sản Xuất cố định (FR-ADM-7, FR-ADM-8). Tổng hợp gom theo đơn vị (FR-BBG-3); Phiếu nhập kho cho cả đơn vị khi mọi loại sẵn sàng (FR-BBG-10 – FR-BBG-14) |
| 14/11/2026 | Trả về ẩn khi thẻ còn dòng (FR-ALC-32) |
| 14/11/2026 | Tổng hợp sơ chế có tab Bù hàng tháng và biên bản vượt định mức (FR-RPT-14 – FR-RPT-17) |
| 14/11/2026 | Cấu hình hệ thống có tab Biên bản vượt định mức cho đại diện, chức vụ Bên A; mỗi tab có bản ghi và nút Lưu riêng (FR-ADM-7, FR-ADM-8, FR-ADM-17, FR-RPT-17) |
| 15/11/2026 | Danh mục sản phẩm: bỏ wip_raw_material; thêm Phụ phẩm (Da dừa) và con của Thành phẩm (Nước dừa, Dầu dừa hữu cơ, Cơm dừa sấy, Bột dừa); trạm cân tải Nguyên liệu thô, Phụ phẩm, Thành phẩm (FR-WSA-6) |
| 15/11/2026 | Kế hoạch sơ chế: dòng ĐVGC phải chọn ĐVGC và đủ ba cột giờ mới lưu được (FR-PSP-3) |
| 15/11/2026 | Kế hoạch thu mua: dòng dừa trái và cơm dừa phải chọn NCC và nguyên liệu; dòng Thêm dòng không còn chép HTX (FR-PPL-4, FR-PPL-6, FR-PPL-7, FR-PPL-9) |