# 从零手把手教程交付与验证

日期：2026-10-12。工作区没有Git仓库，本轮不记录虚构提交号。本轮仅新增/更新文档与入口，不修改现有交易、认证、前端、脚本或部署实现。

新增 [从零教程](../03-development/from-zero-tutorial.md)：23章，Windows PowerShell主路线，从工具/空目录/Go与HTTP基础开始，给出可运行教学核心、资金、单写者日志、三库、注册登录、管理员、React与测试；随后逐项升级到当前架构，覆盖增量批投影、预算、契约、分页、实时行情、原键恢复、完整测试、注释规范、Windows、容器/云与备份恢复。README、文档入口、goal与开发记录同步。

## 教学代码实际验证

完整文件从最终Markdown代码块重新提取到 `/tmp/exchange-tutorial-extracted`，不是只编译最初草稿。共14个完整文件（7个Go文件含2个测试文件、7个前端文件）；另提取初期Hello和health里程碑。执行环境：Go 1.26.9 linux/amd64、Node v22.22.3、npm 12.0.2。使用独立module exchangelearn、五项直接依赖与go mod tidy生成间接依赖，不共享用户数据目录；未把生成的data/node_modules提交到项目。

| 检查 | 实际结果 | 证明范围 |
| --- | --- | --- |
| go mod tidy | 通过 | 五项固定依赖可解析 |
| go test -count=1 -v ./... | 通过；TestTradeAndCancel、TestParse、TestFIFOAndSelfTrade、TestHTTPAndRestart | 资金算例/FIFO/自成交、幂等/对象隔离、输入、真实HTTP/三库/Cookie/权限、正常重启视图/会话 |
| go vet ./... | 通过 | 教学Go静态检查 |
| 初次npm install生成锁文件、npm ci | 通过 | 独立前端固定依赖可安装、锁文件可复现 |
| npm run build | 通过 | 教学React/TS类型检查与Vite实际打包 |
| Hello/health运行 | 通过 | 第3章可执行程序与实际health请求；验证器仅替换为随机空闲回环端口，避免占用用户8080 |
| 本地Markdown链接/锚点、围栏、JSON | 通过；30份Markdown、440个本地链接/锚点、100个围栏块 | 本地引用有效、23章锚点有效、完整文件代码块可提取；文中最终Test名称均存在于源码 |

前端安装复核中先使用 `npm install --ignore-scripts` 创建锁文件，随后 `npm ci` 重新安装并构建。当前 npm 的 allowScripts 策略阻止 esbuild postinstall，平台二进制依赖仍成功安装且实际构建通过；不声称所有依赖安装脚本均被执行；第一次草稿构建使用仓库依赖，正式复核使用隔离目录独立安装，不依赖源码复制的node_modules。本轮执行环境为Linux/WSL，不称为本轮原生Windows重新执行；Windows最终启动指南关联上一轮原生验证。

原始输出/文件摘要见 [独立证据目录](evidence-from-zero-tutorial/extraction.json)、[Go测试](evidence-from-zero-tutorial/go-test.txt)、[前端安装](evidence-from-zero-tutorial/npm-install.txt)、[构建与安装复核](evidence-from-zero-tutorial/frontend-build.txt)、[里程碑](evidence-from-zero-tutorial/milestone-check.json)、[文档检查](evidence-from-zero-tutorial/document-checks.json)。最终教程提取文件摘要用于复核代码块，不是当前应用发布包摘要。

## 边界与历史证据

教学版只支持LIMIT GTC、全量视图、单条FULL日志，未具备完整fail-fast、dataset/版本、并发关闭和资源治理；教程明确后续替换顺序及最终测试入口。教学数据格式不能直接迁移为最终日志，练习目录与现有项目分开。教学HTTP接口是/api，最终是/api/v1；两套类型与函数不能混着编译。

与上一轮Windows报告的source-SHA256SUMS比对，74个既有源码/配置文件摘要全部一致，结果记录在本轮evidence-from-zero-tutorial/source-unchanged.json；此比较只证明本轮未改应用代码，不替代测试。

本轮未重新执行最终项目全套race/故障/浏览器/性能/容器验证，未改写旧报告、源码摘要、发布包/镜像/容量成绩；未运行云服务器、TLS实机、真实断电或远程CI。教学前端实际完成类型检查/构建，未新增真实浏览器教学界面验证。后半章命令提供可执行步骤和已有源码/测试映射，不自动表示所有环境均已本轮执行。
