03-development-plan.md 9.0 KB

开发周期与工作包安排

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

CR-001 已获用户确认:W2/W4 不再为敏感日志脱敏和未知提交暂停保留专属结构;W4 改为验证单次调用一次点击、普通失败交回 Booker、后续调用完整重试。

1. 周期怎么理解

按一名熟悉项目的工程师、已有本地依赖可用估算,净工程投入约 6.5–9 个工作日,包含测试迁移、回归及文档记录,不只是改插件的时间。自动化与代码复用可以缩短实际耗时;不要求等满估算天数才进入下一项。

真实预约验收取决于账号、OTP、网站状态和实际档期,等待窗口单独记录,不承诺日历日期。下表是原始净投入估算,不是从今天重新计算的交付承诺,也不是完成证明;当前 W0 已建基线、W1 已离线回归,W2/W3/W4 仅部分收敛。W5 的旧文档账号池命令已迁移并通过离线回归,但约 1000 行预算及 W5 其余条件仍未完成;实际进度、返工和剩余估算以 执行记录 为准。

2. 工作包与交付物

工作包 估算 主要工作与代码位置 前置条件 验证/交付
W0 行为与消费者基线 0.5 天 盘点 plugins/ita_plugin.py、相关 tools/、test/;核对用户已有改动 用户确认文档及实施范围 现有行为测试结果、配置消费者表、私有符号迁移表;T-11/T-12、H-11
W1 公共能力接入 0.5–1 天 替换手写初始化/日期筛选/清理;主要改 Italy,公共模块只补必要缺口 W0 基线明确 UT-01/02/03;公共消费者回归;H-01/H-02
W2 登录与会话准备收敛 1 天 使用 BaseFlow,合并表单/验证等待/OTP准备与会话状态 W1 验证通过 UT-04/05/06;错误/重复调用测试;H-06
W3 Query/日历共用 1–1.5 天 共用读取/解析,逐月最早日期;保留 Book 可调用的内部读取步骤 W2、H-03/H-05 有证据 UT-07/08/09、IT-01;扫描与准备次数;可选 H-04 对照
W4 Book 与最终核验收敛 1–1.5 天 申请人库存重查、日期/时段选择、单次调用一次点击、最小成功判定和普通失败 W3 共用日历稳定 UT-10/11/12/13、IT-02/03;H-07
W5 工具、热更新和全量回归 1–1.5 天 迁移旧私有调用、支持命令、单文件加载;公共改动回归 W1–W4 完成 UT-14/15、IT-04/05/06;行数及净变化报告
W6 现场与发布验收 1–1.5 天净投入 先 Query,再 Book 预提交,再有授权的真实预约;更新执行记录 离线通过;用户现场条件/授权具备 LT-01/02/03;逐项 RC 验收、发布/回退说明

W6 的实际等待时间不包含在净投入内。任何任务发现新协议或外部依赖问题,先更新 H 编号、估算和影响,不以“再补几行”无限扩展。

2.1 阶段执行对照表

各阶段都以 01 技术方案为约束、02 的假设为待验证问题、04 为测试依据、05 为最终准出标准,并把结果写入 06。下表是执行索引,不另造一套流程或重复生成报告;“阶段完成”只说明本阶段证据齐备,不表示关联 RC 已通过全部离线和现场验收。

阶段 必须核对的技术/假设 必须留下的阶段完成证据 关联准出
W0 T-01/T-11/T-12;H-08/H-11 带版本的行数、旧行为测试结果、配置和工具消费者清单;已有失败与本次回归分开记录 RC-01/07/10
W1 T-02/T-08;H-01/H-02 UT-01/02/03、IT-06;实际复用函数、删除的重复实现、公共消费者兼容结果及净行数变化 RC-02/08
W2 T-05/T-07/T-08;H-01/H-06 UT-04/05/06;登录、延迟表单、自动 OTP、重复调用与账号/会话隔离的离线证据 RC-04/06/07
W3 T-03/T-05/T-08;H-03/H-05/H-08 UT-07/08/09、IT-01;首次正向月停止、最早日期、范围耗尽、无最终请求及剩余行数预算 RC-01/03/07
W4 T-04/T-09;H-03/H-07 UT-10/11/12/13、IT-02/03;申请人重查、选择一致性、单次调用一次点击、普通失败和下一次独立重试的离线证据 RC-04/05
W5 T-01/T-02/T-11/T-12;H-08/H-09/H-10/H-11 UT-14/15、IT-04/05/06 及完整相关回归;约 1000 行和净变化、两套领区配置、单文件热更新、可执行的现行命令 RC-01/02/07/08/10
W6 T-03/T-04/T-07/T-09;所有尚需现场验证的假设 LT-01/02/03;同一待发布版本的真实查询、预提交和受控预约回执,逐项填写最终 RC 记录 RC-03/04/05/06/09/10

H-04 仅在获授权验证并通过后,才允许更换相应的读取通道;没有通过则沿用浏览器路径,不阻止其他工作。开始、执行、结束均使用同一组编号;如果本阶段还有必需证据缺失,标记“部分完成”并列缺口,不自动放宽后续条件。

3. 实施顺序

W0 基线 → W1 公共能力 → W2 登录/准备 → W3 Query → W4 Book → W5 集成 → W6 现场
  • 不一口气删掉 5000 行后才测试。
  • 每个工作包保持独立可审查的差异;Git 提交是否执行取决于用户授权。
  • 不依赖后一步的测试可以提前编写,但不能用提前写好的测试代替当前结果。
  • H-04 的 HTTP 对照是可选支线,失败不阻塞浏览器方案的其他工作。
  • W3 和 W5 必须重新核对总行数预算,提前暴露超支,不能直到发布前才发现仍有数千行。

当前优先顺序:R1–R5 已完成,Italy 为 2598 行。R3 已用现有 Booker 的普通失败/后续信号重试替换跨调用 fence、未知暂停和复杂 reconciliation;R2 已合并 Query/Book 的月份与候选表示;R4 已把表单/OTP/Turnstile 约二十字段快照收为五个布尔事实;R5 已将持久 profile、锁和诊断观察状态归位 Italy 工具,并保持公共模块及 VFS/TLS/BLS 零改动。下一结构包重新审计日历捕获、选择及表单脚本的重复表示。不能把消费者修复、夹具或整理导入当作整体完成;W3/W4/W5 的局部产物不代表现场最终提交验收通过。

结构性减量按 生产代码精简盘点 的 R1→R3→R2→R4→R5 执行;五包当前均已完成。由于 2598 行仍未满足 RC-01,后续结构包继续使用本文件的记录、测试和准出规则,不修改其他插件换取 Italy 行数。

本次周期复核:R3 为 3532 → 2883、净减 649 行;R2 为 2883 → 2823、净减 60 行;R4 为 2823 → 2752、净减 71 行;R5 为 2752 → 2598、净减 154 行。当前 Italy 384 项、调试 280 项、框架离线 75 项、配置/账号 27 项通过。生产 checkpoint/restore、预约列表/详情读取、跨调用 fence、未知暂停、提示日期优先双扫描、重复月份结果类、二十字段表单快照、生产阶段枚举、持久 profile/锁和诊断观察字段已删除;明确响应判定及底层网站事实仍保留。当前仍需净减约 1598 行;下一包必须以真实剩余结构重新盘点,不重复开发已经统一的协议、选择、OTP 或宿主重试能力,也不自行放宽总预算。

4. 每个工作包开始前的检查

  1. 引用本包对应 T/H/UT/IT/LT/RC 编号。
  2. 读取将修改的函数及现成参照,列出“复用、保留、删除、合并”清单。
  3. 记录涉及文件、是否影响 VFS/TLS/BLS、配置兼容及热更新依赖。
  4. 记录本包前后的预计行数;确认没有新增 Italy 私有运行时模块。
  5. 确认本次授权范围,不能把开发权限当成真实预约或部署权限。

5. 每个工作包结束时的检查

按 执行记录模板 填写:

  • 实际修改、引用的现成能力和删除的重复结构。
  • 运行过的精确命令、代码版本/工作区指纹、退出码、测试数量及失败明细。
  • 原有业务断言迁移到哪里;哪些仅绑定旧内部结构的测试被替换及原因。
  • Italy 完整行数、新增公共代码行数、全仓生产代码净变化。
  • 未解决问题、相关假设状态和下一步;没有证据的项目仍为待验证。

6. 用户需要配合的环节

离线重构不需要用户反复操作。W6 才集中配合:确认测试账号和领区、确认邮箱授权可用、完成网站要求的人工验证,并在真实提交前确认本轮允许预约的用户与日期范围。

已明确授权的真实提交运行无需额外输入完整确认句;但开发脚本不能默认提交,也不能把过去另一轮授权用于新增账户或范围。

7. 进度更新规则

进度用“已完成工作包+当前可验证产物+剩余阻碍”表达,不用已删行数代替完成度。

如果公共模块扩展、HTTP 假设或回执核验导致返工,更新文档和剩余估算。不得为了赶周期改成手动 OTP、单账号 Query/Book、香港硬编码或不核验真实预约的缩水版本。