부록_원칙들의_통합

What = 무엇을 하는가 (의도, 역할, 인터페이스) How = 어떻게 하는가 (구현, 세부사항, 메커니즘)

What/How 분리 │ ┌────────┬───────┬───┴───┬───────┬────────┐ │ │ │ │ │ │ SRP OCP DIP IoC 응집도 결합도

// SRP 위반: What이 두 개 class UserManager { saveToDatabase(user) { /* DB 저장 */ } formatForDisplay(user) { /* 화면 표시 */ } } // 이 클래스는 "DB 저장"과 "화면 표시"라는 두 가지 What을 가져요 // SRP 준수: What이 하나씩 class UserRepository { save(user) { /* DB 저장 */ } } class UserPresenter { format(user) { /* 화면 표시 */ } }

// OCP 위반: 새 타입 추가 시 How를 수정해야 함 function calculateArea(shape) { if (shape.type === 'circle') { return Math.PI * shape.radius ** 2; } else if (shape.type === 'rectangle') { return shape.width * shape.height; } // 삼각형 추가하려면 여기를 수정해야 해요 ❌ } // OCP 준수: What(인터페이스)만 확장 interface Shape { area(): number; // What: 넓이를 구한다 } class Circle implements Shape { area() { return Math.PI * this.radius ** 2; } // How } class Rectangle implements Shape { area() { return this.width * this.height; } // How } // 삼각형 추가: 기존 코드 수정 없이 확장 class Triangle implements Shape { area() { return 0.5 * this.base * this.height; } // 새 How }

// DIP 위반: What이 How에 의존 class OrderService { constructor() { this.db = new MySQLDatabase(); // How(MySQL)에 직접 의존 } } // DIP 준수: What이 What에 의존 interface Database { // What: 데이터를 저장한다 save(data): void; } class OrderService { constructor(db: Database) { // What에 의존 this.db = db; } } // How는 별도로 구현 class MySQLDatabase implements Database { ... } class PostgresDatabase implements Database { ... }

// IoC 없음: 내가 직접 How를 호출 class App { run() { const db = new Database(); const service = new UserService(db); service.start(); } } // IoC 적용: 프레임워크가 How를 주입 // 나는 What(인터페이스)만 정의 @Injectable() class UserService { constructor(private db: Database) {} // What만 선언 } // 프레임워크가 How(실제 구현)를 주입

// 낮은 응집도: 여러 What이 섞임 class Utils { formatDate(date) { ... } // What: 날짜 포맷 getTax(amount) { ... } // What: 세금 validateEmail(email) { ... } // What: 이메일 검증 } // 높은 응집도: 하나의 What에 집중 class DateFormatter { format(date) { ... } parse(str) { ... } isValid(date) { ... } } // 모든 메서드가 "날짜 처리"라는 하나의 What에 기여해요

// 높은 결합도: How에 직접 의존 class OrderService { process(order) { const tax = order.items.reduce((sum, item) => sum + item.price * 0.1, 0); // 세금 계산 How가 여기에 } } // 낮은 결합도: What에만 의존 class OrderService { constructor(private taxCalculator: TaxCalculator) {} process(order) { const tax = this.taxCalculator.calculate(order); // What만 호출 } }

1. What과 How가 분리되어 있는가? 2. What이 명확하고 안정적인가? 3. How만 바꿔도 동작하는가?