04 第4周D20 项目开发第3天
D20 作业:契约自测 + 偏差修复
D20 作业:契约自测 + 偏差修复
目标
- 完成各自接口的契约自测,修复偏差,输出"已知问题清零"清单。
任务
任务 1:写自测脚本
- 用 curl 或脚本对你的接口逐一打点,覆盖:成功路径、无效 key、余额不足、重复 request_id(幂等)。
- 输出一份契约核对表(接口 | 输入 | 输出 | 状态码 | 幂等 | 实测结果)。
任务 2:修复偏差
- 所有"实测 ≠ 契约"的项,当天修完;修复后重跑自测。
- 涉及契约字段变更的,先@全员,更新 D17 契约文档后再改。
任务 3:交叉复核
- 找另一位学员复核你的关键接口(A↔B、B↔C),在核对表上签注。
任务 4:收口清单
- 在
docs/training/项目/进度.md追加:- 已清零的问题;
- 尚未修的已知偏差(说明原因);
- 明天联调建议最先联哪两个接口。
验收标准(讲师核验用)
- 核对表覆盖四个测试场景(成功/无效key/余额不足/幂等)
- 无未修复的契约字段偏差(或已记录原因)
- 有交叉复核签注
- 进度.md 收口清单更新
提交方式
- 脚本/核对表进各自分支,中文提交信息,如:
D20 契约自测与修复(姓名)。
参考
- D17 课程.md 接口契约(权威)
- 学习网站.md → D17-D21 分组