Tiêu chuẩn code
Chủ dự án 18.10.2026 (SRC-1435): có cần Context7, Zod hay giới hạn số dòng không. Trả lời ngắn: Context7 và Zod đã có sẵn, thiếu là luật dùng chúng và giới hạn kích thước file. Nguồn một nguồn: coding-conventions §8.
| # | Luật | Máy giữ |
|---|---|---|
| 1 | File code mới tối đa 500 dòng. Component lớn tách theo màn con; dữ liệu và nội dung ở JSON hoặc D1 | cổng check-file-size |
| 2 | TypeScript strict, không thêm any, không @ts-ignore | typecheck |
| 3 | Dữ liệu từ ngoài vào (body, query, webhook, JSON từ R2/D1/API ngoài) kiểm tại cửa bằng Zod | review |
| 4 | Tra tài liệu thư viện bằng Context7 trước khi viết; ghim số phiên bản; không thêm thư viện UI thứ hai | check-design-stack, check-deps |
| 5 | Test hành vi qua request thật; cấm test regex trên mã nguồn và test khớp chữ UI | review |
| 6 | Chú thích nói vì sao, không nói cái gì | review |
| 7 | Định danh tiếng Anh, chữ người dùng theo bề mặt | check-english-identifiers |
Vì sao 500 dòng: file lớn là chỗ các phiên song song đụng nhau và là chỗ agent dễ mất mạch. Repo đang có component 2.517 dòng (Learning.tsx) và dữ liệu khoá học 5.207 dòng nằm trong file .ts. File cũ không bị chặn; chúng nhỏ đi dần mỗi khi được sửa.