Initial commit: Add project files

2026-08-02 05:15:36 +09:00
commit dcd1322d41
636 changed files with 122352 additions and 0 deletions
@@ -0,0 +1,25 @@
+# K-ArtSell Aegis v12.3 실행·검증 하드닝 제안
+
+상태: **IMPLEMENTATION_TEMPLATE / STATIC_VALIDATION_REQUIRED / BUILD_AND_DB_REHEARSAL_REQUIRED**  
+운영 경계: **투자자문형 우선 · 자동주문/KIS 제출 OFF · RESEARCH_CANDIDATE_NOT_PRODUCTION**
+
+## 경영진 결론
+
+v12.3은 v10.0의 Baseline Preservation + Delta + Supersession + Traceability와 v12.2의 Lot/종목 비중 분리를 유지한다. 신규 Delta는 화면 확대가 아니라 **데이터 의미의 안전한 전환, 정책 계약 버전, CI·스캐폴딩의 재현성, 성과지표 정의 이력**에 집중한다.
+
+생산준비도는 `Source/License → PIT/Revision/DQ → Evidence/VersionSet → Sell/Reentry → Recommendation → Maker-Checker → Publish → Outcome → Reconciliation/DR`의 완결성으로 판정한다.
+
+## v12.3 핵심 교정
+
+1. v12.2 이전 `current_portfolio_weight` backfill을 명시적 Lot 비중으로 간주하지 않는다. `weight_semantics_version=2`인 재구축 Context만 결정에 사용한다.
+2. Opportunity edge가 양수라도 요청 매도비율이 0이면 10%로 강제 clamp하지 않고 `BLOCKED` 처리한다.
+3. 정책 ID·우선순위·임계값을 `SellPolicyContract`와 machine-readable JSON registry로 동기화하고 변경 시 Model Change·Golden·OOS 증거를 요구한다.
+4. Decision/API/Event/DB에 `decision_contract_version`과 `policy_trace_schema_version`을 포함한다.
+5. false-exit·재진입 KPI의 분자·분모·평가창·집계를 버전 관리하며, 연구 CSV의 63일 지표와 연 2% 목표를 직접 동일시하지 않는다.
+6. 스캐폴딩은 dry-run 기본·overwrite 금지·SCAFFOLD_ONLY로 고정하여 바이브코딩의 무단 추정을 차단한다.
+
+## 범위와 과유불급
+
+- Modular Monolith·Vertical Slice·Outbox/Inbox·Read Model은 유지한다. 조기 Microservice, Generic Repository, 전면 Event Sourcing은 도입하지 않는다.
+- 26개 Slice 범위를 확대하지 않고, 250개 WBS에 안전·검증 Delta를 연결한다.
+- 자동주문과 KIS 제출은 여전히 OFF다. 252거래일 Shadow, 복수 국면 OOS, PBO/DSR, 준법·보안·DR Gate 전에는 투자일임형을 검토하지 않는다.