回滚步骤

编写人：周敏

当前版本：行政协同平台 V1.2.4

退回版本：V1.2.3

演练日期：9月14日

生产状态：未触发，演练已通过

一、适用版本

本文说明把生产从 V1.2.4 退回 V1.2.3 的步骤。V1.2.4 于 9月9日发布，访客单增加二维码，前台扫码后把状态改为已到达。V1.2.3 没有二维码，前台在访客列表点击「确认到达」完成同一件事。步骤适用于发布后 7 天内。超过 7 天的退回，先由李莉统计已经扫码的到达记录数量，再决定是否仍按本文执行。

二、回滚判定

出现下列任一情况，张伟宣布回滚：扫码后状态与前台选择不一致；扫码接口错误率连续 5 分钟高于 1%；二维码打开的单据不是前台手里的那一笔。值班人先停止继续放大使用范围，两台实例保持当前版本，直到周敏开始退回。判定只看访客扫码，预订、请假和用品的错误不单独触发这次回滚。

三、操作步骤

1. 周敏在发布系统选择 V1.2.3，按 1 台一批退回，共 2 台，两台间隔 2 分钟。
2. 刘洋确认每台启动日志中的版本为 V1.2.3，访客列表的「确认到达」按钮重新出现。
3. 已经扫码写成已到达的记录保留，不改回待到达，避免前台把同一个人再确认一次。
4. 退回完成后，新的二维码请求返回「请让前台在列表中确认到达」。纸质来访登记仍可补录。

四、数据与兼容

V1.2.4 在访客表增加了二维码编号，V1.2.3 读取时忽略该列，退回时不删除列。9月9日之后通过扫码到达的 86 条记录保留状态和到达时间。前台在 V1.2.3 里仍能按姓名搜到这些访客。新的到达改由列表按钮写入，字段与扫码写入的到达时间相同。

五、验证标准

六、演练记录

9月14日 16:00 至 16:11，周敏在预发按本文完整走了一遍，用时 11 分钟。王芳抽查 5 笔列表确认，状态都变为已到达。刘洋用退回前生成的 10 个二维码再次访问，页面给出列表确认的提示，没有把状态改错。张伟在演练记录上确认：生产一旦宣布回滚，按同一顺序执行，并在完成后 30 分钟内向总部前台说明按钮位置。