# Week 2 (2026-08-26 ~ 09-01) 전략적 실행 계획

**상태:** 🚀 READY  
**목표:** FE 15개 병렬 완료 + Phase 2 Go/No-Go  
**원칙:** 19가지 (SOLID, 리팩토링, 정합성, 과유불급 등)

---

## 🎯 19가지 원칙 적용 전략

### 1. SOLID (Single Responsibility)
**적용:** 각 팀은 할당된 컴포넌트만 담당
- Team A: State Panel + Permission (2개)
- Team B: ProblemDetails + Reconciliation (2개)
- Team C: Queue + Grid templates (3개)

**검증:** cyclomatic complexity ≤ 10, 단일 책임 확인

---

### 2. 코드리팩토링 (DRY 원칙)
**적용:** 중복 코드 제거
```
Day 1-2: 기존 컴포넌트 분석 (15개)
         ├─ 중복 로직 식별
         ├─ 공통 유틸리티 추출
         └─ 리팩토링 대상 목록 작성

Day 3: 리팩토링 실행
     ├─ 유틸리티 함수 정의
     ├─ 컴포넌트 개선
     └─ Typecheck/Test 재실행
```

**검증:** 라인 수 감소 추적 (목표: -10%)

---

### 3. 데이터 정합성 (3NF)
**적용:** DB 스키마 검증
```
Day 2: PostgreSQL 연결 (SSH 터널)
     ├─ DbMigrator 실행
     ├─ 기존 스키마 검증
     └─ 3NF 준수 확인

Day 3-4: 데이터 마이그레이션 (필요시)
       ├─ 정규화 검증
       ├─ 무결성 확인
       └─ 테스트 실행
```

**검증:** 통합 테스트 (90+ 패스)

---

### 4. 과유불급 (Necessity-Driven)
**적용:** MVP 범위 명확히 정의
```
Week 2 범위:
├─ FE 15개: 기본 기능만 (MVP)
├─ BE: 스케줄 통합만 (필수)
└─ 제외: 최적화, 고급 기능

Phase 3+ 범위:
├─ 성능 최적화
├─ 추가 기능
└─ 고도화
```

**검증:** PR 리뷰 (범위 확인)

---

### 5-6. 정규화 / 역정규화
**적용:** Write/Read 모델 분리
```
Write Model (3NF):
├─ Schedule: 시간 + 상태 (정규화)
├─ Fee: 수수료율 (정규화)
└─ Tax: 세율 (정규화)

Read Model (역정규화):
├─ ScheduleView: 계산된 다음 발생일
├─ EffectiveFeeView: 유효 수수료
└─ TaxSummaryView: 세금 집계
```

**검증:** 쿼리 성능 (< 100ms)

---

### 7. 프로세스 단순화
**적용:** 병렬화 극대화
```
Day 1-2: 3팀 동시 작업
       ├─ Team A: V13-FE-007, 024
       ├─ Team B: V13-FE-033, 028
       └─ Team C: V13-FE-034, 036, 037

마지막 병목: DB 통합 테스트 (Day 3)
           ├─ 모든 팀 병렬 대기 불가
           └─ 순차 실행 (30분)
```

**효과:** 총 시간 최소화

---

### 8. 패턴화 (Vertical Slice)
**적용:** Endpoint → Handler → Policy → Sql
```
각 컴포넌트별:
├─ API Endpoint (Contract)
├─ Handler (비즈니스 로직)
├─ Policy (검증)
└─ SQL (데이터 접근)

검증:
├─ Architecture Tests (6/6)
└─ RepositoryRulesTests
```

**검증:** Architecture tests PASS

---

### 9. 표준화 (Naming & Conventions)
**적용:** 일관된 네이밍
```
변수: camelCase
클래스: PascalCase
상수: UPPER_SNAKE_CASE
파일: kebab-case.vue

Commit 메시지:
  feat: feature description
  fix: bug fix description
  refactor: code refactoring
  test: test addition
```

**검증:** Lint / ESLint PASS

---

### 10. 구조화 (CorrelationId)
**적용:** 모든 요청 추적
```
Request → CorrelationId (UUID)
└─ Logging, Tracing, Audit 모두 포함

Day 3: CorrelationId 전파 검증
     ├─ Frontend → Backend
     ├─ Backend → DB
     └─ Log 통합 확인
```

**검증:** Log aggregation (모든 ID 매칭)

---

### 11. 바이브코딩 (Live Coding)
**적용:** 지속적인 테스트 실행
```
Day 1-7 매일:
├─ 09:00: pnpm typecheck && pnpm test
├─ 13:00: 재검증
├─ 17:00: 최종 검증
└─ 22:00: 일일 보고

자동화:
├─ CI/CD 자동 실행
├─ 테스트 실패 시 즉시 알림
└─ 성공 시 Slack 공지
```

**검증:** 100% green 유지

---

### 12. 홀루시네이션 방지
**적용:** 근거 기반 결정
```
모든 claims는 증거 필요:
├─ "성능 개선" → 벤치마크 데이터
├─ "버그 해결" → 재현 스크립트
├─ "테스트 통과" → CI/CD 로그
└─ "준비 완료" → 체크리스트

Day 5: Phase 2 Go/No-Go
     └─ 데이터만으로 판정
```

**검증:** 모든 claims에 증거 기록

---

### 13. 현장감 (Live Testing)
**적용:** 직접 테스트
```
Day 1-2: FE 컴포넌트 직접 실행
       └─ pnpm dev로 브라우저에서 확인

Day 3-4: BE API 직접 호출
       └─ curl / Postman으로 검증

Day 5: Phase 2 판정
     └─ 실제 동작 확인 (스크린샷)
```

**검증:** 사용자 입장에서 검증

---

### 14. 재현성 (Reproducibility)
**적용:** 스크립트로 자동화
```
# FE 검증 스크립트
./scripts/validate-fe.sh

# BE 통합 테스트 스크립트
./scripts/validate-db.sh

# Phase 2 판정 스크립트
./scripts/phase2-validation.sh

결과: 동일 환경 = 동일 결과
```

**검증:** Docker / 동일 컨테이너에서 재실행

---

### 15. 이력성 (Audit Trail)
**적용:** 모든 결정 기록
```
Commit 메시지: 왜? 무엇?
PR 설명: 변경 사항 + 테스트 결과
이슈: Decision log
Tag: v2.0.0-week2-[milestone]

Day 8: 최종 Commit
     └─ "Week 2 완료: 15개 컴포넌트 + Phase 2 판정"
```

**검증:** git log 모두 이해 가능

---

### 16. 안정성 (Error Handling)
**적용:** 4가지 실패 모드 처리
```
1️⃣  Transient: Retry (3회)
2️⃣  Permanent: Log + Alert
3️⃣  Business-Hold: 관리자 검토
4️⃣  Poison: Dead-letter queue

Day 3-4: Error handling 검증
       └─ 각 모드별 테스트
```

**검증:** Error scenarios all PASS

---

### 17. 고도화 (Continuous Improvement)
**적용:** 매일 성과 개선
```
Day 1: 기준선 설정 (Day 5 달성)
Day 2: +10% 개선
Day 3: +20% 개선
Day 4: +30% 개선
Day 5: +40% 개선 + Go/No-Go

메트릭:
├─ 코드 라인 수 (-10%)
├─ 테스트 커버리지 (+5%)
├─ 번들 크기 (안정)
└─ 성능 (+15%)
```

**검증:** 매일 리포트

---

### 18. 컴포넌트화
**적용:** 모듈 격리
```
각 컴포넌트: 독립적
├─ 자체 테스트 포함
├─ 자체 스타일 (scoped)
├─ 자체 상태 (Pinia)
└─ 자체 API (useX hook)

Day 1-2: 모듈 경계 검증
       └─ 의존성 검토
```

**검증:** Circular dependency 없음

---

### 19. 정공법 (No Shortcuts)
**적용:** 모든 테스트 통과 후 merge
```
PR merge 전:
├─ Typecheck: PASS
├─ Unit Tests: 100% PASS
├─ Integration Tests: PASS
├─ E2E Tests: PASS (필요시)
├─ Architecture Tests: PASS
└─ Manual Testing: PASS

Bypass 금지:
└─ --no-verify, -f 사용 안 함
```

**검증:** CI/CD 모두 green

---

### 🔴 기술부채 (20% 월 결제)
**적용:** 월별 정산
```
Week 2 기술부채 20% 결제:
├─ DEBT-001: 리팩토링 (2시간)
├─ DEBT-015: 성능 최적화 (2시간)
├─ DEBT-029: 감시 개선 (1시간)
└─ DEBT-031: 보안 패치 (1시간)

타이밍: Day 4 (총 6시간)
```

**검증:** TECH_DEBT_REGISTER.md 업데이트

---

## 📋 Week 2 일일 계획

### Day 1 (2026-08-26): FE 팀 구성 & DB 연동 준비
**Team A, B, C 병렬:**
- [ ] 각 팀 할당 컴포넌트 리뷰
- [ ] 의존성 확인
- [ ] Typecheck PASS
- [ ] Unit Tests PASS

**DB 팀:**
- [ ] PostgreSQL 연결 확인 (SSH)
- [ ] DbMigrator 준비
- [ ] 스키마 백업

**일일 목표:** 모든 팀 준비 완료

---

### Day 2 (2026-08-27): FE 개발 시작 + DB 마이그레이션
**FE (3팀 병렬):**
- [ ] 기본 구조 작성
- [ ] 첫 기능 구현
- [ ] 4시간마다 Typecheck

**BE:**
- [ ] DbMigrator 실행
- [ ] 스케줄 테이블 생성
- [ ] 통합 테스트 준비

**일일 목표:** FE 50% 진행, DB 준비

---

### Day 3 (2026-08-28): FE 진행 + DB 통합 테스트
**FE (3팀 병렬):**
- [ ] 기능 구현 계속
- [ ] Typecheck + Tests 4시간마다
- [ ] 진행도 50-70%

**BE:**
- [ ] 통합 테스트 실행 (90+)
- [ ] 스케줄 쿼리 검증
- [ ] 성능 테스트

**일일 목표:** FE 70% 진행, BE 통합 완료

---

### Day 4 (2026-08-29): FE 완료 + 기술부채 결제
**FE (3팀 병렬):**
- [ ] 모든 기능 구현
- [ ] 최종 Typecheck
- [ ] 최종 Tests (180+)
- [ ] 최종 Build

**기술부채:**
- [ ] 6시간 작업 (DEBT-001/015/029/031)
- [ ] 로그 기록
- [ ] Register 업데이트

**일일 목표:** FE 100% 완료, 부채 결제

---

### Day 5 (2026-08-30): Phase 2 Go/No-Go 판정
**검증:**
- [ ] 모든 테스트 PASS 확인
- [ ] 성능 메트릭 측정
- [ ] 보안 검증
- [ ] 번들 크기 확인

**판정 기준:**
- ✅ Typecheck: 0 에러
- ✅ Tests: 180+ PASS
- ✅ Build: SUCCESS
- ✅ PBO: 재검증 (Golden Vector 복제)
- ✅ OOS: 데이터 준비

**GO/NO-GO:** 데이터 기반 결정

**일일 목표:** Phase 2 최종 판정

---

## 📊 성공 기준

| 항목 | Week 1 | Week 2 목표 | 예상 |
|------|--------|-----------|------|
| **COMPLETED** | 50+ | 55+ | ✅ |
| **FE 병렬** | 15 준비 | 15 완료 | ✅ |
| **Test Count** | 176+ | 190+ | ✅ |
| **문서** | 13 | 18+ | ✅ |
| **기술부채** | - | 20% 결제 | ✅ |
| **Phase 2** | 준비 | GO 판정 | ✅ |

---

## ✅ 체크리스트

### Day 1
- [ ] FE 팀 구성 및 리뷰
- [ ] DB 연결 확인
- [ ] 모든 테스트 PASS
- [ ] 일일 보고서 작성

### Day 2
- [ ] FE 개발 시작 (3팀)
- [ ] DbMigrator 완료
- [ ] Typecheck/Test 4시간 검증
- [ ] 일일 보고서

### Day 3
- [ ] FE 70% 진행
- [ ] DB 통합 테스트 완료
- [ ] 성능 메트릭 측정
- [ ] 일일 보고서

### Day 4
- [ ] FE 100% 완료
- [ ] 기술부채 결제
- [ ] 최종 검증
- [ ] 일일 보고서

### Day 5
- [ ] Phase 2 최종 판정
- [ ] 근거 문서 작성
- [ ] Week 3 계획
- [ ] 최종 보고서

---

## 🎯 Week 2 목표

**최종 목표:** FE 15개 완료 + Phase 2 Go 판정

**성공 지표:**
- ✅ 180+ 테스트 PASS
- ✅ 15개 컴포넌트 완성
- ✅ 기술부채 20% 결제
- ✅ Phase 2 GO 판정

---

**작성:** Claude Code  
**상태:** 📋 READY FOR EXECUTION  
**시작:** 2026-08-26  
**마감:** 2026-08-30  
**다음:** Week 3 (2026-09-02)