UnitOfWork Port와 Decorator를 통한 DB 종속성 제거 및 원자성 확보

Context

Application Layer에서 EntityManager를 직접 호출하여 Transaction을 관리함에 따른 인프라 종속성 발생. 이로 인해 DB 교체 비용 증가 및 Unit Test 시 Mocking 복잡도가 상승하는 구조적 한계 직면.

Technical Solution

• Application Layer 내 Transaction 경계만을 정의한 UnitOfWork Port 인터페이스 설계
• 인프라 계층에서 Doctrine, Laravel, PDO 등 실제 DB 드라이버별 Adapter를 구현하여 세부 메커니즘 은닉
• Use Case 내부의 트랜잭션 로직을 제거하고 wiring 단계에서 Transactional Decorator를 통한 횡단 관심사 분리
• 포트-어댑터 구조를 통해 비즈니스 로직은 보존하며 런타임에 저장소 구현체를 동적으로 교체하는 유연성 확보
• DB Flush 및 Commit/Rollback 제어권을 Use Case 외부로 이전하여 도메인 순수성 유지