이 디렉터리는 미션을 수행하며 내린 큰 기술적 선택과 개선 판단을 기록하는 문서 모음이다. 톤은 딱딱한 ADR보다 기술 블로그형 회고에 가깝게 유지한다.
- 구조를 바꾸는 결정
- 성능에 영향을 주는 결정
- 안정성과 운영성에 영향을 주는 결정
- 테스트 전략을 바꾸는 결정
- 자잘한 구현 선택은 기록하지 않는다.
- 문제, 선택, 이유, 검증, 결과와 남은 이슈 중심으로 짧게 정리한다.
- 기본 원칙은
미션당 문서 하나다. - 문서 하단에는
연관 이슈 및 PR섹션을 두고, 추적 가능한 이슈와 PR을 남긴다. - 구현 자체보다 왜 그런 선택을 했는지와 그 결과를 이해할 수 있게 적는다.
- 구현보다 고민과 판단의 맥락이 먼저 보이게 적는다.
- 001. Chapter 조회 N+1 문제를 Aggregation으로 해소
- 002. Bucket4j와 Redis 기반 Rate Limiting 도입
- 003. 개발 배포 환경을 온프레미스 기반으로 전환
- 004. R2 서명 불일치를 피하기 위해 Chunked Encoding 비활성화
- 005. AI 단어 분석 파이프라인의 비용과 안정성 개선
- 006. 개인화된 추천 PUSH와 캠페인 추적 체계 도입
- 007. 서비스 초기 데이터 저장소를 MongoDB 중심으로 고정
- 008. 글로벌 이미지 전달 성능 최적화
- 009. DSL 기반 크롤링 규칙 관리 구조 도입
- 010. 미션 기반 Codex 에이전트 운영 규칙 정리