Your Domain Doesn't Know About PostgreSQL (And It Shouldn't)

Context

기존 OrderService는 비즈니스 규칙(주문 검증, 할인 계산)과 인프라 관심사(SQLAlchemy 세션, FastAPI 예외 처리, 환경 변수)가 혼재되어 있었다. 이로 인해 단위 테스트를 작성하려면 60줄의 픽스처가 필요하거나 테스트를 아예 작성하지 않는 상황이 발생했다.

Technical Solution

• 도메인 로직을 순수 비즈니스 규칙으로 분리: calculate_total(), is_valid() 메서드를 데이터베이스나 HTTP 프레임워크 의존성 없이 구현
• 데이터 클래스 활용으로 ORM 모델 제거: SQLAlchemy 모델 대신 @dataclass를 사용해 Order, OrderItem 정의
• 외부 의존성 제거: OrderService에서 db.Session, HTTPException, os.getenv() 호출 제거
• 테스트 코드 간소화: 3줄의 테스트 코드로 픽스처, 모킹, 데이터베이스 없이 할인 로직 검증

Key Takeaway

도메인(비즈니스 규칙)과 인프라(데이터베이스, 프레임워크)의 명확한 분리는 테스트 용이성뿐 아니라 마이크로서비스 간 로직 공유, 저장소 기술 변경(PostgreSQL → MongoDB) 시 핵심 규칙의 독립성을 보장하는 기본 아키텍처 원칙이다.