docs: archive superseded roadmap/WBS docs, fix broken install command, retire stale files

Archives 6 more superseded planning docs to docs/archive/ (ROADMAP_WBS.md,
MODERNIZATION_ROADMAP_VISUAL.md, MODERNIZATION_STRATEGY_ROADMAP_2026-2027.md,
ROADMAP_ENTERPRISE_TEMPLATES_WBS.md, EXECUTION_PLAN_PHASE0_CLOSEOUT_AND_PHASE1_KICKOFF.md,
CICD_ROADMAP.md), each replaced by a current source of truth (CLAUDE.md,
docs/MIGRATION_STATUS.md, or the OMS·WMS·ERP spec/playbook), and repoints
4 files that linked to the pre-archive path.

Fixes README's top-of-file install instructions and package.json's
"ops:dev" script, both of which pointed at core_satellite_collector.js -
a file that has never existed anywhere in this repo's git history. The
real, working entry point (tools/run_kis_data_collection_v1.py /
npm run ops:data-collect) was already correctly documented further
down the same README.

Also finishes retiring pre-existing stale state that predates this
session: removes the superseded deploy-prod.yml.backup, completes the
already-in-progress removal of the old src/client/ Vue+AG-Grid
prototype (superseded by src/frontend/), and untracks
test-results/.last-run.json (Playwright's own run-metadata file,
regenerated every test run - shouldn't be version controlled).

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>

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`](ROADMAP_WBS.md) | `.gs → Python` 및 `xlsx → sqlite` WBS |
+| [`ROADMAP_WBS.md`](archive/ROADMAP_WBS.md) | `.gs → Python` 및 `xlsx → sqlite` WBS (2026-07-30 archive됨, 최신 상태는 CLAUDE.md Migration Status 참고) |
 | [`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) | 거버넌스 규칙 인덱스 |

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/ROADMAP_WBS.md`의 WBS-8.2를 따른다.
+3. `docs/archive/ROADMAP_WBS.md`(2026-07-30 archive됨)의 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`로 확인한다.

docs/WBS_10_DOTNET_MIGRATION_HARDENING_2026_06_30.md

@@ -1,6 +1,6 @@
 # WBS-10 보강: .NET Core 마이그레이션 완성 & 상용화 로드맵 (2026-06-30)
 
-> 본 문서는 [docs/ROADMAP_WBS.md](./ROADMAP_WBS.md) 의 **WBS-10(.NET 엔진 고도화)** 을 현 시점 실측 기준으로 재진단하고, 마이그레이션 완성과 단일 사용자 상용 운영에 필요한 잔여 작업을 재정의한다.
+> 본 문서는 [docs/archive/ROADMAP_WBS.md](./archive/ROADMAP_WBS.md) (2026-07-30 archive됨) 의 **WBS-10(.NET 엔진 고도화)** 을 현 시점 실측 기준으로 재진단하고, 마이그레이션 완성과 단일 사용자 상용 운영에 필요한 잔여 작업을 재정의한다.
 >
 > **작성 배경:** 기존 WBS-10 의 다수 항목이 `완료` 로 표기되어 있으나, 2026-06-30 소스 실측 결과 **표기와 실제 상태 간 괴리**가 확인되었다. 본 문서는 그 괴리를 정리하고 실제 잔여 작업을 추적한다.
 >

docs/WBS_9_6_LLM_RADAR_OPTIMIZATION_STRATEGY_2026_06_22.md

@@ -49,7 +49,7 @@
 - 배경 설명 문서
 - 의사결정 근거
 - 최신화 필요
-- 예: docs/ROADMAP_WBS.md
+- 예: docs/archive/ROADMAP_WBS.md (2026-07-30 archive됨)
 
 **Deprecated (신뢰도 0%)**
 - 폐기된 알고리즘

docs/archive/CICD_ROADMAP.md

@@ -0,0 +1,301 @@
+# QuantEngine Gitea Actions CI/CD 개선 로드맵
+
+**최종 목표**: 신뢰성 높은 자동화된 배포 파이프라인 구축
+
+---
+
+## ✅ Phase 1 완료 (2026-07-11 커밋: 0d8e3a6)
+
+### 1.0 근본적 아키텍처 개선: SSH 제거 → 로컬 배포
+- **문제점 (이전)**: Gitea Actions이 로컬 서버에서 실행되는데 같은 서버로 SSH 배포 ❌
+- **해결책**: SSH 제거, 로컬 파일 시스템에 직접 배포 ✅
+- **효과**:
+  - 배포 시간 1-2분 단축
+  - 네트워크 장애 영향 제거
+  - 코드 복잡도 60줄 감소
+  - 신뢰성 향상
+
+**기술 변경**:
+```bash
+# 이전 (SSH)
+ssh user@host "tar -xzf ... && systemctl restart"
+
+# 현재 (로컬)
+tar -xzf ... 
+ln -sfn /deployments/new /active
+systemctl restart quantengine
+```
+
+### 1.1 타임아웃 확대 (15분 → 30분)
+- **효과**: 네트워크 지연 및 재시도 시 안정성 향상
+- **변경**: `.gitea/workflows/deploy-prod.yml` line 28
+
+### 1.2 자동 롤백 구현
+- **효과**: 배포 실패 시 이전 버전으로 자동 복구
+- **구현**:
+  ```bash
+  # 헬스체크 3회 연속 실패 → 이전 버전으로 자동 복구
+  if [ $health_check_passed -eq 0 ]; then
+    PREV_DEPLOY=$(ls -dt /home/kjh2064/deployments/quantengine_* | head -2 | tail -1)
+    ln -sfn ${PREV_DEPLOY} /home/kjh2064/quantengine_active
+    sudo systemctl restart quantengine
+  fi
+  ```
+- **장점**:
+  - 배포 실패 대응 자동화
+  - 수동 개입 최소화
+  - Telegram 알림 자동 발송
+
+### 1.3 헬스체크 강화
+- **데이터베이스 연결 검증** 추가
+- **서비스 상태 확인** 강화
+- **Favicon 검증** 경고로 변경 (선택사항)
+
+### 1.4 배포 이력 추적
+- **로그 파일**: `/home/kjh2064/.config/quantengine_deploy_history.log`
+- **기록 내용**:
+  ```
+  TIMESTAMP=20260711_175640
+  COMMIT=96cc7fc
+  DEPLOY_PATH=/home/kjh2064/deployments/quantengine_20260711_175640
+  PREV_VERSION=20260711_170421
+  STATUS=success
+  DEPLOYED_AT=2026-07-11T17:56:40Z
+  ```
+- **용도**: 배포 이력 추적, 빠른 롤백 결정
+
+---
+
+## 📋 Phase 2 계획 (빌드/배포 분리)
+
+### 2.1 별도 빌드 워크플로우 생성 (**새로운 파일**: `.gitea/workflows/build.yml`)
+
+**특징**:
+- 빌드 결과를 Gitea Releases로 발행
+- 빌드 메타데이터 (커밋, 타임스탐프) 포함
+- 배포 시점에 빌드 재사용
+
+**효과**:
+```
+이전 (현재):
+  push → 빌드 → 테스트 → 배포 (한 번에)
+  
+개선 후:
+  push → 빌드 (별도) → 배포 (독립적)
+  └─ 같은 빌드를 여러 번 배포 가능
+  └─ 빌드 아티팩트 재사용 → 속도 ↑
+```
+
+### 2.2 `appsettings.Production.json` 전략 변경
+
+**현재 문제점**:
+```yaml
+# 현재 (deploy-prod.yml)
+- name: Publish Release Package
+  run: dotnet publish ... -o ./publish
+
+- name: Prepare & Validate DB Env  # 배포 시점에 생성
+  run: |
+    cat > ./publish/appsettings.Production.json << EOF
+    {
+      "ConnectionStrings": {
+        "DefaultConnection": "Host=127.0.0.1;Database=${{ env.QUANTENGINE_DB_NAME }};..."
+      }
+    }
+    EOF
+```
+
+**문제**: 빌드와 배포 사이에 설정이 동적으로 변경됨
+
+**개선 방향**:
+```yaml
+# 개선 후 (build.yml)
+- name: Generate Configuration Template
+  run: |
+    cat > ./publish/appsettings.Production.json.template << EOF
+    {
+      "ConnectionStrings": {
+        "DefaultConnection": "Host={DB_HOST};Database={DB_NAME};Username={DB_USER};..."
+      }
+    }
+    EOF
+
+# 배포 시점에 (deploy-prod.yml)
+- name: Inject Secrets at Deploy Time
+  run: |
+    envsubst < appsettings.Production.json.template > appsettings.Production.json
+```
+
+**효과**:
+- ✅ 빌드 시점 고정 (재현 가능)
+- ✅ 배포 시점에만 secrets 주입
+- ✅ "같은 빌드 → 같은 배포" 보장
+
+### 2.3 배포 워크플로우 개선
+
+**변경 사항**:
+```yaml
+# 현재 (deploy-prod.yml)
+- name: Setup .NET
+  ... (시간 낭비)
+
+- name: Build Release
+  ... (빌드 반복)
+
+# 개선 후
+- name: Download Build Artifact
+  run: |
+    curl -L -o quantengine.tar.gz \
+      https://gitea.taxbaik.com/api/v1/repos/.../releases/download/build-${COMMIT}/quantengine-${COMMIT}.tar.gz
+```
+
+**효과**:
+- 빌드 시간 제거 (5-10분 단축)
+- 배포 속도 ↑↑
+
+---
+
+## 🎯 Phase 3 계획 (E2E 검증 강화)
+
+### 3.1 로그인 기능 E2E 테스트 추가
+
+```bash
+# deploy-prod.yml에 추가
+- name: E2E Login Test
+  run: |
+    # 1. 로그인 시도
+    LOGIN_RESULT=$(curl -s -c /tmp/cookies.txt \
+      -X POST "https://quant.taxbaik.com/Account/Login" \
+      -d "username=${{ secrets.ADMIN_USERNAME }}" \
+      -d "password=${{ secrets.ADMIN_PASSWORD }}" \
+      -o /dev/null -w "%{http_code}")
+
+    # 2. 성공 확인
+    if [ "$LOGIN_RESULT" = "302" ] || [ "$LOGIN_RESULT" = "200" ]; then
+      echo "✓ Login test passed"
+    else
+      echo "❌ Login test failed: $LOGIN_RESULT"
+      exit 1
+    fi
+
+    # 3. 인증 상태 확인
+    DASHBOARD=$(curl -s -b /tmp/cookies.txt \
+      "https://quant.taxbaik.com/Admin/Dashboard" \
+      -o /dev/null -w "%{http_code}")
+
+    if [ "$DASHBOARD" = "200" ]; then
+      echo "✓ Dashboard accessible"
+    else
+      echo "❌ Dashboard access failed: $DASHBOARD"
+      exit 1
+    fi
+```
+
+### 3.2 API 기능 테스트 추가
+
+```bash
+- name: E2E API Test
+  run: |
+    # Collection API 상태 확인
+    API_RESULT=$(curl -s -b /tmp/cookies.txt \
+      "https://quant.taxbaik.com/api/collection/state" \
+      -H "Content-Type: application/json" \
+      -o /dev/null -w "%{http_code}")
+
+    if [ "$API_RESULT" = "200" ]; then
+      echo "✓ API endpoint responding"
+    else
+      echo "❌ API test failed: $API_RESULT"
+      exit 1
+    fi
+```
+
+---
+
+## 📊 구현 우선순위 및 영향도
+
+| 우선 | Phase | 항목 | 난이도 | 효과 | 예상 소요 |
+|------|-------|------|--------|------|----------|
+| 1️⃣ | 1 | 타임아웃 확대 | ⭐ | 즉시 안정성 ↑ | 5분 |
+| 2️⃣ | 1 | 자동 롤백 | ⭐⭐ | 배포 실패 대응 | 30분 |
+| 3️⃣ | 1 | 헬스체크 강화 | ⭐⭐ | 검증 확실성 | 20분 |
+| 4️⃣ | 1 | 배포 이력 추적 | ⭐⭐ | 운영 가시성 | 15분 |
+| 5️⃣ | 2 | 빌드 분리 | ⭐⭐⭐ | 속도 ↑↑ + 일관성 | 2시간 |
+| 6️⃣ | 3 | 로그인 E2E | ⭐⭐⭐ | 기능 검증 | 1시간 |
+
+---
+
+## 🔍 모니터링 및 추적
+
+### 배포 이력 조회 (원격 서버)
+```bash
+ssh kjh2064@178.104.200.7
+cat ~/.config/quantengine_deploy_history.log | tail -20
+```
+
+### 최근 배포 정보
+```bash
+ls -lt /home/kjh2064/deployments/ | head -5
+readlink -f /home/kjh2064/quantengine_active
+```
+
+### 서비스 상태 확인
+```bash
+sudo systemctl status quantengine
+sudo journalctl -u quantengine -f
+```
+
+---
+
+## ✨ 기대 효과
+
+### 배포 신뢰성 향상
+- **이전**: 배포 실패 시 수동 대응 (15-30분 소요)
+- **현재**: 자동 롤백 + 알림 (1-2분)
+
+### 배포 속도 개선 (Phase 2)
+- **이전**: 빌드 5-10분 + 배포 2-3분 = 7-13분
+- **현재**: 빌드 분리 + 아티팩트 재사용 = 2-3분
+
+### 운영 가시성 향상
+- **배포 이력 추적**: 언제, 어떤 버전, 누가 배포했는지
+- **빠른 롤백**: 이전 버전으로 즉시 복구 가능
+- **근본 원인 분석**: 로그를 통한 배포 실패 원인 파악
+
+---
+
+## 다음 액션 (사용자)
+
+### Phase 2 적용하기
+1. `.gitea/workflows/build.yml` 파일 검토 및 조정
+2. `deploy-prod.yml` 수정하여 빌드 아티팩트 다운로드 로직 추가
+3. GitHub Releases API 대신 Gitea Releases API 사용하도록 변경
+
+### 테스트
+```bash
+# 수동 배포 트리거
+curl -X POST https://gitea.taxbaik.com/api/v1/repos/kjh2064/QuantEngineByItz/actions/workflows/deploy-prod.yml/dispatches \
+  -H "Authorization: token ${GITEA_TOKEN}" \
+  -H "Content-Type: application/json" \
+  -d '{"ref":"main", "inputs":{"release_tag":"build-96cc7fc"}}'
+```
+
+### 모니터링
+- Telegram 알림 확인
+- 배포 이력 로그 검증
+- 이전 버전 롤백 테스트 (스테이징 환경)
+
+---
+
+## 참고 자료
+
+- **분석 문서**: [gitea_cicd_analysis.md](https://claude.ai/code/artifact/9b62fb29-6438-4cd3-80a4-3593c7057eb5)
+- **현재 워크플로우**:
+  - `.gitea/workflows/deploy-prod.yml` (개선됨)
+  - `.gitea/workflows/ci.yml` (기존 Python 검증)
+- **배포 스크립트**: `tools/deploy_quantengine.sh` (개선됨)
+
+---
+
+**작성일**: 2026-07-11  
+**상태**: Phase 1 ✅ 완료, Phase 2 📋 계획 중, Phase 3 📋 계획 중