5.4 KiB
5.4 KiB
Data Model: REV-006 催缴事件与通知协同设计
1. Reminder Candidate
Purpose
表示进入催缴评估范围的欠费账单或客户对象集合，是催缴任务生成的输入对象。
Key Fields
| Field | Description | Rule |
|---|---|---|
custId |
客户标识 | 必填；关联客户主档 |
chargeId |
账单标识 | 必填；关联欠费账单 |
billPeriod |
账期 | 必填；用于催缴分组和历史查询 |
arrearsAmount |
欠费金额 | 必填；用于策略匹配 |
agingBucket |
欠费账龄分组 | 必填；用于策略筛选 |
customerCategory |
客户类别 | 必填；用于差异化催缴 |
contactChannelSet |
可用联系方式集合 | 至少存在一个有效触达渠道 |
strategyCode |
命中的催缴策略编码 | 必填；来源于策略规则 |
Relationships
- 来自
biz_charge/biz_charge_detail - 关联客户主档与联系方式
- 可生成一个或多个
Reminder Task
2. Reminder Strategy
Purpose
定义催缴对象筛选、任务分组、触达渠道和频控约束的业务规则。
Key Fields
| Field | Description | Rule |
|---|---|---|
strategyCode |
策略编码 | 唯一 |
agingRule |
账龄匹配规则 | 必填 |
amountRule |
金额匹配规则 | 必填 |
customerCategoryRule |
客户类别匹配规则 | 可为空；为空表示通用 |
channelPriority |
触达渠道优先级 | 必填；至少 1 个渠道 |
dedupeWindow |
重复触达拦截窗口 | 必填 |
escalationFlag |
是否触发后续处置关注 | 必填 |
Relationships
- 一个
Reminder Strategy可匹配多个Reminder Candidate - 一个
Reminder Strategy可驱动多个Reminder Task
3. Reminder Task
Purpose
表示一次正式催缴执行单元，负责承接业务触发、协同下发和结果回写。
Key Fields
| Field | Description | Rule |
|---|---|---|
taskNo |
催缴任务号 | 唯一；正式业务主键 |
interfaceCode |
正式接口编号 | 固定使用 IF-REV-013 |
eventNo |
业务事件号 | 唯一；用于与 SYS-010 协同 |
custId |
客户标识 | 必填 |
chargeId |
账单标识 | 必填 |
strategyCode |
策略编码 | 必填 |
channelType |
触达渠道 | 必填；短信/微信公众号/站内信等 |
triggerType |
触发方式 | 必填；自动/人工 |
status |
当前任务状态 | 必填；PENDING / SUCCESS / FAIL / MANUAL_VERIFIED |
sourceType |
任务来源 | 必填；系统任务/人工补发/核查回补 |
createdTime |
创建时间 | 必填 |
lastResultTime |
最近结果时间 | 可为空；初次发送前为空 |
State Transitions
| From | To | Condition |
|---|---|---|
| 新建 | PENDING |
已生成任务并发起协同 |
PENDING |
SUCCESS |
收到成功回写 |
PENDING |
FAIL |
收到失败回写或确认失败 |
PENDING |
MANUAL_VERIFIED |
人工核查后确认结果 |
FAIL |
MANUAL_VERIFIED |
人工核查补记结果 |
Relationships
- 由一个
Reminder Candidate和一个Reminder Strategy组合产生 - 关联一个或多个
Reminder Result - 可关联一个
Disposal Link
4. Reminder Result
Purpose
表示 SYS-010 回传或人工核查得到的触达结果。
Key Fields
| Field | Description | Rule |
|---|---|---|
eventNo |
业务事件号 | 必填；与 Reminder Task 对应 |
status |
结果状态 | 必填；仅允许四态 |
failureReason |
失败原因 | FAIL 时必填 |
resultChannel |
实际触达渠道 | 必填 |
resultTime |
结果时间 | 必填 |
verifiedBy |
核查人 | MANUAL_VERIFIED 时必填 |
verifiedNote |
核查说明 | MANUAL_VERIFIED 时建议填写 |
Relationships
- 归属于一个
Reminder Task - 结果会回写到任务状态与历史查询记录
5. Reminder History Record
Purpose
为历史查询和迁移验收提供最小保留信息集合。
Key Fields
| Field | Description | Rule |
|---|---|---|
custId |
客户标识 | 必填 |
billPeriod |
账期 | 必填 |
channelType |
催缴方式 | 必填 |
messageContentRef |
触达内容引用 | 必填；可为模板或摘要引用 |
receiver |
接收目标 | 必填；手机号/OpenID/站内信对象 |
status |
执行结果 | 必填；使用四态或历史映射值 |
sendTime |
发送时间 | 必填 |
operatorSource |
操作来源 | 必填；自动/人工/历史迁移 |
relatedChargeId |
关联账单 | 必填 |
relatedDisposalRef |
关联处置引用 | 可为空；用于停复水/工单追溯 |
Relationships
- 可由
Reminder Task和Reminder Result聚合生成 - 同时承接历史催缴记录、停水记录、预存短信记录的查询口径
6. Disposal Link
Purpose
记录催缴结果与停水、复水、工单或人工处置之间的追溯关系。
Key Fields
| Field | Description | Rule |
|---|---|---|
eventNo |
关联业务事件号 | 必填 |
disposalType |
处置类型 | 必填；停水/复水/工单/人工跟进 |
triggerCondition |
触发条件摘要 | 必填 |
disposalRefNo |
下游处置引用号 | 可为空；未创建时为空 |
disposalStatus |
下游处置状态 | 可为空；仅作追溯，不定义内部流程 |
linkedTime |
建立关联时间 | 必填 |
Relationships
- 一个
Reminder Task最多关联一个当前生效的Disposal Link - 不替代下游业务对象，只做引用和追溯