接口联调计划

项目：行政协同平台

负责人：刘洋

部门：产品研发中心

窗口：9月25日–10月11日

结论：6 个接口，完成 1 个，未开始 3 个

一、联调目标

本计划安排行政协同平台与周边能力的联调。平台供总部 A 座员工在浏览器中预订会议室、请假、登记访客和领用办公用品。联调确认数据能按约定字段传递，失败时调用方能看到原因。窗口从 9 月 25 日到 10 月 11 日，完成后进入业务验收。

1. 每个接口至少一笔成功和一笔失败，失败原因可读。
2. 内部接口由刘洋自行准备对端，外部接口预约对方人员。
3. 联调通过的接口冻结字段，变更须重新约时间。
4. 10 月 11 日未通过的接口，由张伟决定是否移出上线范围。

二、接口范围

共 6 个接口。办结通知已用测试信走通，会议室占用和账号同步正在进行，请假回写、门禁核验和库存扣减尚未开始。对端包括平台自身模块、企业邮箱、安衡科技门禁和信息部账号。

1. 会议室占用供预订页判断时段是否可用，对端是平台内的占用数据。
2. 请假回写把主管批准结果写回员工申请，对端是审批模块。
3. 门禁核验由安衡科技提供，字段为二维码、日期和时段。
4. 库存扣减在领用成功后把数量减 1，初值由周敏提供。

三、日程与责任

下表为联调节奏。刘洋对内部接口负责，外部接口由刘洋主测、对方配合。状态反映 9 月 27 日的进度。

四、环境与数据

联调全部在测试库进行。王芳准备 20 个账号，周敏准备 12 间会议室中的 4 间和 8 种用品。门禁使用安衡科技 10 月 9 日送达的测试读卡器，生产门禁在联调期间保持现有策略。

1. 测试库每夜保留备份，失败数据由刘洋在次日 10:00 前清理。
2. 邮箱联调用 40 个测试邮箱中的已抽查部分，避免发给全员。
3. 账号同步先用 20 人名单，与验收账号一致。
4. 读卡器到达前，门禁接口只做字段核对，不做实卡核验。

五、问题处理

联调问题当天记入清单，写清接口、请求时间和现象。内部问题刘洋次日给出修复时间，外部问题当天通知孙磊或赵凯。阻塞验收的问题升级张伟。

1. 成功样例和失败样例都保留报文，放在该接口的目录下。
2. 字段不一致时，陈静确认说明后，刘洋按该说明修改调用方。
3. 对方改期超过 1 天的，刘洋当天告诉张伟对验收的影响。
4. 10 月 11 日 16:00 刘洋提交通过、未通过和移出上线范围的建议。

六、完成标准

6 个接口都有成功和失败记录后，联调阶段结束。若门禁实卡核验在 10 月 9 日完不成，该接口从上线范围移出，访客仍保留登记和行政确认。张伟在 10 月 11 日确认最终清单。

1. 办结邮件已于 9 月 25 日收到 20 封中的测试回执，该项已完成。
2. 占用查询要能拦住已被预订的时段，并返回占用原因。
3. 库存扣减后数量与周敏初值之差等于领用件数。
4. 未进入上线范围的接口，在员工说明里写明仍走原办法。