From 0a2f0eb4a1b2de45a6e1bd59a60ec9040f7a405f Mon Sep 17 00:00:00 2001 From: kjh2064 Date: Thu, 30 Jul 2026 12:36:20 +0900 Subject: [PATCH] fix: un-archive two docs that CI/release-gate validators depend on docs/ROADMAP_WBS.md and docs/ROADMAP_ENTERPRISE_TEMPLATES_WBS.md were archived in an earlier commit today as "superseded planning docs," but that judgment only checked CLAUDE.md/README/other docs for references - not the actual validator scripts, spec YAMLs, and unit tests that drive the release gate. Both paths turn out to be load-bearing: - docs/ROADMAP_WBS.md is read directly by tools/validate_quant_engine_wbs_v1.py, tools/validate_platform_transition_wbs_v1.py, tests/unit/test_validate_quant_engine_wbs_v1.py, and referenced by spec/60_quant_engine_wbs.yaml and others. - docs/ROADMAP_ENTERPRISE_TEMPLATES_WBS.md is read by tools/validate_enterprise_crud_specification_v1.py, which runs as the "Enterprise Contract Parity Test" step in .gitea/workflows/ci-frontend.yml. Moved both back to their original path, replaced the stale "ARCHIVED" banner with a note explaining why they can't be archived without first updating the validators, and fixed the 4 doc cross-references that had been repointed at docs/archive/. Verified all three affected validators now exit 0 by actually running them locally. The other 9 docs archived earlier today (5 CI/CD docs + CICD_ROADMAP.md, EXECUTION_PLAN_PHASE0_CLOSEOUT_AND_PHASE1_KICKOFF.md, MODERNIZATION_ROADMAP_VISUAL.md, MODERNIZATION_STRATEGY_ROADMAP_2026-2027.md) were checked against the same grep sweep (*.py/*.yaml/*.yml/*.js/*.ts/*.cs/*.json, whole repo) and have zero references outside markdown - those archivals stand. Co-Authored-By: Claude Sonnet 5 --- docs/CLOUD_SERVER_SETUP.md | 2 +- docs/GATHERTRADINGDATA_XLSX_OPERATING_RUNBOOK.md | 2 +- .../{archive => }/ROADMAP_ENTERPRISE_TEMPLATES_WBS.md | 11 ++++++++--- docs/{archive => }/ROADMAP_WBS.md | 11 +++++++---- docs/WBS_10_DOTNET_MIGRATION_HARDENING_2026_06_30.md | 2 +- ..._9_6_LLM_RADAR_OPTIMIZATION_STRATEGY_2026_06_22.md | 2 +- 6 files changed, 19 insertions(+), 11 deletions(-) rename docs/{archive => }/ROADMAP_ENTERPRISE_TEMPLATES_WBS.md (91%) rename docs/{archive => }/ROADMAP_WBS.md (99%) diff --git a/docs/CLOUD_SERVER_SETUP.md b/docs/CLOUD_SERVER_SETUP.md index 15fd7eeb..9ce4bf7b 100644 --- a/docs/CLOUD_SERVER_SETUP.md +++ b/docs/CLOUD_SERVER_SETUP.md @@ -47,7 +47,7 @@ |---|---| | [`AGENTS.md`](../AGENTS.md) | 운영 헌법, Directory Routing 인덱스 | | [`GITEA_SECRETS_SETUP.md`](GITEA_SECRETS_SETUP.md) | Gitea 시크릿 설정/검증 가이드 | -| [`ROADMAP_WBS.md`](archive/ROADMAP_WBS.md) | `.gs → Python` 및 `xlsx → sqlite` WBS (2026-07-30 archive됨, 최신 상태는 CLAUDE.md Migration Status 참고) | +| [`ROADMAP_WBS.md`](ROADMAP_WBS.md) | `.gs → Python` 및 `xlsx → sqlite` WBS | | [`docs/GITEA_TOKEN_HOME_RUNBOOK.md`](GITEA_TOKEN_HOME_RUNBOOK.md) | Gitea 토큰 관리 런북 | | [`spec/00_execution_contract.yaml`](../spec/00_execution_contract.yaml) | 실행 계약 원본 권위 | | [`governance/agents_index.yaml`](../governance/agents_index.yaml) | 거버넌스 규칙 인덱스 | diff --git a/docs/GATHERTRADINGDATA_XLSX_OPERATING_RUNBOOK.md b/docs/GATHERTRADINGDATA_XLSX_OPERATING_RUNBOOK.md index 369305d4..f320131f 100644 --- a/docs/GATHERTRADINGDATA_XLSX_OPERATING_RUNBOOK.md +++ b/docs/GATHERTRADINGDATA_XLSX_OPERATING_RUNBOOK.md @@ -41,7 +41,7 @@ 1. `GatherTradingData.json`이 있으면 그 파일을 우선 사용한다. 2. JSON이 없고 workbook 변환이 필요하면 `tools/convert_xlsx_to_json.py`를 별도 seed-prep 단계에서 실행한다. -3. `docs/archive/ROADMAP_WBS.md`(2026-07-30 archive됨)의 WBS-8.2를 따른다. +3. `docs/ROADMAP_WBS.md`의 WBS-8.2를 따른다. 4. `tools/validate_platform_transition_wbs_v1.py`와 `tools/validate_snapshot_admin_web_v1.py`를 확인한다. 5. KIS 토큰은 `src/quant_engine/kis_api_client_v1.py`가 SQLite 캐시로 관리하므로, 수집 재실행 시에도 토큰을 매번 새로 발급하지 않는다. 6. 토큰 상태는 `python tools/inspect_kis_token_cache_v1.py`로 확인한다. diff --git a/docs/archive/ROADMAP_ENTERPRISE_TEMPLATES_WBS.md b/docs/ROADMAP_ENTERPRISE_TEMPLATES_WBS.md similarity index 91% rename from docs/archive/ROADMAP_ENTERPRISE_TEMPLATES_WBS.md rename to docs/ROADMAP_ENTERPRISE_TEMPLATES_WBS.md index 845cf9d9..3905dbeb 100644 --- a/docs/archive/ROADMAP_ENTERPRISE_TEMPLATES_WBS.md +++ b/docs/ROADMAP_ENTERPRISE_TEMPLATES_WBS.md @@ -1,6 +1,11 @@ -> **ARCHIVED (2026-07-30)**: OMS·WMS·ERP WBS의 마크다운 버전입니다. -> 권위있는 버전은 [`../../spec/60_oms_wms_erp_wbs.yaml`](../../spec/60_oms_wms_erp_wbs.yaml) (YAML 형식) 또는 -> [`OMS_WMS_ERP_PLAYBOOK.md`](OMS_WMS_ERP_PLAYBOOK.md)를 참고하세요. +> **정정 (2026-07-30)**: 이 문서는 잠시 `docs/archive/`로 옮겨졌다가 같은 날 다시 원래 위치로 +> 복구되었다. `tools/validate_enterprise_crud_specification_v1.py:29`가 이 경로 +> (`docs/ROADMAP_ENTERPRISE_TEMPLATES_WBS.md`)를 직접 참조하고, 이 검증은 +> `.gitea/workflows/ci-frontend.yml`의 "Enterprise Contract Parity Test" 단계에서 실제로 +> 실행된다 — 즉 이 파일을 옮기면 CI가 깨진다. 내용상 권위는 +> [`../spec/60_oms_wms_erp_wbs.yaml`](../spec/60_oms_wms_erp_wbs.yaml) 또는 +> [`OMS_WMS_ERP_PLAYBOOK.md`](OMS_WMS_ERP_PLAYBOOK.md)에 있을 수 있지만, 파일 자체는 +> 검증기가 요구하는 이 경로에 계속 있어야 한다. # OMS·WMS·ERP 입력 컴포넌트 & 공통 CRUD 템플릿 & 상용화 제안 마스터 WBS (WBS-MASTER-2026) diff --git a/docs/archive/ROADMAP_WBS.md b/docs/ROADMAP_WBS.md similarity index 99% rename from docs/archive/ROADMAP_WBS.md rename to docs/ROADMAP_WBS.md index 2b3ab9d0..c6d4bc41 100644 --- a/docs/archive/ROADMAP_WBS.md +++ b/docs/ROADMAP_WBS.md @@ -1,7 +1,10 @@ -> **ARCHIVED (2026-07-30)**: 본 문서는 QuantEngine 전체 로드맵의 이전 버전(v8.9 기준, 2026-06-13)입니다. -> 현재의 마이그레이션 상태는 [`../CLAUDE.md`](../CLAUDE.md)의 Migration Status 섹션과 -> [`STRATEGIC_EXECUTION_MASTER_PLAN.md`](../STRATEGIC_EXECUTION_MASTER_PLAN.md) (Phase 0-3 상세) 또는 -> 개별 집중 WBS 문서들(`WBS_10_DOTNET_MIGRATION_HARDENING_2026_06_30.md` 등)을 참고하세요. +> **정정 (2026-07-30)**: 이 문서는 잠시 `docs/archive/`로 옮겨졌다가 같은 날 다시 원래 위치로 +> 복구되었다. 내용 자체는 2026-06-13 기준으로 오래됐지만(최신 마이그레이션 상태는 +> [`../CLAUDE.md`](../CLAUDE.md) Migration Status 참고), `tools/validate_quant_engine_wbs_v1.py`, +> `tools/validate_platform_transition_wbs_v1.py`, `tests/unit/test_validate_quant_engine_wbs_v1.py`, +> `spec/60_quant_engine_wbs.yaml` 등 release gate 검증 스크립트/스펙이 이 경로(`docs/ROADMAP_WBS.md`)의 +> 존재와 특정 내용을 실제로 검사하므로, "오래됐다"는 이유만으로 archive하면 검증 파이프라인이 깨진다. +> 문서 정리가 필요하면 이 파일을 지우거나 옮기지 말고, 먼저 위 검증 스크립트들을 갱신해야 한다. # 퀀트투자 엔진 — 전체 로드맵 & WBS & 하네스 성공 기준 diff --git a/docs/WBS_10_DOTNET_MIGRATION_HARDENING_2026_06_30.md b/docs/WBS_10_DOTNET_MIGRATION_HARDENING_2026_06_30.md index 218abea3..de0e6ca3 100644 --- a/docs/WBS_10_DOTNET_MIGRATION_HARDENING_2026_06_30.md +++ b/docs/WBS_10_DOTNET_MIGRATION_HARDENING_2026_06_30.md @@ -1,6 +1,6 @@ # WBS-10 보강: .NET Core 마이그레이션 완성 & 상용화 로드맵 (2026-06-30) -> 본 문서는 [docs/archive/ROADMAP_WBS.md](./archive/ROADMAP_WBS.md) (2026-07-30 archive됨) 의 **WBS-10(.NET 엔진 고도화)** 을 현 시점 실측 기준으로 재진단하고, 마이그레이션 완성과 단일 사용자 상용 운영에 필요한 잔여 작업을 재정의한다. +> 본 문서는 [docs/ROADMAP_WBS.md](./ROADMAP_WBS.md) 의 **WBS-10(.NET 엔진 고도화)** 을 현 시점 실측 기준으로 재진단하고, 마이그레이션 완성과 단일 사용자 상용 운영에 필요한 잔여 작업을 재정의한다. > > **작성 배경:** 기존 WBS-10 의 다수 항목이 `완료` 로 표기되어 있으나, 2026-06-30 소스 실측 결과 **표기와 실제 상태 간 괴리**가 확인되었다. 본 문서는 그 괴리를 정리하고 실제 잔여 작업을 추적한다. > diff --git a/docs/WBS_9_6_LLM_RADAR_OPTIMIZATION_STRATEGY_2026_06_22.md b/docs/WBS_9_6_LLM_RADAR_OPTIMIZATION_STRATEGY_2026_06_22.md index 728ea41b..cb9d77bc 100644 --- a/docs/WBS_9_6_LLM_RADAR_OPTIMIZATION_STRATEGY_2026_06_22.md +++ b/docs/WBS_9_6_LLM_RADAR_OPTIMIZATION_STRATEGY_2026_06_22.md @@ -49,7 +49,7 @@ - 배경 설명 문서 - 의사결정 근거 - 최신화 필요 -- 예: docs/archive/ROADMAP_WBS.md (2026-07-30 archive됨) +- 예: docs/ROADMAP_WBS.md **Deprecated (신뢰도 0%)** - 폐기된 알고리즘