Yêu cầu Quy tắc và chất lượng
Quy tắc và chất lượng
Yêu cầu chức năng, quy tắc nghiệp vụ, yêu cầu phi chức năng và quyết định kiến trúc.
Mọi người Tham chiếu 5 phút đọc
Yêu cầu chức năng
| Mã | Diễn biến | Ca sử dụng |
|---|---|---|
FR-ACC-01 | Đăng nhập bằng số điện thoại, mã gửi qua email hoặc tài khoản Google; tự tạo tài khoản ở lần đầu | |
FR-ACC-02 | Liệt kê phiên, đăng xuất một thiết bị hoặc mọi thiết bị | |
FR-ACC-03 | Sửa tên hiển thị; chặn và bỏ chặn người dùng | |
FR-ACC-04 | eKYC: chụp hai mặt CCCD, đọc chip NFC, quét khuôn mặt; chuyển duyệt tay khi không đọc được chip | |
FR-ACC-05 | Thiết lập giao COD: địa chỉ lấy hàng, liên kết tài khoản GHTK/GHN của người bán | |
FR-SHR-01 | Tải ảnh lên, chuẩn hóa ảnh, xóa thông tin vị trí chụp | |
FR-LST-01 | Đăng tin từ video, ảnh hoặc link Chợ Tốt với AI điền giúp; gợi ý giá từ tin tương tự; lưu nháp | |
FR-LST-02 | Quản lý tin: sửa, đổi giá, ẩn/hiện, đánh dấu đã bán, xóa | |
FR-LST-03 | Đẩy tin và gói người bán | |
FR-DSC-01 | Tìm kiếm bằng câu tự nhiên: AI đọc câu thành điều kiện, trả chip tắt được và câu diễn giải; tìm bằng ảnh | |
FR-DSC-02 | Tìm theo bộ lọc, duyệt danh mục, xem tin tương tự | |
FR-DSC-03 | Lưu tin, báo giảm giá dưới mức đặt, theo dõi tìm kiếm, theo dõi người bán, ẩn tin | |
FR-DEAL-01 | Nhắn tin văn bản và ảnh, đánh dấu đã đọc, tìm trong hộp thư, cập nhật thời gian thực | |
FR-DEAL-02 | Thương lượng giá theo BR-DEAL-03 | |
FR-DEAL-03 | Yêu cầu COD; tạo vận đơn GHTK/GHN trên tài khoản người bán hoặc nhập mã; hủy trước khi gửi | |
FR-DEAL-04 | Nhận trạng thái vận đơn từ hãng, hỏi lại mỗi 2 giờ; cập nhật đơn, thương lượng, tin đăng; tự hoàn tất và tự hủy theo thời hạn | |
FR-TRS-01 | Đánh giá hai chiều sau đơn, người được đánh giá trả lời một lần | |
FR-TRS-02 | Ghi nhận sự cố kèm nhận xét trung lập của AI | |
FR-TRS-03 | Tính số liệu uy tín: sao trung bình khi bán và khi mua, số món đã bán, tỉ lệ trả lời trong 24 giờ, đơn giao không thành trong 90 ngày | |
FR-TRS-04 | Cảnh báo dấu hiệu lừa đảo trong trò chuyện; người dùng tắt được cảnh báo | |
FR-MOD-01 | Báo cáo vi phạm; nhân viên xử lý và tạm khóa tài khoản | |
FR-SHR-02 | Thông báo trong ứng dụng và đẩy tới điện thoại; công tắc theo loại và giờ yên lặng | |
FR-MOD-02 | Quản lý thành viên console, đăng nhập riêng cho nhân viên, nhật ký kiểm toán | |
FR-MOD-03 | Agent của console đọc ca báo cáo và ticket, trình bằng chứng, đề xuất thao tác và soạn câu trả lời; nhân viên duyệt, sửa bằng tick hoặc chat, làm theo và hoàn tác | |
FR-MOD-04 | Phiếu hỗ trợ là một cuộc trò chuyện giữa người dùng và sàn; nhân viên trả lời trên console |
Quy tắc nghiệp vụ
| Mã | Diễn biến |
|---|---|
BR-DEAL-01 | Sàn không giữ tiền: không ví, không cọc, không thu hộ, không hoàn tiền qua sàn. |
BR-LST-01 | Tin đăng gồm tình trạng hàng theo thang Mới / Như mới / Đã dùng, các thông tin người bán ghi trong tin và ảnh; tin không có phần khai vết, AI không chỉ ra vết nào. |
BR-DEAL-02 | Người mua tự xem hàng khi đồng kiểm tại cửa rồi nhận hoặc từ chối; ứng dụng không gợi ý cần kiểm gì. |
BR-LST-02 | Chỉ tài khoản có số điện thoại đã xác minh và không bị tạm khóa mới được đăng tin; mỗi người có tối đa 20 tin đang bán. |
BR-LST-03 | Tiêu đề 1–70 ký tự; giá nguyên đồng từ 10.000 đến 1.000.000.000; mô tả ≤ 1.500 ký tự; 1–10 ảnh, ảnh đầu là ảnh bìa; ≤ 20 thông số; vị trí lưu theo phường/xã (tọa độ tâm xã), không lưu GPS của người bán. |
BR-DEAL-03 | Giá thương lượng là bội số 1.000 đ; giá trả ≥ nửa giá niêm yết (làm tròn lên 1.000) và thấp hơn giá niêm yết hoặc phản giá; phản giá cao hơn giá trả và thấp hơn giá niêm yết; mỗi thời điểm chỉ một giá đang mở, giá mở không hết hạn; chấp nhận phải đúng giá mà người chấp nhận đang thấy, nếu giá vừa bị đổi thì lượt chấp nhận bị từ chối và ứng dụng báo giá đã thay đổi. |
BR-DEAL-04 | Chốt giá không giữ hàng; nhiều người mua có thể cùng chốt một tin; khi người bán gửi hàng cho một người, các yêu cầu COD khác trên tin tự hủy với lý do "đã gửi cho người khác". |
BR-DEAL-05 | COD đồng kiểm qua GHTK hoặc GHN trên tài khoản của người bán là đường giao dịch duy nhất trong ứng dụng; vận đơn thu hộ tiền hàng và đặt người nhận trả phí ship; người mua chỉ trả tiền sau khi xem hàng. |
BR-DEAL-06 | Một người mua có tối đa 3 đơn COD đang mở. |
BR-DEAL-07 | Người mua hoặc người bán hủy được đơn khi người bán chưa gửi; người bán không gửi trong 3 ngày thì đơn tự hủy; hãng chưa lấy hàng 3 ngày sau khi gửi thì đơn bị hủy và vận đơn trên tài khoản hãng bị hủy theo. |
BR-DEAL-08 | Từ chối nhận tại cửa: người mua không mất tiền; phí hai chiều do hãng tính vào tài khoản người bán; tin đăng mở bán lại. |
BR-DEAL-09 | Sau khi người mua đã trả tiền cho shipper, sàn không có cơ chế đòi lại; Trợ giúp ghi điều này, màn nhận hàng không nhắc. |
BR-DEAL-11 | Đơn hoàn tất khi người mua bấm đã nhận hàng, hoặc 3 ngày sau khi hãng báo đã giao; hãng báo không giao được hoặc hoàn hàng thì đơn giao không thành. |
BR-DEAL-12 | Mã vận đơn người bán nhập tay phải thuộc tài khoản GHTK/GHN mà người bán đã liên kết; hãng khác được xin thêm qua phiếu hỗ trợ. |
BR-DEAL-10 | Món giá trên 5.000.000 đ: ứng dụng gợi ý hẹn gặp xem hàng trước, vẫn cho chọn COD. |
BR-TRS-01 | Ghi nhận sự cố không được phân xử; người bán trả lời trong 3 ngày bằng tự hoàn hoặc từ chối; ghi nhận bị từ chối hoặc quá hạn hiển thị công khai trên hồ sơ người bán. |
BR-TRS-02 | Chế tài tự động chỉ xét khi có ≥ 5 đơn COD trong 90 ngày; tỉ lệ từ chối nhận ≥ 20% thì giới hạn còn 1 đơn COD mở, ≥ 35% thì mất quyền COD 30 ngày; mỗi 30 ngày không có lần từ chối nào hồi lại một nấc; đơn tự gửi không tính vào tỉ lệ. |
BR-TRS-03 | Điểm uy tín 0–1000 tính theo bảng sự kiện; quyền COD và bậc uy tín không mua được bằng gói trả phí. |
BR-TRS-04 | Sau khi đơn hoàn tất, người mua và người bán đánh giá nhau mỗi người một lần (1–5 sao, ≤ 500 ký tự); đánh giá ẩn cho đến khi bên kia cũng đánh giá hoặc qua 7 ngày; người được đánh giá trả lời một lần (≤ 500 ký tự), sau đó đánh giá khóa lại; trước khi có câu trả lời, người viết sửa hoặc xóa được trong 7 ngày. |
BR-TRS-05 | Uy tín hiển thị bằng số liệu quan sát được, không có điểm hay bậc; hạn mức như nhau cho mọi tài khoản và không mua được bằng gói trả phí; tỉ lệ trả lời chỉ tính khi có từ 5 cuộc trò chuyện trong 90 ngày. |
BR-TRS-06 | Cảnh báo lừa đảo cần ít nhất một dấu hiệu trong tin nhắn; số điện thoại, số tài khoản, số thẻ, email và link được che trước khi AI đọc; cảnh báo đã tắt hiện lại khi có dấu hiệu mới. |
BR-DSC-01 | AI tìm kiếm chỉ đọc câu tìm: không đặt hàng, không thương lượng, không nhắn tin thay người dùng; mọi điều kiện AI đặt ra hiện thành chip người dùng tắt được. |
BR-MOD-01 | Nhân viên chỉ xử lý phiếu hỗ trợ, hàng cấm và hàng giả bị báo cáo, lừa đảo có tổ chức và yêu cầu của cơ quan có thẩm quyền; giá và tình trạng hàng là việc giữa hai bên. |
BR-ACC-01 | Chặn có hiệu lực hai chiều: hai bên không nhắn tin, không mở thương lượng trên tin của nhau. |
BR-ACC-02 | Không luồng nào tiết lộ một số điện thoại hoặc email đã có tài khoản hay chưa; khi người dùng mở nội dung không thuộc quyền xem của mình, hệ thống trả lời như thể nội dung đó không tồn tại. |
BR-ACC-03 | Tài khoản phải có số điện thoại mới được đăng tin, mở thương lượng hoặc mở cuộc trò chuyện. |
BR-MOD-02 | Tài khoản đang bị tạm khóa không được trả giá, chấp nhận giá hay yêu cầu COD; vẫn được rút giá, từ chối và hủy. |
BR-MOD-03 | Agent của console chỉ đọc và đề xuất; mọi thay đổi do nhân viên bấm và được ghi nhật ký thao tác; tin nhắn gửi cho người dùng luôn mang tên chung của sàn. |
Yêu cầu phi chức năng
| Mã | Thuộc tính | Diễn biến |
|---|---|---|
NFR-DUR-01 | Độ bền | Máy chủ gặp sự cố giữa một quy trình nhiều bước không để lại dữ liệu dở dang; quy trình chạy tiếp từ bước đã xong và không lặp việc đã làm (không tạo hai vận đơn, không gửi hai email mã đăng nhập). |
NFR-IDEM-01 | Không lặp khi gửi lại | Một thao tác được ứng dụng gửi lại vì mạng chập chờn cho đúng kết quả của lần đầu; hãng báo trùng một trạng thái thì đơn không đổi trạng thái hai lần. |
NFR-CONC-01 | Nhất quán khi đồng thời | Hai người cùng sửa một dữ liệu thì người sửa sau được báo dữ liệu đã thay đổi thay vì ghi đè; các hạn mức (số đơn COD đang mở, số tin đang bán) vẫn đúng khi nhiều yêu cầu đến cùng lúc. |
NFR-MSG-01 | Không mất thông báo giữa phân hệ | Thông báo cho các phân hệ khác được ghi cùng lúc với thay đổi dữ liệu; khi phần điều phối quy trình tạm ngừng, thông báo được giữ lại và gửi sau, người dùng vẫn xem được dữ liệu và giữ được phiên đăng nhập. |
NFR-PERF-01 | Hiệu năng | 95% lượt xem dữ liệu trả về dưới 300 ms; 95% lượt tìm kiếm có câu đã đọc trả về dưới 800 ms; mô hình đọc câu quá 4 giây thì hệ thống tìm bằng câu gốc. |
NFR-SEC-01 | An toàn xác thực | Phiên đăng nhập ngắn hạn sống 15 phút và được làm mới tự động; mã làm mới bị dùng lại thì phiên bị thu hồi; có hạn mức gửi OTP; không lộ việc một số điện thoại hay email đã có tài khoản. |
NFR-PRIV-01 | Quyền riêng tư | Xóa thông tin vị trí chụp khỏi ảnh; vị trí tin theo xã; che số điện thoại, email trong nhật ký; mã hóa khóa kết nối tài khoản hãng vận chuyển của người bán. |
NFR-OBS-01 | Quan trắc | Mọi yêu cầu được theo vết; thông báo lỗi mang mã tra cứu để đối chiếu nhật ký; có số liệu đăng nhập, gửi OTP và thông báo đã gửi giữa các phân hệ. |
NFR-PERF-02 | Hiệu năng | Một lượt hỏi agent của console trả lời trong 60 giây hoặc dừng và cho chạy nền, báo khi xong. |
NFR-PRIV-02 | Quyền riêng tư | Mỗi lần agent của console đọc dữ liệu cá nhân được ghi lại kèm nhân viên đã hỏi; cuộc chat với agent giữ 180 ngày; xóa tài khoản thì xóa các phần trích dữ liệu của tài khoản đó. |
NFR-API-01 | Tuân thủ hợp đồng API | Mọi yêu cầu được kiểm theo đặc tả API; bộ kiểm thử đầu-cuối gặp đủ mọi kết quả trả về đã khai trong đặc tả. |
NFR-ARCH-01 | Khả năng tách phân hệ | Mỗi phân hệ chỉ cho phân hệ khác dùng qua giao diện đã công bố; tách ra chạy riêng không phải sửa nghiệp vụ. |
NFR-UX-01 | Ứng dụng di động | Ứng dụng chạy trên Android 12 trở lên, có giao diện tối, cỡ chữ 130%, vùng chạm tối thiểu 48 dp; website dùng được ở bề rộng điện thoại. |
Quyết định kiến trúc
| Mã | Tên |
|---|---|
ADR-0001 | Sàn không giữ tiền, giao dịch bằng COD qua tài khoản hãng của người bán Vận đơn được tạo trên tài khoản GHTK/GHN của chính người bán; tiền hàng do hãng thu hộ trả thẳng cho người bán. Sàn không có ví, không cọc, không hoàn tiền, nên cũng không phải phân xử ai được nhận tiền (BR-DEAL-01). |
ADR-0002 | Quy trình nhiều bước chạy trên Restate Mỗi quy trình gọi ra ngoài nhiều bước (giữ tin, tạo vận đơn, lưu đơn) là một service Restate: từng bước được ghi lại, máy chủ chết giữa chừng thì chạy tiếp từ bước đã xong, gọi lại cùng khóa thì trả kết quả lần đầu (NFR-DUR-01, NFR-IDEM-01). |
ADR-0003 | Agent của console chạy riêng, đọc qua MCP của máy chủ Vòng lặp agent là dịch vụ riêng (shopnexus/agent) trong mạng nội bộ; console chỉ gọi máy chủ, máy chủ kiểm phiên rồi chuyển tiếp. Agent lấy dữ liệu qua MCP của máy chủ, chỉ có công cụ đọc; mọi thao tác ghi đi qua các endpoint console có nhật ký (BR-MOD-03). Việc chạy nền do Restate của máy chủ gọi agent (ADR-0002). |