Skip to content

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ạiSố mãCó file test nhắc tớiChưa có
Acceptance criteria (user story)106105 (99%)1
Business rule184132 (72%)52
Quyết định243180 (74%)63
NFR66 (100%)0
GAP604271 (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ùngThư mục
Backendcode/apps/api/supabase/functions
Web Admincode/apps/web-admin/src
Kit @pi/uicode/packages/web-ui/src
User Appcode/apps/app-user/lib
Sale Appcode/apps/app-sale/lib
pi_featurescode/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ữ.

Sinh từ ad83b0aea · 820 migration · PostgreSQL 17