kjh2064
bc93b7df3c
## 요약 - 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>
10 KiB
10 KiB
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 |
✅ 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)
-
의존성 분석 확정
grep "^AEG-VS-05\|^AEG-VS-06\|^AEG-X-038" docs/CURRENT/CATALOGS/WBS_PROGRESS_TRACKER.csv -
FE 컴포넌트 병렬 작업 시작
cd frontend pnpm typecheck pnpm test --reporter=verbose -
PostgreSQL 연결 복구
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