Giới thiệu
Chào mừng bạn đến với NextJS Coding Convention — tài liệu coding convention và checklist dành cho team AutoTMS. Nội dung dựa trên Coding Convention Checklist của team, được tách thành các trang theo chủ đề và bổ sung giải thích, ví dụ để dễ áp dụng.
Mục đích
- Đồng nhất code style — dễ đọc, dễ review và bảo trì
- Áp dụng best practices — Next.js, React, TypeScript, Strapi/Prisma, styling
- Checklist trước khi hoàn thành tính năng — kiểm tra nghiệp vụ, Server Actions, UI, Git, v.v.
- Onboard nhanh — thành viên mới nắm quy ước chung trong thời gian ngắn
Cấu trúc tài liệu (thứ tự đọc gợi ý)
| Thứ tự | Nhóm | Nội dung chính |
|---|---|---|
| 1 | TypeScript | Typing, naming, modules, comments, strings/functions |
| 2 | React | Component, JSX, Props & Refs, hooks, global state, loading & empty |
| 3 | Next.js | Kiến trúc tầng, Prisma, Server Actions, data fetching, authorization |
| 4 | Styling | UI rules, Master screen, responsive, i18n |
| 5 | Kiểm tra nghiệp vụ | Logic đầy đủ, xử lý lỗi, test luồng, mô tả nghiệp vụ |
| 6 | Lỗi thường gặp | Checklist vi phạm hay gặp (comment, inline, import, loading, phân quyền, …) |
Bắt đầu từ TypeScript hoặc mục bạn đang cần.