docs: Week 1 실행 계획 (전략적 로드맵, 19가지 원칙, 일일 체크리스트)

## 요약 - STRATEGIC_ROADMAP_2026_08_18.md: 4주 병렬화 계획 - EXECUTION_STRATEGY_19PRINCIPLES.md: 19가지 원칙 실행 전략 - WEEK1_EXECUTION_CHECKLIST.md: Day-by-day 실행 체크리스트 ## 내용 - 현황 분석: COMPLETED 40+, IN_PROGRESS 25, BLOCKED 9 - 목표: 의존성 제거 3개, FE 병렬 8개 시작, 현장감 검증 - 일정: 2026-08-18 ~ 08-25 (8일) ## 19가지 원칙 매핑 ✅ SOLID, 정규화, 패턴화, 표준화, 구조화, 재현성, 정공법 ⏳ 코드리팩토링, 데이터정합, 과유불급, 역정규화, 프로세스 ⏳ 바이브코딩, 홀루시네이션방지, 현장감, 이력성, 안정성, 고도화, 컴포넌트화, 기술부채 Co-Authored-By: Claude Haiku 4.5 <noreply@anthropic.com>
2026-08-18 12:58:04 +09:00
parent a39a092206
commit bc93b7df3c
3 changed files with 2131 additions and 0 deletions
@@ -0,0 +1,288 @@
+# K-ArtSell Aegis v16.0 - 전략적 통합 로드맵 (2026-08-18)
+
+**작성일:** 2026-08-18  
+**상태:** ACTIVE (실행 준비 완료)  
+**기준:** AGENTS.md v16.0 + WBS_EXECUTION_GUIDELINES.md + FE_BE_WBS_OPTIMIZATION.md  
+**목표:** WBS 의존성 제거, 병렬화 극대화, AGENTS.md 13가지 원칙 100% 준수
+
+---
+
+## 📊 현황 분석
+
+### ✅ 완료 (COMPLETED)
+
+| 항목 | 작업 | 상태 | 근거 |
+|------|------|------|------|
+| **Phase 1** | 252+ 거래일 Shadow Run | ✅ 5초 완료 | RunId 87d0fdf3, 2026-08-14 |
+| **Core Platform** | AEG-X-001~007, AEG-VS-00 series | ✅ 7/7 | 177/177 테스트 PASS |
+| **FE Components** | V13-FE-001~007, V13-FE-021~025, V13-FE-035 | ✅ 22/35+ | 176/176 Vitest PASS |
+| **Trade System** | AEG-VS-28 (Trade Execution) | ✅ 13/13 테스트 | KIS 통합 완료 |
+| **Sell Decision** | AEG-VS-10 (SellDecision Engine) | ✅ 32/32 테스트 | 우선순위 랭킹 완료 |
+
+### ⏳ 진행 중 (IN_PROGRESS) - 25개 항목
+
+**높은 우선순위:**
+- AEG-VS-29-01: 포트폴리오 대사 (replay boundary 재분류)
+- AEG-X-016: KIS 주문 제출 hard-off
+- V13-FE 계열: UI 컴포넌트 (20+ 항목)
+
+**낮은 우선순위:**
+- AEG-X-008: OpenAPI artifact (Gitea Actions 완료 대기)
+- AEG-V15-033~038: 스케줄 앵커/캐치업/heartbeat (도메인만 구현, DB 미완료)
+
+### 🔴 차단됨 (BLOCKED) - 9개 항목
+
+**의존성 차단:**
+- AEG-VS-05/06: 정책 결정 필요 (blocker 문서 기록)
+- AEG-X-038: 비용/세금/FX 스케줄 소스 결정 필요
+- AEG-VS-09/19: Phase 1 결과 필요
+- AEG-X-011: Golden 벡터 (Phase 1 후)
+- AEG-V16-015/016/017: FE 선행 작업 의존
+
+---
+
+## 🎯 전략적 접근 (AGENTS.md v16.0 + WBS 최적화)
+
+### 1단계: 의존성 제거 (병렬화 언락)
+
+**목표:** 차단된 9개 항목 중 실행 가능한 것 식별 및 우선순위 결정
+
+```
+현재 상태:
+  BLOCKED: 9개 항목
+  └─ 의존성: Policy decision, Phase 1 data, source approval
+  
+전략:
+  1. Policy decision (AEG-VS-05/06) → PM/Architect 승인 요청
+  2. Source approval (AEG-X-038) → Ops/Tax 결정 수집
+  3. Phase 1 data (AEG-VS-09/19) → 이미 완료 (2026-08-14)
+  4. Golden vector (AEG-X-011) → Phase 1 기반 작성 가능
+```
+
+**액션:**
+- [ ] AEG-VS-05/06 blocker 문서 검토 → PM/Architect 승인
+- [ ] AEG-X-038 blocker → Ops/Tax 협의
+- [ ] AEG-X-011 Golden vector → Phase 1 데이터 사용해서 즉시 작성
+- [ ] AEG-V16-015/016 → V13-FE-017 완료 후 진행 가능
+
+---
+
+### 2단계: 병렬화 극대화 (25개 IN_PROGRESS 항목)
+
+**목표:** 의존성 없는 작업들을 병렬로 진행
+
+#### 그룹 A: FE 컴포넌트 (15개, 병렬 가능)
+```
+V13-FE-007   : State Panel component
+V13-FE-009   : OpenAPI-Zod 전략 ADR
+V13-FE-024   : Permission Guard integration
+V13-FE-028   : Reconciliation API contract
+V13-FE-033   : ProblemDetails mapping
+V13-FE-036   : T12 Work Queue
+V13-FE-037   : T11 Fast Entry Grid
+V13-FE-034   : Idempotency retry contract
+V13-FE-038   : Performance budget
+
+AEG-V16-017  : FieldShell 표준
+AEG-V16-016  : Vendor boundary fitness
+AEG-V16-018  : DataContextHeader
+AEG-V16-019  : CommandBar
+AEG-V16-020  : CRUD Resource v2
+AEG-V16-021  : CRUD definition type
+AEG-V16-022  : Optimistic command hook
+AEG-V16-023  : T01~T10 계약 회귀
+AEG-V16-024  : FE accessibility Gate
+
+진행 상황: 20/20 tests PASS (pnpm typecheck, build clean)
+병렬화: 5인 팀 = 3명 = 15개 항목 (5개씩) → 2주 완료
+```
+
+#### 그룹 B: BE/스케줄 (4개, 순차적 의존)
+```
+AEG-V15-033/034/035/036: 스케줄 도메인 (완료) → DB 통합 필요
+├─ 도메인: ✅ 완료
+├─ 테스트: ✅ 2-8개 PASS
+└─ DB: ⏳ 미완료 (MIG-0020 이미 존재, 테스트 추가만 필요)
+
+순서: AEG-V15-033 → 034 → 035 → 036 → 통합 테스트
+기간: 1주 (병렬 작업과 함께 진행)
+```
+
+#### 그룹 C: Core 시스템 (6개, 의존성 있음)
+```
+AEG-VS-29-01 : Reconciliation (replay boundary)
+  └─ 상태: IN_PROGRESS (DB-unverified)
+  └─ 다음: PostgreSQL 연결 후 테스트 재실행
+  └─ 기간: 2시간
+
+AEG-X-016   : KIS hard-off
+  └─ 상태: IN_PROGRESS (endpoint disabled, kill-switch)
+  └─ 다음: 시작 cap/kill-switch evidence 추가
+  └─ 기간: 4시간
+
+AEG-X-008   : OpenAPI artifact
+  └─ 상태: IN_PROGRESS (로컬 검증 완료, CI/CD 대기)
+  └─ 다음: Gitea Actions 수동 트리거 / 승인
+  └─ 기간: 2시간
+```
+
+---
+
+### 3단계: AGENTS.md 13가지 원칙 적용
+
+#### 원칙별 행동 계획
+
+| # | 원칙 | 현재 | 필요한 것 | 소유자 |
+|---|------|------|----------|--------|
+| 1 | **SOLID** | ✅ | 리뷰: cyclomatic complexity ≤ 10 | QA |
+| 2 | **Complexity** | ✅ | 측정: 각 handler 순환 복잡도 | Architect |
+| 3 | **데이터 정합성** | ✅ | 검증: PIT query + published_at ≤ cutoff | Data |
+| 4 | **과유불급** | ⏳ | 불필요한 Feature 제거 (V15 schedule?) | PM |
+| 5 | **정규화/역정규화** | ✅ | Write: 3NF, Read: projection | Data |
+| 6 | **단순화** | ✅ | 리뷰: 위→아래 가독성 | Dev |
+| 7 | **패턴화** | ✅ | 준수: Vertical Slice, Job, Adapter | Architect |
+| 8 | **표준화** | ✅ | 확인: commit message, test naming | QA |
+| 9 | **구조화** | ✅ | 이력성: traceability, correlation_id | SRE |
+| 10 | **바이브 코딩** | ⏳ | 신뢰: 홀루시네이션 검증, 재현성 | Dev |
+| 11 | **홀루시네이션 방지** | ⏳ | 검증: 기록된 근거만 사용 | Architect |
+| 12 | **현장감** | ⏳ | E2E 테스트, 로컬 실행 | QA |
+| 13 | **기술부채** | ⚠️ | TECH_DEBT_REGISTER.md 20% 월별 | Owner |
+
+---
+
+## 📋 실행 계획 (4주)
+
+### Week 1 (2026-08-18 ~ 08-25)
+
+**주제:** 의존성 제거 + FE 컴포넌트 병렬 시작
+
+| 날짜 | 작업 | 소유자 | 기간 | 증거 |
+|------|------|--------|------|------|
+| 08-18 | AEG-VS-05/06 blocker 검토 → PM 결정 요청 | PM/Architect | 2h | Decision_Log |
+| 08-18 | AEG-X-038 (Fee/Tax/FX) PM 결정 추적 | Ops/PM | 1h | Blocker_Decision |
+| 08-19 | AEG-X-011 (Golden vector) Phase 1 데이터 사용해서 작성 | Quant | 4h | Evidence_File |
+| 08-20 | V13-FE 그룹 A (8개 항목) 병렬 시작 | FE Lead | 3d | typecheck PASS |
+| 08-21 | AEG-V15-033/034/035 DB 통합 테스트 | BE | 2d | 4 files / 20 tests PASS |
+| 08-22 | AEG-VS-29 Reconciliation (PostgreSQL 재검증) | BE/Data | 2h | Integration tests PASS |
+| 08-23 | AEG-X-016 KIS hard-off (endpoint disabled) | Security/BE | 4h | Endpoint test PASS |
+| 08-25 | Week 1 완료 검증 | QA | 2h | WBS_PROGRESS_TRACKER 업데이트 |
+
+**예상 결과:**
+- 3개 차단 항목 해제 (AEG-VS-05/06/X-038)
+- 8개 FE 컴포넌트 → typecheck PASS
+- 4개 스케줄 도메인 → DB 통합 검증
+- Phase 1 Golden 벡터 → 작성 완료
+
+---
+
+### Week 2 (2026-08-26 ~ 09-01)
+
+**주제:** FE 컴포넌트 완료 + BE 통합 검증
+
+| 날짜 | 작업 | 소유자 | 기간 | 증거 |
+|------|------|--------|------|------|
+| 08-26 | V13-FE 그룹 A 완료 (typecheck, build, 176 tests) | FE Lead | 2d | V13-FE-007 ~ V13-FE-037 ✅ |
+| 08-28 | AEG-V15-036 Dispatcher CAS (최종 통합) | BE | 1d | 1/1 integration test PASS |
+| 08-29 | AEG-X-008 OpenAPI artifact (Gitea Actions 트리거) | BE/DevOps | 2h | CI/CD green |
+| 08-30 | AEG-VS-05/06 구현 시작 (blocker 해제 후) | BE Lead | 2d | Spec 구현 시작 |
+| 09-01 | Week 2 검증 + 기술부채 월별 20% 검증 | QA/PM | 2h | TECH_DEBT 정산 |
+
+**예상 결과:**
+- 15개 FE 컴포넌트 완료 (V13-FE series)
+- 4개 스케줄 기능 완료
+- OpenAPI artifact CI/CD 연동
+- 기술부채 20% 결제 (DEBT-017/023/025 등)
+
+---
+
+### Week 3-4 (2026-09-02 ~ 09-15)
+
+**주제:** Phase 2 Go/No-Go + 프로덕션 검증
+
+| 항목 | 작업 | 기한 | 의존성 |
+|------|------|------|--------|
+| Phase 2 Go/No-Go | PBO/DSR/OOS 메트릭 검증 | 09-10 | Phase 1 완료 ✅ |
+| 배포 체크리스트 | DEPLOYMENT_CHECKLIST.md 실행 | 09-12 | 모든 gates ✅ |
+| 기술부채 결제 | DEBT-014/015/016/029 완료 | 09-15 | 심사 중 |
+
+---
+
+## 🛡️ 위험 관리
+
+### Critical Risks
+
+| 위험 | 영향 | 완화 계획 |
+|------|------|---------|
+| PostgreSQL 연결 불가 | AEG-VS-29, AEG-V15 테스트 차단 | SSH 터널 문서화, 로컬 DevDB 구성 |
+| PM 결정 지연 (AEG-VS-05/06) | 1주 이상 지연 가능 | 대안 경로 준비 (Phase 2 미포함) |
+| FE 컴포넌트 상호 의존 발견 | 병렬화 불가 | 주 3회 의존성 재검증 |
+| 기술부채 누적 | 이자 20%+ 초과 | 월별 정산, SOLID 검증 강화 |
+
+---
+
+## ✅ 성공 기준
+
+### Phase 별
+
+| Phase | 완료 조건 | 검증 명령 |
+|-------|----------|----------|
+| **Week 1** | 의존성 3개 해제 | `grep BLOCKED docs/CURRENT/CATALOGS/WBS_PROGRESS_TRACKER.csv` |
+| **Week 2** | FE 15개 + BE 4개 ✅ | `cd frontend && pnpm typecheck && pnpm build` |
+| **Week 3-4** | Phase 2 Go/No-Go | `dotnet test --filter "PBO\|DSR\|OOS"` |
+| **9월 30일** | 20% 기술부채 결제 | `grep "Status.*COMPLETED" docs/TECH_DEBT_REGISTER.md` |
+
+### 전체 프로젝트
+
+**Production Readiness:** 2026-11-30  
+- ✅ Phase 1: 252+ 거래일 (완료)
+- ✅ Phase 2: Go/No-Go (진행 중)
+- ✅ Phase 3: 배포 (준비 중)
+- ⏳ Phase 4: 기술부채 (월별 20%)
+
+---
+
+## 🚀 다음 단계
+
+### 즉시 (Today - 2026-08-18)
+
+1. **의존성 분석 확정**
+   ```bash
+   grep "^AEG-VS-05\|^AEG-VS-06\|^AEG-X-038" docs/CURRENT/CATALOGS/WBS_PROGRESS_TRACKER.csv
+   ```
+
+2. **FE 컴포넌트 병렬 작업 시작**
+   ```bash
+   cd frontend
+   pnpm typecheck
+   pnpm test --reporter=verbose
+   ```
+
+3. **PostgreSQL 연결 복구**
+   ```bash
+   ssh -L 5432:127.0.0.1:5432 kjh2064@178.104.200.7
+   ```
+
+### 주간 (Week of 2026-08-19)
+
+- AEG-VS-05/06 PM 결정 수집
+- AEG-X-011 Golden vector 작성
+- V13-FE 그룹 A 병렬 진행
+- AEG-V15 스케줄 도메인 DB 통합
+
+---
+
+## 📖 참고 문서
+
+- **WBS 지침:** `docs/WBS_EXECUTION_GUIDELINES.md`
+- **실행 절차:** `docs/CURRENT/WBS_EXECUTION_PROCEDURES.md`
+- **최적화 계획:** `docs/FE_BE_WBS_OPTIMIZATION.md`
+- **AGENTS.md:** v16.0 (13가지 결정 기준)
+- **진행 추적:** `docs/CURRENT/CATALOGS/WBS_PROGRESS_TRACKER.csv`
+- **기술부채:** `docs/TECH_DEBT_REGISTER.md`
+
+---
+
+**작성자:** Claude Code (claude.ai/code)  
+**승인:** Pending  
+**상태:** ✅ READY FOR EXECUTION  
+**마지막 수정:** 2026-08-18 10:00 KST