Bỏ qua

Tài liệu kỹ thuật — đọc thế nào

Vùng này do MÁY SINH

Mọi trang dưới đây được tool/render-phe-duyet.py dựng từ kho mã nguồn: khung, tên và tiêu chí dự kiến từ repo hoạch định; nội dung BRD/URD/PRD từ hồ sơ của thay đổi đã đóng ở bốn hệ thống con. Sửa ở đây là mất khi render lại — sai sót thì sửa ở nguồn ghi trong dòng đầu mỗi trang.

Cách tổ chức

Menu chia hai mục theo hệ thống: Admin (cổng quản trị nội bộ) và Portal (cổng bên thứ ba). Dưới mỗi mục là epic theo tên nghiệp vụ; dưới mỗi epic là các nhóm việc — mỗi nhóm một trang. Nhóm việc là đơn vị gộp mọi story cùng một tính năng, cả phần máy chủ lẫn giao diện. Nhóm nào chạm cả hai hệ (ví dụ bên thứ ba nộp, ngân hàng duyệt) thì cùng một trang xuất hiện ở cả hai mục — không cắt đôi hành trình.

Ba phần trong mỗi trang, theo thứ tự đọc, và mỗi phần ở đúng tầng của nó:

Phần Trả lời câu Ở đâu
Vì sao làm — BRD giá trị nghiệp vụ Trang epic (mục tiêu + nhóm yêu cầu trong PRD). Trang nhóm chỉ ghi mỗi story góp gì
Ai dùng, dùng thế nào — URD một hành trình cho cả nhóm Trang nhóm, từ story giao diện. Nhóm không có giao diện ⇒ ghi rõ không cần, có vết
Hệ làm gì, ràng buộc gì — PRD yêu cầu từng phần Trang nhóm, mỗi story một mục, máy chủ trước, giao diện sau

Trạng thái

Khung của toàn bộ 72 story đợt 1 có sẵn từ đầu. Story chưa có hồ sơ hiển thị tiêu chí dự kiến từ kế hoạch đã qua cổng duyệt, kèm mốc chờ; story đã đóng thay đổi thì hiển thị hồ sơ thật, ghi rõ nguồn. Nhãn 🟡 / 🟢 ở đầu mỗi trang nhóm nói còn bao nhiêu story chờ.

Ai viết, ai duyệt

Nội dung do agent của làn thi công viết khi đóng thay đổi. Người chỉ đọc, phản hồi và duyệt.

Danh sách theo hệ thống

Admin — cổng quản trị nội bộ

Portal — cổng bên thứ ba

Đợt 2 (E-008–E-011) chưa chia story nên chưa có ở đây — cố ý để trống.

Quyết định tài liệu cho change KHÔNG gắn story

Vùng này xếp theo epic → nhóm việc → story, nên một change không gắn story không có trang nào nhận nó. Quyết định tài liệu của những change đó ghi ở đây.

Change Repo Quyết định Vì sao
2026-09-07-tra-no-luoi-portal-be portal-be khong-can · PO duyệt 07/09/2026 Trả nợ lưới: che dữ liệu cá nhân ở tầng log bằng mã (không bằng cấu hình, vì mức log ghi đè được lúc chạy), dọn rò trạng thái giữa các lớp kiểm, cổng hợp đồng đối chiếu với phản hồi thật. Không đổi thứ gì người dùng cuối nhìn thấy.

⚠️ Một khoản nợ có tên, đừng để mất. Change trên còn ghim định dạng thời gian AD-28 cho Instant — tức đổi hình dạng ba trường thời gian trên bề mặt API, thứ mà kỹ sư tích hợp của bên thứ ba đọc. Hôm nay nó thuộc openapi.yaml (hiện vật integrator đọc trực tiếp) chứ không thuộc trang hướng dẫn nào, vì vùng Hướng dẫn cho bên thứ ba chưa có mục hợp đồng API. ⇒ Khi mục đó được viết, định dạng ISO-8601 cho Instant phải được nêu trong đó. Ghi ở đây vì nếu không, nó mất cùng lúc với việc change này rời khỏi tầm mắt.

⚠️ Khoá docs: của change này để trống trong link.yaml và giữ nguyên — hồ sơ đã archive, mà PO chốt 07/09/2026: archive là BẤT BIẾN. inbox --role docs mục [D3] sẽ kê nó vĩnh viễn: lỗ thật đã có người quyết, không phải việc còn tồn.