05-release-criteria.md 7.0 KB

准出条件、发布与回退

版本:1.1;日期:2026-09-01;依据:技术方案、测试计划。

CR-001 已调整准出边界:敏感调试日志暂时允许;最终提交失败或结果未确认可作为普通失败由 Booker 后续重试。准出仍要求单次 book() 最多一次点击、申请人/服务/库存正确及成功不误报。

1. 什么叫完成

完成不是“代码少了”“测试全绿”或“看到了 Calendar”。必须同时证明:约 1000 行、公共模块优先、Query/Book 职责清楚、既有框架/配置可接入、单文件热更新成立,以及真实 Book 成功链路经过验收。

当前完成公共复用、Query/Book 入口、共用月份状态、准备上下文、日历操作、协议表示、薄最终提交、表单合同及 R5 生命周期归位的局部精简。生产最终路径不再读取预约列表或维护 Italy 专属未知状态机;它只核对当前申请人/选择、执行一次原生点击,并把明确响应解释为成功或普通失败。本表整体准出尚未通过。完整文件仍为 2598 行,真实网站、邮箱及预约未按本轮实现验收;384/280 项离线回归不能代替剩余条件。H-04 只读对照探针已就绪但现场等价性未通过,生产仍使用原生月份路径。公共模块及 VFS/TLS/BLS 当前零差异,详见 最新记录。

2. 准出清单

编号 条件 必须提供的证据 关联
RC-01 完整 Italy 插件达到约 1000 行预算 当前文件行数、正常排版审查、分区预算与实际对照;超预算须有用户确认的方案变更,否则不能默认通过 T-01、UT-15、H-08
RC-02 真正复用而非搬家 复用符号清单、Italy 专属导入审查、新增公共生产代码及真实消费者、全仓净变化;没有隐藏旧实现或 Italy 私有运行时 T-02/T-10、UT-01/15
RC-03 Query 行为完整 最早日期/首个正向月份/扫描范围/有效会话重复查询测试;最终预约请求为 0;错误不伪装无号 T-03、UT-07/08/09、IT-01、LT-01
RC-04 Book 使用正确用户与库存 独立会话重查、日期范围、运行时 ID 来源、选择一致性;预提交不写入 T-04/T-08、UT-10/11、LT-02
RC-05 提交与普通重试语义正确 成功/拒绝/丢包/超时及连续独立调用测试;单次调用最多一次点击;失败交回 Booker;重试重新准备、重查库存、重选运行时 ID,健康登录可复用 T-09、UT-12/13、IT-02/03
RC-06 自动 OTP 正确且可调试 当前账号/时间窗绑定、前导零/冲突/旧码/超时测试;允许记录 OTP、Token 与敏感表单,不要求本轮完成日志脱敏 T-07/T-10、UT-05/06、LT-01/02
RC-07 多领区与现有配置兼容 两套不同配置离线通过;现有配置消费者迁移清单;无固定香港/邮箱/日期;旧探测不发布假有号 T-05/T-11、UT-14
RC-08 公共模块和交付机制不退化 公共消费者回归、单文件安装/工厂/双版本热更新、多实例、常用命令验证;必要宿主版本注明 T-01/T-02/T-11、IT-04/05/06
RC-09 新版本真实预约成功 LT-03 单次调用恰好一次最终请求、真实成功结果、公共结果/Booker处理;绑定本轮代码版本与授权范围 T-04/T-09、LT-03
RC-10 测试和过程可追溯 W0–W6 执行记录、T/H/测试映射、精确命令/退出码、失败/跳过说明、方案变更记录 T-12、全部工作包

不因接近 1000 行就容许丢失核心行为;也不以“行为复杂”为由默默放弃 1000 行目标。两者冲突时按变更流程说明事实与可选方案。

3. 问题等级

  • P0:错误申请人/服务预约、同一次 book() 内重复点击、无法控制真实业务写入、把失败误报为成功。必须修复,不能例外发布。跨调用普通重试及当前调试期敏感日志是 CR-001 明确接受的风险,不列为本轮 P0。
  • P1:Query/Book 主路径失败、假阳性或假无号、自动 OTP 退化、单文件更新失败、公共消费者被破坏、行数/复用硬要求未满足。必须修复或先由用户明确批准目标变更;不能直接算完成。
  • P2:不影响核心行为的说明、展示或非关键诊断问题。可记录处置安排,但不能借此归类未通过的必需准出项。

准出要求:未解决 P0/P1 为 0,全部适用 RC 条目有当前证据。P2 是否接受由用户决定并记录。

4. 合并、发布与真实成功分开记录

状态 可以说明什么 不能说明什么
离线回归通过 指定版本的模拟行为、接口和加载符合测试 不能说网站上预约成功
真实预提交通过 登录、OTP、查询、选中可在现场跑通,尚未创建预约 不能说 Book 已完成真实验收
受控真实提交通过 指定版本、账户/服务范围内成功创建并核验预约 不能说所有领区或未来网站版本都已实测
发布完成 已获授权的版本交付/部署动作完成 不替代上面的业务证据

若用户选择先合并未完成现场验收的代码,必须标明“未完成真实预约准出”,默认提交关闭;这不是完整目标完成。不能把未验收版本无提示替换到生产提交任务。

5. 发布前核对

  1. 用户已授权本次 Git/上传/部署操作;文档或开发授权本身不够。
  2. 工作区差异精确可审查,用户的配置修改和旧文档删除没有被恢复、覆盖或误带入提交。
  3. 插件版本递增,发布文件和实测文件的哈希一致。
  4. 若使用新公共 API,记录最低宿主提交,先升级宿主后更新插件;未升级的节点不能仅上传 Italy 文件。
  5. 不在真实预约提交进行中热更新;使用现有停止、清理、加载、启动机制。
  6. 保留上一可运行版本的获取方式以及当前配置备份策略,不在文档中保存秘密。

6. 回退方案

  • 使用既有发布/安装机制回到已确认的前一版本;不新增 Italy 专属部署系统。
  • 回退前停止相关实例,检查是否存在“可能已提交”的任务。业务状态不随代码回退而撤销。
  • 普通失败任务可由 Booker 后续重试;每次重试必须重新进入服务、准备日历、重查库存和重选运行时 ID,不得恢复旧页面状态后直接重放最终请求。仍健康的申请人登录会话可以复用。
  • 公共模块若发生变化,回退须同时核对其他插件兼容性;不能只回退 Italy 文件而保留不兼容宿主。
  • 不自动取消已创建预约,不清空账号池冷却或删除用户数据。此类操作需单独明确授权。

7. 完成报告最少内容

最终报告必须列出:基线/最终版本、6286→实际行数、公共复用及新增公共代码、配置与工具迁移、测试结果、现场预约证据范围、遗留问题、发布状态。没有执行的事项明确写“未执行”,不使用模糊的“全部完成”。