update stage-pilot

2026-04-14 22:09:53 +09:00
parent c3513b3a15
commit ec20f933ad
50 changed files with 3355 additions and 0 deletions
@@ -0,0 +1,71 @@
+# 0. 문서 상태
+- 상태: draft
+- 승인자: {{DECIDE: 이 Design의 최종 승인자는 누구인가?}}
+- 승인 시각: {{CONFIRM: 승인 후 기재}}
+
+# 1. Design 개요
+- 입력 Planning:
+- 목적:
+- 설계 대상 작업 (WSJF 상위 3개):
+  - 1순위:
+  - 2순위:
+  - 3순위:
+
+# 2. 설계 대안 비교 (우선순위 상위 작업)
+## <작업 ID>: <작업명>
+### 대안 A
+- 설명:
+- 장점:
+- 단점:
+
+### 대안 B
+- 설명:
+- 장점:
+- 단점:
+
+### 선택 결정
+- 선택: 대안 A / 대안 B
+- 근거:
+
+# 3. 인터페이스 정의
+## <작업 ID>: <작업명>
+- 입력:
+- 출력:
+- 오류 경로:
+
+# 4. 데이터/흐름 설계
+## <작업 ID>: <작업명>
+- 주요 데이터 경로:
+- 상태 변화:
+
+# 5. 테스트 전략 연계 (AC 매핑)
+| 작업 ID | AC | 검증 방법 | 검증 포인트 |
+|---|---|---|---|
+| P-001 | AC-1 |  |  |
+| P-001 | AC-2 |  |  |
+
+# 6. 리스크 대응 설계
+| 리스크 ID | 리스크 내용 | 설계 대응 전략 |
+|---|---|---|
+| R-1 |  |  |
+
+# 7. Implementation 단계 전달 체크
+- [ ] 우선순위 상위 작업의 설계 근거(대안 비교 + 선택 이유)가 존재함
+- [ ] 전체 작업의 인터페이스(입력/출력/오류 경로)가 정의됨
+- [ ] AC와 검증 포인트가 매핑됨
+- [ ] Planning 리스크에 대한 설계 대응이 반영됨
+- [ ] 최종 승인
+  - {{CONFIRM: Design 초안 승인 여부를 확인하라}}
+
+# 8. 파일 처리 결과
+- 생성/갱신 경로:
+
+# 9. 사용자 결정 필요 항목 요약
+## {{DECIDE}}
+- (없으면 이 섹션 제거)
+
+## {{CONFIRM}}
+- Design 초안 승인 여부를 확인하라. (위치: #7)
+
+## {{DATA}}
+- (없으면 이 섹션 제거)
@@ -0,0 +1,90 @@
+# 0. 문서 상태
+- 상태: draft
+- 승인자: {{DECIDE: 승인자를 지정하라}}
+- 승인 시각: {{CONFIRM: 승인 후 기재}}
+
+# 1. 계획 상태 요약
+- Discovery 문서 현황:
+- Planning 점수 파일 현황: docs/sdlc/planning/planning-backlog-scores.out.csv
+- 해석:
+
+# 2. 요구사항 판정 결과 (완전 중복/유사/신규 + 근거)
+- 판정: {{DECIDE: 완전 중복/유사/신규 중 하나를 선택하라}}
+- 근거
+  -
+  -
+
+# 3. 문제점의 요약
+- 현재 상태
+  -
+- 기대 상태
+  -
+- 이해관계자
+  -
+- 제약사항
+  -
+
+# 4. 이번에 만들 기능 1개
+-
+
+# 5. 요구사항 목록
+## 기능 요구사항
+- FR-1:
+- FR-2:
+
+## 비기능 요구사항
+- NFR-1:
+- NFR-2:
+
+## 범위 경계
+- In Scope
+  -
+- Out of Scope
+  -
+
+# 6. 리스크/가정 목록
+## 리스크
+- R-1 (High/Medium/Low):
+  - 완화 방안:
+- R-2 (High/Medium/Low):
+  - 완화 방안:
+
+## 가정
+- A-1:
+- A-2:
+
+# 7. 초기 성공 기준
+- S-1:
+- S-2:
+
+## 측정 방식 및 데이터 출처
+- S-1 측정 방식: / 데이터 출처:
+- S-2 측정 방식: / 데이터 출처:
+
+# 8. Planning으로 넘기기 전 확인 체크
+- Planning 시작 시점은 {{DECIDE: 즉시 가능/보류 중 선택하라}}.
+- [ ] 범위(In Scope/Out of Scope) 확정
+  - 기준:
+- [ ] 성공 지표의 측정 방식/데이터 출처 확정
+  - 기준:
+- [ ] High 영향 플레이스홀더 우선순위 및 해소 책임자 지정
+  - 기준:
+- [ ] 승인자 확정
+  - 기준:
+
+# 9. 파일 처리 결과 (생성/미생성 경로)
+- 처리 결과:
+- 생성 경로:
+- 재검토:
+- 참조 문서:
+
+# 10. 사용자 결정 필요 항목 요약
+## {{DECIDE}}
+- (없으면 이 섹션 제거)
+
+## {{CONFIRM}}
+- (없으면 이 섹션 제거)
+
+## {{DATA}}
+- (없으면 이 섹션 제거)
+
@@ -0,0 +1,62 @@
+# 0. 문서 상태
+- 상태: draft
+- 승인자: {{DECIDE: 이 Implementation의 최종 승인자는 누구인가?}}
+- 승인 시각: {{CONFIRM: 승인 후 기재}}
+
+# 1. Implementation 개요
+- 입력 Design:
+- 목적:
+- 이번 구현 우선순위 작업:
+  - 1순위:
+  - 2순위:
+  - 3순위:
+
+# 2. 이번 구현 범위
+## In Scope
+- 
+
+## Out of Scope
+- 
+
+# 3. 작업 단위 분해
+| Impl ID | 작업명 | 연결 설계/AC | 변경 유형 | 우선순위 |
+|---|---|---|---|---|
+| I-001 |  |  |  |  |
+
+# 4. 파일 변경 계획
+| Impl ID | 대상 파일 | 변경 목적 | 변경 종류(생성/수정) |
+|---|---|---|---|
+| I-001 |  |  |  |
+
+# 5. 테스트/검증 계획
+| Impl ID | 검증 방법 | 성공 기준 | 근거 |
+|---|---|---|---|
+| I-001 |  |  |  |
+
+# 6. 영향도 및 의존성 점검
+| 항목 | 영향 내용 | 대응 방안 |
+|---|---|---|
+| 코드 |  |  |
+| 문서 |  |  |
+| 설정/의존성 |  |  |
+
+# 7. Verification 단계 전달 체크
+- [ ] 구현 범위가 설계 문서와 연결됨
+- [ ] 작업 단위별 검증 방법이 정의됨
+- [ ] 영향 파일과 의존성 점검 결과가 기록됨
+- [ ] Verification에 전달할 실행/검증 근거가 정의됨
+- [ ] 최종 승인
+  - {{CONFIRM: Implementation 초안 승인 여부를 확인하라}}
+
+# 8. 파일 처리 결과
+- 생성/갱신 경로:
+
+# 9. 사용자 결정 필요 항목 요약
+## {{DECIDE}}
+- (없으면 이 섹션 제거)
+
+## {{CONFIRM}}
+- Implementation 초안 승인 여부를 확인하라. (위치: #7)
+
+## {{DATA}}
+- (없으면 이 섹션 제거)
@@ -0,0 +1,80 @@
+# 0. 문서 상태
+- 상태: draft
+- 승인자: {{DECIDE: 이 Operations의 최종 승인자는 누구인가?}}
+- 승인 시각: {{CONFIRM: 배포 완료 후 Operations 확인}}
+
+# 1. 배포 실행 기록
+- 입력 Release: {{DATA: docs/sdlc/release/rel-XXX_YYYY-MM-DD_topic.release.md}}
+- 배포 방식: {{DATA: 점진 배포/일괄 배포}}
+- 배포 환경: {{DATA: production/staging 등}}
+- 배포 창(UTC): {{DATA: 시작/종료 시각}}
+
+## 사전 검증
+- 체크리스트 점검 결과: {{DATA: 완료/미완료 항목}}
+- 롤백 준비 상태: {{DATA: 준비됨/미준비 + 근거}}
+
+## 실행 결과
+- 실행 명령/절차 요약: {{DATA: 실행 로그 요약}}
+- 결과: {{DATA: 성공/부분성공/실패}}
+- 영향 범위: {{DATA: 사용자/시스템 영향}}
+
+## 배포 직후 검증 결과
+- 핵심 시나리오 검증: {{DATA: 통과/실패 + 근거}}
+- 예외/알림 발생 여부: {{DATA: 있음/없음 + 내용}}
+
+# 2. 모니터링 관찰 결과
+| 모니터링 항목 | 측정 지표 | 정상 범위 | 이상 감지 기준 | 관찰 결과 | 비고 |
+|---|---|---|---|---|---|
+| {{DATA: 항목명}} | {{DATA: 지표}} | {{DATA: 정상 범위}} | {{DATA: 임계치}} | {{DATA: 결과}} |  |
+
+## 관찰 기간
+- 집중 관찰 기간: {{DATA: 시작~종료}}
+- 일반 관찰 기간: {{DATA: 시작~종료}}
+
+# 3. 인시던트 대응 기록
+- 인시던트 발생 여부: {{DATA: 발생/해당없음}}
+
+## 발생한 경우 기록
+- 영향도 분류: {{DATA: 사용자/기능/데이터 영향}}
+- 타임라인:
+  - 탐지 시각(UTC): {{DATA: 시각}}
+  - 대응 시작(UTC): {{DATA: 시각}}
+  - 완화 시각(UTC): {{DATA: 시각}}
+  - 복구 완료(UTC): {{DATA: 시각}}
+- 커뮤니케이션:
+  - 채널: {{DATA: 채널}}
+  - 공지 시각(UTC): {{DATA: 시각}}
+  - 업데이트 주기: {{DATA: 주기}}
+- 우회책 실행 여부: {{DATA: 실행/미실행 + 내용}}
+- 복구 절차 요약: {{DATA: 복구 단계}}
+
+# 4. Postmortem
+- What Happened: {{DATA: 사건 개요와 사용자 관찰 증상}}
+- Impact: {{DATA: 서비스/사용자/비즈니스 영향}}
+- Root Cause: {{DATA: 기술적 원인 + 시스템적 원인}}
+- Detection: {{DATA: 탐지 경로/지연 요인/알림 품질}}
+- Response: {{DATA: 대응 의사결정 및 실행 평가}}
+- Recovery: {{DATA: 복구 절차와 검증 결과}}
+- Preventive Actions: {{DATA: 재발 방지 액션(담당자/기한 포함)}}
+- Follow-up Tracking: {{DATA: Discovery/Planning 백로그 연결 상태}}
+
+# 5. 다음 반복 환류 항목
+| 환류 ID | 개선 항목 | 연결 대상(Discovery/Planning) | 담당자 | 목표일 | 상태 |
+|---|---|---|---|---|---|
+| FB-001 | {{DATA: 개선 항목}} | {{DATA: dcy/pln 문서 또는 티켓}} | {{DATA: 담당자}} | {{DATA: YYYY-MM-DD}} | {{DATA: 등록됨/대기}} |
+
+# 6. 파일 처리 결과
+- 생성/갱신 경로: {{DATA: docs/sdlc/operations/ops-XXX_YYYY-MM-DD_topic.operations.md}}
+- 입력 Release 경로: {{DATA: docs/sdlc/release/rel-XXX_YYYY-MM-DD_topic.release.md}}
+- 처리 결과: {{DATA: 생성/갱신/검토}}
+- 비고: {{DATA: 특이사항}}
+
+# 7. 사용자 결정 필요 항목 요약
+## {{DECIDE}}
+- (없으면 이 섹션 제거)
+
+## {{CONFIRM}}
+- (없으면 이 섹션 제거)
+
+## {{DATA}}
+- (없으면 이 섹션 제거)
@@ -0,0 +1,4 @@
+item_id,work_item,business_value,time_criticality,rr_oe,job_size,reach,impact,confidence,effort,method,notes
+P-001,Example work item A,8,7,6,5,1000,2,80,8,WSJF,baseline sample
+P-002,Example work item B,6,8,5,3,3000,1,70,10,RICE,marketing-facing change
+P-003,Example work item C,9,6,8,8,500,3,90,5,WSJF,risk reduction heavy
@@ -0,0 +1,63 @@
+# 0. 문서 상태
+- 상태: draft
+- 승인자: {{DECIDE: 이 Planning의 최종 승인자는 누구인가?}}
+- 승인 시각: {{CONFIRM: 승인 후 기재}}
+
+# 1. Planning 개요
+- 입력 Discovery:
+- 목적:
+- 우선순위 방법: WSJF
+- 점수 스케일: Business Value/Time Criticality/RR-OE/Job Size 모두 1~10
+
+# 2. 이번 반복 범위 경계
+## In Scope
+-
+
+## Out of Scope
+-
+
+# 3. 백로그 작업 분해
+| Item ID | Work Item | 연결 요구사항 | 연결 리스크 | 담당 |
+|---|---|---|---|---|
+| P-001 |  |  |  |  |
+
+# 4. WSJF 점수표
+| Item ID | Work Item | Business Value | Time Criticality | RR/OE | Job Size | WSJF Score | Priority |
+|---|---:|---:|---:|---:|---:|---:|---:|
+| P-001 |  |  |  |  |  |  |  |
+
+계산식: WSJF = (Business Value + Time Criticality + RR/OE) / Job Size
+
+## 점수 근거 메모
+- P-001:
+
+# 5. 작업별 수용 기준 (AC)
+## P-001 AC
+- AC-1:
+- AC-2:
+
+# 6. 우선순위 조정/예외
+- 동률 처리:
+- Override:
+- 승인자:
+
+# 7. Design 단계 전달 체크
+- [ ] 우선순위 상위 백로그의 AC가 검증 가능한 문장으로 정의됨
+- [ ] WSJF 계산 근거 기록 완료
+- [ ] 이번 반복 In Scope/Out of Scope 확정
+- [ ] 최종 승인
+  - {{CONFIRM: Planning 초안 승인 여부를 확인하라}}
+
+# 8. 파일 처리 결과
+- 생성/갱신 경로:
+- 점수 파일 갱신: docs/sdlc/planning/planning-backlog-scores.out.csv
+
+# 9. 사용자 결정 필요 항목 요약
+## {{DECIDE}}
+- (없으면 이 섹션 제거)
+
+## {{CONFIRM}}
+- Planning 초안 승인 여부를 확인하라. (위치: #7)
+
+## {{DATA}}
+- (없으면 이 섹션 제거)
@@ -0,0 +1,4 @@
+item_id,work_item,business_value,time_criticality,rr_oe,job_size,reach,impact,confidence,effort,method,wsjf_score,rice_score,selected_score,priority
+P-001,Example work item A,8,7,6,5,1000,2,80,8,WSJF,=(C2+D2+E2)/F2,=(G2*H2*I2)/J2,=IF(K2="WSJF",L2,M2),=
+P-002,Example work item B,6,8,5,3,3000,1,70,10,RICE,=(C3+D3+E3)/F3,=(G3*H3*I3)/J3,=IF(K3="WSJF",L3,M3),=
+P-003,Example work item C,9,6,8,8,500,3,90,5,WSJF,=(C4+D4+E4)/F4,=(G4*H4*I4)/J4,=IF(K4="WSJF",L4,M4),=
@@ -0,0 +1,105 @@
+# 0. 문서 상태
+- 상태: draft
+- 승인자: {{DECIDE: 이 Release의 최종 승인자는 누구인가?}}
+- 승인 시각: {{CONFIRM: 승인 후 기재}}
+
+# 1. Release 개요
+- 입력 Verification:
+- 배포 대상 범위:
+- 배포 방식: {{DECIDE: 점진 배포/일괄 배포 중 선택하라}}
+- 배포 환경:
+
+# 2. 배포 체크리스트
+
+| 항목 | 확인 내용 | 결과 (완료/미완료/해당없음) | 비고 |
+|---|---|---|---|
+| 설정 검증 | 환경 변수, 시크릿, 외부 연동 키 유효성 확인 |  |  |
+| 데이터 검증 | 마이그레이션 순서, 백업 상태, 복구 가능성 확인 |  |  |
+| 호환성 검증 | 이전 버전 클라이언트/API 호환 여부 확인 |  |  |
+| 의존성 검증 | 신규/변경 라이브러리 버전 충돌 여부 확인 |  |  |
+| 트래픽 전략 | 점진/일괄 배포 방식과 중단 기준 확인 |  |  |
+| 커뮤니케이션 | 사용자 공지, 내부 공지, 온콜 담당자 공유 완료 |  |  |
+
+# 3. 롤백 계획
+
+## 롤백 트리거
+- 에러율 임계치:
+- 지연 임계치:
+- 장애 지표:
+
+## 롤백 절차
+1. 
+2. 
+3. 
+
+## 데이터 롤백 전략
+- 스키마/데이터 복원 여부:
+- 절차:
+
+## 롤백 후 검증
+- 핵심 시나리오 확인 항목:
+  -
+
+## 롤백 커뮤니케이션
+- 공지 채널:
+- 공지 시각:
+- 상태 업데이트 주기:
+
+## 참조 런북
+- 롤백 런북: .github/templates/rollback-runbook.template.md
+
+# 4. 릴리즈 노트 초안
+
+## 변경 요약
+- 
+
+## 주요 변경 내용
+- 
+
+## 영향 범위
+- 사용자 영향:
+- 시스템 영향:
+
+## 알려진 제한 사항
+- 
+
+# 5. 배포 후 관찰 계획
+
+| 모니터링 항목 | 측정 지표 | 정상 범위 | 이상 감지 기준 | 담당자 |
+|---|---|---|---|---|
+|  |  |  |  |  |
+
+## 관찰 기간
+- 집중 관찰 기간:
+- 일반 관찰 기간:
+
+# 6. 승인된 예외 인계 목록
+
+| 예외 ID | 출처 (Verification) | 심각도 | 완화책 | 유효 기간 (UTC) | Operations 후속 조치 |
+|---|---|---|---|---|---|
+|  |  |  |  |  |  |
+
+> 예외 없음 시 이 섹션을 "해당 없음"으로 처리한다.
+
+# 7. Operations 단계 전달 체크
+- [ ] 롤백 가능한 배포 계획 승인됨
+- [ ] 배포 체크리스트 항목 전체 "완료" 또는 "해당없음" 처리됨
+- [ ] 릴리즈/롤백 체크리스트가 근거와 함께 완료됨
+- [ ] 배포 후 관찰 항목이 정의됨
+- [ ] Operations에 전달할 관찰 포인트, 장애 트리거, 후속 대응 절차 준비됨
+- [ ] 승인된 예외 이력 인계됨
+- [ ] 최종 승인
+  - {{CONFIRM: Release 초안 승인 여부를 확인하라}}
+
+# 8. 파일 처리 결과
+- 생성/갱신 경로:
+
+# 9. 사용자 결정 필요 항목 요약
+## {{DECIDE}}
+- (없으면 이 섹션 제거)
+
+## {{CONFIRM}}
+- Release 초안 승인 여부를 확인하라. (위치: #7)
+
+## {{DATA}}
+- (없으면 이 섹션 제거)
@@ -0,0 +1,62 @@
+# Rollback Runbook Template
+
+## Metadata
+
+1. Change ID:
+2. Release Version:
+3. Environment:
+4. Owner:
+5. On-call Contact:
+6. Last Updated (UTC):
+
+## Trigger Conditions
+
+1. Error Rate Threshold:
+2. Latency Threshold:
+3. Availability Threshold:
+4. Data Integrity Alarm:
+5. Business Impact Trigger:
+
+## Pre-rollback Checks
+
+1. 장애 범위 확인(기능/사용자/데이터)
+2. 최근 배포 변경점 확인
+3. 백업/스냅샷 가용성 확인
+4. 커뮤니케이션 채널 준비
+
+## Rollback Procedure
+
+1. 트래픽 차단 또는 점진 축소
+2. 이전 안정 버전으로 아티팩트 전환
+3. 마이그레이션 롤백 또는 안전 모드 전환
+4. 캐시/큐/비동기 작업 상태 정리
+5. 서비스 재기동 및 헬스체크 확인
+
+## Data Recovery Plan
+
+1. 복원 대상 데이터 범위:
+2. 복원 방법(백업/스냅샷/리플레이):
+3. 데이터 무결성 검증 방법:
+4. 복원 예상 시간:
+
+## Validation After Rollback
+
+1. 핵심 사용자 시나리오 통과 여부
+2. API 오류율 정상화 여부
+3. 지연 시간 정상화 여부
+4. 데이터 정합성 점검 결과
+5. 모니터링 알림 해소 여부
+
+## Communication Plan
+
+1. 롤백 선언 메시지(내부)
+2. 영향 공지 메시지(외부)
+3. 상태 업데이트 주기
+4. 종료 공지 조건
+
+## Post-rollback Follow-up
+
+1. 원인 분석 티켓:
+2. 재배포 조건:
+3. 임시 완화책 제거 계획:
+4. Postmortem 일정:
@@ -0,0 +1,83 @@
+# 0. 문서 상태
+- 상태: draft
+- 승인자: {{DECIDE: 이 Verification의 최종 승인자는 누구인가?}}
+- 승인 시각: {{CONFIRM: 승인 후 기재}}
+
+# 1. Verification 개요
+- 입력 Implementation: 
+- 목적:
+- 검증 대상 작업:
+  - 1순위:
+  - 2순위:
+  - 3순위:
+
+# 2. 검증 범위
+## In Scope
+- 
+
+## Out of Scope
+- 
+
+# 3. AC별 검증 결과
+
+| Impl ID | AC | 검증 방법 | 결과 (통과/실패/보류) | 비고 |
+|---|---|---|---|---|
+| I-001 |  |  |  |  |
+
+## 품질 게이트 판정
+- Blocker 결함 수:
+- Major 결함 수:
+- 승인된 예외 건수:
+- 배포 가능 여부: {{DECIDE: 배포 가능/불가 중 선택하라}}
+
+# 4. 결함 목록
+
+| 결함 ID | 연결 Impl ID | 심각도 (Blocker/Major/Minor) | 증상 | 재현 여부 | 처리 상태 |
+|---|---|---|---|---|---|
+| D-001 |  |  |  |  |  |
+
+## 심각도 기준
+- Blocker: 서비스 중단, 데이터 손실/오염, 보안 취약점 악용 가능 상태
+- Major: 핵심 기능 오동작, 우회 가능하지만 사용자 영향이 큰 결함
+- Minor: 비핵심 기능 이슈, 문구/표시 오류, 영향이 제한적인 결함
+
+# 5. 회귀 테스트 결과
+
+| 테스트 항목 | 영향 영역 | 실행 결과 | 실패 시 원인 |
+|---|---|---|---|
+|  |  |  |  |
+
+## 회귀 리스크 평가
+- 영향 영역:
+- 롤백 조건:
+
+# 6. 예외 승인 목록
+
+| 예외 ID | 연결 결함 | 심각도 | 완화책 | 승인자 | 승인 시각 (UTC) | 유효 기간 (UTC) |
+|---|---|---|---|---|---|---|
+|  |  |  |  |  |  |  |
+
+> 예외 없음 시 이 섹션을 "해당 없음"으로 처리한다.
+
+# 7. Release 단계 전달 체크
+- [ ] Blocker 결함 0건 확인
+- [ ] Major 결함 0건 또는 승인된 예외 존재
+- [ ] 변경 코드 경로의 테스트 실행 증거(로그/리포트) 첨부
+- [ ] 신규 기능의 정상 경로 테스트 1개 이상 및 예외 경로 테스트 1개 이상 확인
+- [ ] 회귀 테스트 실패 없음 또는 원인 분석/롤백 계획 존재
+- [ ] Release에 전달할 배포 가능 여부, 예외 승인 정보, 잔여 리스크 준비됨
+- [ ] 최종 승인
+  - {{CONFIRM: Verification 초안 승인 여부를 확인하라}}
+
+# 8. 파일 처리 결과
+- 생성/갱신 경로:
+
+# 9. 사용자 결정 필요 항목 요약
+## {{DECIDE}}
+- (없으면 이 섹션 제거)
+
+## {{CONFIRM}}
+- Verification 초안 승인 여부를 확인하라. (위치: #7)
+
+## {{DATA}}
+- (없으면 이 섹션 제거)