Yêu cầu
Mỗi ca sử dụng, quy tắc và yêu cầu chất lượng của ShopNexus có một mã, và code cùng test của server ghi mã của phần chúng hiện thực.
Các mã nằm trong một file, docs/registry/requirements.yaml. Báo cáo đồ án và các trang này đọc file đó; make trace ở repo gốc kiểm tra code, test và đặc tả API của server theo file đó.
Mã
| Loại | Dạng | Ví dụ |
|---|---|---|
| Ca sử dụng | UC-<nhóm>-nn | UC-DEAL-02 |
| Yêu cầu chức năng | FR-<nhóm>-nn | FR-DEAL-02 |
| Quy tắc nghiệp vụ | BR-<nhóm>-nn | BR-DEAL-03 |
| Yêu cầu phi chức năng | NFR-<thuộc tính>-nn | NFR-CONC-01 |
| Quyết định kiến trúc | ADR-nnnn | ADR-0002 |
Các nhóm gồm ACC tài khoản, LST tin đăng, DSC khám phá, DEAL trò chuyện và giao dịch, TRS uy tín sau giao dịch, MOD vận hành và SHR ca dùng chung. Luồng được đánh số trong từng ca: A1, A2… là luồng thay thế, vẫn đạt mục tiêu; E1, E2… là luồng ngoại lệ, dừng mà không đạt mục tiêu. Một mã không bao giờ được cấp hai lần; mã bỏ đi được đánh dấu đã bỏ.
Mức truy vết
| Mã | Ca sử dụng | Trạng thái | Code / test | Luồng E có test |
|---|---|---|---|---|
UC-ACC-01 | Đăng nhập bằng số điện thoại, email hoặc Google (lần đầu tự tạo tài khoản) | Chưa truy vết | ||
UC-ACC-02 | Quản lý phiên đăng nhập trên các thiết bị | Chưa truy vết | ||
UC-ACC-04 | Thiết lập giao COD (địa chỉ lấy hàng, liên kết tài khoản GHTK/GHN) | Chưa truy vết | ||
UC-ACC-05 | Chặn người dùng khác | Chưa truy vết | ||
UC-LST-01 | Đăng tin với AI điền giúp (từ video, ảnh hoặc link Chợ Tốt) | Đã xong | 42 / 26 | 8/8 |
UC-LST-02 | Quản lý tin đăng (sửa, đổi giá, ẩn/hiện, đánh dấu đã bán, xóa) | Đã xong | 13 / 6 | 3/3 |
UC-LST-03 | Đẩy tin và đăng ký gói người bán | Dự kiến | ||
UC-DSC-01 | Tìm kiếm bằng câu tự nhiên với AI | Chưa truy vết | ||
UC-DSC-02 | Duyệt danh mục và lọc kết quả | Chưa truy vết | ||
UC-DSC-03 | Lưu tin, theo dõi tìm kiếm và nhận cảnh báo giảm giá | Chưa truy vết | ||
UC-DSC-04 | Xem hồ sơ người bán (đánh giá khi bán và khi mua, số liệu, tin đang bán) | Chưa truy vết | ||
UC-DEAL-01 | Nhắn tin theo tin đăng | Đã xong | 2 / 2 | 0/2 |
UC-DEAL-02 | Thương lượng giá | Đã xong | 24 / 14 | 9/9 |
UC-DEAL-03 | Yêu cầu giao COD | Đã xong | 6 / 5 | 5/5 |
UC-DEAL-04 | Tạo đơn gửi hàng (vận đơn GHTK/GHN hoặc nhập mã) | Đã xong | 16 / 13 | 7/8 |
UC-DEAL-05 | Theo dõi đơn và nhận hàng đồng kiểm (nhận hoặc từ chối tại cửa) | Đã xong | 11 / 11 | 3/3 |
UC-DEAL-06 | Hủy đơn trước khi gửi hàng | Đã xong | 11 / 10 | 1/1 |
UC-TRS-01 | Đánh giá người cùng giao dịch và trả lời đánh giá | Chưa truy vết | ||
UC-TRS-04 | Xem số liệu uy tín và hạn mức | Chưa truy vết | ||
UC-MOD-01 | Báo cáo vi phạm (hàng cấm, hàng giả, lừa đảo, khác) | Chưa truy vết | ||
UC-MOD-02 | Xử lý báo cáo vi phạm và tạm khóa tài khoản | Chưa truy vết | ||
UC-MOD-04 | Quản lý tài khoản điều phối viên | Chưa truy vết | ||
UC-MOD-05 | Tra cứu nhật ký kiểm toán | Chưa truy vết | ||
UC-MOD-06 | Xử lý ca báo cáo với đề xuất của agent | Dự kiến | ||
UC-MOD-07 | Trả lời ticket bằng câu trả lời agent soạn | Dự kiến | ||
UC-MOD-08 | Hỏi agent về một ticket, ca báo cáo hoặc tài khoản | Đang làm | 23 / 13 | |
UC-MOD-09 | Gửi phiếu hỗ trợ (báo chưa nhận hàng, xin thêm hãng, yêu cầu khác) | Chưa truy vết | ||
UC-SHR-01 | Tải ảnh lên (kiểm tra, chuẩn hóa và lưu ảnh) | Chưa truy vết | ||
UC-SHR-02 | Ghi nhật ký kiểm toán | Chưa truy vết |
Số liệu lấy từ registry/trace.json, do make trace ghi từ một commit của server. Ca ghi “Chưa truy vết” là ca mà code chưa gắn mã.