아키텍처 문서 수동 갱신 가이드
갱신 시점
다음 중 하나가 확정됐을 때 ARCHITECTURE.md와 DECISION_LOG.md를 함께 검토한다.
| 변경 유형 | 기록 예시 |
|---|---|
| 책임 경계 | DirectoryService, UI Center, 공통 Asset, 포털 중 역할 이동 |
| 권한·인증 | 서비스 간 scope, 중앙 로그인, 관리자 작업 보호 변경 |
| 데이터 소유권 | 중앙 원장과 포털 DB의 접근·보관 책임 변경 |
| 배포 구조 | 새 운영 도구 분리, 공통 UI 배포 경로 변경 |
| Asset 정책 | 기본 소스의 제공 범위, 인계 방식, 업그레이드 기준 변경 |
기록 순서
ARCHITECTURE.md에서 현재 역할 분리나 Asset 인계 원칙이 달라졌는지 갱신한다.DECISION_LOG.md상단에 새 결정 항목을 추가한다.- 결정 항목에는 날짜, 결정, 이유, 영향, 후속 조치를 빠짐없이 적는다.
- UI Center의 아키텍처 문서 화면에 표시하는 내용도 같은 변경으로 갱신한다.
- 테스트·빌드를 통과한 뒤 체크포인트를 저장한다.
결정 이력 템플릿
md
## YYYY-MM-DD · 결정 제목
**결정:** 무엇을 확정하거나 변경했는가.
**이유:** 어떤 요구 또는 문제를 해결하는가.
**영향:** DirectoryService, UI Center, 공통 기능 Asset, 개별 포털 중 영향 범위.
**후속 조치:** 구현, 테스트, 문서화, 배포에 필요한 다음 작업.문서는 자동으로 바꾸지 않는다. 실제로 합의되고 구현에 반영할 변경만 사람이 검토해 기록한다.