Use cases
Each use case with its main, alternate and exception flows, the error codes the exceptions return, and the server code and tests that name it.
Use cases are grouped as in the thesis report. The code and test links point to the server commit in registry/trace.json.
Accounts and identity
UC-ACC-01 Sign in by phone, email or Google Not traced
Not specified yet.
UC-ACC-02 Manage sessions across devices Not traced
Not specified yet.
UC-ACC-04 Set up COD (pickup address, GHTK/GHN link) Not traced
Not specified yet.
UC-ACC-05 Block another user Not traced
Not specified yet.
Listings
UC-LST-01 Post a listing with AI filling it in Done
Main flow
- Người bán chụp hoặc chọn từ thư viện 1–10 ảnh, hoặc quay video; ảnh được tải lên qua UC-SHR-01.
- AI đọc ảnh, hoặc khung hình và lời nói tiếng Việt trong video, rồi điền tiêu đề, danh mục, tình trạng theo thang Mới/Như mới/Đã dùng, thông số, mô tả và khoảng giá tham khảo.
- Người bán sửa biểu mẫu, nhập giá, xác nhận phường/xã rồi bấm Đăng.
- Hệ thống kiểm quyền đăng và trần số tin của người bán (BR-LST-02), kể cả khi người bán gửi nhiều tin cùng lúc; kiểm giới hạn từng mục (BR-LST-03).
- Hệ thống lưu tin ở trạng thái đang xử lý, chuẩn hóa ảnh và xóa thông tin vị trí chụp trong ảnh; xong thì tin chuyển sang đang bán, ứng dụng báo "Đã đăng tin".
Alternate flows
| Flow | Step | What happens | Tested |
|---|---|---|---|
A1 | 2 | Mô hình không trả kết quả: người bán tự điền biểu mẫu, tiếp tục bước 3. | ✓ |
A2 | 1 | Người bán dán link tin của mình trên Chợ Tốt: hệ thống hiện thẻ xem trước rồi đọc tin đó thành biểu mẫu, bỏ số điện thoại và Zalo trong mô tả. | ✓ |
A3 | 3 | Hệ thống hiện các tin tương tự, số người mua đang theo dõi loại hàng này và hai mức gợi ý: giá thị trường và giá bán nhanh, kèm số ngày bán. | ✓ |
A4 | 3 | Người bán lưu nháp và quay lại sau; nháp giữ ảnh đã tải. | ✓ |
A5 | 1 | Người bán đăng lại từ một tin cũ của mình: ảnh của tin đó được chép thành ảnh tải lên mới. | ✓ |
A6 | 4 | Ứng dụng gửi lại cùng một lần đăng: trả đúng tin của lần đầu, không tạo tin thứ hai. | ✓ |
Exception flows
| Flow | Step | What happens | Error code | Tested |
|---|---|---|---|---|
E1 | 4 | Tài khoản đang bị tạm khóa: từ chối đăng. BR-LST-02 | account_suspended | ✓ |
E2 | 4 | Đã có 20 tin đang bán: từ chối, báo số tin tối đa. BR-LST-02 | listing_cap_reached | ✓ |
E3 | 5 | Có ảnh lỗi: tin chuyển sang bị từ chối kèm lý do; sửa tin hoặc thêm ảnh đưa tin về đang xử lý. | ✓ | |
E4 | 4 | Người bán chưa có số điện thoại BR-ACC-03 | phone_required | ✓ |
E5 | 4 | Nội dung tin sai giới hạn BR-LST-03 | invalid_listing | ✓ |
E6 | 2 | Người bán đã dùng hết lượt đọc bằng AI trong 24 giờ (30 video, 60 ảnh, 30 link) | read_limit_reached | ✓ |
E7 | 1 | Link không phải tin trên Chợ Tốt | unsupported_source | ✓ |
E8 | 4 | Ảnh không thuộc người bán hoặc chưa tải xong | invalid_upload | ✓ |
Implemented in: 42 · Tested by: 26
Implemented in
-
internal/assist/service/link_preview.go:14A2 -
internal/assist/service/link_read_durable.go:101A2 -
internal/assist/service/link_read_durable.go:144A1 -
internal/assist/service/link_read_start.go:10A2 -
internal/assist/service/photo_read_durable.go:101 -
internal/assist/service/photo_read_durable.go:144A1 -
internal/assist/service/photo_read_start.go:8 -
internal/assist/service/price_guide.go:26A3 -
internal/assist/service/read_get.go:12 -
internal/assist/service/service.go:33 -
internal/assist/service/service.go:38 -
internal/assist/service/service.go:43A2 -
internal/assist/service/service.go:49 -
internal/assist/service/service.go:58 -
internal/assist/service/service.go:63A2 -
internal/assist/service/service.go:68A3 -
internal/assist/service/video_read_durable.go:165 -
internal/assist/service/video_read_durable.go:217A1 -
internal/assist/service/video_read_start.go:11 -
internal/catalog/service/listing_draft.go:11A4 -
internal/catalog/service/listing_draft.go:34A4 -
internal/catalog/service/listing_draft.go:59A4 -
internal/catalog/service/listing_draft.go:73A4 -
internal/catalog/service/listing_photo_copy.go:9A5 -
internal/catalog/service/listing_photo_copy_durable.go:56A5 -
internal/catalog/service/listing_post.go:11 -
internal/catalog/service/listing_post_durable.go:54 -
internal/catalog/service/listing_post_durable.go:64E1 -
internal/catalog/service/listing_post_durable.go:74E4 -
internal/catalog/service/listing_post_durable.go:84E2 -
internal/catalog/service/listing_post_durable.go:103E5 -
internal/catalog/service/listing_post_durable.go:109E2 -
internal/catalog/service/listing_post_durable.go:119E8 -
internal/catalog/service/listing_post_durable.go:130 -
internal/catalog/service/listing_publish_durable.go:38 -
internal/catalog/service/listing_publish_durable.go:82E3 -
internal/catalog/service/service.go:33 -
internal/catalog/service/service.go:63A4 -
internal/catalog/service/service.go:67A4 -
internal/catalog/service/service.go:72 -
internal/catalog/service/service.go:76A4 -
internal/catalog/service/service.go:90A5
Tested by
-
internal/assist/service/link_read_test.go:27A2 -
internal/assist/service/link_read_test.go:152E7 -
internal/assist/service/link_read_test.go:212A2 -
internal/assist/service/photo_read_test.go:25 -
internal/assist/service/photo_read_test.go:58A1 -
internal/assist/service/price_guide_test.go:30A3 -
internal/assist/service/read_watch_test.go:17 -
internal/assist/service/video_read_test.go:35 -
internal/assist/service/video_read_test.go:81A1 -
internal/assist/service/video_read_test.go:155A1 -
internal/assist/service/video_read_test.go:198E4, E6 -
internal/catalog/domain/listing_test.go:46E5 -
internal/catalog/service/flow_test.go:39 -
internal/catalog/service/flow_test.go:61E2 -
internal/catalog/service/flow_test.go:87E8 -
internal/catalog/service/flow_test.go:167A6 -
internal/catalog/service/listing_draft_test.go:26A4 -
internal/catalog/service/listing_draft_test.go:179A4 -
internal/catalog/service/listing_draft_test.go:212A4 -
internal/catalog/service/listing_photo_copy_test.go:28A5 -
internal/catalog/service/listing_photo_copy_test.go:92A5 -
internal/catalog/service/listing_photo_copy_test.go:153A5 -
internal/catalog/service/listing_test.go:30E1, E2, E4, E5, E8 -
internal/catalog/service/listing_test.go:83A6 -
internal/catalog/service/listing_test.go:114E3 -
internal/catalog/service/listing_test.go:458A5
UC-LST-02 Manage listings Done
Main flow
- Người bán mở một tin của mình trong Tin của bạn.
- Người bán sửa nội dung, đổi giá, ẩn hoặc hiện tin, đánh dấu đã bán hoặc xóa tin.
- Hệ thống lưu thay đổi; tin sửa có ảnh mới quay lại đang xử lý cho tới khi ảnh xử lý xong.
Alternate flows
| Flow | Step | What happens | Tested |
|---|---|---|---|
A1 | 2 | Người bán đổi giá hoặc ẩn tin: giá đang mở trong các thương lượng bị rút (UC-DEAL-02 A4). | — |
A2 | 2 | Người bán bỏ đánh dấu đã bán: tin bán lại, vẫn tính vào trần số tin. BR-LST-02 | ✓ |
A3 | 3 | Ứng dụng gửi lại cùng một lần sửa: không sửa thêm lần nào. | — |
Exception flows
| Flow | Step | What happens | Error code | Tested |
|---|---|---|---|---|
E1 | 2 | Trạng thái tin không cho thao tác này, ví dụ hiện một tin đang bán hay sửa tin đang giữ cho một đơn | listing_state_conflict | ✓ |
E2 | 1 | Tin không phải của người bán hoặc đã xóa BR-ACC-02 | listing_not_found | ✓ |
E3 | 3 | Nội dung sửa sai giới hạn BR-LST-03 | invalid_listing | ✓ |
Implemented in: 13 · Tested by: 6
Implemented in
-
internal/catalog/service/listing_edit.go:11 -
internal/catalog/service/listing_edit_durable.go:42 -
internal/catalog/service/listing_state.go:15 -
internal/catalog/service/listing_state.go:28 -
internal/catalog/service/listing_state.go:41 -
internal/catalog/service/listing_state.go:54A2 -
internal/catalog/service/listing_state.go:67 -
internal/catalog/service/service.go:38 -
internal/catalog/service/service.go:42 -
internal/catalog/service/service.go:46 -
internal/catalog/service/service.go:50 -
internal/catalog/service/service.go:54A2 -
internal/catalog/service/service.go:58
Tested by
UC-LST-03 Boost listings and seller plans Planned
Not specified yet.
Discovery
UC-DSC-01 Natural-language search with AI Not traced
Main flow
- Người dùng gõ một câu nhu cầu, hoặc chọn một ảnh để tìm món giống.
- Hệ thống gửi câu cho mô hình ngôn ngữ một lần; mô hình đổi câu thành các điều kiện ưu tiên: cụm từ, danh mục, giá, tình trạng, nơi bán, độ gần, độ mới. Điều kiện không khớp dữ liệu thật (danh mục, tỉnh, xã) bị bỏ.
- Hệ thống tìm trên các tin đang bán theo ba cách (khớp từ khóa, theo nghĩa của câu, theo ảnh) rồi hợp nhất thứ hạng; câu gốc luôn được giữ làm một cụm từ tìm.
- Hệ thống trả tin, chip và câu diễn giải; cách đọc câu được lưu 7 ngày cho lần tìm sau.
- Người dùng tắt một chip; hệ thống tìm lại bằng cách đọc đã lưu, không hỏi lại mô hình.
Alternate flows
| Flow | Step | What happens |
|---|---|---|
A1 | 2 | Mô hình lỗi hoặc quá 4 giây: hệ thống tìm bằng nguyên câu gốc, không có chip. |
A2 | 4 | Không có tin phù hợp: trả kết quả rỗng kèm chip để người dùng nới điều kiện. |
A3 | 4 | Người dùng theo dõi câu tìm: hệ thống quét tin mới mỗi 30 phút và báo số tin mới khớp (UC-DSC-03). |
UC-DSC-02 Browse categories and filter Not traced
Not specified yet.
UC-DSC-03 Save listings, follow searches, price-drop alerts Not traced
Not specified yet.
UC-DSC-04 View a seller's profile Not traced
Not specified yet.
Chat and deals
UC-DEAL-01 Chat about a listing Done
Main flow
- Người dùng mở cuộc trò chuyện từ một tin đăng.
- Hệ thống mở cuộc trò chuyện của hai người, hoặc dùng lại cuộc trò chuyện đã có.
- Hai bên gửi tin nhắn văn bản hoặc ảnh; bước của thương lượng và của đơn hiện thành tin nhắn hệ thống trong cuộc trò chuyện.
Exception flows
| Flow | Step | What happens | Error code | Tested |
|---|---|---|---|---|
E1 | 2 | Hai người đã chặn nhau BR-ACC-01 | blocked | — |
E2 | 2 | Người dùng chưa có số điện thoại BR-ACC-03 | phone_required | — |
Where the code differs
- Phần nhắn tin nằm ở module chat, chưa gắn tag. Module deal mới gắn phần tin nhắn hệ thống (bước 3).
Implemented in: 2 · Tested by: 2
Implemented in
Tested by
UC-DEAL-02 Negotiate a price Done
Main flow
- Người mua mở thương lượng trên tin đăng; hệ thống mở hoặc dùng lại cuộc trò chuyện của hai người.
- Người mua trả giá theo BR-DEAL-03.
- Người bán phản giá hoặc từ chối; người đưa giá có thể rút giá của mình. Hai bên lặp lại cho tới khi một bên chấp nhận.
- Một bên chấp nhận đúng giá mình đang thấy; thương lượng chuyển sang đã chốt giá.
Alternate flows
| Flow | Step | What happens | Tested |
|---|---|---|---|
A1 | 1 | Người mua đã có thương lượng trên tin: hệ thống mở lại thương lượng đó. | ✓ |
A2 | 2 | Người mua chấp nhận ngay giá niêm yết, không trả giá. | — |
A3 | 4 | Sau khi chốt, một bên hủy chốt giá khi chưa có đơn: thương lượng quay lại bước 2. | — |
A4 | 3 | Người bán đổi giá niêm yết, tắt trả giá, ẩn hoặc xóa tin: giá đang mở bị rút; tin bị xóa thì chốt giá cũng bị bỏ. | ✓ |
Exception flows
| Flow | Step | What happens | Error code | Tested |
|---|---|---|---|---|
E1 | 1 | Tài khoản đang bị tạm khóa BR-MOD-02 | account_suspended | ✓ |
E2 | 1 | Người mua chưa có số điện thoại BR-ACC-03 | phone_required | ✓ |
E3 | 1 | Tin đăng của chính người mua | own_listing | ✓ |
E4 | 1 | Hai người đã chặn nhau BR-ACC-01 | blocked | ✓ |
E5 | 1 | Tin không còn đang bán | listing_unavailable | ✓ |
E6 | 2 | Giá trả sai bước giá hoặc ngoài khoảng cho phép BR-DEAL-03 | invalid_amount | ✓ |
E7 | 4 | Giá vừa bị đổi trước khi chấp nhận BR-DEAL-03 | price_changed | ✓ |
E8 | 3 | Bên kia vừa đi trước một bước | deal_changed | ✓ |
E9 | 3 | Chưa tới lượt hoặc trạng thái không cho bước này | move_not_allowed | ✓ |
Implemented in: 24 · Tested by: 14
Implemented in
-
internal/deal/service/deal_move.go:15 -
internal/deal/service/deal_move.go:27 -
internal/deal/service/deal_move.go:39 -
internal/deal/service/deal_move.go:51 -
internal/deal/service/deal_move.go:63A3 -
internal/deal/service/deal_move.go:86 -
internal/deal/service/deal_move.go:95E1 -
internal/deal/service/deal_move.go:114E8 -
internal/deal/service/deal_open.go:15 -
internal/deal/service/deal_open.go:21A1 -
internal/deal/service/deal_open.go:30E1 -
internal/deal/service/deal_open.go:38E2 -
internal/deal/service/deal_open.go:46E3 -
internal/deal/service/deal_open.go:50E4 -
internal/deal/service/deal_open.go:58E5 -
internal/deal/service/deal_open.go:62 -
internal/deal/service/listing_changed.go:14A4 -
internal/deal/service/service.go:43 -
internal/deal/service/service.go:67 -
internal/deal/service/service.go:71 -
internal/deal/service/service.go:75 -
internal/deal/service/service.go:79 -
internal/deal/service/service.go:83 -
internal/deal/service/service.go:143A4
Tested by
-
internal/deal/domain/deal_test.go:61E9 -
internal/deal/domain/deal_test.go:143E6 -
internal/deal/domain/deal_test.go:187E6 -
internal/deal/domain/deal_test.go:300E7 -
internal/deal/service/deal_test.go:20 -
internal/deal/service/deal_test.go:84 -
internal/deal/service/deal_test.go:99A1, E1, E2, E3, E5 -
internal/deal/service/deal_test.go:170E7 -
internal/deal/service/deal_test.go:188A4 -
internal/deal/service/deal_test.go:215E1 -
internal/deal/service/deal_test.go:235E8 -
internal/deal/service/deal_test.go:258E4 -
internal/deal/service/listing_changed_test.go:33A4 -
internal/deal/service/moves_post_test.go:20
UC-DEAL-03 Request cash on delivery Done
Main flow
- Người mua chọn yêu cầu COD và chọn một địa chỉ trong sổ địa chỉ.
- Hệ thống tạo đơn chờ gửi với giá đã chốt, lưu bản sao địa chỉ và bắt đầu đếm thời hạn người bán gửi hàng.
- Người bán thấy yêu cầu trong cuộc trò chuyện và chuyển sang UC-DEAL-04.
Alternate flows
| Flow | Step | What happens | Tested |
|---|---|---|---|
A1 | 2 | Nhiều người mua cùng yêu cầu COD trên một tin: mỗi người có đơn riêng; chốt giá không giữ hàng (BR-DEAL-04). | — |
Exception flows
| Flow | Step | What happens | Error code | Tested |
|---|---|---|---|---|
E1 | 1 | Tài khoản đang bị tạm khóa BR-MOD-02 | account_suspended | ✓ |
E2 | 1 | Địa chỉ không thuộc người mua | address_not_found | ✓ |
E3 | 2 | Người mua đã đủ số đơn COD đang mở BR-DEAL-06 | cod_limit_reached | ✓ |
E4 | 2 | Tin không còn đang bán | listing_unavailable | ✓ |
E5 | 2 | Thương lượng chưa chốt giá hoặc đã có đơn đang mở | move_not_allowed | ✓ |
Implemented in: 6 · Tested by: 5
Implemented in
-
internal/deal/service/deal_move.go:87 -
internal/deal/service/order_request.go:8 -
internal/deal/service/order_request_durable.go:38 -
internal/deal/service/order_request_durable.go:48E1, E2 -
internal/deal/service/order_request_durable.go:73E4, E5, E3 -
internal/deal/service/service.go:89
Tested by
UC-DEAL-04 Ship an order (GHTK/GHN waybill or a typed code) Done
Main flow
- Người bán chọn tạo vận đơn qua hãng đã liên kết (điểm lấy hàng, dịch vụ, khối lượng), hoặc nhập mã vận đơn đã tạo trên ứng dụng của hãng đó.
- Hệ thống giữ tin đăng cho đơn.
- Hệ thống tạo vận đơn trên tài khoản hãng của người bán, thu hộ tiền hàng, người nhận trả phí ship; với mã nhập tay, hệ thống đọc vận đơn bằng tài khoản hãng của người bán.
- Đơn chuyển sang đã gửi; các đơn chờ khác trên tin tự hủy với lý do "đã gửi cho người khác".
- Hệ thống bắt đầu đếm thời hạn hãng lấy hàng và theo dõi trạng thái vận đơn.
Alternate flows
| Flow | Step | What happens | Tested |
|---|---|---|---|
A1 | 1 | Ứng dụng gửi lại cùng một yêu cầu: trả đúng kết quả lần đầu, không tạo thêm vận đơn. | — |
A2 | 4 | Hãng báo vận đơn nhập tay đã giao: hệ thống hẹn giờ tự hoàn tất đơn. | ✓ |
A3 | 5 | Người bán sửa mã vận đơn nhập tay khi hàng chưa giao. | ✓ |
Exception flows
| Flow | Step | What happens | Error code | Tested |
|---|---|---|---|---|
E1 | 3 | Mã vận đơn không thuộc tài khoản hãng của người bán BR-DEAL-12 | shipment_not_found | ✓ |
E2 | 1 | Hệ thống không bật hãng vận chuyển nào | carrier_unavailable | ✓ |
E3 | 1 | Người bán chưa liên kết hãng | carrier_not_linked | ✓ |
E4 | 3 | Hãng không giao tới địa chỉ; tin đăng được trả lại | carrier_address_unknown | — |
E5 | 2 | Tin không còn đang bán | listing_unavailable | ✓ |
E6 | 3 | Vận đơn sai quy tắc hoặc hãng báo vận đơn hỏng | invalid_shipment | ✓ |
E7 | 4 | Đơn bị hủy cùng lúc: tin đăng được trả lại, vận đơn vừa tạo bị hủy trên hãng | ✓ | |
E8 | 1 | Đơn không còn chờ gửi hoặc không phải của người bán | move_not_allowed | ✓ |
Implemented in: 16 · Tested by: 13
Implemented in
-
internal/deal/service/order_ship_durable.go:44 -
internal/deal/service/order_ship_durable.go:86E5 -
internal/deal/service/order_ship_durable.go:91 -
internal/deal/service/order_ship_durable.go:127E4 -
internal/deal/service/order_ship_durable.go:144 -
internal/deal/service/order_ship_durable.go:157 -
internal/deal/service/order_ship_durable.go:163A2 -
internal/deal/service/order_ship_durable.go:170E7 -
internal/deal/service/order_shipment_create.go:28 -
internal/deal/service/order_shipment_create.go:37E6 -
internal/deal/service/order_shipment_create.go:57E1, E2 -
internal/deal/service/order_shipment_create.go:58E3 -
internal/deal/service/order_shipment_edit.go:16A3 -
internal/deal/service/service.go:96 -
internal/deal/service/service.go:101A3 -
internal/deal/service/service.go:112
Tested by
-
internal/deal/domain/order_test.go:157E6, E8 -
internal/deal/service/flow_test.go:78 -
internal/deal/service/flow_test.go:145 -
internal/deal/service/flow_test.go:165A3 -
internal/deal/service/flow_test.go:201 -
internal/deal/service/flow_test.go:220E5 -
internal/deal/service/flow_test.go:265E7 -
internal/deal/service/flow_test.go:298E1, E6, E8 -
internal/deal/service/flow_test.go:362 -
internal/deal/service/no_carrier_test.go:28E2 -
internal/deal/service/order_timers_test.go:152A2 -
internal/deal/service/shipping_test.go:31E3 -
internal/deal/service/shipping_test.go:96
UC-DEAL-05 Track an order and inspect on delivery Done
Main flow
- Hãng lấy hàng và báo trạng thái về hệ thống; ứng dụng cập nhật màn hình đơn và gửi thông báo đẩy. Hãng không báo thì hệ thống hỏi lại mỗi 2 giờ.
- Shipper mang hàng tới cửa người mua.
- Người mua xem hàng, đồng ý nhận và trả tiền hàng cùng phí ship chiều đi cho shipper.
- Hãng báo đã giao; người mua bấm đã nhận hàng; hệ thống chuyển đơn sang hoàn tất, đánh dấu tin đã bán và đóng thương lượng.
Alternate flows
| Flow | Step | What happens | Tested |
|---|---|---|---|
A1 | 4 | Hãng báo lặp cùng một trạng thái của cùng một vận đơn: hệ thống chỉ ghi nhận lần đầu, đơn không đổi trạng thái hai lần. | ✓ |
A2 | 4 | Người mua bấm đã nhận hàng trước khi hãng báo: đơn hoàn tất ngay. | ✓ |
A3 | 4 | Đơn đã báo giao mà người mua chưa nhận được hàng: người mua gửi phiếu Báo chưa nhận hàng (UC-MOD-09). | — |
A4 | 4 | Hãng báo đã giao mà người mua không bấm: 3 ngày sau hệ thống tự hoàn tất đơn. BR-DEAL-11 | ✓ |
Exception flows
| Flow | Step | What happens | Error code | Tested |
|---|---|---|---|---|
E1 | 1 | Hãng chưa lấy hàng sau 3 ngày: đơn bị hủy, vận đơn trên tài khoản hãng bị hủy theo (UC-DEAL-06 A2). | ✓ | |
E2 | 3 | Người mua không ưng hàng: người mua từ chối nhận, không trả đồng nào; hãng hoàn hàng, đơn giao không thành, hãng tính phí hai chiều vào tài khoản người bán. BR-DEAL-08 | ✓ | |
E3 | 4 | Đơn không còn ở trạng thái đã gửi | move_not_allowed | ✓ |
Implemented in: 11 · Tested by: 11
Implemented in
-
internal/deal/service/order_confirm.go:8A2 -
internal/deal/service/order_confirm_durable.go:20A2 -
internal/deal/service/order_confirm_durable.go:31E3 -
internal/deal/service/order_timers_durable.go:119A4 -
internal/deal/service/order_timers_durable.go:146 -
internal/deal/service/service.go:107A2 -
internal/deal/service/service.go:125 -
internal/deal/service/shipment_updated.go:10 -
internal/deal/service/shipment_updated_durable.go:39 -
internal/deal/service/shipment_updated_durable.go:69A1 -
internal/deal/service/shipment_updated_durable.go:81E2
Tested by
-
internal/deal/domain/order_test.go:340A1 -
internal/deal/domain/order_test.go:459E2 -
internal/deal/service/flow_test.go:78A2 -
internal/deal/service/flow_test.go:119A2 -
internal/deal/service/flow_test.go:298E3 -
internal/deal/service/flow_test.go:381E3 -
internal/deal/service/order_test.go:185E1 -
internal/deal/service/order_timers_test.go:121A4 -
internal/deal/service/shipment_updated_test.go:19A1, E2 -
internal/deal/service/shipment_updated_test.go:79 -
internal/deal/service/shipping_test.go:268
UC-DEAL-06 Cancel an order before it ships Done
Main flow
- Một bên chọn hủy đơn.
- Hệ thống hủy đơn, ghi bên hủy và lý do.
- Chốt giá bị bỏ, thương lượng quay lại đang thương lượng.
Alternate flows
| Flow | Step | What happens | Tested |
|---|---|---|---|
A1 | 1 | Người bán không gửi hàng trong 3 ngày: hệ thống tự hủy đơn. | ✓ |
A2 | 1 | Hãng chưa lấy hàng 3 ngày sau khi người bán gửi: hệ thống tự hủy đơn và hủy vận đơn trên tài khoản hãng. | ✓ |
A3 | 1 | Người bán gửi tin cho người mua khác, hoặc ẩn, xóa tin: các đơn chờ gửi trên tin tự hủy. BR-DEAL-04 | ✓ |
Exception flows
| Flow | Step | What happens | Error code | Tested |
|---|---|---|---|---|
E1 | 1 | Đơn đã gửi hàng | move_not_allowed | ✓ |
Implemented in: 11 · Tested by: 10
Implemented in
-
internal/deal/service/deal_move.go:63 -
internal/deal/service/listing_changed.go:14A3 -
internal/deal/service/order_cancel.go:8 -
internal/deal/service/order_cancel_durable.go:20 -
internal/deal/service/order_cancel_durable.go:31E1 -
internal/deal/service/order_request_durable.go:84A1 -
internal/deal/service/order_timers_durable.go:34A1 -
internal/deal/service/order_timers_durable.go:60A2 -
internal/deal/service/service.go:38 -
internal/deal/service/service.go:83 -
internal/deal/service/service.go:143A3
Tested by
-
internal/deal/domain/order_test.go:157E1 -
internal/deal/service/listing_changed_test.go:90A3 -
internal/deal/service/order_cancel_test.go:13 -
internal/deal/service/order_test.go:76 -
internal/deal/service/order_test.go:185 -
internal/deal/service/order_test.go:218A3 -
internal/deal/service/order_test.go:301A3 -
internal/deal/service/order_timers_test.go:72A1 -
internal/deal/service/order_timers_test.go:89A2 -
internal/deal/service/shipping_test.go:216A2
After the sale and trust
UC-TRS-01 Review the other side and reply to a review Not traced
Not specified yet.
UC-TRS-04 View trust figures and limits Not traced
Not specified yet.
Operations
UC-MOD-01 Report a violation Not traced
Not specified yet.
UC-MOD-02 Handle reports and suspend accounts Not traced
Not specified yet.
UC-MOD-04 Manage moderator accounts Not traced
Not specified yet.
UC-MOD-05 Search the audit log Not traced
Not specified yet.
UC-MOD-06 Handle a report case with the agent's proposal Planned
Main flow
- Báo cáo mới tới; hệ thống gom báo cáo theo tài khoản bị báo thành một ca và cho agent đọc ca ở nền.
- Agent đọc tin, ảnh giống nhau, giá tham khảo, các cuộc chat bị báo và lịch sử tài khoản bằng các công cụ chỉ đọc, rồi ghi bằng chứng và một đề xuất (ẩn tin, tạm khóa, nhắn người mua).
- Điều phối viên mở ca, xem bằng chứng và đề xuất, tick hoặc bỏ tick từng dòng.
- Điều phối viên bấm làm theo; console gọi các thao tác của console, mỗi thao tác một dòng nhật ký.
- Khối đề xuất chuyển thành đã làm, ghi người làm và thời điểm, kèm Hoàn tác.
Alternate flows
| Flow | Step | What happens |
|---|---|---|
A1 | 3 | Điều phối viên nhắn để agent sửa đề xuất; agent trả lời bằng bản kế tiếp, bản cũ thu gọn. |
A2 | 3 | Điều phối viên chọn Không vi phạm; ca đóng, không thao tác nào trên tài khoản. |
A3 | 5 | Điều phối viên bấm Hoàn tác; hệ thống làm ngược từng thao tác, bỏ qua thao tác đã đổi từ trước, tin đã gửi cho người mua giữ nguyên. |
A4 | 2 | Ca liên quan một nhóm tài khoản: agent vẽ đồ thị liên kết và đề xuất cho cả nhóm. |
UC-MOD-07 Answer a ticket with the agent's reply Planned
Main flow
- Ticket mới hoặc tin nhắn mới của người gửi tới; agent đọc ticket, đơn, vận đơn và soạn câu trả lời ở nền.
- Điều phối viên mở ticket, xem phần agent đọc và câu trả lời soạn sẵn.
- Điều phối viên bấm gửi; câu trả lời vào cuộc chat của ticket dưới tên chung của sàn.
Alternate flows
| Flow | Step | What happens |
|---|---|---|
A1 | 2 | Điều phối viên nhắn để agent viết lại; agent trả lời bằng bản kế tiếp. |
A2 | 2 | Điều phối viên sửa trực tiếp câu trả lời rồi gửi. |
A3 | 2 | Điều phối viên tự viết trong cuộc chat với khách, không dùng câu trả lời soạn sẵn. |
UC-MOD-08 Ask the agent about a ticket, a report case or an account In progress
Main flow
- Thành viên mở cuộc chat với agent của một bản ghi, hoặc cuộc chat mới gắn một bản ghi.
- Thành viên đặt câu hỏi; mỗi câu hỏi ghi tên người hỏi, cuộc chat của bản ghi dùng chung cho mọi thành viên.
- Agent dùng các công cụ chỉ đọc, hiện nguồn đã đọc, rồi trả lời bằng chữ và các khối (bằng chứng, bảng, đồ thị).
Alternate flows
| Flow | Step | What happens |
|---|---|---|
A1 | 3 | Quá 60 giây: lượt dừng, thành viên hỏi lại hoặc cho chạy nền và được báo khi xong. |
A2 | 3 | Thành viên bấm Dừng; lượt bị hủy, phần đã đọc giữ lại. |
Exception flows
| Flow | Step | What happens | Error code |
|---|---|---|---|
E1 | 3 | Hết hạn mức chi phí trong ngày: agent không trả lời, console vẫn dùng được. |
Implemented in: 23 · Tested by: 13
Implemented in
-
internal/agent/service/ask.go:16 -
internal/agent/service/ask.go:41E1 -
internal/agent/service/ask.go:84 -
internal/agent/service/ask.go:101 -
internal/agent/service/ask.go:104A1 -
internal/agent/service/conversations.go:33 -
internal/agent/service/conversations.go:57 -
internal/agent/service/conversations.go:74 -
internal/agent/service/conversations.go:124 -
internal/agent/service/conversations.go:143 -
internal/agent/service/events.go:32 -
internal/agent/service/reads.go:16 -
internal/agent/service/service.go:35 -
internal/agent/service/service.go:41 -
internal/agent/service/service.go:45 -
internal/agent/service/service.go:50 -
internal/agent/service/service.go:56 -
internal/agent/service/service.go:61 -
internal/agent/service/service.go:65 -
internal/agent/service/service.go:84 -
internal/agent/service/service.go:164 -
internal/agent/service/turns.go:57 -
internal/agent/service/turns.go:113
Tested by
-
e2e/agent_mcp_test.go:110 -
e2e/agent_runs_test.go:38A1 -
e2e/agent_test.go:26A1 -
internal/agent/handler/turns_test.go:69 -
internal/agent/service/mentions_test.go:22 -
internal/agent/service/service_test.go:159 -
internal/agent/service/service_test.go:250 -
internal/agent/service/service_test.go:314A1 -
internal/agent/service/service_test.go:369 -
internal/agent/service/service_test.go:441 -
internal/agent/service/service_test.go:491 -
internal/agent/service/service_test.go:518 -
internal/agent/service/service_test.go:573
UC-MOD-09 Open a support ticket Not traced
Not specified yet.
Shared use cases («include»)
UC-SHR-01 Upload photos Not traced
Not specified yet.
UC-SHR-02 Write the audit log Not traced
Not specified yet.