docs: record advanced module contracts and isolated Linux acceptance

performance/advancedAcceptance.md

@@ -0,0 +1,44 @@
+# 扩展模块验收
+
+代码提交：`208a9c3fbdb7ccf2ed409ba380050842e89829d8`。本报告与随后文档提交没有改变被测运行代码。
+
+2026-09-23 在独立 Linux amd64 验证目录运行，开始 06:51:31 UTC，完成 06:55:56 UTC。工作树在启动时干净。原始 [JSON](advancedLinux.json) 记录 98 个源码/模板/脚本摘要、镜像 ID、命令和容器清理；[TXT](advancedLinux.txt) 保存实际输出。回传本机后已逐个核对源码摘要及日志 SHA-256。
+
+```sh
+python3 scripts/verifyModules.py --advanced \
+  --goproxy https://goproxy.cn,direct \
+  --output performance/advancedLinux.json
+```
+
+## 环境与隔离
+
+- Go 1.25.14，Linux amd64。实际依赖版本以提交内 go.mod/go.sum 为准；新增依赖后已覆盖原有网络适配器回归。
+- Redis 7.4.11，MinIO RELEASE.2025-09-07T16-13-09Z，MySQL 8.4.11。
+- 编译、Redis、MinIO、MySQL 顺序运行，最多一个测试容器；每个硬限制 2 CPU / 2 GiB 内存与内存加 swap / 256 pids。
+- 数据服务阶段 `--network none`，仅容器回环/Unix socket，无发布端口，数据位于本次临时目录/tmpfs。没有连接现有业务数据库。
+- 四个测试容器已清理，原有 7 个业务容器均仍运行。
+
+## 通过范围
+
+| 项目 | 实际证据 |
+| --- | --- |
+| 全仓库检查 | `go test -race -count=1 -timeout=240s ./...`、`go vet ./...`、`go build ./...`；脚手架集成开关已开启，包含独立生成项目 |
+| 认证与配置 | JWT 过期/缺 exp/错误发行者或受众/算法混用/轮换、Session 撤销与状态隔离、文件环境覆盖、非法/静态配置拒绝、子日志级别更新 |
+| 契约与观测 | OpenAPI 路径参数与 DTO、重复注册拒绝、W3C 入站/出站关联、外层访问日志 traceId、HTTP 指标、Redis miss 错误保持、SQL spans |
+| 熔断与通用模块 | 冷却探针、迟到结果、响应体期间槽位、panic 释放、分页溢出与重复参数、审计白名单与写入失败 |
+| 组合示例 | nethttp/native/实验 HTTP2 的真实 TLS 401/403/201、对象内容、非法路径、OpenAPI 和关闭；原有 modules/reference 回归同批通过 |
+| 共享 Redis | 并发 claim 唯一赢家、错误 owner 拒绝、二进制响应回放、两个应用实例仅执行一次、冲突 409、共享限流 429、存储失败 503、过期目标不受批次清理顺序影响 |
+| Redis 队列 | 重报回执、内容冲突、容量拒绝、旧 owner 无法 ACK、保留未确认消息后自动接管、两个 Consumer 竞争、有限重试/永久拒绝、失败消息分页/受控删除、完成身份 TTL |
+| 对象存储 | Local 契约及失败上传保留原对象、拒绝符号链接、签名篡改；OSS SDK 协议 fixture；S3 SDK fixture 和 R2 endpoint/region/签名参数；真实 MinIO 上传/覆盖/读取/删除与错误签名 403 |
+| MySQL 迁移 | 全新测试库 up、重复 up 不重执行、版本读取、SQL 查询/更新观测、失败迁移保留 dirty、后续执行被阻断 |
+
+真实 Redis/MinIO/MySQL 阶段使用 Go 编译的静态测试程序；该阶段没有启用 race。全仓库 race 阶段不连接这些外部数据服务。两类验证各自的范围不混为一项。
+
+## 保留边界
+
+- 本批按用户决定不集成 Orbit，未修改 Orbit 或业务项目，也没有用通用队列模拟其流程编排协议。
+- OSS/R2 没有真实云账号、bucket 权限、临时凭据轮换、地域/公网故障验收；MinIO 通过不能替代这些验证。
+- 队列接管通过真实 Redis 中的未确认 delivery 验证，没有本批 Worker 进程强杀、Redis AOF 重启/复制切换、长期负载或 exactly-once 证明。测试 Redis 关闭持久化以隔离协议检查，生产需另行配置持久化与故障验收。
+- 没有在生产业务上自动执行迁移；没有证明任意 DDL 可事务回滚。MySQL 失败保留 dirty，由部署流程核查。
+- OpenTelemetry 的采集/传播/exporter 接口通过本批测试，未连接实际 OTLP collector 或告警系统。
+- 这是扩展模块的首版功能验收，不是生产规模容量或完整运维验收。