kjh2064/KArtSell.Aegis
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

refactor: Reorganize docs folder structure for clarity and version management (PR 3c)
ci / backend (push) Failing after 1s
Details
ci / static (push) Failing after 6s
Details
ci / frontend (push) Failing after 5s
Details

Browse Source 
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>
This commit is contained in:
김재현
2026-08-02 05:49:29 +09:00
parent 5e50ec6991
commit 5dfb8f3e12
205 changed files with 135 additions and 10178 deletions
Download Patch File Download Diff File Expand all files Collapse all files
docs/LEGACY/v11/04_TECH_DEBT_REGISTER_V11_1.csv
+19
View File
@@ -0,0 +1,19 @@
DebtId,Title,RiskClass,Priority,Impact,Owner,Secondary,DueSprint,Remediation,ExitTest,Decision
TD-H-001,Raw data/환경 lock 부재,Data/Model,P0,재현 불가,Quant Lead,Data Lead,S0,manifest+checksum+lock+image digest,clean-room replay hash,Fix
TD-H-002,Scalar position이 Core/Tactical lot 혼합,Model,P0,보호선·재진입 왜곡,BE Lead,Quant Lead,S3,Lot/Cycle/Protection/Reentry model,property+golden,Fix
TD-H-003,KR 기업행사 추정 소급조정,Data,P0,가격·ATR·수익 왜곡,Data Lead,DBA,S2,공식 CA master+quarantine,CA reconciliation,Fix
TD-H-004,총수익/PIT/상폐/세금/FX 불완전,Data/Model,P0,생산 판단 불가,Data Lead,Risk,S2,canonical PIT sources,DQ/replay,Fix
TD-H-005,비용 전역상수/라벨 불일치,Model,P0,성과 왜곡,Quant Lead,QA,S2,FeeSchedule PIT contract,cost scenario diff,Fix
TD-H-006,Internal research endpoint AllowAnonymous,Security,P0,무권한 정책 실행,Security,BE Lead,S0,auth policy+access test,anonymous 0,Fix
TD-H-007,FE pnpm-lock 누락,Engineering,P0,CI 비결정/현재 CI 실패,FE Lead,DevOps,S0,lockfile commit,frozen install,Fix
TD-H-008,Handler/Validator/DB/Outbox 없는 endpoint,Architecture,P1,Vertical Slice 미완성,BE Lead,Architect,S4,full slice packet,integration/trace,Fix
TD-H-009,Survival/집중/기회비용 정책 미구현,Model,P1,정책 우선순위 불완전,Quant Lead,BE Lead,S4,ALG-PORT/SELL-004/005,golden/property,Fix
TD-H-010,sell_fraction 단위 모호,Contract,P1,core floor 계산 오류 위험,Quant Lead,Architect,S4,ratio/quantity/target weight 분리,contract tests,Fix
TD-H-011,Reentry multi-stage 상태 전이 불완전,Model,P1,단계 재진입/새 cycle 오류,BE Lead,Quant Lead,S5,explicit transition table,calendar/stage tests,Fix
TD-H-012,SignalDecision immutable trigger 누락,Data/Audit,P1,감사·재현 훼손,DBA,BE Lead,S4,DB trigger+privilege,update/delete test,Fix
TD-H-013,Architecture test가 문자열 1종만 검사,Quality,P1,경계 회귀 탐지 불가,Architect,QA,S0,AF-01~20,CI gate,Fix
TD-H-014,FE DTO 수동 중복/Idempotency retry key 변경,Frontend,P1,계약 drift/중복 명령,FE Lead,BE Lead,S7,generated/versioned contract+stable key,Vitest/E2E,Fix
TD-H-015,Outbox publisher/Inbox consumer/dead-letter 미구현,Reliability,P1,이벤트 미전달/중복,BE Lead,SRE,S4,dispatcher/inbox/replay,fault tests,Fix
TD-H-016,Read Model rebuild/staleness 미구현,Operations,P2,복구·오래된 화면,Data Lead,SRE,S6,projection registry/rebuild,DR rebuild,Fix
TD-H-017,Swagger 상시 노출,Security,P2,공격표면 증가,Security,BE Lead,S0,environment/role gate,security test,Fix
TD-H-018,No dependency vulnerability/license evidence,SupplyChain,P2,공급망 위험,DevOps,Security,S0,audit/SBOM/license report,release evidence,Fix
1 DebtId Title RiskClass Priority Impact Owner Secondary DueSprint Remediation ExitTest Decision
2 TD-H-001 Raw data/환경 lock 부재 Data/Model P0 재현 불가 Quant Lead Data Lead S0 manifest+checksum+lock+image digest clean-room replay hash Fix
3 TD-H-002 Scalar position이 Core/Tactical lot 혼합 Model P0 보호선·재진입 왜곡 BE Lead Quant Lead S3 Lot/Cycle/Protection/Reentry model property+golden Fix
4 TD-H-003 KR 기업행사 추정 소급조정 Data P0 가격·ATR·수익 왜곡 Data Lead DBA S2 공식 CA master+quarantine CA reconciliation Fix
5 TD-H-004 총수익/PIT/상폐/세금/FX 불완전 Data/Model P0 생산 판단 불가 Data Lead Risk S2 canonical PIT sources DQ/replay Fix
6 TD-H-005 비용 전역상수/라벨 불일치 Model P0 성과 왜곡 Quant Lead QA S2 FeeSchedule PIT contract cost scenario diff Fix
7 TD-H-006 Internal research endpoint AllowAnonymous Security P0 무권한 정책 실행 Security BE Lead S0 auth policy+access test anonymous 0 Fix
8 TD-H-007 FE pnpm-lock 누락 Engineering P0 CI 비결정/현재 CI 실패 FE Lead DevOps S0 lockfile commit frozen install Fix
9 TD-H-008 Handler/Validator/DB/Outbox 없는 endpoint Architecture P1 Vertical Slice 미완성 BE Lead Architect S4 full slice packet integration/trace Fix
10 TD-H-009 Survival/집중/기회비용 정책 미구현 Model P1 정책 우선순위 불완전 Quant Lead BE Lead S4 ALG-PORT/SELL-004/005 golden/property Fix
11 TD-H-010 sell_fraction 단위 모호 Contract P1 core floor 계산 오류 위험 Quant Lead Architect S4 ratio/quantity/target weight 분리 contract tests Fix
12 TD-H-011 Reentry multi-stage 상태 전이 불완전 Model P1 단계 재진입/새 cycle 오류 BE Lead Quant Lead S5 explicit transition table calendar/stage tests Fix
13 TD-H-012 SignalDecision immutable trigger 누락 Data/Audit P1 감사·재현 훼손 DBA BE Lead S4 DB trigger+privilege update/delete test Fix
14 TD-H-013 Architecture test가 문자열 1종만 검사 Quality P1 경계 회귀 탐지 불가 Architect QA S0 AF-01~20 CI gate Fix
15 TD-H-014 FE DTO 수동 중복/Idempotency retry key 변경 Frontend P1 계약 drift/중복 명령 FE Lead BE Lead S7 generated/versioned contract+stable key Vitest/E2E Fix
16 TD-H-015 Outbox publisher/Inbox consumer/dead-letter 미구현 Reliability P1 이벤트 미전달/중복 BE Lead SRE S4 dispatcher/inbox/replay fault tests Fix
17 TD-H-016 Read Model rebuild/staleness 미구현 Operations P2 복구·오래된 화면 Data Lead SRE S6 projection registry/rebuild DR rebuild Fix
18 TD-H-017 Swagger 상시 노출 Security P2 공격표면 증가 Security BE Lead S0 environment/role gate security test Fix
19 TD-H-018 No dependency vulnerability/license evidence SupplyChain P2 공급망 위험 DevOps Security S0 audit/SBOM/license report release evidence Fix