发生了什么
每个网点都对应一份签约合同,合同记录着这个网点用哪种方式签约,以及提交签约时网点的运营状态。商户名下可以有多个网点。网点需要再签一份合同时,业务人员在后台提交一次重新签约,系统把这一步叫“重新签约”。
签约方式分两种。线上签约会在电子签平台发起一份线上合同,等签署方在线签完;线下签约不发起线上合同,签署在线下进行。正常情况下,一个线下签约的普通网点重新签约,走的是线下签署流程。
暂停运营是网点的另一种状态:网点不再正常营业,它的签约关系要单独处理,所以暂停运营的网点重新签约时不能按普通网点的流程走,线下签约的暂停运营网点要走专门的线下暂停运营流程。
这次出问题的正是这一类网点。业务人员提交重新签约、合同审批通过之后,系统没有把它送进线下暂停运营流程,而是发起了一份线上电子签合同,等于让一个线下签约的网点去线上完成签署。业务先上报了一例,按签约方式和网点状态自查后,确认一共影响四个网点、两个商户。
本质
审批通过后的流程由一段分流程序决定。它读合同记录里的两个字段——签约方式和网点状态——然后选择后续的签署流程。判断按组合逐条进行:线下签约且正常运营的网点走线下签署;线上签约的暂停运营网点走线上暂停运营流程;其余情况落到最后一段,也就是线上签约流程。
坑就在这个“其余情况”。“线下签约 + 暂停运营”这一种组合没有被列举,也没有对应的处理程序可用:暂停运营网点只实现了线上那一条处理,线下的暂停运营流程当时并不存在。于是这类网点在判断里哪个分支都不命中,直接落到了兜底的线上签约流程,被发起了一份线上电子签合同。
结果就是同一批网点走了错误的签署通道:它们应当在线下签署,系统却生成了等待在线签署的线上合同。四个网点都属于同一类:线下签约、暂停运营,问题也都出在审批通过后的分流这一步,说明这不是偶发数据异常,而是分流规则本身少了一种组合。更要紧的是,分流程序把线上签约当成默认分支,遗漏的组合不会报错,只会安静地走错。
修复方向是:在分流处补上“线下签约 + 暂停运营”的分支,让这类网点进入线下暂停运营流程;同时取消“线上签约兜底”的写法,遇到没有覆盖的组合就拒绝发起并报警,交人工确认。对已经误发线上合同的网点,需要逐个核对该合同的状态,决定撤销还是按线下流程重新发起;这部分存量处理没有记录,修复上线情况也待确认。
下面用一段脱敏教学示例说明分流逻辑,代码只用于解释错误与修复思路,不代表实际项目源码或已上线实现。
错误代码
// 审批通过后,按签约方式和网点状态选择签署流程
void routeAfterApprove(ContractRecord r) {
if (r.getSignMode() == OFFLINE && r.getSiteStatus() == NORMAL) {
offlineSignService.start(r); // 普通线下网点
return;
}
if (r.getSiteStatus() == SUSPENDED && r.getSignMode() == ONLINE) {
onlineSuspendFlow.start(r); // 线上暂停运营网点
return;
}
// 线下 + 暂停运营没有对应分支,直接落在这里
onlineSignService.start(r); // 为什么错:线下网点被误发线上电子签合同
}
修复代码示例
void routeAfterApprove(ContractRecord r) {
switch (r.getSignMode()) {
case OFFLINE:
// 线下签约按网点状态再分,不再漏掉暂停运营
if (r.getSiteStatus() == SUSPENDED) {
offlineSuspendReSignService.start(r); // 新增:线下暂停运营网点重签
} else {
offlineSignService.start(r);
}
return;
case ONLINE:
if (r.getSiteStatus() == SUSPENDED) onlineSuspendFlow.start(r);
else onlineSignService.start(r);
return;
default:
// 未覆盖的组合不再用线上兜底,直接拒绝并告警
throw new IllegalStateException("unsupported sign mode: " + r.getSignMode());
}
}
下次遇到这些场景要警惕
- 给签约流程增加状态或签约方式时,先把“签约方式 × 网点状态”列成组合表,逐格标出对应流程,再对照代码确认每一格都有分支。
- 在测试环境构造一个“线下签约 + 暂停运营”的网点提交重新签约,审批通过后同时查合同记录和线上合同表,确认没有生成线上合同,而是进入了线下暂停运营流程。
- 分流程序的最后一个分支不要用线上流程兜底;构造一个当前未支持的状态组合,确认程序会拒绝并报警,而不是悄悄选一条流程继续执行。
- 修复后核对存量:按签约方式和网点状态筛出已误发线上合同的网点,逐个确认合同状态并处理,避免线下签署流程和线上合同同时挂在同一个网点上。