Java 25와 Spring Boot 4.1.0 기반의 Gradle 멀티모듈 backend입니다.
| Module | Responsibility |
|---|---|
api |
HTTP Presentation, Application, Domain, Infrastructure와 애플리케이션 실행 진입점 |
common |
여러 모듈이 공유하는 최소 공통 계약과 예외 |
external |
외부 클라이언트 모듈을 묶는 Gradle 영역 |
external:kamis-client |
KAMIS Feign client, 응답 모델, 인증 설정, 오류 디코더 |
외부 시스템 모델은 api의 Application·Presentation으로 직접 노출하지 않고 Adapter에서 내부 결과로 변환합니다.
./gradlew check --no-daemonDocker가 필요한 통합 검증의 제한과 상세 검증 기준은 docs/ENGINEERING_BASELINE.md를 확인합니다.
AGENTS.md: Codex 작업 계약과 문서 읽기 순서docs/ARCHITECTURE.md: 계층·모듈·의존성 경계docs/CODE_CONVENTION.md: Java·API·TDD 규칙docs/ENGINEERING_BASELINE.md: 적용 상태와 검증 기준docs/GIT_CONVENTION.md: Issue·Branch·Commit·PR 규칙docs/DECISION.md: 구조적 결정 indexCONTEXT.md: 안정된 도메인 용어가 생길 때 관리하는 glossary
Terraform 작업은 .infra/AGENTS.md의 범위를 따르고, PostgreSQL·Redis Compose 운영은 ops/data-services/README.md를 따릅니다.