Decision Log
이 섹션은 rest-domain-state-manager 설계 과정에서 내린 주요 아키텍처 결정과 구체적인 구현 의사결정들을 기록합니다.
모든 라이브러리는 수많은 트레이드오프의 산물입니다. 각 결정이 왜 이루어졌는지, 어떤 대안이 검토되었고 어떤 이유로 기각되었는지를 투명하게 공개함으로써, 미래의 기여자와 사용자가 설계 의도를 정확히 파악할 수 있도록 합니다.
아키텍처 결정 레코드 (ARD)
ARD는 큰 방향성을 결정하는 상위 문서입니다.
| ID | 날짜 | 제목 | 상태 |
|---|---|---|---|
| ARD-0000 | 2026-03-18 | 아키텍처 진단 및 초기 설계 방향 | 완료 |
| ARD-0001 | 2026-03-20 | V8 최적화 정렬 및 2026 아키텍처 동향 반영 | 완료 |
구현 의사결정 (IMPL)
ARD 하위의 구체적인 구현 결정을 기록합니다. 각 문서는 하나의 소주제에 집중하며, 변경 근거와 엣지 케이스 분석을 포함합니다.
| ID | 날짜 | 제목 | 상위 ARD |
|---|---|---|---|
| IMPL-001 | 2026-03-20 | Dirty Checking 기반 HTTP 분기 알고리즘 | ARD-0001 |
| IMPL-002 | 2026-03-20 | Optimistic Update 롤백 메커니즘 | ARD-0001 |
| IMPL-003 | 2026-03-20 | Microtask 기반 브로드캐스트 배칭 | ARD-0001 |
| IMPL-004 | 2026-03-20 | 소스 디렉토리 구조 재편 | ARD-0001 |
| IMPL-005 | 2026-03-23 | CI/CD 파이프라인 구축 | ARD-0001 |
이 기록이 존재하는 이유
소프트웨어는 설계 과정의 흔적을 남기지 않습니다. 코드는 현재 상태만 보여주지, 왜 그렇게 되었는지는 말하지 않습니다. 6개월 후 같은 문제를 다시 마주쳤을 때 이미 검토하고 기각했던 아이디어를 또 검토하는 비효율을 막기 위해, 그리고 이 프로젝트를 포트폴리오로 검토하는 사람이 단순히 코드 결과물이 아니라 사고 과정을 볼 수 있도록 이 기록을 공개합니다.