33 lines
2.4 KiB
Markdown
33 lines
2.4 KiB
Markdown
# v0.9.0-preview 迁移扩展验收
|
||
|
||
本轮只使用本机临时服务与生成项目；没有运行业务服务器压测，没有修改 ePay/eTax 业务代码。
|
||
|
||
## 本地验收
|
||
|
||
- `GO_OMNI_SCAFFOLD_INTEGRATION=1 go test -race -p=1 -count=1 -timeout=300s ./...`：40 个有测试的包通过；包含真实生成消费者、标准 Handler/Middleware、动态 JSON、路由限额和 scalar。
|
||
- `go vet ./...`、`go build ./...`、gofmt、`git diff --check` 通过。
|
||
- 独立 `examples/userService` module 的 race/vet/build 通过；生成文件 `--check` 通过，手写业务保持原样。
|
||
- nethttp/native 本机真实 TCP 测试：首块数据立即 Flush、2 MiB 文件保持原响应、已知长度和 chunked 超限返回 413，并能继续处理正常请求。
|
||
- 404 访问日志、提交后错误/panic 不追加 JSON、标准中间件提前写入/跨请求状态/取消/PathValue 通过。
|
||
- multipart 落盘临时文件在成功和 panic 后清理；原始请求体 HMAC 验签、定制绑定和生成代码保护通过。
|
||
- scalar 最大 int64、数字/字符串兼容、溢出/错误类型拒绝、指针 null、query 集合、输入/输出 schema 分离通过；普通字段仍严格。
|
||
- ePay 原始契约只读校验：26 types、43 routes、0 errors、0 auth schemes。后两项是声明数量，不代表无需鉴权或没有业务错误；不代表 144 条注册路由已全部迁移。
|
||
|
||
环境：`go version go1.27.1 darwin/arm64`。记录时间：2026-09-23T17:47:26+00:00。
|
||
|
||
## 远程验收
|
||
|
||
已执行 `scripts/verifyCompatibilityRelease.py --version v0.9.0-preview`，通过。详见 [远程验收记录](compatibilityRemote.json)。
|
||
|
||
- 从全新 module cache 安装发布版 CLI，消费者固定依赖 `v0.9.0-preview`，无本地 replace。
|
||
- 消费者实际生成、race 测试、自定义 ID/动态 JSON、请求体限额、上传清理、原文签名、下载和重生成保护通过。
|
||
- 发布源码：`a8c973d8a2c24f3cc572f32a976349d9a97427a1`。
|
||
- module 校验和：`h1:cYpW6HwZnLHsxq7thO1C2pR/H3vyoUQQhuBVuEHhtHw=`。
|
||
- 耗时 13.51 秒；临时目录和缓存已清理。脚本与 fixture 哈希保存在 JSON 中。
|
||
|
||
验收结果在 main 单独记录，发布标签保持不可变。
|
||
|
||
## 范围
|
||
|
||
本次不是完整 ePay 迁移验收；资金事务、原权限体系、业务响应细节仍需业务自己的回归。未重跑 Linux soak、Nginx/Cloudflare 代理或云存储账号实网验收。
|