# 旧实现清理方案（已作废，禁止执行）

> `next/`已被用户否决。禁止依据本方案删除原系统任何代码、容器或数据。权威冻结决定见
> `../../../docs/migration/next失败冻结记录.md`。

本文只定义正式切换后的清理边界，不授权当前阶段删除旧代码、旧容器或旧数据。
清理目标是让仓库最终只保留 `next/` 新系统及不可替代的产品和研究资产，不保留两套运行时。

## 执行前置条件

以下条件必须全部成立：

1. NAS 已使用固定镜像标签在临时端口完成构建、迁移、重启和恢复演练。
2. 新系统已完成真实账号、权限、行情、竞价、盘后选股、LLM、问天和私有复盘抽验。
3. 正式流量切换后至少完整经历一个交易日，包括盘前、竞价、盘中、收盘刷新和盘后任务。
4. 观察期内没有触发登录、私有数据错绑、行情不可读、持续 5xx 或后台任务连续失败等回退条件。
5. 旧镜像、旧容器配置、旧数据库、固定加密密钥和私有 Skill 已形成一致性归档，并完成独立恢复。
6. 用户明确批准旧实现清理。NAS 切换确认不自动等于删除确认。

## 永久保留

| 资产 | 位置 | 原因 |
|---|---|---|
| 新系统 | `next/` | 唯一正式运行时 |
| 完整产品规格 | `docs/product/` | 从零重建的产品真相源 |
| 迁移章程 | `docs/migration/` | 架构约束和历史决策依据 |
| 蒸馏研究素材 | `游资skills/` | Skill 的研究来源，不进入正式运行时 |
| Git 历史和最终旧版标签 | `.git/` | 精确回档和审计依据 |
| 仓库忽略规则 | `.gitignore` | 保护数据库、密钥、日志和生成物不被提交 |

公开运行 Skill 的唯一副本位于 `next/config/mentor-skills/`。`游资skills/`只作为研究档案，
不得在新系统运行时读取。管理员私有 Skill 只保存在 NAS 持久化数据目录和加密备份中。

## 切换后删除的旧运行时

以下路径在删除确认后进入同一个独立提交，不分批留下半套旧系统：

- 旧后端与依赖：`backend/`、`vendor/`、根目录全部旧业务 `*.py`。
- 旧前端：`static/`、根目录 `package.json`、`package-lock.json`、`playwright.config.js`。
- 旧配置与测试：`config/`、`tests/`、`tools/`。
- 旧部署入口：根目录 `Dockerfile`、`compose.yaml`、`.dockerignore`、`.env.example`、`requirements.txt`。
- 已被新文档取代的旧说明：根目录 `README.md`、`ARCHITECTURE.md`、`DOCKER_DEPLOY.md`、
  `REDESIGN_PLAN.md`、`STAGE19_ACCEPTANCE.md`、`THIRD_PARTY_NOTICES.md` 和 `docs/governance/`。
- 已在 `next/config/heaven/` 中存在权威副本的 `data/iching_zh.json`。

根目录旧业务 Python 文件包括：

```text
advanced_strategies.py  alert_service.py       api_access.py
app_config.py           assistant_agent.py     chart_data_provider.py
database.py             demo_data.py           heaven_agent.py
heaven_engine.py        ifind_client.py         llm_strategy.py
llm_stream.py           market_insights.py      mentor_agent.py
realtime_aggregator.py  screener.py             security.py
sentiment_engine.py     server.py               strategy_tracking.py
sync_data.py            trade_journal.py        tushare_client.py
```

## 数据与密钥处理

旧 `data/review.db`、旧 `.env`、数据库 WAL/SHM 文件和旧容器数据卷从来不进入 `git rm`。
它们按以下顺序处理：

1. 停止旧系统写入并通过 SQLite 在线备份取得一致数据库。
2. 将数据库、旧环境文件、旧镜像标签和容器配置写入加密归档并校验 SHA-256。
3. 在独立目录恢复归档，验证旧镜像能够启动并读取账号和私有记录。
4. 在约定回退保留期内只停止旧容器，不删除旧容器、镜像或数据卷。
5. 回退保留期结束且用户再次确认后，才从 NAS 工作目录移除旧明文副本；加密归档继续保留。

## 一次性迁移代码

`next/tools/legacy_migration.py` 和 `next/tests/test_legacy_migration.py` 只服务旧库切换，
不是长期运行时能力。旧系统回退保留期结束、最终迁移报告归档且旧明文数据库移除后，
二者应在单独提交中删除；`next/docs/evidence/stage-14/real-migration-report.json`继续保留。
备份、恢复和正式数据库 migration 工具仍属于新系统维护能力，不删除。

## 清理提交验收

清理必须在新分支或新提交中一次完成，并满足：

1. 给清理前提交打不可变标签，记录旧版和新版镜像标签及数据库校验和。
2. `next/` 不得导入或读取任何已删除路径；允许的外部引用只限产品规格和迁移章程文档。
3. 从全新 Git 检出执行 Ruff、pytest、Vue 类型检查、Vitest、生产构建和 Playwright 全量回归。
4. 从全新 Git 检出在 NAS 构建镜像，证明构建上下文不依赖工作区残留文件。
5. 新容器使用恢复后的数据卷启动，重启后账号、私有记录和后台任务状态不丢失。
6. `git status`为空，仓库中不存在第二个 `server.py`、第二套前端 Shell、第二套 CSS 令牌、
   第二个数据网关或第二个 LLM 网关。

任一验收失败时，回退整个清理提交，不在残缺状态下逐文件补救。
