# 测试计划与需求追溯 版本:1.1;日期:2026-09-01;依据:[技术方案](01-technical-design.md)、[可行性](02-feasibility.md)。 > CR-001 覆盖说明:敏感日志脱敏不再是本轮测试目标;提交失败、超时和未确认结果按普通失败进入 Booker 后续重试。下方历史回归叙述中的“未知暂停/脱敏”只说明当时版本,不作为新实现必须保留的行为。 当前状态:以下为实施与验收要求,不是已执行结果。新版本测试证据填写在 [执行记录](06-execution-records.md)。 2026-09-02 最新执行:用户明确授权删除剩余 20 个导入失败的旧测试模块,覆盖此前逐文件迁移这 20 个模块的要求。删除后当前目录完整发现 **131 项通过,0 errors、0 failures、0 skips**;未迁移的历史场景不因此获得覆盖证明,业务需求和真实预约准出不变。清单见 [旧测试清理记录](records/CR-legacy-test-retirement.md),此前结果见 [第 2 批](records/CR-query-selection-fixes.md) 和 [第 1 批](records/CR-framework-error-fixes.md)。 ## 1. 测试策略 1. 先建立旧实现的业务行为基线,再改代码。 2. 单元测试覆盖协议、表单、会话、查询、选择、提交与回执边界;集成测试调用真正的公开接口和宿主方法。 3. 离线使用合成账号、脱敏网页/响应夹具、模拟浏览器和外部服务;不得因运行测试意外读取真实邮件或创建预约。 4. 真实验收依次执行 Query、Book 预提交、获授权的单次真实提交。 5. 旧版本或前一工作包的历史通过结果不能自动继承;测试数量不是质量指标,但每个业务断言必须有迁移去向。 ## 2. 测试代码组织 - 沿用现有 `test/`、unittest 和 `tools/plugin_tester.py`;Italy 专属测试与测试辅助模块统一放在 `test/ita/` 包内,避免继续散落在通用测试根目录。 - 当前公开合同的精简行为测试位于 `test/ita/test_ita_compact.py`;后续 Italy 新测试继续进入 `test/ita/`,只有被多个插件真实消费的测试辅助能力才考虑放到通用测试目录。 - 不为维持旧测试导入而保留第二份旧运行时,也不在测试中重新实现业务算法。 - 只淘汰依赖旧类名、旧文件分区、初次机械搬迁逐字一致的结构断言;核心行为迁移后原断言的去向记入 W0/W5 表。 - 数据夹具只保留协议相关字段;禁止提交密码、Cookie、Bearer、真实 OTP、邮件授权码和完整个人资料。 ## 3. 单元/适配器测试矩阵 每个编号是一组场景,不能只写一个快乐路径用例就标记整组通过。 | 编号 | 场景与注入条件 | 必须观察到的结果 | 决策 | | --- | --- | --- | --- | | UT-01 | 公共初始化:无代理、直连代理、认证代理、浏览器路径、持久化目录 | 使用公共函数;参数正确;不重复启动浏览器,不另造端口/隧道实现 | T-01/T-02 | | UT-02 | 清理:正常、重复调用、页面退出失败、隧道失败、删除失败、仍占用锁 | 只清理实例拥有的资源,不删除持久化目录;失败不伪装成功,不误释放占用 | T-02/T-08 | | UT-03 | 日期:两端/单端/无偏好、非法日期、起点晚于终点、跨年 | 默认边界明确;升序、包含边界;非法配置明确失败 | T-02/T-04 | | UT-04 | 登录:延迟 DOM、停留登录页、验证页、错误凭据、错误域名、超时 | 到认证 DOM 才成功;凭据至多提交一次;不靠停滞刷新重提;调试日志可包含 Token/敏感表单,不要求专属脱敏器 | T-02/T-08/T-10 | | UT-05 | 表单:控件未加载、选项文字/值不匹配、隐藏字段不同步、未知必填项、验证未就绪 | 就绪前不发 OTP/AVANTI;不能跳过新必填项;超时有界;提交后等待真实日历就绪 | T-05/T-07/T-08 | | UT-06 | OTP:前导零、重复的相同码、冲突码、过期、旧码、错误邮箱、无权限、504、HTML/指令文本 | 保留前导零;冲突/过期拒绝;绑定本次账号和时间;不执行正文;无自动旧码回退/重发;允许日志记录验证码 | T-07/T-10 | | UT-07 | 协议:双重 JSON、空数组、畸形 JSON、HTML 200、缺字段、错误日期/时段、非法/重复 ID | 单一解析边界给出可分类错误;错误不变成无号或成功 | T-03/T-04/T-12 | | UT-08 | 库存:`SlotLiberi=1, SlotRimanenti=0`;`0,-1`;冲突、负值、布尔伪整数 | 已验证正向样本可用;零库存不可用;冲突/未知语义拒绝;不能用 `SlotRimanenti>0` 漏掉最后一位 | T-03/T-04 | | UT-09 | Query:当前月空、后续月正向、月内无序、跨年、范围耗尽、翻月不前进、服务变化、重复 Query | 返回首个正向月份的最早日期;之后不再翻月;有效会话不再 OTP;最终提交数为 0;配置两领区隔离 | T-03/T-05/T-08 | | UT-10 | Book:不同用户、过期/较晚 Query 信号、日期范围、Query 提供的外部时段 ID、同日时段余量不同、售罄、下一候选 | 用申请人自己会话重查;Query 日期只唤醒、不覆盖申请人库存中的更早日期;按方案的日期/时段顺序选择允许范围,不能被余量排序悄悄覆盖;不复用池子运行时 ID;找不到时返回明确无可预约结果 | T-04/T-05/T-08 | | UT-11 | 选中:不可用 CSS、日期 DOM 不一致、时段/ID/余量不同、控件缺失;预提交开关关闭 | 选择不一致时不能提交;预提交模式最终请求数 0,结果不是成功 | T-04/T-09 | | UT-12 | 提交:成功、明确拒绝、超时、断线、响应结构变化、提交后异常、连续两次独立调用 | 每次调用最多一次最终点击;可确认成功才成功;其余为普通失败;后一次调用从新会话/新库存开始,不复用旧运行时 ID | T-09 | | UT-13 | 结果:旧记录、同日他服务、错误日期/时间、数量变化但归属不明、结构冲突 | 当前调用能明确归属才成功;不完整或冲突按普通失败;不要求生产维护复杂历史 reconciliation 或未知暂停状态 | T-04/T-09 | | UT-14 | 配置:至少两套服务/表单/路由;现有模式及旧探测配置;动态邮箱 | 无香港或固定邮箱;旧弱探测不发布成真实有号;不支持配置明确诊断,不静默改含义 | T-05/T-11 | | UT-15 | 源码结构:行数、导入、公开接口、公共消费者、正常排版、测试迁移清单 | 约定预算满足,无额外 Italy 运行时/旧实现加载,不跳过失败业务测试 | T-01/T-02/T-10/T-12 | ## 4. 集成测试矩阵 | 编号 | 验证范围 | 通过条件 | | --- | --- | --- | | IT-01 | 真正 `ItaPlugin.query()` → `VSQueryResult` → 现有 Sentinel 信号序列化 | 正确最早日期、routing key、公共状态;信号不含 Cookie/OTP/运行时 ID;过期和无号语义不变 | | IT-02 | 现有 Booker 调用 `ItaPlugin.book()` → 成功上报 | 使用用户账号;公共 `VSBookResult` 到既有异步上报字段;不新增订单通道 | | IT-03 | `ItaPlugin.book()` 普通失败 → 原 Booker 调度 | 本次调用结束且不在插件内循环提交;后续信号重新进入服务、准备日历、重查库存并再次调用,健康登录可复用;无需 Italy 专属异常分支 | | IT-04 | 原安装器、工厂、热更新函数;多实例、前后两个版本 | 只交付 Italy 单文件即可加载;旧实例停止、新实例用新实现;公共类型身份不丢失;不沿用旧模块缓存 | | IT-05 | 支持的调试命令、PluginTester、Query+Book 本地串联工具 | 调用新公开接口,默认不提交;配置来源明确;无失效私有类型导入;重复运行的本地提交保护不丢失 | | IT-06 | VFS/TLS/BLS 相关共享依赖回归 | 公共函数默认参数/返回/异常不退化;有公共改动则测试原调用者,不操作真实网站 | 集成测试不得把被测 `query()`、`book()`、信号序列化或 Booker 分支替换成总是成功的 Mock。只模拟网络、邮箱、浏览器、Redis/云端等外部边界;共享 Redis 协议与调度行为仍由现有代码执行。 ## 5. 现场测试矩阵 ### LT-01:真实 Query 前提:用户确认的账号池/路由、邮箱读取已授权、网络可用、已明确本次只查询。 步骤:记录版本与脱敏配置来源 → 登录池子账号 → 首次准备 → Query → 同一有效会话再次 Query → 清理。 通过条件: - 正向结果与页面/响应日期一致,扫描到首个正向月份即停止;无号必须说明已覆盖月份。 - 重复 Query 不重复发 OTP/AVANTI;两次调用均没有最终预约请求。 - 不新增预约或等待名单。网站原生日历可能自动读取第一天时段,不能把该读取误认为 Book。 - 留存月份摘要、最早日期、请求次数和退出状态;当前调试阶段允许同时留存 OTP、Token 与敏感表单,后续另行清理。 ### LT-02:真实 Book 预提交及串联 前提:独立的用户账号、OTP 已授权、允许的日期范围、`final_submit_enabled=false`。 步骤:使用现有本地 Sentinel/Booker 串联入口或 PluginTester 对应场景 → 接收真实 Query 信号 → 用户会话重查 → 选中时段 → 读取预约基线/结束状态。 通过条件: - 信号确实由 Query 发布并由 Booker 消费;不是手工构造信号替代现场串联。 - 用户会话自动 OTP,选中日期/时段与当前库存、配置范围一致。 - 最终请求为 0,`VSBookResult.success=false`,预约/等待名单不增加。 - 账号隔离和清理通过;敏感日志脱敏不作为本轮阻塞项。 ### LT-03:受控单次真实预约 前提:W5 离线通过、LT-01/LT-02 通过;用户明确本轮允许创建真实预约,申请人/服务/日期范围已确认,当前确有符合范围的号。 步骤:记录授权范围与版本 → 核对已有预约/等待名单 → 使用现有提交开关进行一次自动 Book → 读取真实回执和宿主结果 → 清理。 通过条件:本次 `book()` 最终业务请求恰好一次;出现可归属本轮申请人、服务、日期/时段的新成功结果;公共成功结果被原 Booker 正确处理。 如果已尝试提交但结果不明:本次 `book()` 立即结束并返回普通失败,不在同一次调用内重新点击。后续由现有 Booker 按普通调度重试完整流程;该重复预约风险是 CR-001 已确认的取舍。取消预约仍属于额外业务操作,必须另行授权。 没有合适档期或无法确认回执时,LT-03 为未完成;离线模拟成功不能填成真实成功。 ## 6. 命令与执行记录 以下是现有入口,执行前必须核对测试副作用和实际依赖;各工作包实际结果保存在 [执行记录](06-execution-records.md)。命令列在这里不表示整套测试已经通过。 ```bash git diff --check wc -l plugins/ita_plugin.py PYTHONDONTWRITEBYTECODE=1 .venv/bin/python -B -m unittest discover -s test/ita -t . -p 'test*.py' ``` 新增/迁移后必须检查上述 discovery 是否覆盖全部相关用例,不能只跑一个方便通过的文件。若某命令依赖旧结构,先迁移入口,不将其故障默默排除。 2026-09-01 目录整理说明:36 个既有 Italy 测试/辅助文件原样迁入 `test/ita/`,另增加包入口;当前公开薄合同 69 项通过。完整 discovery 同时收集到若干仍依赖已删除历史工具或已移除私有生产符号的旧测试,当前如实失败,后续必须按 W5 迁移到现行公开合同,不能恢复旧运行时壳或把这些文件静默排除。 同日后续清理:本地持久 Query Profile 能力随其最后两个已删除工具一起退休;对应 1 个薄合同用例和 4 个旧插件内部用例移除,`test_debug_ita_query.py`、`test_debug_ita_session.py` 两个纯工具测试文件删除。当前薄合同为 68 项;其他混有现行业务断言的旧文件不能因导入失败直接整批删除。 当前 R4 回归为 Italy 385 项、调试 280 项、框架离线入口 75 项、配置/加账号 27 项通过,全部 0 skip;R4 定向 279 项通过。覆盖两套表单配置、错误来源/path/action/method/enctype、上传字段、错误标签和值、隐藏字段不同步、同行人数、未知 required、重复 OTP/AVANTI/Turnstile、原生 change 离页、两阶段 OTP、一次发送/读取/写入、邮箱和时间窗绑定、Turnstile 三次共享预算及 AVANTI 目标。生产旧阶段枚举、日志门禁和恢复状态类已不存在;调试工具保留自己的阶段名称,仅用于输出诊断。所有外部边界均为模拟,没有访问真实网站、邮箱、账号池、订单或预约;H-06 只有离线证据,RC-06/09 尚未获得当前现场证据。 R4 首轮迁移曾出现一个测试夹具重复关键字错误;修正夹具后通过。进一步删除旧日志门禁时,OTP 输入异常一度直接传播为 `RuntimeError`;实现恢复为 `CalendarGateError` 并保留用户允许的原始诊断信息后通过。没有通过放松表单合同、删除业务场景或恢复旧生产类型解决失败。 以下是 CR-001 前的历史迁移证据,不代表当前仍保留未知暂停、持久 fence 或生产预约列表:Italy 535 项、调试 330 项、框架离线入口 74 项、配置/加账号 27 项曾通过;单文件热加载及当时回执测试包含在完整 Italy 套件内。协议/OTP/配置/日历定向 107 项在协议表示收敛前后通过;首轮暴露 capability 缺失值错误码漂移,修正实现后恢复既有 `string_required` 合同,未修改测试。最终交易的 241 项定向回归曾覆盖一次提交、未知暂停、精确归因、本地持久 fence 与热更新,并从“独立 read-port+状态机”迁移为同一申请人绑定交易对象,见 [W4 第 15–16 节](records/W4-selection-readback.md)。新增 H-04 调试测试覆盖公共 browser-fetch 与原生月份的同解析器比较、库存差异、401/403/429/503、错误 URL/正文、每月恰好两次只读请求以及 OTP/AVANTI/final 零增量;现场空月+正向月样本仍未执行。旧文档命令的失败已通过迁移到受支持 CLI 消除。历史套件之间有交集,不能相加为独立测试总数。 回执单源化补充:生产成功核验只使用严格预约列表、精确原生请求证明和唯一新增活动记录;列表结构/覆盖、活动基线、历史变化、错误服务/日期/时间、拒绝/丢包/未知、清理失败和重启阻断仍在离线测试。详情 DOM、预约类型和状态码保留在 `debug_ita_reservation` 的只读协议测试,不再要求生产按每条历史记录导航详情页。 本批新增/迁移覆盖:Book 表单模式不执行诊断采集也不提交;实际错误页面仍拒绝;表单结构脱敏和错误元数据路径在调试工具验证;日期诊断原只读用例继续执行;热更新不再依赖已删的全局 Book 转发函数,而验证公开 Book 使用上传文件自身的库存重查。等待校验新增“不改写快照、不放松其他字段”和布尔策略类型用例;既有真实扫描顺序、跨年、首月停止与不足范围不得报无号的测试保留。 CR-001 前补充:当时的回执夹具曾改用真实字段及快照级原生请求证明,保留错误归属、历史变化、缺证明和未知暂停;这些生产回执结构已由 R3 删除。解析的内层错误/长度上限、时段分量字段位置以及两种月份日期格式回归仍保留。导入整理前后检查与实际单文件热更新仍是有效证据;不能只以文本行数或 AST 等价替代业务测试。 上下文合并补充:普通 Query 未导出恢复参考时也校验账号/页面/代次/服务/标签页/路由/目录,新增跨实例复制、准备读取中换页面、查询读取中换账号的拒绝回归。原工具使用真实准备登记方法,登录健康状态和 Calendar 延迟就绪夹具按真实生命周期迁移;保留诊断 Book 和自动工作流各自的配置边界,不将真实公开调用替换为总是成功的桩。 日历操作补充:实际 Node 脚本覆盖翻月控件可见/禁用/遮挡/重复/错误来源和路径;时段延迟只筛一次、不额外请求,超时不点击,读回期间账号变化阻止选择。原 2 项服务提示脚本测试迁往调试套件,不删除业务覆盖;新增诊断脱敏、异常不覆盖原错误及 soak 恢复测试。两组新增共 11 项,诊断迁移造成套件计数变化需单独说明。 控件语义合同补充:日期和时段都必须返回精确的上下文、候选数、就绪、选中和点击事实;Python 只接受普通布尔和非负整数。实际 Node 场景继续逐项制造错误来源/服务/日期、不可用标记、错误 ID/时间/容量、重复/隐藏/遮挡元素及点击后漂移;最终脚本必须使用同一读回且不得在不安全状态点击。两个按旧 21 字段分组的 Mock 测试合成一项协议测试,所以 Italy 总数减少 1;具体场景未减少,见 [W3 第 10 节](records/W3-query-entry.md)。 生命周期归位补充:Sentinel 真实 health/cleanup/creator 用例继续证明失效 Query 不发布信号并退役一次;普通 Query 继续覆盖当前实例、页面、tab、账号、代次、route、服务和 profile 漂移。受控跨实例 Calendar 恢复只在 soak 工具测试,必须在导航前拒绝 owner/profile/route/外域/未知参数,在导航后拒绝 form 和错服务,并执行新月份请求而非复用旧 scan。删除生产 checkpoint 方法名不等于删除这些业务断言,见 [W2 第 15 节](records/W2-login-preparation.md)。 表单脚本合并补充:保留原实际 JS、原生隐藏同步、两套配置及前后 OTP 阶段测试;新增 3 项验证调试入口也受同一边界约束、重复业务控件拒绝、原生 change 离页不会被报成就绪。新增重复 token 测试首跑误限定内部错误检查顺序,已改为验证计数和拒绝行为;生产校验没有被放松。旧裸生成器消费者改用唯一的有边界生成器,没有保留旧私有导入或第二份实现。 W0 已验证 discovery 必须带 `-t .`:否则 Python 会将 `test/test.py` 误识别成 `test` 包,导致夹具导入失败;这不是 Italy 缺少 OpenCV,不应通过安装无关依赖解决。 现场命令不在此给一个默认会真实提交的复制块。W6 结合实际配置给出完整命令,明确标注是否会发 OTP、是否会创建预约、账号来源和日期范围;不把密码写进命令行。 每次结果至少包含:代码版本/指纹、命令、退出码、通过/失败/跳过数量、对应测试编号、外部边界是真实还是模拟、请求与回执摘要、遗留问题。任何必需用例被跳过都必须解释,不能计为通过。