diff --git a/docs/adr/README.md b/docs/adr/README.md new file mode 100644 index 0000000..6a67737 --- /dev/null +++ b/docs/adr/README.md @@ -0,0 +1,35 @@ +# Architecture Decision Records + +본 디렉토리는 프로젝트의 주요 아키텍처 결정 사항을 문서화합니다. + +## ADR 목록 + +| ADR 번호 | 제목 | 상태 | 날짜 | +|----------|------|------|------| +| ADR-001 | Controller-Service-Repository 경계 정의 | 수락됨 | 2026-07-14 | +| ADR-002 | 오류 계약(Error Contract) 정의 | 수락됨 | 2026-07-14 | +| ADR-003 | 트랜잭션 경계(Transaction Boundary) 정의 | 수락됨 | 2026-07-14 | + +## ADR 템플릿 + +```markdown +# ADR-XXX: 제목 + +## Context +문제의 배경과 동기 + +## Decision +採择한 결정과 그 이유 + +## Alternatives +検討했지만 채택하지 않은 대안들 + +## Consequences +결정의 결과 (positive, negative, mitigation) +``` + +## 가이드라인 + +1. **새 ADR 생성 시:** `ADR-XXX` 형식으로 파일명 지정 +2. **상태 변경:** 수락됨(Accepted), 대체됨(Superseded), 폐기됨(Deprecated) +3. **검토 주기:** 분기별 기존 ADR 검토 및 업데이트