Initial commit: Add project files
ci / backend (push) Failing after 12s
ci / frontend (push) Failing after 19s
ci / static (push) Failing after 45s

This commit is contained in:
2026-08-02 05:15:36 +09:00
commit dcd1322d41
636 changed files with 122352 additions and 0 deletions
@@ -0,0 +1,43 @@
# K-ArtSell Aegis v12.4 지속 모델 운영·개선 통합 고도화 제안
상태: **IMPLEMENTATION_TEMPLATE / STATIC_VALIDATION_REQUIRED / BUILD_AND_DB_REHEARSAL_REQUIRED**
운영 경계: **RESEARCH_CANDIDATE_NOT_PRODUCTION · 투자자문형 우선 · 자동주문/KIS 제출 OFF**
## 경영진 결론
v12.4는 기존 패키지를 다시 쓰거나 요약본으로 대체하지 않는다. v10.0의 `Baseline Preservation + Delta + Supersession + Traceability`, v12.1의 실행준비 기준, v12.3의 정책·데이터 의미 버전을 그대로 보존한다. 이번 Delta는 **모델이 시간이 지나면서 스스로 생산 설정을 바꾸는 자동학습 체계가 아니라, 동결된 증거를 정기적으로 수집·평가하고 개선 제안을 생성하여 사람이 승인하도록 하는 지속 모델 운영 체계**다.
제품의 핵심 흐름은 다음과 같다.
`Source/License → Raw/PIT/Revision/DQ → Frozen Evidence/VersionSet → Decision → Outcome → Daily Scorecard → Drift → Champion/Challenger → Frozen OOS/PBO/DSR → Improvement Proposal → Independent Validation → Maker-Checker Review → Shadow/Pilot`
이 흐름 어디에도 자동 모델 승격, 자동 임계값 수정, 자동 롤백, 자동 주문 또는 KIS 제출은 없다.
## v12.4 전략적 Delta
1. **지속 평가 스케줄러**: 15분 Dispatcher가 DB schedule을 lease하여 일·주·월·분기 작업을 동적으로 queue에 배치한다. 각 요청은 `Dataset/Model/Config/Code/Contract VersionSet`을 동결한다.
2. **평가 주기 표준화**: J10/J11/J17은 일, J18/J24는 주, J19/J21/J22는 월, J20/J23은 분기 cadence를 기본으로 한다.
3. **개선과 승격 분리**: J21은 개선 제안만 만들고 J22는 승격 증거 패킷만 만든다. 실제 변경은 Model Change, Golden, Frozen OOS, 독립검증, maker-checker 승인 후 별도 Release다.
4. **성과지표 계약 v2**: false-exit, reentry capture, net expected utility, calibration, PBO, DSR의 분자·분모·평가창·집계·PIT·revision을 버전 관리한다.
5. **데이터 정정 재평가**: revision 발생 시 과거 결과를 overwrite하지 않고 영향 결정을 찾아 새 Outcome/Evaluation/Correction evidence를 생성한다.
6. **운영 복원력**: schedule lease, dynamic queue, idempotency, Outbox, BusinessHold, dead-letter, rollback drill, OTel 추적을 단일 운영계약으로 연결한다.
7. **FE 운영 화면**: 모델 운영 계획, 자동화 경계, drift, champion/challenger, OOS, 개선 제안, 승격 Gate를 역할별 읽기·검토 화면으로 분리한다.
## 과유불급 통제
- 26개 Vertical Slice는 확대하지 않는다. 지속 모델 운영은 VS-18, VS-19, VS-20, VS-23, VS-25에 귀속한다.
- 전면 Event Sourcing, 조기 Microservice, 범용 Workflow Engine, AutoML, 실시간 온라인 학습을 도입하지 않는다.
- 모든 테이블을 불변으로 만들지 않는다. Evidence/Observation/Review는 append-only, schedule lease와 운영 상태는 명시적 mutable state로 분리한다.
- Drift 임계값, false-exit 정의, 보존기간처럼 첨부 근거가 부족한 항목은 `DECISION_REQUIRED`로 남긴다.
## 완료 정의
v12.4의 완료는 파일 존재가 아니다. 다음 증거가 연결되어야 한다.
`Source → Requirement → Schedule/Metric Contract → API/DB/Job/UI → Test → PR → Release Evidence → Operating Evidence`
현재 패키지는 정적 검증과 템플릿 제공 단계이며, .NET 10 실빌드·PostgreSQL migration rehearsal·pnpm frozen build·252거래일 Shadow는 별도 승인 환경에서 수행해야 한다.
### v12.4 request lifecycle audit clarification
`evaluation.model_operation_request`는 실행 상태와 시각을 트랜잭션으로 갱신할 수 있는 lifecycle aggregate다. 모든 상태 전이는 `evaluation.model_operation_status_event`에 append-only로 기록하여 실행 이력과 재처리 증거를 보존한다.