Thiết kế đơn giản (Emergence)

Vòng 1 - Chạy hết test: viết test trước, code tối thiểu để xanh

// Test truoc - mo ta hanh vi mong muon
// (Vitest)
it('tinh tong gia don hang', () => {
  const items = [
    { price: 100_000, qty: 2 },
    { price: 50_000,  qty: 3 }
  ];
  expect(calcTotal(items)).toBe(350_000);
});

// Code toi thieu de test xanh - chua dep nhung dung
function calcTotal(items: Array<{ price: number; qty: number }>): number {
  let sum = 0;
  for (const item of items) sum += item.price * item.qty;
  return sum;
}

Vòng 2 - Xoá lặp & diễn đạt rõ: refactor sau khi test xanh

// Xoa lap: reduce ngan hon, ro hon
// Dien dat ro: kieu OrderItem dat ten, tham so ten day du
interface OrderItem {
  price: number;
  qty: number;
}

function calcTotal(items: OrderItem[]): number {
  return items.reduce((sum, item) => sum + item.price * item.qty, 0);
}

// Test van xanh - hanh vi khong doi, chi cau truc tot hon

Vòng 3 - Tối thiểu phần tử: đừng thêm gì khi chưa cần

// DUNG: ham co ket qua tinh xac, kieu ro rang, test xanh
// KHONG NEN: tao interface ICalculator chi vi "co the can sau"
// KHONG NEN: tao abstract class BaseCalculator khi chi co mot implementation
// KHONG NEN: them DiscountStrategy pattern khi chua co yeu cau giam gia

// Quy tac 4: moi abstraction can mot ly do HIEN TAI, khong phai tuong lai

Điểm xuất phát - code chạy nhưng chưa qua bộ lọc nào

function registerUser(email: string, pw: string, pw2: string): boolean {
  if (!email.includes('@')) return false;
  if (pw.length < 8) return false;
  if (pw !== pw2) return false;
  db.insert({ email, password: hashPw(pw), createdAt: new Date() });
  return true;
}

// Van de: khong co test; logic lon; magic number 8 khong ten

Sau quy tắc 1 & 2 - test phủ, xoá lặp validation bằng cách tách

// Quy tac 1: test truoc
it('tu choi email sai dinh dang', () => {
  expect(registerUser('khong-at', '12345678', '12345678')).toBe(false);
});
it('tu choi mat khau qua ngan', () => {
  expect(registerUser('a@b.com', '1234567', '1234567')).toBe(false);
});
it('tu choi mat khau khong khop', () => {
  expect(registerUser('a@b.com', '12345678', 'xxxxxxxx')).toBe(false);
});

// Quy tac 2: xoa lap - tach validation thanh ham rieng
const MIN_PASSWORD_LENGTH = 8; // replace magic number

function isValidEmail(email: string): boolean {
  return email.includes('@');
}
function isStrongEnough(password: string): boolean {
  return password.length >= MIN_PASSWORD_LENGTH;
}
function passwordsMatch(pw: string, pw2: string): boolean {
  return pw === pw2;
}

Sau quy tắc 3 & 4 - ý định rõ, không có abstraction thừa

// Quy tac 3: dien dat ro - ham dieu phoi doc nhu van xuoi
function registerUser(email: string, password: string, confirmPassword: string): boolean {
  if (!isValidEmail(email)) return false;
  if (!isStrongEnough(password)) return false;
  if (!passwordsMatch(password, confirmPassword)) return false;
  saveNewUser(email, password);
  return true;
}

function saveNewUser(email: string, password: string): void {
  db.insert({ email, password: hashPw(password), createdAt: new Date() });
}

// Quy tac 4: khong them IUserRepository, UserFactory, ValidationStrategy...
// khi chi co mot implementation va chua co yeu cau mo rong cu the