契约测试说明

编写人：王芳

系统：行政协同平台

流水线：合并前必跑

日期：0000-00-00

最近结果：46 条通过

一、说明目的

契约测试用来核对行政协同平台网页和显示屏所调用接口的字段与结果码是否仍符合约定。该检查在合并前的流水线中执行，未通过则不能合并。覆盖预订、请假、访客、用品和屏端只读接口。手工探索和「库存为 1」一类边界用例另行维护。王芳维护用例，刘洋修改接口时同步修改契约。

二、契约范围

合计 46 条，与流水线接口测试是同一套。9月20日主干从 09:12 跑到 09:32，这 46 条失败 0。预发数据库用可回滚的数据，跑完按批次删除，不连生产。

三、契约变更条件

1. 字段从时间戳改成日历日时，请假的 10 条已在 v1.2.5 前改完，旧形态现在期望得到 40012。
2. 用品若增加预占状态，要先加断言再合并。当前生产契约仍期望「已提交」。
3. 屏端多返回一个字段时，旧断言只检查原有字段，多出来的字段不导致失败。
4. 删除字段视为破坏约定，必须先改契约和调用方，再删服务端。

四、失败处理

契约未通过时，王芳先区分是接口变更还是用例过期。接口变更由作者修改代码或补充公告，用例过期由王芳当日修改。9月27日功能分支的并发预占尚未纳入这 46 条，当日流水线结果为通过，该问题在集中试用中发现。王芳已将「库存为 1 时只有一笔预占成功」写入下一版契约，合入后条数由 46 增至 48。陈静每月核对是否存在被静默的失败，9 月没有静默记录。这 46 条在预发的平均耗时为 8 分钟。失败日志保留 14 天。9月20日执行结果为全部通过。新增的 2 条并发断言计划在 9月28日复测通过后提交。提交后接口测试耗时预计由 8 分钟增至 9 分钟以内，仍低于 30 分钟的调整线。王芳在合并说明中写明新增用例的名称。