# K-ArtSell Aegis v12.1 실행준비 고도화 제안

상태: `IMPLEMENTATION_TEMPLATE / STATIC_VALIDATED / BUILD_AND_DB_REHEARSAL_REQUIRED`  
운영 경계: **투자자문형 우선 · RESEARCH_CANDIDATE_NOT_PRODUCTION · 자동주문/KIS 제출 OFF**

## 1. 경영진 결론

v12.1은 기존 문서를 다시 쓰는 요약본이 아니다. v10.0의 `Baseline Preservation + Delta + Supersession + Traceability`를 유지하고, K-ArtSell 12.2 연구근거, v11 구현 골격, v11.1 하드닝, v12.0 통합 패키지 위에 **실행준비도 Delta**를 추가한다.

핵심은 기능 수가 아니라 다음 Critical Path의 완결성이다.

`Source/License → PIT/Revision/DQ → Evidence/Version Set → Sell/Reentry Policy → Recommendation → Maker-Checker → Publish → Outcome → Reconciliation/DR`

대시보드나 상품탐색을 앞당겨도 이 경로가 끊기면 생산준비도는 올라가지 않는다.

## 2. v12.1에서 보강한 것

- 현재 세션 첨부파일 **8개를 원본 그대로 보존**하고 SHA-256·중복그룹을 기록했다.
- 26개 Vertical Slice를 Requirement/API/DB/Job/UI/Test/Gate에 연결했다.
- 상세 WBS를 **202개 실행 작업**으로 재구성했다. 각 행은 산출물·수용증거·Owner·의존성·Gate·PD를 가진다.
- Generic Repository/God Service/조기 microservice/현재값 overwrite/무승인 자동 추상화를 금지한다.
- Outbox/Inbox, JobRun, Projection checkpoint, PIT/DQ, immutable audit의 기본 템플릿을 보강한다.
- FE는 TanStack Query=서버상태, Pinia=세션/권한/UI 선호, vee-validate+Zod=폼, vue-router=공유상태로 책임을 고정한다.
- 바이브코딩은 `SOURCE / ASSUMPTION / UNKNOWN / DECISION_REQUIRED`를 강제하고 실행하지 않은 검증은 통과로 기록하지 않는다.

## 3. 즉시 Go/No-Go

현재는 **코딩 착수용 템플릿은 Go, 생산/Shadow 승격은 No-Go**다.

Go 전 필수:
1. 승인 runner의 `.NET 10 restore/build/test`.
2. `pnpm-lock.yaml` 생성·검토 후 frozen install/typecheck/test/build.
3. PostgreSQL fresh/upgrade/re-run/failure migration rehearsal.
4. OIDC/JWT, 데이터 라이선스, Fee/Tax/FX, SLO/RPO/RTO 결정.
5. 252거래일·복수 국면 Shadow와 PBO/DSR/비용 2배 검증.

## 4. 과유불급 원칙

- 초기 배포는 Modular Monolith다. 실제 독립 배포·확장·장애 격리 요구가 증명되기 전 microservice로 분리하지 않는다.
- 동일 업무 의미와 변경축이 3회 이상 반복될 때만 공통 컴포넌트로 승격한다.
- 한 번 쓰는 Interface/Wrapper/Factory는 만들지 않는다.
- 정책 변경과 동작보존 리팩터링은 별도 PR로 분리한다.
- 정규화 Write Model과 역정규화 Read Model을 분리하며, Read Model에는 Owner/Version/Watermark/Rebuild/Staleness가 필수다.