timsquad 2.0.0

package/templates/common/timsquad/ssot/deployment-spec.template.md

@@ -0,0 +1,384 @@
+---
+title: "배포 명세서 (Deployment Specification)"
+version: 1.0.0
+last_updated: {{DATE}}
+author: tsq-planner
+status: draft
+project: {{PROJECT_NAME}}
+required_level: 3
+---
+
+# 배포 명세서 (Deployment Specification)
+
+> 인프라 아키텍처, CI/CD 파이프라인, 배포 환경을 정의합니다.
+> Level 3 (Enterprise) 프로젝트 필수 문서입니다.
+
+---
+
+## 1. 인프라 개요
+
+### 1.1 아키텍처 다이어그램
+
+```
+                    ┌─────────────┐
+                    │   CDN       │
+                    │ (CloudFront)│
+                    └──────┬──────┘
+                           │
+                    ┌──────▼──────┐
+                    │ Load Balancer│
+                    │    (ALB)     │
+                    └──────┬──────┘
+                           │
+         ┌─────────────────┼─────────────────┐
+         │                 │                 │
+    ┌────▼────┐      ┌────▼────┐      ┌────▼────┐
+    │ App #1  │      │ App #2  │      │ App #3  │
+    │(Container)│    │(Container)│    │(Container)│
+    └────┬────┘      └────┬────┘      └────┬────┘
+         │                 │                 │
+         └─────────────────┼─────────────────┘
+                           │
+              ┌────────────┼────────────┐
+              │            │            │
+         ┌────▼────┐  ┌───▼────┐  ┌───▼────┐
+         │  DB     │  │ Redis  │  │  S3    │
+         │ (RDS)   │  │(Cache) │  │(Storage)│
+         └─────────┘  └────────┘  └────────┘
+```
+
+### 1.2 환경 구성
+
+| 환경 | 용도 | URL | 인프라 |
+|-----|------|-----|--------|
+| Development | 개발 | dev.example.com | 단일 인스턴스 |
+| Staging | QA/테스트 | staging.example.com | Production 유사 |
+| Production | 서비스 운영 | example.com | 고가용성 |
+
+---
+
+## 2. 클라우드 리소스
+
+### 2.1 컴퓨팅
+
+| 리소스 | 서비스 | 사양 | 환경별 수량 |
+|-------|-------|------|-----------|
+| 애플리케이션 | ECS Fargate | 0.5 vCPU, 1GB | Dev:1, Stg:2, Prod:3+ |
+| 배치 작업 | Lambda | 256MB | 필요 시 |
+
+### 2.2 데이터베이스
+
+| 리소스 | 서비스 | 사양 | 백업 |
+|-------|-------|------|------|
+| Primary DB | RDS PostgreSQL | db.t3.medium | 7일 |
+| Read Replica | RDS (Prod만) | db.t3.medium | - |
+| Cache | ElastiCache Redis | cache.t3.micro | - |
+
+### 2.3 스토리지
+
+| 리소스 | 서비스 | 용도 |
+|-------|-------|------|
+| 정적 파일 | S3 | 이미지, 파일 업로드 |
+| 로그 | S3 + CloudWatch | 애플리케이션 로그 |
+| 백업 | S3 Glacier | DB 백업 장기 보관 |
+
+### 2.4 네트워크
+
+| 리소스 | 서비스 | 설정 |
+|-------|-------|------|
+| VPC | VPC | 10.0.0.0/16 |
+| Public Subnet | 2개 AZ | 10.0.1.0/24, 10.0.2.0/24 |
+| Private Subnet | 2개 AZ | 10.0.10.0/24, 10.0.20.0/24 |
+| NAT Gateway | 각 AZ | 아웃바운드 트래픽 |
+| Security Group | 서비스별 | 최소 권한 |
+
+---
+
+## 3. CI/CD 파이프라인
+
+### 3.1 파이프라인 개요
+
+```
+┌─────────┐   ┌─────────┐   ┌─────────┐   ┌─────────┐   ┌─────────┐
+│  Push   │ → │  Build  │ → │  Test   │ → │ Deploy  │ → │ Verify  │
+│ (Main)  │   │ (Docker)│   │ (Auto)  │   │ (Auto)  │   │ (Smoke) │
+└─────────┘   └─────────┘   └─────────┘   └─────────┘   └─────────┘
+```
+
+### 3.2 브랜치 전략
+
+| 브랜치 | 용도 | 배포 환경 | 자동 배포 |
+|-------|------|----------|:--------:|
+| `main` | 프로덕션 릴리스 | Production | ❌ (승인 필요) |
+| `develop` | 개발 통합 | Staging | ✅ |
+| `feature/*` | 기능 개발 | - | ❌ |
+| `hotfix/*` | 긴급 수정 | Production | ❌ (승인 필요) |
+
+### 3.3 배포 단계
+
+```yaml
+# .github/workflows/deploy.yml
+name: Deploy
+
+on:
+  push:
+    branches: [main, develop]
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Build & Push Docker
+        run: |
+          docker build -t $IMAGE_NAME .
+          docker push $IMAGE_NAME
+
+  test:
+    needs: build
+    steps:
+      - name: Unit Tests
+        run: npm test
+
+      - name: Integration Tests
+        run: npm run test:integration
+
+      - name: Security Scan
+        run: npm audit
+
+  deploy-staging:
+    needs: test
+    if: github.ref == 'refs/heads/develop'
+    steps:
+      - name: Deploy to Staging
+        run: ./deploy.sh staging
+
+  deploy-production:
+    needs: test
+    if: github.ref == 'refs/heads/main'
+    environment: production  # 승인 필요
+    steps:
+      - name: Deploy to Production
+        run: ./deploy.sh production
+
+  verify:
+    needs: [deploy-staging, deploy-production]
+    steps:
+      - name: Smoke Test
+        run: ./smoke-test.sh
+```
+
+### 3.4 롤백 전략
+
+| 상황 | 롤백 방식 | 소요 시간 |
+|-----|----------|:--------:|
+| 배포 실패 | 자동 롤백 (이전 버전) | < 5분 |
+| 버그 발견 | 수동 롤백 | < 10분 |
+| 긴급 상황 | Blue-Green 스위칭 | < 1분 |
+
+---
+
+## 4. 컨테이너 설정
+
+### 4.1 Dockerfile
+
+```dockerfile
+# Build stage
+FROM node:20-alpine AS builder
+WORKDIR /app
+COPY package*.json ./
+RUN npm ci --only=production
+COPY . .
+RUN npm run build
+
+# Production stage
+FROM node:20-alpine
+WORKDIR /app
+COPY --from=builder /app/dist ./dist
+COPY --from=builder /app/node_modules ./node_modules
+EXPOSE 3000
+USER node
+CMD ["node", "dist/main.js"]
+```
+
+### 4.2 컨테이너 설정
+
+| 설정 | 값 | 비고 |
+|-----|-----|------|
+| Base Image | node:20-alpine | 보안 업데이트 유지 |
+| Port | 3000 | 내부 포트 |
+| User | node (non-root) | 보안 |
+| Health Check | /health | 30초 간격 |
+
+### 4.3 리소스 제한
+
+| 환경 | CPU | Memory | 최소/최대 인스턴스 |
+|-----|:---:|:------:|:---------------:|
+| Development | 0.25 | 512MB | 1/1 |
+| Staging | 0.5 | 1GB | 1/2 |
+| Production | 1.0 | 2GB | 2/10 |
+
+---
+
+## 5. 환경 변수
+
+### 5.1 환경 변수 목록
+
+→ [env-config.md](./env-config.md) 참조
+
+| 변수 | 설명 | 시크릿 | 환경별 |
+|-----|------|:------:|:------:|
+| NODE_ENV | 실행 환경 | ❌ | ✅ |
+| DATABASE_URL | DB 연결 문자열 | ✅ | ✅ |
+| JWT_SECRET | JWT 서명 키 | ✅ | ✅ |
+| REDIS_URL | Redis 연결 | ✅ | ✅ |
+| AWS_REGION | AWS 리전 | ❌ | ❌ |
+
+### 5.2 시크릿 관리
+
+| 관리 도구 | 용도 |
+|----------|------|
+| AWS Secrets Manager | 데이터베이스 자격 증명 |
+| GitHub Secrets | CI/CD 환경 변수 |
+| AWS Parameter Store | 애플리케이션 설정 |
+
+---
+
+## 6. 모니터링
+
+### 6.1 메트릭
+
+| 메트릭 | 도구 | 알림 조건 |
+|-------|------|----------|
+| CPU 사용률 | CloudWatch | > 80% (5분) |
+| Memory 사용률 | CloudWatch | > 85% (5분) |
+| 응답 시간 (P95) | CloudWatch | > 500ms |
+| 에러율 | CloudWatch | > 1% |
+| 4xx/5xx 응답 | ALB Metrics | > 10/분 |
+
+### 6.2 로깅
+
+| 로그 유형 | 저장소 | 보존 기간 |
+|---------|-------|----------|
+| 애플리케이션 | CloudWatch Logs | 30일 |
+| 액세스 로그 | S3 | 90일 |
+| 에러 로그 | CloudWatch + 알림 | 90일 |
+| 감사 로그 | S3 (Glacier) | 7년 |
+
+### 6.3 알림
+
+| 채널 | 용도 | 대상 |
+|-----|------|------|
+| Slack | 일반 알림 | #alerts |
+| PagerDuty | 긴급 알림 (P1) | On-call |
+| Email | 일일 리포트 | 팀 전체 |
+
+---
+
+## 7. 스케일링
+
+### 7.1 Auto Scaling 정책
+
+| 조건 | 액션 | 쿨다운 |
+|-----|------|:------:|
+| CPU > 70% (3분) | Scale Out (+1) | 300초 |
+| CPU < 30% (10분) | Scale In (-1) | 300초 |
+| Memory > 80% | Scale Out (+1) | 300초 |
+
+### 7.2 예상 트래픽
+
+| 시간대 | 예상 RPS | 인스턴스 수 |
+|-------|:-------:|:---------:|
+| 평시 | 100 | 2 |
+| 피크 (오후 2-6시) | 500 | 5 |
+| 이벤트 | 1000+ | 10+ |
+
+---
+
+## 8. 재해 복구 (DR)
+
+### 8.1 RPO/RTO
+
+| 메트릭 | 목표 | 전략 |
+|-------|:----:|------|
+| RPO (복구 시점 목표) | 1시간 | 시간별 백업 |
+| RTO (복구 시간 목표) | 4시간 | 자동화된 복구 |
+
+### 8.2 백업 전략
+
+| 대상 | 주기 | 보존 | 복구 테스트 |
+|-----|------|------|-----------|
+| DB 스냅샷 | 매일 | 7일 | 월간 |
+| S3 데이터 | 실시간 (버전관리) | 30일 | 분기별 |
+| 설정 파일 | 변경 시 (Git) | 영구 | - |
+
+### 8.3 Multi-AZ 구성
+
+| 리소스 | AZ 분산 |
+|-------|:------:|
+| ECS Tasks | 2 AZ |
+| RDS | 2 AZ (Multi-AZ) |
+| ElastiCache | 2 AZ |
+| ALB | 2 AZ |
+
+---
+
+## 9. 보안
+
+### 9.1 네트워크 보안
+
+| 레이어 | 보안 설정 |
+|-------|----------|
+| Edge | CloudFront + WAF |
+| ALB | HTTPS only, Security Group |
+| Application | Private Subnet |
+| Database | Private Subnet, 암호화 |
+
+### 9.2 접근 제어
+
+| 리소스 | 접근 방식 |
+|-------|----------|
+| AWS Console | IAM + MFA 필수 |
+| 서버 접속 | SSM Session Manager (SSH 없음) |
+| DB 접속 | Bastion + IAM Auth |
+
+---
+
+## 10. 비용 최적화
+
+### 10.1 예상 비용 (월간)
+
+| 리소스 | 예상 비용 | 비고 |
+|-------|:--------:|------|
+| ECS Fargate | $150 | 3 tasks 기준 |
+| RDS | $100 | db.t3.medium |
+| ElastiCache | $30 | cache.t3.micro |
+| S3 + Transfer | $50 | 100GB 기준 |
+| CloudWatch | $20 | 로그 + 메트릭 |
+| **총계** | **$350** | |
+
+### 10.2 비용 절감 방안
+
+| 방안 | 절감율 | 적용 |
+|-----|:------:|------|
+| Reserved Instance | 30-50% | 운영 안정 후 |
+| Spot Instance (비운영) | 70-90% | Dev/Test |
+| S3 Intelligent Tiering | 20% | 자동 |
+
+---
+
+## 11. 관련 문서
+
+- [환경 설정](./env-config.md) - 환경 변수
+- [보안 명세](./security-spec.md) - 보안 설정
+- [테스트 명세](./test-spec.md) - CI/CD 테스트
+
+---
+
+## 변경 이력
+
+| 버전 | 날짜 | 작성자 | 변경 내용 |
+|------|------|--------|----------|
+| 1.0.0 | {{DATE}} | tsq-planner | 초기 작성 |

package/templates/common/timsquad/ssot/env-config.template.md

@@ -0,0 +1,346 @@
+---
+title: "환경 설정 (Environment Configuration)"
+version: 1.0.0
+last_updated: {{DATE}}
+author: tsq-planner
+status: draft
+project: {{PROJECT_NAME}}
+---
+
+# 환경 설정 (Environment Configuration)
+
+> 환경별 설정값, 환경변수, 시크릿 관리를 정의합니다.
+
+---
+
+## 1. 환경 개요
+
+### 1.1 환경 목록
+
+| 환경 | 용도 | URL | 비고 |
+|-----|------|-----|------|
+| **local** | 로컬 개발 | localhost:3000 | 개인 개발 |
+| **development** | 개발 서버 | dev.example.com | 통합 테스트 |
+| **staging** | QA/테스트 | staging.example.com | Production 유사 |
+| **production** | 서비스 운영 | example.com | 실서비스 |
+
+### 1.2 환경별 특성
+
+| 특성 | Local | Development | Staging | Production |
+|-----|:-----:|:-----------:|:-------:|:----------:|
+| 디버그 모드 | ✅ | ✅ | ❌ | ❌ |
+| 로그 레벨 | debug | debug | info | warn |
+| 외부 API | Mock | Sandbox | Sandbox | Real |
+| DB | Local | Shared | Dedicated | Dedicated |
+| SSL | ❌ | ✅ | ✅ | ✅ |
+
+---
+
+## 2. 환경변수 목록
+
+### 2.1 애플리케이션 설정
+
+| 변수명 | 설명 | 타입 | 필수 | 기본값 |
+|-------|------|------|:----:|--------|
+| `NODE_ENV` | 실행 환경 | string | ✅ | development |
+| `PORT` | 서버 포트 | number | ❌ | 3000 |
+| `HOST` | 호스트 주소 | string | ❌ | 0.0.0.0 |
+| `API_VERSION` | API 버전 | string | ❌ | v1 |
+| `LOG_LEVEL` | 로그 레벨 | enum | ❌ | info |
+| `TZ` | 타임존 | string | ❌ | UTC |
+
+### 2.2 데이터베이스 설정
+
+| 변수명 | 설명 | 타입 | 필수 | 시크릿 |
+|-------|------|------|:----:|:------:|
+| `DATABASE_URL` | DB 연결 문자열 | string | ✅ | ✅ |
+| `DB_HOST` | DB 호스트 | string | ⚪ | ❌ |
+| `DB_PORT` | DB 포트 | number | ⚪ | ❌ |
+| `DB_NAME` | DB 이름 | string | ⚪ | ❌ |
+| `DB_USER` | DB 사용자 | string | ⚪ | ✅ |
+| `DB_PASSWORD` | DB 비밀번호 | string | ⚪ | ✅ |
+| `DB_SSL` | SSL 사용 여부 | boolean | ❌ | ❌ |
+| `DB_POOL_MIN` | 최소 커넥션 | number | ❌ | ❌ |
+| `DB_POOL_MAX` | 최대 커넥션 | number | ❌ | ❌ |
+
+> ⚪ = `DATABASE_URL` 사용 시 불필요
+
+### 2.3 캐시/세션 설정
+
+| 변수명 | 설명 | 타입 | 필수 | 시크릿 |
+|-------|------|------|:----:|:------:|
+| `REDIS_URL` | Redis 연결 문자열 | string | ⚪ | ✅ |
+| `REDIS_HOST` | Redis 호스트 | string | ⚪ | ❌ |
+| `REDIS_PORT` | Redis 포트 | number | ❌ | ❌ |
+| `REDIS_PASSWORD` | Redis 비밀번호 | string | ⚪ | ✅ |
+| `SESSION_SECRET` | 세션 시크릿 | string | ✅ | ✅ |
+| `SESSION_TTL` | 세션 만료 (초) | number | ❌ | ❌ |
+
+### 2.4 인증/보안 설정
+
+| 변수명 | 설명 | 타입 | 필수 | 시크릿 |
+|-------|------|------|:----:|:------:|
+| `JWT_SECRET` | JWT 서명 키 | string | ✅ | ✅ |
+| `JWT_EXPIRES_IN` | JWT 만료 시간 | string | ❌ | ❌ |
+| `JWT_REFRESH_SECRET` | Refresh 토큰 키 | string | ⚪ | ✅ |
+| `JWT_REFRESH_EXPIRES_IN` | Refresh 만료 | string | ❌ | ❌ |
+| `BCRYPT_ROUNDS` | 해시 라운드 | number | ❌ | ❌ |
+| `CORS_ORIGINS` | 허용 Origin | string | ❌ | ❌ |
+
+### 2.5 외부 서비스 설정
+
+| 변수명 | 설명 | 타입 | 필수 | 시크릿 |
+|-------|------|------|:----:|:------:|
+| `AWS_REGION` | AWS 리전 | string | ⚪ | ❌ |
+| `AWS_ACCESS_KEY_ID` | AWS 액세스 키 | string | ⚪ | ✅ |
+| `AWS_SECRET_ACCESS_KEY` | AWS 시크릿 키 | string | ⚪ | ✅ |
+| `S3_BUCKET` | S3 버킷명 | string | ⚪ | ❌ |
+| `SMTP_HOST` | SMTP 서버 | string | ⚪ | ❌ |
+| `SMTP_USER` | SMTP 사용자 | string | ⚪ | ✅ |
+| `SMTP_PASSWORD` | SMTP 비밀번호 | string | ⚪ | ✅ |
+
+---
+
+## 3. 환경별 설정값
+
+### 3.1 Local
+
+```env
+# .env.local
+NODE_ENV=development
+PORT=3000
+LOG_LEVEL=debug
+
+# Database (Local)
+DATABASE_URL=postgresql://postgres:postgres@localhost:5432/{{PROJECT_NAME}}_dev
+
+# Redis (Local)
+REDIS_URL=redis://localhost:6379
+
+# Auth
+JWT_SECRET=local-dev-secret-change-in-production
+JWT_EXPIRES_IN=1d
+SESSION_SECRET=local-session-secret
+
+# 기타
+CORS_ORIGINS=http://localhost:3000,http://localhost:3001
+```
+
+### 3.2 Development
+
+```env
+# .env.development
+NODE_ENV=development
+PORT=3000
+LOG_LEVEL=debug
+
+# Database
+DATABASE_URL=${DEV_DATABASE_URL}
+
+# Redis
+REDIS_URL=${DEV_REDIS_URL}
+
+# Auth (시크릿 매니저에서 관리)
+JWT_SECRET=${DEV_JWT_SECRET}
+SESSION_SECRET=${DEV_SESSION_SECRET}
+
+# External Services (Sandbox)
+AWS_REGION=ap-northeast-2
+```
+
+### 3.3 Staging
+
+```env
+# .env.staging
+NODE_ENV=staging
+PORT=3000
+LOG_LEVEL=info
+
+# Database
+DATABASE_URL=${STAGING_DATABASE_URL}
+
+# Redis
+REDIS_URL=${STAGING_REDIS_URL}
+
+# Auth
+JWT_SECRET=${STAGING_JWT_SECRET}
+SESSION_SECRET=${STAGING_SESSION_SECRET}
+
+# External Services
+AWS_REGION=ap-northeast-2
+```
+
+### 3.4 Production
+
+```env
+# .env.production
+NODE_ENV=production
+PORT=3000
+LOG_LEVEL=warn
+
+# Database (시크릿 매니저)
+DATABASE_URL=${PROD_DATABASE_URL}
+
+# Redis
+REDIS_URL=${PROD_REDIS_URL}
+
+# Auth
+JWT_SECRET=${PROD_JWT_SECRET}
+JWT_EXPIRES_IN=15m
+JWT_REFRESH_EXPIRES_IN=7d
+SESSION_SECRET=${PROD_SESSION_SECRET}
+
+# External Services
+AWS_REGION=ap-northeast-2
+```
+
+---
+
+## 4. 시크릿 관리
+
+### 4.1 시크릿 목록
+
+| 시크릿명 | 환경 | 관리 도구 | 비고 |
+|---------|------|----------|------|
+| `DATABASE_URL` | All | AWS Secrets Manager | DB 연결 |
+| `JWT_SECRET` | All | AWS Secrets Manager | 토큰 서명 |
+| `SESSION_SECRET` | All | AWS Secrets Manager | 세션 암호화 |
+| `REDIS_PASSWORD` | Staging/Prod | AWS Secrets Manager | 캐시 인증 |
+| `AWS_SECRET_ACCESS_KEY` | All | IAM Role (권장) | AWS 인증 |
+| `SMTP_PASSWORD` | All | AWS Secrets Manager | 이메일 발송 |
+
+### 4.2 시크릿 관리 정책
+
+```yaml
+secret_policy:
+  rotation:
+    DATABASE_URL: 90d
+    JWT_SECRET: 30d
+    SESSION_SECRET: 30d
+
+  access:
+    development:
+      - team: developers
+        permission: read
+    staging:
+      - team: developers
+        permission: read
+      - team: qa
+        permission: read
+    production:
+      - team: devops
+        permission: admin
+      - team: developers
+        permission: none  # CI/CD만 접근
+```
+
+### 4.3 시크릿 접근 방법
+
+**Local (dotenv):**
+```typescript
+// .env.local 파일에서 로드
+import 'dotenv/config';
+
+const secret = process.env.JWT_SECRET;
+```
+
+**Production (AWS Secrets Manager):**
+```typescript
+import { SecretsManager } from '@aws-sdk/client-secrets-manager';
+
+const client = new SecretsManager({ region: 'ap-northeast-2' });
+const secret = await client.getSecretValue({ SecretId: 'prod/jwt-secret' });
+```
+
+---
+
+## 5. 설정 검증
+
+### 5.1 필수 환경변수 검증
+
+```typescript
+// config/validation.ts
+import { z } from 'zod';
+
+const envSchema = z.object({
+  NODE_ENV: z.enum(['development', 'staging', 'production']),
+  PORT: z.coerce.number().default(3000),
+  DATABASE_URL: z.string().url(),
+  JWT_SECRET: z.string().min(32),
+  SESSION_SECRET: z.string().min(32),
+});
+
+export const env = envSchema.parse(process.env);
+```
+
+### 5.2 시작 시 검증
+
+| 검증 항목 | 실패 시 동작 |
+|---------|-------------|
+| 필수 변수 누락 | 앱 시작 중단 + 에러 로그 |
+| DB 연결 실패 | 앱 시작 중단 + 알림 |
+| Redis 연결 실패 | 경고 + 폴백 (in-memory) |
+| 시크릿 형식 오류 | 앱 시작 중단 |
+
+---
+
+## 6. Feature Flags
+
+### 6.1 플래그 목록
+
+| 플래그 | 설명 | 기본값 | 환경별 |
+|-------|------|:------:|--------|
+| `FEATURE_NEW_UI` | 새 UI 활성화 | false | Staging만 true |
+| `FEATURE_BETA_API` | Beta API 노출 | false | Dev만 true |
+| `FEATURE_MAINTENANCE` | 점검 모드 | false | 필요 시 true |
+
+### 6.2 플래그 사용
+
+```typescript
+// 환경변수 방식
+if (process.env.FEATURE_NEW_UI === 'true') {
+  // 새 UI 렌더링
+}
+
+// 설정 서비스 방식 (권장)
+if (await featureService.isEnabled('NEW_UI', userId)) {
+  // 사용자별 롤아웃 지원
+}
+```
+
+---
+
+## 7. 배포 시 체크리스트
+
+### 7.1 환경별 체크리스트
+
+| 항목 | Dev | Staging | Prod |
+|-----|:---:|:-------:|:----:|
+| 환경변수 설정 완료 | ✅ | ✅ | ✅ |
+| 시크릿 등록 완료 | ✅ | ✅ | ✅ |
+| DB 마이그레이션 | ✅ | ✅ | ✅ |
+| SSL 인증서 | ❌ | ✅ | ✅ |
+| 모니터링 연동 | ❌ | ✅ | ✅ |
+| 알림 설정 | ❌ | ⚪ | ✅ |
+
+### 7.2 롤백 시 주의사항
+
+- 시크릿 변경 후 롤백 시 **이전 시크릿 값 필요**
+- Feature flag 롤백은 **즉시 적용됨**
+- DB 스키마 변경은 **backwards-compatible 필수**
+
+---
+
+## 8. 관련 문서
+
+- [배포 명세](./deployment-spec.md) - CI/CD 설정
+- [보안 명세](./security-spec.md) - 인증/암호화
+- [외부 연동 명세](./integration-spec.md) - 외부 서비스
+
+---
+
+## 변경 이력
+
+| 버전 | 날짜 | 작성자 | 변경 내용 |
+|------|------|--------|----------|
+| 1.0.0 | {{DATE}} | tsq-planner | 초기 작성 |