首页
学习
活动
专区
圈层
工具
发布
社区首页 >专栏 >退货定责的码级证据链:出库快照、签收存证与责任判定的规则引擎实现

退货定责的码级证据链:出库快照、签收存证与责任判定的规则引擎实现

原创
作者头像
用户4575637
发布于 2026-11-16 13:05:08
发布于 2026-11-16 13:05:08
220
举报

退货纠纷在数据库里表现为一张退货单,在业务上却是一场举证。传统做法是把出库单、签收单、聊天记录拼在一起开会讨论,耗时且结论不稳定。要把它变成可自动化的流程,需要三样东西:码级的流转记录、结构化的证据快照、可解释的判定规则。

本文拆解这条证据链的实现,重点在证据模型、快照生成、规则引擎与接口边界四块。

一、约束条件

  • 证据不可篡改:快照一旦生成,只能追加不能修改,任何更正以新版本形式存在。
  • 判定可解释:每条结论必须能回溯到具体规则与具体证据项。
  • 证据可缺省:现场条件有限,缺证据是常态,系统要能给出置信度而不是直接拒绝。
  • 判定幂等:同一退货单多次触发判定,结果一致且不重复产生工单。

第三条决定了设计的走向。要求"证据齐全才受理"的流程在一线会被绕过,正确的做法是先受理、再评分。

二、数据模型

证据与业务单据分离建表,写入路径完全隔离:业务单据可修改,证据只允许追加存储。

代码语言:sql
复制
CREATE TABLE trace_evidence (
  id            BIGINT      NOT NULL AUTO_INCREMENT,
  tenant_id     BIGINT      NOT NULL,
  biz_type      TINYINT     NOT NULL,      -- 1 出库 2 运输 3 签收 4 退货 5 入库
  biz_no        VARCHAR(48) NOT NULL,
  code_level    TINYINT     NOT NULL,      -- 1 箱码 2 瓶码
  code_value    VARCHAR(64) NOT NULL,
  evidence_type SMALLINT    NOT NULL,      -- 1 照片 2 称重 3 温控 4 轨迹 5 电子签收
  payload       JSON        NOT NULL,      -- 对象存储 key、数值、坐标、设备号
  integrity     VARCHAR(64) NOT NULL,      -- 内容哈希
  prev_hash     VARCHAR(64) NULL,          -- 链式哈希,按码维度串接
  captured_at   TIMESTAMP(3) NOT NULL,
  operator_id   BIGINT      NOT NULL,
  PRIMARY KEY (id),
  KEY idx_code_time (tenant_id, code_value, captured_at),
  KEY idx_biz (tenant_id, biz_type, biz_no)
);

CREATE TABLE return_verdict (
  id             BIGINT      NOT NULL AUTO_INCREMENT,
  tenant_id      BIGINT      NOT NULL,
  return_no      VARCHAR(48) NOT NULL,
  rule_set_ver   VARCHAR(16) NOT NULL,
  responsibility TINYINT     NOT NULL,     -- 1 终端 2 运输 3 仓库 4 生产 5 待定
  confidence     DECIMAL(4,3) NOT NULL,
  missing_items  JSON        NULL,
  evidence_digest VARCHAR(64) NOT NULL,
  decided_at     TIMESTAMP   NOT NULL,
  PRIMARY KEY (id),
  UNIQUE KEY uk_return (tenant_id, return_no)
);

prev_hash 按 (code_value) 维度串成链,写入时读取上一条的 integrity 作为前驱。这样即使有人拿到数据库权限,也很难在不被发现的情况下替换某一条历史快照。

三、出库快照

出库是整条链路的起点,快照质量决定后续判定的上限。

生成逻辑放在出库单确认的回调里,一次性写入五类证据:箱码与瓶码绑定关系、封箱前后照片(各一张)、整箱称重值、承运商与车牌、出库环境温度。每条证据单独一行,biz_no 为出库单号。

照片上传走客户端直传对象存储,服务端只保存 key 与哈希,避免大文件占用应用带宽。上传成功后计算内容哈希,写入证据表时携带 prev_hash。

绑定关系必须显式存储,而不是从箱码前缀推断。实际业务中存在换箱、拼箱、拆箱再封的情况,前缀推断会在这些场景下出错。

四、签收与异常登记

签收环节的核心是把"签字"升级为"带状态的结构化记录"。

正常签收通过签收接口写入一条 evidence_type = 5 的记录,payload 包含签收人、设备指纹、GPS、签收时间、是否开箱抽检。抽检照片作为独立证据写入。

异常签收走单独的事件类型,必须携带异常项枚举:外箱破损、封条断裂、水渍、数量不符、温度超标。异常项是后续规则引擎的主要输入,不能塞在备注里。

签收后设 24 小时补报窗口,窗口内的补报标记 late_report = true,参与判定但降低权重;窗口外的补报只记录不参与判定。这个规则要在配置中心可调,不同品类差异很大。

五、判定规则

规则用决策表实现,输入是证据特征,输出是责任归属与置信度。示例规则集:

规则

条件

结论

置信度

R1

出库快照完整 且 签收正常 且 无异常登记

终端

0.80

R2

出库快照完整 且 签收登记外箱破损

运输

0.85

R3

箱码与出库绑定不一致

待定(转核查)

0.60

R4

同门店 90 天内退货次数 ≥ 3

待定(转信用评估)

0.50

R5

出库快照缺失 且 签收正常

待定(补证)

0.35

置信度不是概率,而是证据强度的归一化表达,用于排序与人工复核分流。低于 0.6 的判定默认进入人工队列,而不是直接出结论。

规则执行前先做证据完备性评分,并把它作为独立特征参与最终置信度计算:五类出库证据齐全记 1.0,缺照片记 0.6,缺绑关系记 0.4。完备性分数乘进最终置信度,避免"证据不全但结论很硬"的荒谬输出。

六、幂等与并发

退货单可能被多次触发判定:客户补报、仓库改判、主管复核。判定结果表对 (tenant_id, return_no) 建唯一键,写入用 INSERT ... ON DUPLICATE KEY UPDATE,只在 rule_set_ver 或 evidence_digest 变化时更新。

evidence_digest 是所有关联证据 integrity 的聚合哈希。证据没变,判定结果就不该变,直接返回缓存结果即可。这一条能挡掉大量重复计算。

并发场景主要是出库回调和称重设备上报同时写同一箱码。链式哈希需要在同一码维度上加行锁,锁粒度控制在 code_value,避免整表锁。

七、性能与容量

证据表是典型的写多读少表,按 captured_at 月分区,热数据保留 6 个月,冷数据转列式存储。照片放对象存储,数据库只存 key。

查询路径有两条:按码查全链路、按单据查证据集。前者走 idx_code_time,后者走 idx_biz。两条路径都要限制返回条数,避免一次拉出几年的历史。

判定服务与证据服务分离部署。判定是纯计算,可以水平扩容;证据写入是有状态操作,按租户分片更稳。

八、小结

退货定责的自动化,难点不在规则本身,而在证据的结构化程度。照片存在手机里、异常写在备注里、绑定关系靠前缀推断,这三件事任意一件成立,规则引擎拿到的输入特征都不可靠。

把证据当成一等公民来建模,剩下的事情是工程细节:链式哈希保证不可篡改,完备性评分处理缺证,幂等写入保证结果稳定。做到这三步,一张退货单的定责时间可以从周级压到小时级。

原创声明:本文系作者授权腾讯云开发者社区发表,未经许可,不得转载。

如有侵权,请联系 cloudcommunity@tencent.com 删除。

目录
  • 一、约束条件
  • 二、数据模型
  • 三、出库快照
  • 四、签收与异常登记
  • 五、判定规则
  • 六、幂等与并发
  • 七、性能与容量
  • 八、小结
问题归档专栏文章快讯文章归档关键词归档开发者手册归档开发者手册 Section 归档