1. Giới thiệu
Hệ thống Quản Lý Sinh Viên tuân thủ các quy tắc sau để đảm bảo mã nguồn nhất quán, dễ đọc, dễ bảo trì và phù hợp với chuẩn cộng đồng Node.js/TypeScript/React:
- Language Convention (Quy ước ngôn ngữ): Tuân thủ chuẩn ES6+, TypeScript, React.
- Formatting Conventions (Định dạng): Định dạng mã nguồn nhất quán, rõ ràng.
- Naming Conventions (Quy tắc đặt tên): Đặt tên biến, hàm, class, file… theo quy tắc thống nhất.
2. Language Convention (Quy ước ngôn ngữ)
2.1. Sử dụng ES6+ và TypeScript
- Quy tắc: Luôn sử dụng cú pháp ES6+ (let/const, arrow function, destructuring, spread, v.v.) và tận dụng TypeScript để kiểm soát kiểu dữ liệu.
✅ Code đúng:
const sum = (a: number, b: number): number => a + b;
interface Student {
id: string;
fullName: string;
}
❌ Code sai:
var sum = function(a, b) { return a + b; }
function Student(id, fullName) {
this.id = id;
this.fullName = fullName;
}
2.2. Xử lý bất đồng bộ với async/await
- Quy tắc: Luôn dùng async/await cho các thao tác bất đồng bộ (API, DB, v.v.), không dùng callback hoặc promise chaining.
✅ Code đúng:
const students = await studentService.getAll();
❌ Code sai: