# 文档路径迁移表

日期：2026-11-02。按用户要求，将原 docs 根目录的 33 份主题文档实际移到分类文件夹，并新增 Web3 小白入门章节。根目录只保留总 README；历史报告和 evidence 继续位于 docs/reports。

返回[项目总览](README.md) · [分类总目录](../README.md) · [Web3 入门](../01-beginner/README.md)

## 原位置与新位置

| 原位置（项目根目录起） | 新位置 |
| --- | --- |
| `docs/current-progress.md` | [00-overview/current-progress.md](../00-overview/current-progress.md) |
| `docs/development-plan.md` | [00-overview/development-plan.md](../00-overview/development-plan.md) |
| `docs/timeline.md` | [00-overview/timeline.md](../00-overview/timeline.md) |
| `docs/architecture.md` | [02-architecture/architecture.md](../02-architecture/architecture.md) |
| `docs/auth-design.md` | [02-architecture/auth-design.md](../02-architecture/auth-design.md) |
| `docs/flash-sale-design.md` | [02-architecture/flash-sale-design.md](../02-architecture/flash-sale-design.md) |
| `docs/production-architecture.md` | [02-architecture/production-architecture.md](../02-architecture/production-architecture.md) |
| `docs/backend-web3-roadmap.md` | [02-architecture/backend-web3-roadmap.md](../02-architecture/backend-web3-roadmap.md) |
| `docs/onchain-feasibility.md` | [02-architecture/onchain-feasibility.md](../02-architecture/onchain-feasibility.md) |
| `docs/engineering-standards.md` | [03-development/engineering-standards.md](../03-development/engineering-standards.md) |
| `docs/code-reading-guide.md` | [03-development/code-reading-guide.md](../03-development/code-reading-guide.md) |
| `docs/from-zero-tutorial.md` | [03-development/from-zero-tutorial.md](../03-development/from-zero-tutorial.md) |
| `docs/api-guide.md` | [03-development/api-guide.md](../03-development/api-guide.md) |
| `docs/web3-development.md` | [03-development/web3-development.md](../03-development/web3-development.md) |
| `docs/reference-audit.md` | [03-development/reference-audit.md](../03-development/reference-audit.md) |
| `docs/technology-selection.md` | [03-development/technology-selection.md](../03-development/technology-selection.md) |
| `docs/sale-acceptance.md` | [04-testing/sale-acceptance.md](../04-testing/sale-acceptance.md) |
| `docs/sale-testing.md` | [04-testing/sale-testing.md](../04-testing/sale-testing.md) |
| `docs/web3-testing.md` | [04-testing/web3-testing.md](../04-testing/web3-testing.md) |
| `docs/testing-guide.md` | [04-testing/testing-guide.md](../04-testing/testing-guide.md) |
| `docs/test-design.md` | [04-testing/test-design.md](../04-testing/test-design.md) |
| `docs/test-cases.md` | [04-testing/test-cases.md](../04-testing/test-cases.md) |
| `docs/windows-local-run.md` | [05-deployment/windows-local-run.md](../05-deployment/windows-local-run.md) |
| `docs/deployment.md` | [05-deployment/deployment.md](../05-deployment/deployment.md) |
| `docs/web3-deployment.md` | [05-deployment/web3-deployment.md](../05-deployment/web3-deployment.md) |
| `docs/data-lifecycle.md` | [05-deployment/data-lifecycle.md](../05-deployment/data-lifecycle.md) |
| `docs/operations-runbook.md` | [05-deployment/operations-runbook.md](../05-deployment/operations-runbook.md) |
| `docs/interview-guide.md` | [06-interview/interview-guide.md](../06-interview/interview-guide.md) |
| `docs/interview-qa.md` | [06-interview/interview-qa.md](../06-interview/interview-qa.md) |
| `docs/v0.2-design.md` | [07-history/v0.2-design.md](../07-history/v0.2-design.md) |
| `docs/v0.3-design.md` | [07-history/v0.3-design.md](../07-history/v0.3-design.md) |
| `docs/v0.4-design.md` | [07-history/v0.4-design.md](../07-history/v0.4-design.md) |
| `docs/v0.5-design.md` | [07-history/v0.5-design.md](../07-history/v0.5-design.md) |

## 迁移时同步了什么

文档相对链接重新按新目录计算，包括指向源码、接口、goal 和报告的链接；根 README、goal 中的路径及手写源码注释同步更新。发布脚本使用新位置并保留所选文件的层级，仍只打包原有的六份链交易资料，不把本次文档整理当成一次发布。

历史报告只修改必要的 Markdown 跳转，事实正文、日期、失败记录与成绩不改。279 份原始证据文件不移动，迁移前后通过摘要比对；自动化脚本继续向原 evidence 位置写入。

没有在旧位置保留第二套正文，避免两份文档分叉。旧聊天中的文件链接或外部书签需按上表更新；归档日志中的旧路径属于历史记录，不批量改写。当前入口统一从分类 README 进入。

## 后续维护规则

新增主题资料放对应文件夹并更新该目录 README；面向初学者的章节放 01-beginner，旧阶段设计放 07-history，实际执行报告按日期放 reports。修改路径同时核对 Markdown 跳转、源码注释、发布和测试脚本。时间线按真实日期记录，不用文件修改时间替代执行日期。

本轮只调整教学说明和文档路径；业务源码只同步注释引用，未改变接口、合约或数据库规则。验证范围是本地链接/目录覆盖、原始证据摘要、历史报告正文、源码引用差异和发布脚本语法/文件复制，不以此声称业务重新验收通过。

## 本轮检查结果

本地文档链接、代码围栏、分类入口覆盖与 33 份文档迁移检查通过；12 份历史报告去除链接目标后与迁移前逐字一致，279 份原始证据摘要一致。现存业务源码的差异仅为文档路径引用。发布脚本 Bash 语法检查和六份所选文档的实际复制检查通过，未执行完整发布。

检查记录：[文档与迁移核对](../../bin/doc-folders-20261102/document-check.json)、[发布文档复制核对](../../bin/doc-folders-20261102/release-docs-check.json)。这些是本轮文档整理证据，不替代原有业务测试报告。
