发生了什么

网点是线下合作门店,场地里放换电柜,面向骑手提供电池租换服务。每个网点对应一份租赁合同,合同写明这段合作从哪天到哪天、每期租金多少。系统按合同约定的周期生成租金账单,一张账单对应一期场地租金,之后进入结算和付款。

合同有两种结束方式。一种是到期自然结束;另一种是提前解约,走单独的终止协议:审批通过、双方签署后,系统生成一条终止协议合同记录,同时生成一笔负向清算账单,把已覆盖期间的租金冲掉,并停止后续的租金生成任务。

为了不每次都回读合同主表,系统在合同生效时留一份合同快照:把起止日期、租金、履约期拷一份出来。之后生成账单,判断依据是这份快照,而不是网点当前的状态。每份合同还会按周期预排一批租金触发器,到点就按快照生成一期账单。

正常情况:合同在履约期内,触发器按期生成账单;一旦走了终止协议,触发器链停掉,不再出账。

这次不一样的地方是一个停业的网点。这个网点在 8 月中旬停业,名下是一份今年 1 月换签的新合同,合同期到明年 1 月。系统里没有这条合同的终止协议记录,合同状态仍是已签约,快照也还是履约中。停业之后,合同没有任何终止动作,触发器继续按新合同周期排期:覆盖 7 月中旬到 10 月中旬的这一期账单已经生成,金额约两千元,后续每季度还会继续生成。从换签至今一共出了三期,合计约六千元。

同时,页面上显示的还是上一份合同的起止日期,去年 3 月到今年 3 月,已经过期。运营在页面上看到结束日期早已过去,以为合约到期就不会再出账,可系统算的却是另一份还在履约的合同,于是产生了“网点都关了,为什么还持续出租金账单”的疑问。

本质

一句话:停业只改了网点自己的状态,合同和租金触发器都没有动;决定要不要出账的是合同在不在履约期,不是网点有没有停业。

按先后顺序拆开:

  1. 网点状态、合同记录、合同快照、租金触发器是分开保存的四份数据。停业接口更新的是网点状态这一份。
  2. 换签时,系统做了三件事:建一条新合同记录;把旧快照标成履约前、新快照标成履约中;按新合同期重排租金触发器。
  3. 触发器到点时只做一件事:看这份快照是不是履约中、这一期是不是落在合同期内。是,就生成正向租金账单。它不读网点状态,也不读合同主表上的结束日期。
  4. 能停下这条链的只有终止协议:审批签署后生成终止记录和一笔负向清算账单,并把触发链停掉。停业不在这个清单里,所以账单继续生成。
  5. 换签时合同主表上的合作结束日期没有回写,仍是上一份合同的日期。页面(包括关闭网点时展示的合约信息)取的是这个字段,因此显示的是旧合同期。它和账单生成用的是两份数据,账单按新合同快照算。

停业不等于解约:网点状态变成停业,合同照样在履约,账单就照样出。

排查时容易走反的一步,是拿页面上的合同日期推断“合同到期了、不会再出账”。这个日期来自合同主表,换签后没更新;真正决定出账的是当前生效合同的快照和触发器链。要确认还会不会出账,得查当前合同和触发器,不能看页面。

修复方向是:停业流程里增加合同处理环节,名下有履约中合同的网点,停业时落一条待处理标记并提示走终止协议,而不是直接放行;换签时把合同主表的起止日期与新合同、快照放在同一个事务里更新;出账判断和页面展示都改成读当前生效的同一份合同。这些是可采用的方式,是否实施、是否上线尚未确认。

下面两段 Java 是脱敏教学示例,用于解释错误与修复思路,不代表实际项目源码或已上线实现。

错误代码

// 教学示意:停业与合同展示各自实现,中间没有交汇
public class NodeService {

    // 停业:只改网点自己的状态
    public void stopBusiness(Long nodeId) {
        // 为什么错:拿到网点就直接置为停业,
        // 名下还在履约的合同既不标记待终止,也不提示要走终止协议
        nodeMapper.updateStatus(nodeId, NodeStatus.STOP_BUSINESS);
    }

    // 页面(含关闭网点时的合约信息)从这里取合同期
    public ContractView viewContract(Long nodeId) {
        Contract main = contractMapper.selectMainByNodeId(nodeId);
        // 为什么错:只读合同主表,这张表的结束日期在换签时没有回写,
        // 页面显示的是旧合同期,与真正计费的新合同不是同一份
        return new ContractView(main.getStartDate(), main.getEndDate());
    }
}

修复代码示例

// 同一个类:停业时把合同状态摆到明面上,换签时把主表日期写回去
public class NodeService {

    @Transactional
    public void stopBusiness(Long nodeId) {
        // 为什么这样改:先看名下有没有履约中的合同,有就落待处理标记,
        // 由业务决定发起终止协议还是只暂停,停业不再等于"什么都不用管"
        contractService.markPendingTermination(nodeId);
        nodeMapper.updateStatus(nodeId, NodeStatus.STOP_BUSINESS);
    }

    @Transactional
    public void resign(Long nodeId, ContractForm form) {
        Contract fresh = contractService.createFormal(nodeId, form);
        snapshotService.switchCurrent(fresh);
        triggerService.rebuild(nodeId, fresh);
        // 为什么这样改:主表日期与新合同在同一事务里更新,
        // 页面、关闭校验和账单判断读到的才是同一份合同期
        contractMapper.updateMainDates(nodeId, fresh.getStartDate(), fresh.getEndDate());
    }
}

下次遇到这些场景要警惕

  1. 给网点增加“停业、关店”这类终态动作时,先用一个真实网点走一遍:执行停业,再查它名下的合同状态、有没有终止记录、触发器还在不在、下一期账单会不会生成,观察这四个结果是否与业务预期一致。
  2. 看到“合同已到期却还在出账”时,先按当前合同查快照的履约期和触发器队列,再看页面和合同主表上的日期;两处不一致时以快照和触发器为准,不要拿页面日期推断会不会出账。
  3. 换签类改动上线前,核对合同主表起止日期、当前快照、触发器周期三者是否一致,再对这个网点做一次关闭或停业操作,确认校验读的是新合同。
  4. 按季度对账时,拉一份“网点已停业但还有履约中合同”的清单,逐条确认是暂时停业还是要解约;这份清单能把停业与解约之间的缺口长期暴露出来。