docs: add first-release delivery checklist

README.md

@@ -76,6 +76,8 @@ make integration
 make protocol-check
 ```
 
+首版发布前按[交付核对清单](docs/release-checklist.md)逐项留存命令输出和目标环境证据；当前阶段回归不替代生产拓扑、容量、复制切换或 RPO/RTO 验收。
+
 `make integration` 要求 Docker、OpenSSL 等标准命令，启动独立的临时 MySQL 容器，使用随机凭据和回环随机端口；完成后删除该测试容器。不会连接已有业务数据库。可通过 `GO`、`DOCKER` 和 `ORBIT_TEST_MYSQL_IMAGE` 指定工具/测试镜像。
 
 受理层负载采样工具见 [有界受理负载工具](docs/api/load.md)，只允许在隔离命名空间或一次性数据库中运行；它不自动重试、不启动 Worker，也不提供生产容量承诺。

docs/08-development-plan.md

@@ -31,7 +31,7 @@
 | P4 Weave 主流程 | SDK 定义构建与发布校验、实例、顺序/分支/结构化并行汇合、信号/定时等待、版本绑定 | 重启接续、早到/重复信号、并行竞争、内部事件重放、发布版本兼容；端到端通用流程 | 已完成平台功能阶段验收：[原功能及W01–W17逐项核对](reports/phase-4-5.md)、[版本/暂停/全停回归](reports/phase-4-5-races.md)、[提交故障边界](reports/phase-6-fault-boundaries.md)。研发发布、固定版本、顺序/分支/有限并行、信号/时间等待、公共API/SDK及可运行示例均已交付；生产拓扑与发布兼容继续P6/P7 |
 | P5 Weave 恢复与查询 | 有界查询、暂停继续、取消、人工核查恢复、控制门控与审计 | 轮次与尝试独立预算；暂停/开始/回执/超时竞争；恢复保留预算；未知结果不盲目重复 | 已完成平台功能阶段验收：[原功能核对](reports/phase-4-5.md)。有界查询、独立预算、暂停继续/取消、六类恢复、历史/筛选/事件/来源与SDK场景均已交付；真实竞争、COMMIT断线及进程全停保留原身份、截止和预算。运维、容量与首版发布继续P6/P7 |
 | P6 生产验证与运维 | 完整监控、凭据轮换、备份恢复、滚动升级、运行手册、可复现负载和故障工具 | 对照生产验收清单执行，报告环境/指标/遗留项；容量、RPO/RTO 按真实拓扑验证 | 进行中；已补[精确故障边界](reports/phase-6-fault-boundaries.md)和[进程观测](reports/phase-6-observability.md)；继续业务积压/阶段延迟、凭据轮换及其余生产门槛 |
-| P7 首版交付核对 | SDK 兼容与发布准备、完整 API 手册、场景示例、全量回归及交付清单 | 新接入者按文档跑通全部示例；所有首版能力可追溯到实现与测试；报告实际生产边界 | 进行中；已补[通用文件转换示例](reports/phase-7-file-conversion.md)、[SDK独立发布门禁](reports/phase-7-sdk-release.md)和[当前协议兼容矩阵](reports/phase-7-compatibility.md)，仍需带标签的跨版本矩阵、全量资源充足回归和交付清单 |
+| P7 首版交付核对 | SDK 兼容与发布准备、完整 API 手册、场景示例、全量回归及交付清单 | 新接入者按文档跑通全部示例；所有首版能力可追溯到实现与测试；报告实际生产边界 | 进行中；已补[通用文件转换示例](reports/phase-7-file-conversion.md)、[SDK独立发布门禁](reports/phase-7-sdk-release.md)、[当前协议兼容矩阵](reports/phase-7-compatibility.md)和[首版交付核对清单](release-checklist.md)，仍需带标签的跨版本矩阵、全量资源充足回归和目标拓扑验收 |
 
 SDK、文档与示例随 P1–P5 同步开发，P7 是全量核对，不是最后才开始补文档。
 

docs/release-checklist.md

@@ -0,0 +1,47 @@
+# Orbit 首版交付核对清单
+
+这份清单把“代码已实现”“当前环境已回归”和“生产拓扑仍待验收”分开记录。勾选一项必须有对应命令输出、测试日志或发布工单，不能只凭设计文档勾选。业务接入方名称、行业规则和真实外部副作用不写入平台发布物。
+
+## 当前版本候选
+
+| 项目 | 证据/命令 | 状态 |
+| --- | --- | --- |
+| 服务端与 SDK 代码来自同一提交 | `git rev-parse HEAD`；发布时记录不可变提交 | 待发布候选冻结 |
+| Go 工具链 | Go 1.27.1；当前资源受限环境已用 Docker Go 1.25 临时 modfile 验证 | Go 1.27.1全量待资源充足环境 |
+| 服务端单元、竞态、vet、build | `make test && make vet && make build` | 待资源充足环境复跑 |
+| 当前协议线一致 | `make protocol-check` | 已通过：HTTP `/v1`、Worker/Event v1、流程 schema 1 |
+| SDK 独立性和发布门禁 | `make sdk-check` | 已通过 Docker Go 1.25；Go 1.27.1待复跑 |
+| 文档与示例 | 本清单、[接口手册](api/README.md)、[SDK手册](sdk/README.md)、[场景示例](examples/README.md) | 文档链接和 JSON 块已检查；端到端全量待复跑 |
+
+## 数据库与安全
+
+| 项目 | 证据/命令 | 状态 |
+| --- | --- | --- |
+| 空库初始化不创建外键 | `TestIntegrationFreshInstallUsesNoForeignKeys`；[无外键基线报告](reports/phase-6-fresh-install.md) | 已通过 MySQL 8.4 |
+| 历史库升级不改写迁移校验和 | `TestIntegrationNoForeignKeysUpgrade`；v7 外键70→0、索引和数据保留 | 已通过 MySQL 8.4 |
+| 发布前结构核验 | `orbit-admin verify` 输出 schema v28、外键0、固定观测索引6 | 已实现，发布前必须执行 |
+| 多租户、凭据轮换、权限撤销、审计脱敏 | [凭据报告](reports/phase-6-credentials.md)、P1–P5集成回归 | 功能回归已通过；密钥托管和生产审计待验收 |
+| 迁移/运行账户隔离 | 目标部署权限清单及演练 | 待目标环境 |
+
+## 正确性、故障与运维
+
+| 项目 | 证据/命令 | 状态 |
+| --- | --- | --- |
+| 幂等、事务、租约、重试、未知结果和流程恢复 | P1–P5阶段报告及真实 MySQL 回归 | 功能阶段已通过 |
+| 派发未送达、提交前后断线、最终信号竞争 | [故障边界报告](reports/phase-6-fault-boundaries.md) | 定向场景已通过；完整脚本需资源充足环境复跑 |
+| 备份恢复 | `scripts/test-backup-restore.sh`、[恢复报告](reports/phase-6-backup-restore.md) | 隔离演练已通过；生产介质待验收 |
+| MySQL 短暂不可用恢复 | `scripts/test-db-recovery.sh`、[恢复报告](reports/phase-6-db-recovery.md) | 单节点同卷演练已通过；主从/跨故障域待验收 |
+| 运行观测和只读快照 | `/metrics`、`orbit-admin observe snapshot`、[观测手册](api/observability.md) | 固定基数和有界单节点快照已实现 |
+| 告警、值守、回滚/前向修复 | 目标监控、值班和发布工单 | 待目标环境 |
+
+## 容量与生产高可用
+
+| 项目 | 必须提供的证据 | 状态 |
+| --- | --- | --- |
+| 受理、派发、流程推进和恢复吞吐 | 固定硬件、数据量、任务/流程混合模型，p50/p95/p99和资源曲线 | 仅有隔离小样本受理工具，生产容量未验收 |
+| 100万+企业规模推导 | 租户、队列、连接、事件、索引和保存周期的容量模型 | 未验收，不能由租户数直接推导 |
+| MySQL 复制、切换、RPO/RTO | 目标拓扑上的实际切换、复制确认、恢复点和恢复时间 | 未验收 |
+| 慢消费者、重连风暴、磁盘和锁等待 | 受控故障负载及积压清空证据 | 未验收 |
+| 跨版本 SDK/服务端 | 至少一个正式旧标签与候选版本的双向矩阵 | 当前仓库无正式标签，未验收 |
+
+发布候选只有在所有“待目标环境/未验收”项得到对应环境证据后，才能进入生产审批。当前代码和阶段回归不等同于生产高可用、容量、RPO/RTO或百万企业承诺。