SP 11 DEPLOY

# Stage 11 Prompt: 배포 (Deploy)

> Spec-Contract v5.0 | Cycle: 종료 (Finalization)
> Stage Prompt ID: SP-11

---

## CONTEXT

- **현재 위치:** 종료 Cycle > Stage 11 (Deploy)
- **이전 Stage:** Stage 10 (사람 최종 점검) — 산출물: A-100 (배포 승인)
- **다음 Stage:** Stage 12 (배포 후 모니터링)
- **프로덕트 모드:** 해당 (배포 실행, dev → staging → prod)

---

## OBJECTIVE

Stage 10의 승인을 받은 성과물을 자동화된 CI/CD 파이프라인을 통해 안전하게 배포합니다. dev 환경 → staging 환경 → production 환경으로 단계적 배포를 수행하며, 각 단계마다 검증 및 모니터링을 실시합니다.

성공 기준:
1. 모든 활동(11-0 ~ 11-3) 완료: 배포 준비 → Dev 배포 → Staging 배포 → Prod 배포
2. Production Readiness 체크리스트 통과 (Staging 단계에서)
3. 최종 산출물(A-110, A-111) 생성: CICD_Pipeline.md, DEPLOY_LOG.md
4. Production 배포 후 모니터링(1시간) 완료 및 정상 확인

---

## CONSTRAINTS

**MUST DO:**
- [ ] A-072(Production_Readiness) 체크리스트 100% 통과 후에만 Staging 진행
- [ ] A-100(HUMAN_REVIEW) 승인(GO) 확인 후에만 Prod 배포 시작
- [ ] dev → staging → prod 순서 준수 (순서 뒤바뀜 금지)
- [ ] 각 단계별 헬스 체크 및 Smoke Test 자동 실행
- [ ] Production 배포 후 최소 1시간 실시간 모니터링 필수
- [ ] Rollback 계획 수립 및 테스트 완료 후 배포 실행
- [ ] 배포 중 데이터베이스 마이그레이션 필요 시 rollback 스크립트 준비

**MUST NOT DO:**
- [ ] Production 환경에 직접 배포 금지 (반드시 dev → staging 거쳐야 함)
- [ ] 테스트 단계(Smoke Test, 통합 테스트) 스킵 금지
- [ ] A-072 Production Readiness 미충족 상태로 Staging/Prod 배포 금지
- [ ] Production 배포 후 모니터링 없이 종료 금지
- [ ] 배포 로그를 기록하지 않고 종료 금지
- [ ] 에러 발생 시 수동 개입 없이 자동 진행 금지 (사람 승인 필수)

**SCOPE:**
- 배포 범위: 코드, 데이터베이스 마이그레이션, 환경 변수 설정만 포함
- 생성 파일: A-110 (CICD_Pipeline.md), A-111 (11_DEPLOY_LOG.md) 만 생성
- 기존 파일 수정 금지: A-072, A-100 등 이전 산출물 미수정
- 배포 담당자: DevOps Lead, DevOps Engineer, Ops Lead, Release Manager, On-Call Engineer

---

## INPUT ARTIFACTS

| ID | 파일 경로 | 참조 내용 |
|----|----------|----------|
| A-072 | `outputs/tms/docs/methodology/v5/artifacts/A-072_Production_Readiness.md` | Production Readiness 체크리스트 (Stage 11-2에서 검증) |
| A-100 | `outputs/tms/docs/methodology/v5/artifacts/A-100_10_HUMAN_REVIEW.md` | 사람 최종 점검 결과, Deploy 승인(GO) 여부 |
| A-023 | `outputs/tms/docs/methodology/v5/artifacts/A-023_CLAUDE.md` | 프로젝트 개요, 배포 환경 설정 정보 |

---

## OUTPUT ARTIFACTS

| ID | 파일 경로 | 형식 | 등급 | 설명 |
|----|----------|------|:----:|------|
| A-110 | `outputs/tms/docs/methodology/v5/artifacts/A-110_CICD_Pipeline.md` | ♻️ Pipeline | P0 | CI/CD 파이프라인 설정: 빌드, 테스트, 배포 단계 명세 |
| A-111 | `outputs/tms/docs/methodology/v5/artifacts/A-111_11_DEPLOY_LOG.md` | ⚡ Log | P0 | 배포 실행 로그: Dev/Staging/Prod 배포 결과, 모니터링 데이터, Rollback 실행 기록 |

---

## EXECUTION RULES

### 활동 11-0: 배포 사전 준비 (Pre-Deployment Setup)

**담당자**: DevOps Lead, Ops Lead, Backend Lead

#### 1단계: 배포 환경 점검

**Dev 환경 점검:**
- [ ] SSH 연결 확인
- [ ] 애플리케이션 서버 상태 (CPU, 메모리, 디스크) 확인
- [ ] 데이터베이스 연결 확인
- [ ] 캐시(Redis) 상태 확인
- [ ] 로그 저장소 상태 확인

**Staging 환경 점검:**
- [ ] 프로덕션과 동일 스펙 확인
- [ ] 최신 데이터 동기화 또는 마스킹 데이터 준비
- [ ] 모든 외부 서비스 연결 확인
- [ ] 모니터링 에이전트 설치 확인

**Production 환경 점검:**
- [ ] 로드 밸런서 상태 확인
- [ ] 모든 인스턴스 상태 확인
- [ ] 데이터베이스 백업 확인 (백업 시간, 크기, 검증 여부)
- [ ] CDN 캐시 상태 확인
- [ ] 보안 그룹 / 방화벽 규칙 확인

#### 2단계: 데이터베이스 마이그레이션 준비

**마이그레이션 필요 여부 확인:**
- [ ] 필요 없음 (코드 변경만)
- [ ] 필요함 (DB 스키마 변경)

**마이그레이션이 필요한 경우:**
- [ ] 마이그레이션 스크립트 작성 완료
- [ ] Rollback 스크립트 작성 및 테스트 완료
- [ ] Staging에서 테스트 완료
- [ ] 백업 생성 계획 수립
- [ ] 마이그레이션 예상 시간 추정 및 다운타임 계획 수립

#### 3단계: 환경 변수 및 시크릿 확인

**환경 변수 체크리스트:**
- [ ] API 엔드포인트 URL (Dev/Staging/Prod 각각)
- [ ] 데이터베이스 연결 문자열 (각 환경)
- [ ] 외부 서비스 API 키 (결제, 이메일, SMS, 클라우드 서비스)
- [ ] 모니터링 도구 API 키
- [ ] 보안 설정 (CORS, HTTPS 인증서, 방화벽 규칙, VPN)

#### 4단계: Rollback 계획 수립

**자동 Rollback 트리거 정의:**
- 에러율 > 1% (5분 이상 지속)
- 가용성 < 95%
- 응답 시간 > 2초 (p95)

**수동 Rollback 시나리오:**
- 데이터 무결성 오류 발견
- 보안 취약점 발견
- 심각한 비즈니스 영향

**Rollback 담당자 지정:**
- [ ] 주담당: DevOps Lead
- [ ] 부담당: Backend Lead
- [ ] 승인: CTO / VP Engineering
- [ ] 통신: Product Manager / Incident Commander

#### 5단계: 모니터링 및 알림 설정

**실시간 모니터링 대시보드 준비:**
- [ ] 에러율 (목표: < 0.1%)
- [ ] 응답 시간 (목표: < 500ms)
- [ ] 가용성 (목표: > 99.9%)
- [ ] 사용자 활동 (DAU, 신규 가입 등)
- [ ] 리소스 사용 (CPU, 메모리, 디스크)

**알림 설정:**
- [ ] P1 (가동률 < 95%) → 즉시 알림 + 자동 롤백 트리거
- [ ] P2 (응답 > 2초) → Slack 알림 + 모니터링
- [ ] P3 (에러 > 1%) → Log 기록

**모니터링 도구 설정:**
- [ ] Datadog / New Relic (APM, 로그 수집)
- [ ] 로그 분석 (ELK / Splunk)
- [ ] 사용자 모니터링 (Sentry / LogRocket)

**산출물**: DEPLOYMENT_READINESS_CHECKLIST (모든 항목 ✓ 완료 필수)

---

### 활동 11-1: Dev 환경 배포

**담당자**: DevOps Engineer, Backend Lead

#### 목표
Dev 환경에서 배포 파이프라인을 검증하고 빌드 및 배포 과정 테스트

#### 실행 단계

**1단계: 자동화된 배포 파이프라인 실행**

CI/CD 파이프라인 흐름: