Giao diện
Truy vết yêu cầu → code → test
Trang sinh tự động
Quét 8.992 file nguồn tại commit ad83b0aea và thu 1.143 mã yêu cầu được nhắc trong comment hoặc trong code.
Code của dự án ghi mã yêu cầu ngay trong comment. Ví dụ một trang Admin mở đầu bằng danh sách AC nó cài, một hàm SQL ghi mã quyết định đã đổi hành vi của nó. Bộ sinh quét những mã đó và dựng bảng dưới đây.
Đây là truy vết theo nhắc tên, không phải bằng chứng cài đúng
Một mã có test nghĩa là có test nhắc tới nó — test đó đúng hay đủ thì chỉ người đọc test mới biết. Chiều đáng tin là chiều phủ định: mã không xuất hiện ở đâu thì chắc chắn chưa có dấu vết trong code.
Theo loại mã
| Loại | Số mã | Có file test nhắc tới | Chưa có |
|---|---|---|---|
| Acceptance criteria (user story) | 106 | 105 (99%) | 1 |
| Business rule | 184 | 132 (72%) | 52 |
| Quyết định | 243 | 180 (74%) | 63 |
| NFR | 6 | 6 (100%) | 0 |
| GAP | 604 | 271 (45%) | 333 |
- Acceptance criteria (user story) — Mã AC trong user story của Product. Đây là mã gần nghiệp vụ nhất.
- Business rule — Quy tắc nghiệp vụ trích từ Word/FuncSpec của Product.
- Quyết định — Quyết định của owner hoặc của đợt phát triển. Xem Sổ quyết định.
- NFR — Yêu cầu phi chức năng. Phần lớn là mục tiêu đo, không phải kiểm chặn.
- GAP — Chỗ chưa có quyết định. Mã GAP trong code thường đánh dấu nơi đang chờ.
Vùng được quét
| Vùng | Thư mục |
|---|---|
| Backend | code/apps/api/supabase/functions |
| Web Admin | code/apps/web-admin/src |
| Kit @pi/ui | code/packages/web-ui/src |
| User App | code/apps/app-user/lib |
| Sale App | code/apps/app-sale/lib |
| pi_features | code/packages/app-features/lib |
Bỏ qua node_modules, build, dist, .dart_tool, vendor. File test nhận diện theo tên (*_test.ts, *_test.dart, *.test.tsx).
Cách dùng
Tra một mã để biết nó được cài ở đâu và có test nào chạm tới. Ngược lại, mở một file và đọc các mã trong comment là biết file đó phục vụ yêu cầu nào — đó là lý do quy ước ghi mã trong comment được giữ.