kjh2064
5dfb8f3e12
Reorganize documentation following AGENTS.md v16.0 governance (traceability, reproducibility): Structure changes: - CURRENT/ (new) ├─ 00~08.md (v16.0 standards, renamed for clarity) └─ CATALOGS/ (9 CSV files: WBS, decision log, debt register, matrices, catalogs) - LEGACY/ (new, read-only archives) ├─ v11/ (original baseline + hardening analysis) ├─ v12~v15/ (.gitkeep + README for future archiving) - DECISIONS/ (new, ready for ADR usage) - TEMPLATES/ (existing, unchanged) Deletions (consolidated into CURRENT/): - v16_0/ folder (files migrated) - hardening/ folder (contents → LEGACY/v11/) - Root-level v11 files (00~07.md, CSV) Renames (for clarity): - 00_EXECUTIVE_REFERENCE_IMPLEMENTATION.md → 00_EXECUTIVE.md - 01_BRUTAL_ROLE_AUDIT.md → 01_ROLE_AUDIT.md - 02_FRONTEND_ADAPTER_CRUD_STANDARD.md → 02_FE_ADAPTER.md - 03_BACKEND_DATA_SCHEDULER_STANDARD.md → 03_BE_DATA.md - 04_ALGORITHM_MODEL_GOVERNANCE.md → 04_ALGORITHM.md - 05_PROCESS_VIBE_DEBT_CONTROL.md → 05_PROCESS_VIBE_DEBT.md - 06_VALIDATION_TRUTH.md → 06_VALIDATION.md - 07_PACKAGE_ATTACHMENT_POLICY.md → 07_PACKAGE_POLICY.md Updates: - docs/INDEX.md (complete rewrite with navigation) - LEGACY/ folders with README + .gitkeep Benefits: ✅ Clear version management (v16.0 is active, v11~v15 read-only) ✅ No version mixing in root ✅ CURRENT/ as single point of reference for active docs ✅ CATALOGS/ consolidates all data matrices ✅ LEGACY/ preserves history without clutter ✅ Traceability: decision log, tech debt, WBS all linked ✅ DECISIONS/ ready for ADR pattern (future use) Sync with root: - CLAUDE.md references: docs/CURRENT/, docs/INDEX.md ✅ - AGENTS.md references: docs/CURRENT/, traceability ✅ - README.md: Document guide links updated ✅ Co-Authored-By: Claude Haiku 4.5 <noreply@anthropic.com>
13 KiB
13 KiB
| 1 | Decision_ID | Status | Decision_or_Question | Basis | Owner | Gate | Approved_or_Due |
|---|---|---|---|---|---|---|---|
| 2 | DEC-001 | APPROVED | 투자자문형→Shadow→Pilot; 자동주문 OFF | v10.0·v12.2 | 운영사/준법 | ALL | 2026-08-01 |
| 3 | DEC-002 | APPROVED | 알고리즘 상태 RESEARCH_CANDIDATE_NOT_PRODUCTION | v10.0·v12.2 | 투자위/리스크 | G4 | 2026-08-01 |
| 4 | DEC-003 | APPROVED | Modular Monolith+Vertical Slice; 조기 microservice 금지 | v10.0 | Architect | G0 | 2026-08-01 |
| 5 | DEC-004 | APPROVED | PIT/revision/hash/lineage와 immutable Evidence 우선 | v10.0·v12.2 | Data/Quant | G1 | 2026-08-01 |
| 6 | DEC-005 | APPROVED | 매도 우선순위: impairment→survival→floor→concentration→opportunity→reentry | v12.2 | 투자위/Quant | G2 | 2026-08-01 |
| 7 | DEC-006 | APPROVED | SellRatioOfLot와 portfolio weight/core floor 단위 분리 | v12.0 Delta | Quant/Architect | G2-A | 2026-08-02 |
| 8 | DEC-007 | DECISION_REQUIRED | 생산 OIDC/JWT 공급자와 claims mapping | 자료 미지원 | Security/PM | G5 | 미정 |
| 9 | DEC-008 | DECISION_REQUIRED | PIT 총수익·상폐·컨센서스 공급원/라이선스 | 자료 미지원 | Data Governance/Legal | G1 | 미정 |
| 10 | DEC-009 | DECISION_REQUIRED | 계좌·시장·venue별 Fee/Tax/FX schedule | 자료 미지원 | Ops/Tax/Quant | G1 | 미정 |
| 11 | DEC-010 | DECISION_REQUIRED | SLO/RPO/RTO와 운영 용량 기준 | 자료 미지원 | SRE/PM | G5 | 미정 |
| 12 | DEC-011 | DECISION_REQUIRED | 고객/계좌/상품 규모와 성능 테스트 볼륨 | 자료 미지원 | PM/SRE | G6-A | 미정 |
| 13 | DEC-012 | DECISION_REQUIRED | 한국 최신 PIT 데이터 확보 범위와 재검증 일정 | 자료 미지원 | Quant/Data | G4 | 미정 |
| 14 | DEC-013 | APPROVED | Lot-relative sell ratio uses CurrentLotPortfolioWeight; target security weight subtracts LotWeight×Ratio | v10/v12.1 unit-separation intent and data-consistency correction | Quant/Architect | G2-A | 2026-08-02 |
| 15 | DEC-014 | APPROVED | Ordered policy trace is immutable internal decision evidence; customer view receives curated explanation | Explainability and audit delta | Quant/Compliance/Architect | G2-A/G3 | 2026-08-02 |
| 16 | DEC-015 | APPROVED | v12.2 preserves all six current-session attachments byte-for-byte and treats v12.1 as baseline | Non-regression source control | PM/Architect | G0 | 2026-08-02 |
| 17 | DEC-016 | DECISION_REQUIRED | Select production OpenAPI client generation tool and ownership | Toolchain/network approval required | BE/FE/DevOps | G3 | Before S11 |
| 18 | DEC-017 | DECISION_REQUIRED | Approve .NET/PostgreSQL/pnpm runner image digests | Real build and migration evidence prerequisite | DevOps/Security | G0 | Before coding start |
| 19 | DEC-063 | DECISION_REQUIRED | 자본바닥/생존 매도가 same-direction cooldown을 우회하는가 | v10 우선순위는 명확하나 cooldown 예외는 첨부 근거에 명시되지 않음 | 투자위/리스크/Quant | G2 | Before VS-10 production path |
| 20 | DEC-064 | DECISION_REQUIRED | Hard impairment 80~100%를 어떤 증거등급/심각도로 매핑하는가 | v10 범위는 80~100%; 현재 구현은 보수적으로 100% | 투자위/준법/Quant | G2 | Before policy parameter change |
| 21 | DEC-065 | APPROVED | v12.2 이전 ambiguous weight context는 추정 사용하지 않고 semantics v2로 재구축한다 | PIT·재현성·DECISION_REQUIRED fail-closed 원칙 | Data Architect/Quant/Architect | G2-A | 2026-08-02 |
| 22 | DEC-066 | APPROVED | 정책·이벤트·성과지표 계약은 버전과 hash를 가진 machine-readable artifact로 관리한다 | DOC-NR-05/06, v12.1 TD-021/032 | Architect/Quant/Risk | G2/G3 | 2026-08-02 |
| 23 | DEC-022 | APPROVED | 스케줄러 자동화는 EVALUATION_ONLY/PROPOSAL_ONLY/DRILL_ONLY로 제한 | v10 자동주문 OFF·v12.1 연구후보 경계 | Risk/Architect | ALL | 2026-08-02 |
| 24 | DEC-023 | APPROVED | 모델·정책·임계값 자동 승격/변경/롤백 금지; human maker-checker 필수 | 모델 거버넌스와 독립검증 Gate | InvestmentCommittee/Compliance | G4/G5 | 2026-08-02 |
| 25 | DEC-024 | APPROVED | 15분 Dispatcher + DB schedule/lease + dynamic queue 패턴 | 시장별 job 난립과 DST hard-code 방지 | Architect/SRE | G3 | 2026-08-02 |
| 26 | DEC-025 | APPROVED | 모델 평가 요청 시 승인 Dataset/Model/Config/Code/Contract VersionSet 동결 | 재현성·이력성·PIT 원칙 | Data/Quant | G3 | 2026-08-02 |
| 27 | DEC-026 | APPROVED | 성과지표는 분자/분모/평가창/집계/비용을 버전 계약으로 관리 | 63일 연구 통계와 연간 목표 혼용 방지 | Quant/Risk | G4 | 2026-08-02 |
| 28 | DEC-027 | APPROVED | 일/주/월/분기 평가와 revision-trigger replay를 분리 | 운영 부하와 증거 적시성 균형 | Quant/SRE | G3/G4 | 2026-08-02 |
| 29 | DEC-028 | APPROVED | J21은 개선 제안만 생성하며 코드·모델·설정 파일을 수정하지 않음 | 바이브코딩·홀루시네이션·과최적화 통제 | Architect/Quant | G4 | 2026-08-02 |
| 30 | DEC-029 | APPROVED | J10/J11/J17 일, J18/J24 주, J19/J21/J22 월, J20/J23 분기 기본 cadence | v10 J10/J11 및 유지보수 운영리듬 계승 | Risk/Ops | G3/G5 | 2026-08-02 |
| 31 | DEC-030 | DECISION_REQUIRED | 평가 evidence retention/partition/archive/legal hold 기간 | 첨부 근거에 구체 보존기간 없음 | Compliance/DBA | G5/G6-A | G5 전 |
| 32 | DEC-031 | DECISION_REQUIRED | Data/Feature/Prediction/Calibration drift metric·sample·threshold | 첨부 근거는 drift 필요성만 제시하고 수치 계약 미제공 | Quant/Risk | G4 | J17 구현 전 |
| 33 | DEC-032 | DECISION_REQUIRED | False-exit adverse-regret의 정확한 가격·benchmark·window 정의 | 첨부의 연 2% 목표와 연구 CSV를 직접 동일시할 수 없음 | InvestmentCommittee/Quant | G4 | J10 생산화 전 |
| 34 | DEC-033 | APPROVED | ModelOperations Dispatcher 기본 OFF, ShadowEvaluation과 별도 승인 필요 | v10 안전경계+v12.5 | Architect/Security | G0 | 2026-08-02 |
| 35 | DEC-034 | APPROVED | J10~J30은 평가·제안·훈련만 허용, 모델/주문 자동변경 금지 | v12.4+v12.5 | Risk/Compliance | ALL | 2026-08-02 |
| 36 | DEC-035 | APPROVED | v12.4 원본 ZIP을 immutable baseline으로 보존하고 current attachment를 직접 보존 | 비회귀 | PM/QA | G0 | 2026-08-02 |
| 37 | DEC-036 | DECISION_REQUIRED | 생산 OIDC/JWT provider와 claims/key rotation | 첨부 미결 | Security/PM | G5 | D+10 |
| 38 | DEC-037 | DECISION_REQUIRED | 총수익·상폐·컨센서스 source/license/SLA | 첨부 미결 | Data Governance/Legal | G1 | D+10 |
| 39 | DEC-038 | DECISION_REQUIRED | KRX/NYSE/NASDAQ market calendar source와 운영 owner | v12.4 TD-042 | Data/Ops | G1 | D+10 |
| 40 | DEC-039 | DECISION_REQUIRED | Fee/Tax/FX account/venue/asset schedule | 첨부 미결 | Ops/Tax/Quant | G1 | D+10 |
| 41 | DEC-040 | DECISION_REQUIRED | false-exit/reentry metric denominator/window | metric governance | Risk/Quant | G4 | D+30 |
| 42 | DEC-041 | DECISION_REQUIRED | SLO/RPO/RTO와 volume assumptions | 운영 미결 | SRE/PM | G5 | D+20 |
| 43 | DEC-042 | APPROVED | 288 baseline WBS 보존+48 execution assurance Delta | v12.5 | PM/Architect | G0 | 2026-08-02 |
| 44 | DEC-043 | APPROVED | 직접 runtime evidence 없는 상태를 IMPLEMENTATION_TEMPLATE로 표시 | 신뢰성 | QA/Compliance | ALL | 2026-08-02 |
| 45 | DEC-044 | DECISION_REQUIRED | 투자일임형 검토 개시 시점과 독립승인 체계 | 252일 Shadow 이후 | 운영사/법무/준법 | G6 | Shadow+252 |
| 46 | DEC-045 | APPROVED | Feature는 UI vendor를 직접 import하지 않고 adapter port만 사용 | v10 Ch42 + v13 design | Architect/FE | G0 | 2026-08-02 |
| 47 | DEC-046 | APPROVED | T01~T10을 표준 CRUD/업무화면 타입으로 사용 | v10 Ch41 + v13 delta | UX/FE/QA | MVP-A | 2026-08-02 |
| 48 | DEC-047 | APPROVED | J31~J38은 evidence/proposal only이며 기본 OFF | v10/v12.5 automation boundary | Risk/Ops | ALL | 2026-08-02 |
| 49 | DEC-048 | APPROVED | 모델 개선은 가설→Challenger 계획→독립검증→maker-checker 순서 | model governance | Investment Committee/Risk | G4 | 2026-08-02 |
| 50 | DEC-049 | DECISION_REQUIRED | 승인된 PrimeVue theme와 디자인 토큰 시각 기준 | runtime visual evidence missing | UX/Brand/FE | G0 | D6 |
| 51 | DEC-050 | DECISION_REQUIRED | OpenAPI→TypeScript/Zod 생성 도구와 버전 정책 | tool not selected | BE/FE Architect | G3 | S2 |
| 52 | DEC-051 | DECISION_REQUIRED | Visual regression 승인 브라우저·viewport·허용차 | runtime environment missing | QA/UX | MVP-B | S6 |
| 53 | DEC-052 | DECISION_REQUIRED | 모델 개선가설 보존기간·법무/준법 열람 범위 | retention policy missing | Compliance/Risk | G4 | S10 |
| 54 | DEC-053 | APPROVED | UI Adapter contractVersion 2.0과 10 capability를 표준으로 사용 | v14 Delta | FE Architect | G0 | 2026-08-02 |
| 55 | DEC-054 | APPROVED | PrimeVue+AG Grid는 생산 후보, Native는 교체 검증용 reference만 | 과유불급·교체가능성 | FE/UX | G3 | 2026-08-02 |
| 56 | DEC-055 | APPROVED | Feature의 PrimeVue/AG Grid 직접 import 금지 | DIP·기술부채 통제 | Architect | G0 | 2026-08-02 |
| 57 | DEC-056 | APPROVED | T01~T10 화면 ID와 v2 컴포넌트를 안정 계약으로 관리 | 표준화·재현성 | UX/FE | MVP-B | 2026-08-02 |
| 58 | DEC-057 | APPROVED | 지속 모델 루프는 평가·제안까지만 자동화하고 activation은 수동 change approval | 고객보호·모델리스크 | Risk/Compliance | G4 | 2026-08-02 |
| 59 | DEC-058 | APPROVED | J39 FeedbackCycleIntegrityAudit는 기본 disabled | fail-closed | SRE/Risk | G4 | 2026-08-02 |
| 60 | DEC-059 | APPROVED | Feedback transition·activation decision은 append-only evidence로 보존 | 감사·이력성 | DBA/Compliance | G4 | 2026-08-02 |
| 61 | DEC-060 | APPROVED | 과거 생성 ZIP은 Core에 포함하지 않고 Full 패키지의 원본 첨부에만 포함 | 재귀 ZIP 방지 | PM/DevOps | G0 | 2026-08-02 |
| 62 | DEC-061 | DECISION_REQUIRED | UI 접근성 자동화 도구와 visual regression 저장소 선택 | v14 잔여 위험 | UX/QA | G3 | D10 |
| 63 | DEC-062 | APPROVED | 실행하지 않은 .NET/pnpm/PostgreSQL 검증은 PASS로 표기하지 않음 | 홀루시네이션 통제 | QA/Architect | ALL | 2026-08-02 |
| 64 | DEC-067 | APPROVED | UI Adapter contract 3.0은 14개 정규화 capability를 사용하고 Feature vendor import를 금지 | v10 화면계약+v14 delta | Architect/FE | G0 | 2026-08-02 |
| 65 | DEC-068 | APPROVED | Native provider는 계약 검증용 reference이며 생산 적격으로 간주하지 않음 | 과유불급 | Architect/QA | G0 | 2026-08-02 |
| 66 | DEC-069 | APPROVED | Server state=TanStack Query, form=vee-validate/Zod, URL=vue-router, Pinia는 session/UI preference만 | v12.1 FE 기준 | FE Lead | MVP-A | 2026-08-02 |
| 67 | DEC-070 | APPROVED | CRUD 화면은 Idempotency-Key·If-Match·ProblemDetails·asOf/projection metadata를 표준 계약으로 사용 | v10 화면/API 기준 | BE/FE | G3 | 2026-08-02 |
| 68 | DEC-071 | APPROVED | Schedule 다음 시각은 dispatch 시각이 아니라 scheduledFor anchor에서 계산 | 재현성·drift 방지 | BE/SRE | G3 | 2026-08-02 |
| 69 | DEC-072 | APPROVED | 장애 catch-up 기본은 LATEST_ONLY, 무제한 replay 금지 | 운영 안정성 | SRE/Quant | G3 | 2026-08-02 |
| 70 | DEC-073 | APPROVED | 평가창은 1/5/20/63/126/252 거래세션이며 calendar day 사용 금지 | v10 일평가 | Quant/Data | G4 | 2026-08-02 |
| 71 | DEC-074 | APPROVED | Metric과 Cohort 정의를 version/hash로 동결 | KPI drift 방지 | Risk/Quant | G4 | 2026-08-02 |
| 72 | DEC-075 | APPROVED | J40은 EvaluationWindowIntegrityAudit이며 기본 disabled | 자동화 경계 | Compliance/QA | G4 | 2026-08-02 |
| 73 | DEC-076 | APPROVED | BusinessHold는 기술 실패와 분리하고 blind retry하지 않음 | v10 배치 기준 | Ops/SRE | G3 | 2026-08-02 |
| 74 | DEC-077 | APPROVED | ModelFeedback transition은 시간 단조성과 immutable transition evidence를 보존 | 재현성·감사 | Risk/BE | G4 | 2026-08-02 |
| 75 | DEC-078 | APPROVED | UI provider 교체는 contract/a11y/visual/perf/release evidence 승인 후 수행 | 교체 안정성 | UX/QA | G3 | 2026-08-02 |
| 76 | DEC-079 | DECISION_REQUIRED | 생산 시장 Calendar/Timezone source와 휴장 정정 SLA | Source 미확정 | Data Governance | G1 | D10 |
| 77 | DEC-080 | DECISION_REQUIRED | Metric/Cohort 최초 승인 정의와 최소표본 | 정량 기준 미확정 | Quant/Risk | G4 | S8 |
| 78 | DEC-081 | DECISION_REQUIRED | CRUD 삭제를 soft delete/reversal 중 무엇으로 적용할지 도메인별 결정 | 업무 규칙 미확정 | Product/DBA | MVP-A | S6 |
| 79 | DEC-082 | DECISION_REQUIRED | PrimeVue/AG Grid Community 사용범위·라이선스 승인 | 법무 검토 필요 | Legal/FE | G5 | S10 |
| 80 | DEC-083 | DECISION_REQUIRED | Scheduler enqueue/mark 원자성 구현을 dispatch outbox로 승격할지 | 구현 선택 | Architect/SRE | G3 | S3 |
| 81 | DEC-084 | DECISION_REQUIRED | 성능시험 고객/계좌/상품/Job 볼륨 | 용량 가정 미확정 | PM/SRE | G6-A | S12 |
| 82 | DEC-085 | APPROVED | v16은 v15 기준선을 리셋하지 않고 Delta만 추가 | v10 비회귀 | PM/Architect | ALL | 2026-08-02 |
| 83 | DEC-086 | APPROVED | UI Adapter contract v4와 startup provider 선택 | 교체가능성/안정성 | FE Lead/Architect | G0 | 2026-08-02 |
| 84 | DEC-087 | APPROVED | Vendor prop 전체 래핑 금지, 최소 업무의미 계약 | 과유불급 | FE Lead/UX | G0 | 2026-08-02 |
| 85 | DEC-088 | APPROVED | ExecutionEnvelope의 PIT cutoff와 server VersionSet 강제 | 룩어헤드/홀루시네이션 방지 | BE/Data | G1 | 2026-08-02 |
| 86 | DEC-089 | APPROVED | Scheduler lease fencing token 도입 | 중복/유령 worker 방지 | SRE/BE | G3 | 2026-08-02 |
| 87 | DEC-090 | APPROVED | J41/J42 기본 disabled·EvaluationOnly | 자동변경 금지 | Risk/Compliance | ALL | 2026-08-02 |
| 88 | DEC-091 | APPROVED | J42는 repair plan만 만들고 model/config를 변경하지 않음 | 업무분장 | Risk/Quant | G4 | 2026-08-02 |
| 89 | DEC-092 | APPROVED | Core에는 과거 ZIP 0, Full에는 직전 v15 Core ZIP 1개 | 재귀 ZIP 방지 | Release Manager | G6 | 2026-08-02 |
| 90 | DEC-093 | DECISION_REQUIRED | Lease 획득/갱신 SQL과 DB clock tolerance | runtime 미실증 | SRE/DBA | G3 | S3 |
| 91 | DEC-094 | DECISION_REQUIRED | J41 alert threshold와 자동 abandon 여부 | 운영정책 미확정 | SRE/Compliance | G3 | S8 |
| 92 | DEC-095 | DECISION_REQUIRED | J42 late window SLA와 escalation | 평가 운영정책 | Quant/Ops | G4 | S8 |
| 93 | DEC-096 | DECISION_REQUIRED | Metric/Cohort 승인 Owner와 version cadence | KPI 정의 거버넌스 | Risk/Quant | G4 | S8 |
| 94 | DEC-097 | DECISION_REQUIRED | Projection별 staleAfter/SLO/Rebuild quota | 용량 미확정 | BE/Data/SRE | G3 | S9 |
| 95 | DEC-098 | DECISION_REQUIRED | UI visual regression 기준 해상도/허용차 | QA 기준 미확정 | UX/QA | G3 | S6 |
| 96 | DEC-099 | DECISION_REQUIRED | OIDC provider/claims mapping | 생산 인증 미확정 | Security/PM | G5 | S10 |
| 97 | DEC-100 | DECISION_REQUIRED | 252세션 최신 한국 PIT 데이터 확보 일정 | 검증 공백 | Quant/Data | G4 | S11 |