# 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