# 版本与文档时间线

整理日期：2026-11-02。日期依据开发记录、版本设计及报告正文，不按文件修改时间推断创建时间。同一天仅按记录中的依赖和交付顺序排列，未记录的时分不补写。按内容查阅见[文档目录](../README.md)，原始记录见[报告目录](../reports/README.md)。

## 版本演进

| 日期 | 阶段 / 版本 | 当时新增内容 | 设计与记录 |
| --- | --- | --- | --- |
| 2026-10-09 | 需求、审计与设计 | 确定 Go 单写者撮合、精确金额、日志与投影，形成选型和计划；当时尚无业务实现 | [原项目审计](../03-development/reference-audit.md)、[开发记录](development-plan.md) |
| 2026-10-10 | 首版模拟交易 | 撮合、资金、日志恢复、注册登录、管理员及 React 联调，补面试 Q&A 和中文注释 | [首版报告](../reports/2026-10-10.md)，另含 2026-10-11 注释/容器复核 |
| 2026-10-11 | v0.2 | OpenAPI / TS、订单分页、幂等查询、刷新后恢复原请求、dataset 隔离 | [设计](../07-history/v0.2-design.md)、[报告](../reports/2026-10-11-v0.2.md) |
| 2026-10-11 | v0.3 | 补齐模拟 P1–P7：历史分页、维护 CLI、指标、批投影、恢复及部署工具 | [设计](../07-history/v0.3-design.md)、[报告](../reports/2026-10-11-v0.3.md) |
| 2026-10-11 | 测试完善与更正 | 补测试、修复对象所有权，更正旧 Linux 故障用例未被收集的问题 | [测试完善报告](../reports/2026-10-11-test-hardening.md)，早期故障结论结合此更正 |
| 2026-10-11 | 文档与注释复核 | 对照源码纠正状态，补接口、数据生命周期和排障手册 | [审阅报告](../reports/2026-10-11-documentation.md) |
| 2026-10-11 | Windows 入口 | CMD/PowerShell 原生启动、依赖隔离、本地管理员和 ready 后开浏览器 | [启动报告](../reports/2026-10-11-windows-launcher.md) |
| 2026-10-12 | 从零教程 | 23 章模拟系统教程，在隔离目录验证教学代码 | [教程](../03-development/from-zero-tutorial.md)、[教程验证](../reports/2026-10-12-from-zero-tutorial.md) |
| 2026-10-12 | Web3 路线分析 | 比较链上方案，收敛为 Go 后端为主、少量原子结算合约 | [可行性](../02-architecture/onchain-feasibility.md)、[路线](../02-architecture/backend-web3-roadmap.md)、[开发记录](development-plan.md)，路线页后续有更新 |
| 2026-10-12 | v0.4 | 独立钱包签单、链下撮合/链上结算、Redis/PG/Kafka 和恢复验证 | [设计](../07-history/v0.4-design.md)、[报告](../reports/2026-10-12-v0.4.md)，Kafka 属当时环境 |
| 2026-10-12 | 业务架构分析 → v0.5 | 先评估差距，再实现阶段 A：完整历史、任务 CAS、确认索引、对账和观测 | [演进设计](../02-architecture/production-architecture.md)、[v0.5 设计](../07-history/v0.5-design.md)、[报告](../reports/2026-10-12-v0.5.md) |
| 2026-11-02 | 发售架构审阅 | 复核链交易，设计独立库存/资格/凭证；当次尚未开发发售，记录 Windows 失败 | [审阅报告](../reports/2026-11-02-architecture-review.md) |
| 2026-11-02 | v0.6 实现与验收 | 发售服务/合约、SQL 库存、RabbitMQ、索引回收、前端及 Windows 入口，回归先前问题 | [发售实现](../02-architecture/flash-sale-design.md)、[实现报告](../reports/2026-11-02-sale-v0.6.md)、[手动验收](../04-testing/sale-acceptance.md) |
| 2026-11-02 | 中文注释完善 | 详细注释与脚本排版，核对有效代码一致，单独记录相关回归 | [阅读指南](../03-development/code-reading-guide.md)、[注释报告](../reports/2026-11-02-chinese-comments.md) |
| 2026-11-02 | 文档整理 | 按主题重编目录，按日期编排报告及开发记录，明确当前说明与历史范围 | [主题目录](../README.md)、[报告目录](../reports/README.md)、[开发记录](development-plan.md)，本次仅文档整理 |

## 同日记录的阅读关系

2026-11-02 后续文档工作：新增[Web3 小白 10 章讲解](../01-beginner/README.md)，将原主题文档移入分类文件夹；旧路径对应关系见[迁移表](document-migration.md)。此为教学与文档路径调整，未新增业务测试成绩。

2026-10-11：v0.2 → v0.3 → 测试完善与故障收集更正 → 文档/注释审阅 → Windows 入口。首版报告中跨日复核仍在原报告，不能仅依据文件名判断全部执行日期。

2026-10-12：教程与路线分析 → v0.4 链交易 → 真实业务架构评估 → v0.5 阶段 A。具体过程见开发记录，阶段报告没有覆盖的分析不补造独立验证报告。

2026-11-02：架构审阅 → v0.6 授权实现与验收 → 中文注释完善 → 本次文档整理。审阅报告中的“没有发售”“Windows 失败”是当时状态，后续变化见实现报告，原失败证据继续保留。

## 当前阅读口径

模拟 v0.3 是保留的独立业务模式；v0.5 是既有链协议与历史/索引能力背景；v0.6 增加发售并统一 RabbitMQ。当前运行和手动验收优先看 v0.6 手册。

公共链、云实机、生产高可用、独立安全审计与长时容量仍按[当前进度](current-progress.md)的边界理解。历史性能、Kafka 集成和此前产物只属于各自报告的环境，不转换为新版本成绩。
