接口变更单

单号：CHG-0000-006

提出人 / 实施人：陈静 / 刘洋

决定：同意变更

生效：测试环境 0000-00-00

一、变更原因

周敏统计 9月1日至 9月15日的 86 场会议室使用，其中 17 场在会后补报参会人数，行政据此补备茶水，平均补备延迟 40 分钟。陈静提出在预订时增加可选字段 attendeeCount，便于会前按人数准备。刘洋评估后确认现有预订表可以增加可空整数列，旧客户端忽略该字段时行为保持不变。

二、变更内容

1. 预订接口请求体增加 attendeeCount，整数，选填，取值 1 至 30，缺省时按 0 存储，表示未填写。
2. 查询占用接口在每条预订中返回该字段，供行政视图展示。
3. 主题 subject 的长度、时段冲突规则和单据号规则保持 V1.2 原样。
4. 数据库预订表增加可空列 attendee_count，默认值 0，历史 1,240 条记录回填为 0。

三、影响范围

受影响的是预订写入、占用查询和行政准备视图。请假、访客、用品接口的路径和字段不变。

四、兼容策略

新字段为选填。旧版页面和脚本继续只提交原有五个字段时，服务按 0 写入，响应仍返回原有字段，并额外带上 attendeeCount。新页面在人数为空时不展示茶水提示，人数大于 0 时展示「按 N 人准备」。超出 1 至 30 的取值返回业务码 40022，单据不入库。刘洋于 9月23日用旧脚本成功创建单据 BK-0000-130，人数字段为 0。

五、验证记录

1. 陈静于 9月23日提交人数 8 的预订，行政视图显示 8 人，单据号 BK-0000-131。
2. 张伟于同日提交人数 0 和省略字段两种请求，两条记录均保存成功，页面显示未填写人数。
3. 刘洋提交人数 40，接口返回 40022，预订表行数未增加。
4. 周敏正在把 9月余下 12 场已排会议的人数补录入测试数据，计划 9月25日完成。

六、发布安排

测试环境于 0000-00-00 开放该字段。生产试点随 V1.2.0 窗口发布，由刘洋在发布检查中确认列已加上且默认值为 0。陈静在发布次日抽查 5 场预订的人数展示。若行政视图未就绪，字段仍先入库，视图延迟不超过 2 个工作日，员工预订主路径照常使用。

陈静附上 9月1日至 9月15日的 17 场补报明细，平均每场 6 人，最多 22 人。行政按人数大于 8 的场次优先备水，送达时间为会议开始前 15 分钟。刘洋实测加列在测试库耗时不足 1 秒。历史 1240 条回填为 0 后，周敏抽查 10 条，页面显示未填写人数，会后补报台账仍单独保存，两边数字各自留档。陈静要求人数输入框放在主题下方，提示填写 1 至 30 的整数。人数为 0 时行政视图显示未填写，避免把缺省当成零人场次。刘洋已在测试环境改完，9月24日由陈静复核一遍。