Skip to content

Commit 6c2497b

Browse files
authored
docs: backfill decision metadata template (#324)
1 parent ff6f982 commit 6c2497b

10 files changed

Lines changed: 66 additions & 10 deletions

docs/decisions/001-chapter-query-aggregation.md

Lines changed: 7 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,12 @@
11
# Chapter 조회 N+1 문제를 Aggregation으로 해소
22

3-
관련 PR: [#197](https://github.com/SWM16-ASAP/back-server/pull/197)
3+
## 미션 메타데이터
4+
5+
- 관련 PR: [#197](https://github.com/SWM16-ASAP/back-server/pull/197)
6+
- 작업 브랜치: `미상`
7+
- 기준 브랜치: `develop`
8+
- 현재 상태: Aggregation 기반 조회 개선 회고 정리 완료. 추가 성능 측정과 주변 조회 패턴 점검은 남아 있다.
9+
- 다음 시작점: `content/book` 영역의 유사 반복 조회를 점검하고, 쿼리 로그나 부하 테스트로 실제 개선 폭을 측정한다.
410

511
## 문제
612

docs/decisions/002-rate-limiting-with-bucket4j.md

Lines changed: 7 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,12 @@
11
# Bucket4j와 Redis 기반 Rate Limiting 도입
22

3-
관련 PR: [#191](https://github.com/SWM16-ASAP/back-server/pull/191)
3+
## 미션 메타데이터
4+
5+
- 관련 PR: [#191](https://github.com/SWM16-ASAP/back-server/pull/191)
6+
- 작업 브랜치: `미상`
7+
- 기준 브랜치: `develop`
8+
- 현재 상태: Bucket4j와 Redis 기반 rate limit 도입 회고 정리 완료. 응답 형식 통일과 운영 데이터 기반 튜닝은 남아 있다.
9+
- 다음 시작점: 429 응답을 공통 예외 형식으로 맞추고, rate limit hit 메트릭을 노출해 정책 조정 근거를 만든다.
410

511
## 문제
612

docs/decisions/003-migrate-dev-infrastructure-to-on-premise.md

Lines changed: 7 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,12 @@
11
# 개발 배포 환경을 온프레미스 기반으로 전환
22

3-
관련 PR: [#312](https://github.com/SWM16-ASAP/back-server/pull/312)
3+
## 미션 메타데이터
4+
5+
- 관련 PR: [#312](https://github.com/SWM16-ASAP/back-server/pull/312)
6+
- 작업 브랜치: `미상`
7+
- 기준 브랜치: `develop`
8+
- 현재 상태: 개발 배포 환경의 온프레미스 전환 회고 정리 완료. 운영 경계와 runbook 보강은 남아 있다.
9+
- 다음 시작점: 브랜치 트리거와 환경 문서를 정리하고, 백업·재시작·모니터링 기준을 runbook으로 남긴다.
410

511
## 문제
612

docs/decisions/004-disable-r2-chunked-encoding.md

Lines changed: 7 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,12 @@
11
# R2 서명 불일치를 피하기 위해 Chunked Encoding 비활성화
22

3-
관련 PR: [#314](https://github.com/SWM16-ASAP/back-server/pull/314)
3+
## 미션 메타데이터
4+
5+
- 관련 PR: [#314](https://github.com/SWM16-ASAP/back-server/pull/314)
6+
- 작업 브랜치: `미상`
7+
- 기준 브랜치: `develop`
8+
- 현재 상태: R2 호환 설정 조정 회고 정리 완료. 대용량 업로드 검증과 외부 스토리지 fallback 전략은 남아 있다.
9+
- 다음 시작점: 멀티파트와 대용량 업로드 호환성을 점검하고, 스토리지 장애나 지연에 대한 대응 전략을 분리 정리한다.
410

511
## 문제
612

docs/decisions/005-ai-word-analysis-cost-and-reliability.md

Lines changed: 7 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,12 @@
11
# AI 단어 분석 파이프라인의 비용과 안정성 개선
22

3-
관련 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)
3+
## 미션 메타데이터
4+
5+
- 관련 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)
6+
- 작업 브랜치: `미상`
7+
- 기준 브랜치: `develop`
8+
- 현재 상태: AI 단어 분석 비용·안정성 개선 회고 정리 완료. 실험 자료 분리 관리와 실패 유형 세분화는 남아 있다.
9+
- 다음 시작점: 비용 측정 자료를 별도 기록으로 분리하고, 단어 분석 실패 유형과 사용자 경험 fallback 전략을 보강한다.
410

511
## 문제
612

docs/decisions/006-personalized-push-notification-and-tracking.md

Lines changed: 7 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,12 @@
11
# 개인화된 추천 PUSH와 캠페인 추적 체계 도입
22

3-
관련 근거: [#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)
3+
## 미션 메타데이터
4+
5+
- 관련 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)
6+
- 작업 브랜치: `미상`
7+
- 기준 브랜치: `develop`
8+
- 현재 상태: 개인화 PUSH와 캠페인 추적 체계 도입 회고 정리 완료. 실험 설계와 빈도 제한 정책은 남아 있다.
9+
- 다음 시작점: 캠페인별 실험 기준과 A/B 구조를 정리하고, 사용자 피로도 기반 알림 빈도 제한 정책을 설계한다.
410

511
## 문제
612

docs/decisions/007-choose-mongodb-for-early-flexibility.md

Lines changed: 8 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,13 @@
11
# 서비스 초기 데이터 저장소를 MongoDB 중심으로 고정
22

3+
## 미션 메타데이터
4+
5+
- 관련 PR: 미상
6+
- 작업 브랜치: `미상`
7+
- 기준 브랜치: `develop`
8+
- 현재 상태: 초기 저장소 전략에 대한 회고 정리 완료. 저장소 분리 기준과 MongoDB 활용 경계 정리는 남아 있다.
9+
- 다음 시작점: Aggregation·인덱스·문서 구조 튜닝 기준을 정리하고, 관계형 저장소 분리 신호와 MongoDB 활용 범위를 명확히 한다.
10+
311
## 문제
412

513
서비스 초기에는 기능 요구사항과 응답 형태가 빠르게 바뀌는 반면, 운영 비용은 제한적이었다.

docs/decisions/008-image-delivery-optimization.md

Lines changed: 7 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,12 @@
11
# 글로벌 이미지 전달 성능 최적화
22

3-
관련 PR: [#160](https://github.com/SWM16-ASAP/back-server/pull/160)
3+
## 미션 메타데이터
4+
5+
- 관련 PR: [#160](https://github.com/SWM16-ASAP/back-server/pull/160)
6+
- 작업 브랜치: `미상`
7+
- 기준 브랜치: `develop`
8+
- 현재 상태: 글로벌 이미지 전달 최적화 회고 정리 완료. 인프라 운영 문서와 포맷 전략 확장은 남아 있다.
9+
- 다음 시작점: CDN·Lambda@Edge·저장소 운영 문서를 보강하고, 이미지 종류별 전처리 규격과 포맷 대응 범위를 다시 검토한다.
410

511
## 문제
612

docs/decisions/009-dsl-driven-crawling.md

Lines changed: 7 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,12 @@
11
# DSL 기반 크롤링 규칙 관리 구조 도입
22

3-
관련 근거: [#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)
3+
## 미션 메타데이터
4+
5+
- 관련 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)
6+
- 작업 브랜치: `미상`
7+
- 기준 브랜치: `develop`
8+
- 현재 상태: DSL 기반 크롤링 규칙 관리 구조 회고 정리 완료. 변화 탐지와 실패 알림 자동화는 남아 있다.
9+
- 다음 시작점: 사이트 구조 변화 탐지와 규칙 실패 알림을 자동화하고, 서버·클라이언트·RSS fallback 책임 경계를 더 선명하게 나눈다.
410

511
## 문제
612

docs/decisions/010-mission-oriented-agent-guidelines.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -5,8 +5,8 @@
55
- 관련 PR: 미정
66
- 작업 브랜치: `refactor/strengthen-agent-guidelines`
77
- 기준 브랜치: `develop`
8-
- 현재 상태: `AGENTS.md`, repo-local mission skill, decision 템플릿 규칙 정리 완료
9-
- 다음 시작점: 기존 decision 문서를 새 메타데이터 포맷으로 리포맷하고, 현재 PR과 연결된 문서를 더 잘 찾는 규칙을 보강한다.
8+
- 현재 상태: `AGENTS.md`, repo-local mission skill, decision 템플릿 규칙 정리와 기존 decision 문서 메타데이터 backfill 완료
9+
- 다음 시작점: 현재 PR과 연결된 decision 문서를 더 잘 찾는 규칙을 보강하고, 템플릿과 실제 사용 규칙의 차이를 더 줄인다.
1010

1111
## 문제
1212

0 commit comments

Comments
 (0)