아키텍처

[AI가 읽을 수 있는 코드베이스 3/5] Standalone App: 도메인 슬라이스 독립 실행

flex2026년 5월 27일

두줄요약

Issue 도메인을 독립 실행 가능한 standalone-app으로 조립해 핵심 로직만 빠르게 검증하는 구조를 소개했습니다. 프로덕션 Adapter만 교체하고 시드 데이터, Swagger, React 프론트엔드를 묶어 AI 협업 검증 환경을 만들었습니다.

Hexagonal Architecture의 Port/Adapter 분리를 활용해 Issue 도메인만 독립 실행 가능한 standalone-app 구성
프로덕션과 동일한 api, service, infrastructure, repository-jdbc 조립하되 인증/인가 Adapter만 헤더 기반으로 교체
UseCase 기반 시드 데이터 생성, TestContainer MySQL, Swagger UI, React 프론트엔드까지 포함한 자기 완결적 검증 환경
전체 시스템을 올리지 않고 도메인 슬라이스만 빠르게 검증해 AI 에이전트의 수정·확인 루프를 단축