From e05100347520973f2899eb518986095502743857 Mon Sep 17 00:00:00 2001 From: solfe Date: Sun, 29 Mar 2026 22:04:03 +0900 Subject: [PATCH] docs: backfill decision metadata template --- docs/decisions/001-chapter-query-aggregation.md | 8 +++++++- docs/decisions/002-rate-limiting-with-bucket4j.md | 8 +++++++- .../003-migrate-dev-infrastructure-to-on-premise.md | 8 +++++++- docs/decisions/004-disable-r2-chunked-encoding.md | 8 +++++++- .../005-ai-word-analysis-cost-and-reliability.md | 8 +++++++- .../006-personalized-push-notification-and-tracking.md | 8 +++++++- .../decisions/007-choose-mongodb-for-early-flexibility.md | 8 ++++++++ docs/decisions/008-image-delivery-optimization.md | 8 +++++++- docs/decisions/009-dsl-driven-crawling.md | 8 +++++++- docs/decisions/010-mission-oriented-agent-guidelines.md | 4 ++-- 10 files changed, 66 insertions(+), 10 deletions(-) diff --git a/docs/decisions/001-chapter-query-aggregation.md b/docs/decisions/001-chapter-query-aggregation.md index 0e32d12..8e22077 100644 --- a/docs/decisions/001-chapter-query-aggregation.md +++ b/docs/decisions/001-chapter-query-aggregation.md @@ -1,6 +1,12 @@ # Chapter 조회 N+1 문제를 Aggregation으로 해소 -관련 PR: [#197](https://github.com/SWM16-ASAP/back-server/pull/197) +## 미션 메타데이터 + +- 관련 PR: [#197](https://github.com/SWM16-ASAP/back-server/pull/197) +- 작업 브랜치: `미상` +- 기준 브랜치: `develop` +- 현재 상태: Aggregation 기반 조회 개선 회고 정리 완료. 추가 성능 측정과 주변 조회 패턴 점검은 남아 있다. +- 다음 시작점: `content/book` 영역의 유사 반복 조회를 점검하고, 쿼리 로그나 부하 테스트로 실제 개선 폭을 측정한다. ## 문제 diff --git a/docs/decisions/002-rate-limiting-with-bucket4j.md b/docs/decisions/002-rate-limiting-with-bucket4j.md index 3527266..ed5097e 100644 --- a/docs/decisions/002-rate-limiting-with-bucket4j.md +++ b/docs/decisions/002-rate-limiting-with-bucket4j.md @@ -1,6 +1,12 @@ # Bucket4j와 Redis 기반 Rate Limiting 도입 -관련 PR: [#191](https://github.com/SWM16-ASAP/back-server/pull/191) +## 미션 메타데이터 + +- 관련 PR: [#191](https://github.com/SWM16-ASAP/back-server/pull/191) +- 작업 브랜치: `미상` +- 기준 브랜치: `develop` +- 현재 상태: Bucket4j와 Redis 기반 rate limit 도입 회고 정리 완료. 응답 형식 통일과 운영 데이터 기반 튜닝은 남아 있다. +- 다음 시작점: 429 응답을 공통 예외 형식으로 맞추고, rate limit hit 메트릭을 노출해 정책 조정 근거를 만든다. ## 문제 diff --git a/docs/decisions/003-migrate-dev-infrastructure-to-on-premise.md b/docs/decisions/003-migrate-dev-infrastructure-to-on-premise.md index 9379bbc..7c5b244 100644 --- a/docs/decisions/003-migrate-dev-infrastructure-to-on-premise.md +++ b/docs/decisions/003-migrate-dev-infrastructure-to-on-premise.md @@ -1,6 +1,12 @@ # 개발 배포 환경을 온프레미스 기반으로 전환 -관련 PR: [#312](https://github.com/SWM16-ASAP/back-server/pull/312) +## 미션 메타데이터 + +- 관련 PR: [#312](https://github.com/SWM16-ASAP/back-server/pull/312) +- 작업 브랜치: `미상` +- 기준 브랜치: `develop` +- 현재 상태: 개발 배포 환경의 온프레미스 전환 회고 정리 완료. 운영 경계와 runbook 보강은 남아 있다. +- 다음 시작점: 브랜치 트리거와 환경 문서를 정리하고, 백업·재시작·모니터링 기준을 runbook으로 남긴다. ## 문제 diff --git a/docs/decisions/004-disable-r2-chunked-encoding.md b/docs/decisions/004-disable-r2-chunked-encoding.md index e3aeeab..6ed51c2 100644 --- a/docs/decisions/004-disable-r2-chunked-encoding.md +++ b/docs/decisions/004-disable-r2-chunked-encoding.md @@ -1,6 +1,12 @@ # R2 서명 불일치를 피하기 위해 Chunked Encoding 비활성화 -관련 PR: [#314](https://github.com/SWM16-ASAP/back-server/pull/314) +## 미션 메타데이터 + +- 관련 PR: [#314](https://github.com/SWM16-ASAP/back-server/pull/314) +- 작업 브랜치: `미상` +- 기준 브랜치: `develop` +- 현재 상태: R2 호환 설정 조정 회고 정리 완료. 대용량 업로드 검증과 외부 스토리지 fallback 전략은 남아 있다. +- 다음 시작점: 멀티파트와 대용량 업로드 호환성을 점검하고, 스토리지 장애나 지연에 대한 대응 전략을 분리 정리한다. ## 문제 diff --git a/docs/decisions/005-ai-word-analysis-cost-and-reliability.md b/docs/decisions/005-ai-word-analysis-cost-and-reliability.md index c79677e..662f7fc 100644 --- a/docs/decisions/005-ai-word-analysis-cost-and-reliability.md +++ b/docs/decisions/005-ai-word-analysis-cost-and-reliability.md @@ -1,6 +1,12 @@ # AI 단어 분석 파이프라인의 비용과 안정성 개선 -관련 PR: [#185](https://github.com/SWM16-ASAP/back-server/pull/185), [#209](https://github.com/SWM16-ASAP/back-server/pull/209), [#211](https://github.com/SWM16-ASAP/back-server/pull/211) +## 미션 메타데이터 + +- 관련 PR: [#185](https://github.com/SWM16-ASAP/back-server/pull/185), [#209](https://github.com/SWM16-ASAP/back-server/pull/209), [#211](https://github.com/SWM16-ASAP/back-server/pull/211) +- 작업 브랜치: `미상` +- 기준 브랜치: `develop` +- 현재 상태: AI 단어 분석 비용·안정성 개선 회고 정리 완료. 실험 자료 분리 관리와 실패 유형 세분화는 남아 있다. +- 다음 시작점: 비용 측정 자료를 별도 기록으로 분리하고, 단어 분석 실패 유형과 사용자 경험 fallback 전략을 보강한다. ## 문제 diff --git a/docs/decisions/006-personalized-push-notification-and-tracking.md b/docs/decisions/006-personalized-push-notification-and-tracking.md index dbc0109..c4e77a0 100644 --- a/docs/decisions/006-personalized-push-notification-and-tracking.md +++ b/docs/decisions/006-personalized-push-notification-and-tracking.md @@ -1,6 +1,12 @@ # 개인화된 추천 PUSH와 캠페인 추적 체계 도입 -관련 근거: [#222](https://github.com/SWM16-ASAP/back-server/pull/222), [#253](https://github.com/SWM16-ASAP/back-server/pull/253), [#288](https://github.com/SWM16-ASAP/back-server/pull/288) +## 미션 메타데이터 + +- 관련 PR: [#222](https://github.com/SWM16-ASAP/back-server/pull/222), [#253](https://github.com/SWM16-ASAP/back-server/pull/253), [#288](https://github.com/SWM16-ASAP/back-server/pull/288) +- 작업 브랜치: `미상` +- 기준 브랜치: `develop` +- 현재 상태: 개인화 PUSH와 캠페인 추적 체계 도입 회고 정리 완료. 실험 설계와 빈도 제한 정책은 남아 있다. +- 다음 시작점: 캠페인별 실험 기준과 A/B 구조를 정리하고, 사용자 피로도 기반 알림 빈도 제한 정책을 설계한다. ## 문제 diff --git a/docs/decisions/007-choose-mongodb-for-early-flexibility.md b/docs/decisions/007-choose-mongodb-for-early-flexibility.md index 9fe7953..561afd9 100644 --- a/docs/decisions/007-choose-mongodb-for-early-flexibility.md +++ b/docs/decisions/007-choose-mongodb-for-early-flexibility.md @@ -1,5 +1,13 @@ # 서비스 초기 데이터 저장소를 MongoDB 중심으로 고정 +## 미션 메타데이터 + +- 관련 PR: 미상 +- 작업 브랜치: `미상` +- 기준 브랜치: `develop` +- 현재 상태: 초기 저장소 전략에 대한 회고 정리 완료. 저장소 분리 기준과 MongoDB 활용 경계 정리는 남아 있다. +- 다음 시작점: Aggregation·인덱스·문서 구조 튜닝 기준을 정리하고, 관계형 저장소 분리 신호와 MongoDB 활용 범위를 명확히 한다. + ## 문제 서비스 초기에는 기능 요구사항과 응답 형태가 빠르게 바뀌는 반면, 운영 비용은 제한적이었다. diff --git a/docs/decisions/008-image-delivery-optimization.md b/docs/decisions/008-image-delivery-optimization.md index 3bd7ecf..8b3fc0b 100644 --- a/docs/decisions/008-image-delivery-optimization.md +++ b/docs/decisions/008-image-delivery-optimization.md @@ -1,6 +1,12 @@ # 글로벌 이미지 전달 성능 최적화 -관련 PR: [#160](https://github.com/SWM16-ASAP/back-server/pull/160) +## 미션 메타데이터 + +- 관련 PR: [#160](https://github.com/SWM16-ASAP/back-server/pull/160) +- 작업 브랜치: `미상` +- 기준 브랜치: `develop` +- 현재 상태: 글로벌 이미지 전달 최적화 회고 정리 완료. 인프라 운영 문서와 포맷 전략 확장은 남아 있다. +- 다음 시작점: CDN·Lambda@Edge·저장소 운영 문서를 보강하고, 이미지 종류별 전처리 규격과 포맷 대응 범위를 다시 검토한다. ## 문제 diff --git a/docs/decisions/009-dsl-driven-crawling.md b/docs/decisions/009-dsl-driven-crawling.md index 32dd0ca..434ec24 100644 --- a/docs/decisions/009-dsl-driven-crawling.md +++ b/docs/decisions/009-dsl-driven-crawling.md @@ -1,6 +1,12 @@ # DSL 기반 크롤링 규칙 관리 구조 도입 -관련 근거: [#100](https://github.com/SWM16-ASAP/back-server/pull/100), [#120](https://github.com/SWM16-ASAP/back-server/pull/120), [#284](https://github.com/SWM16-ASAP/back-server/pull/284) +## 미션 메타데이터 + +- 관련 PR: [#100](https://github.com/SWM16-ASAP/back-server/pull/100), [#120](https://github.com/SWM16-ASAP/back-server/pull/120), [#284](https://github.com/SWM16-ASAP/back-server/pull/284) +- 작업 브랜치: `미상` +- 기준 브랜치: `develop` +- 현재 상태: DSL 기반 크롤링 규칙 관리 구조 회고 정리 완료. 변화 탐지와 실패 알림 자동화는 남아 있다. +- 다음 시작점: 사이트 구조 변화 탐지와 규칙 실패 알림을 자동화하고, 서버·클라이언트·RSS fallback 책임 경계를 더 선명하게 나눈다. ## 문제 diff --git a/docs/decisions/010-mission-oriented-agent-guidelines.md b/docs/decisions/010-mission-oriented-agent-guidelines.md index be83c4a..24dd471 100644 --- a/docs/decisions/010-mission-oriented-agent-guidelines.md +++ b/docs/decisions/010-mission-oriented-agent-guidelines.md @@ -5,8 +5,8 @@ - 관련 PR: 미정 - 작업 브랜치: `refactor/strengthen-agent-guidelines` - 기준 브랜치: `develop` -- 현재 상태: `AGENTS.md`, repo-local mission skill, decision 템플릿 규칙 정리 완료 -- 다음 시작점: 기존 decision 문서를 새 메타데이터 포맷으로 리포맷하고, 현재 PR과 연결된 문서를 더 잘 찾는 규칙을 보강한다. +- 현재 상태: `AGENTS.md`, repo-local mission skill, decision 템플릿 규칙 정리와 기존 decision 문서 메타데이터 backfill 완료 +- 다음 시작점: 현재 PR과 연결된 decision 문서를 더 잘 찾는 규칙을 보강하고, 템플릿과 실제 사용 규칙의 차이를 더 줄인다. ## 문제