退货纠纷在数据库里表现为一张退货单,在业务上却是一场举证。传统做法是把出库单、签收单、聊天记录拼在一起开会讨论,耗时且结论不稳定。要把它变成可自动化的流程,需要三样东西:码级的流转记录、结构化的证据快照、可解释的判定规则。
本文拆解这条证据链的实现,重点在证据模型、快照生成、规则引擎与接口边界四块。
第三条决定了设计的走向。要求"证据齐全才受理"的流程在一线会被绕过,正确的做法是先受理、再评分。
证据与业务单据分离建表,写入路径完全隔离:业务单据可修改,证据只允许追加存储。
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 删除。