docs: 补完REV模块详细设计与追溯映射
This commit is contained in:
parent
69ad12837e
commit
2f580f26d8
@ -114,6 +114,7 @@
|
||||
|
||||
> 说明：本表中的历史记录按当时原始表述保留；当前正式数据库口径统一以“达梦数据库 8.0+”为准。
|
||||
|
||||
| 2026-03-11 | `12_REV_Detailed` 设计补完（结构化增强） | 补完 `docs/design/02_Detailed_Design/12_REV_Detailed.md`：1）新增“营收模块统一约束”章节；2）新增“接口与数据追溯矩阵”，统一 `REV-001~REV-009` 对应 `IF-REV-*` 与核心数据域；3）为各 REV 模块补充“接口映射”段落；4）补齐 `REV-009` 缺失的“接口映射 + 落地边界”；5）为 `REV-004/005/006/008` 增加流程图，强化评审可读性与协同边界说明。 | 用户要求补完 `12_REV_Detailed.md`，并提升评审可交付性与跨文档追溯效率。 | 正面影响，营收模块正文从“说明型”提升为“可追溯、可评审、可维护”结构；接口、数据、协同边界更清晰，减少详细设计与接口/数据库专题之间的理解偏差。 |
|
||||
| 2026-03-11 | `docs/design` P2 优化（Archive 标签化与抽检自动化） | 完成 P2 持续优化：1）新增 `scripts/generate-archive-tag-index.sh` 并生成 `docs/design/04_Appendix/Archive/00_Archive_Tag_Index.md`，对 Archive 文档按“来源/用途/可信级别”标签化；2）新增 `scripts/ai-weekly-audit-diff.sh` 并输出 `docs/design/00_Management/14_AI_Audit_Diff_Latest.md` 差异清单；3）在 `Makefile` 接入 `archive-tag-index` 与 `ai-audit-diff` 命令；4）同步更新 `12_AI_Weekly_Audit_Template.md`、`04_Appendix/README.md`、`00_Management/README.md`、`scripts/README.md` 的入口说明。 | 用户要求执行 P2 优化清单，需把“标签化 + 自动化”从规划项落地为可执行资产。 | 正面影响，Archive 资料从“目录分类”升级为“可检索标签资产”；AI 抽检从人工记录升级为脚本化差异输出，周检可复用、可对比、可追踪，后续持续治理成本显著降低。 |
|
||||
| 2026-03-11 | `docs/design` P1 修复（治理口径与统一入口） | 执行 P1 修复清单：1）更新 `00_Management/04_Writing_Guide.md` 中数据库选型与术语标准，统一为“达梦数据库 8.0+”；2）修复 `00_Management/03_Task_Checklist.md` 与 `00_Management/01_Project_Progress.md` 当前交付总结中的旧数据库表述；3）增强 `00_Management/11_Main_Doc_Chapter_Index.md` 的数据库导航，新增 `METER/INST` 专题边界与 `02_Table_Specs` 映射入口；4）更新 `00_Management/10_AI_Retrieval_Whitelist.md`，将 `02_Table_Specs.md` 纳入 P2 映射检索。 | 用户要求“执行 P1 修复清单”，需完成跨文档术语映射统一与入口完善。 | 正面影响，治理文档与主文档口径进一步对齐，减少历史术语对 AI 检索与评审的干扰；数据库主口径与映射补充入口更清晰，P0/P1/P2 检索链路更加稳定。 |
|
||||
| 2026-03-11 | `docs/design` P0 全量修复（接口/数据库/边界收敛） | 按 P0 缺口执行全量修复：1）更新 `03_Technical_Design/03_Interface_Design.md`，补齐 `IF-UP/IF-METER/IF-INST` 接口域口径并将“实现状态”改为“已覆盖 + 版本迭代维护”；2）修复 `02_Detailed_Design/01_Detailed_Design.md` 附录编号规则（`CS` 前缀、`IF-UP/REV/CS/METER/INST/EXT`）及历史占位写法；3）在 `03_Technical_Design/01_Database_Design.md` 新增 `METER/INST` 专题表边界章节，收敛 `installation_*` 与历史 `water_meter_*` 口径；4）重写 `03_Technical_Design/02_Table_Specs.md` 为“单表规格补充（历史映射）”，降级为非主口径并移除 OpenGauss 冲突表述；5）同步更新 `README.md`、`03_Technical_Design/README.md`、`02_Module_Traceability_Index.md`、`scripts/unified_export.sh` 等入口说明。 | 用户明确要求“P0 全量修复”，需消除主文档与补充文档在接口编号、数据库专题表与权威边界上的冲突。 | 正面影响，主文档链路（详设→数据库→接口）口径一致性显著提升；`02_Table_Specs` 从并行主稿风险收敛为映射补充，避免历史命名反向污染；AI 检索时“主口径优先级”更清晰，可降低后续持续优化与交付评审的返工风险。 |
|
||||
|
||||
@ -138,6 +138,15 @@
|
||||
|
||||
## ✅ 最新完成任务 (持续更新)
|
||||
|
||||
### 📋 `12_REV_Detailed` 设计补完（结构化增强）
|
||||
|
||||
- [x] **完成营收模块正文补完与追溯增强** ✅ (2026-03-11)
|
||||
- [x] 新增“营收模块统一约束”章节，明确 `SYS-002` 与 `SYS-008/009/010` 协同边界 ✅
|
||||
- [x] 新增“接口与数据追溯矩阵”，覆盖 `REV-001~REV-009` 的接口与数据域映射 ✅
|
||||
- [x] 为 `REV-001~REV-009` 全模块补充“接口映射”段落 ✅
|
||||
- [x] 补齐 `REV-009` 缺失的“接口映射 + 落地边界” ✅
|
||||
- [x] 为 `REV-004/005/006/008` 增加流程图，提升评审可读性 ✅
|
||||
|
||||
### 📋 `docs/design` P2 优化（标签化 + 自动化）
|
||||
|
||||
- [x] **完成 Archive 标签化与 AI 抽检自动化** ✅ (2026-03-11)
|
||||
|
||||
@ -14,6 +14,8 @@ retrieval_priority: P1
|
||||
|
||||
- [文档定位](#sec-position)
|
||||
- [营收业务详细设计正文](#sec-content)
|
||||
- [营收模块统一约束](#sec-rev-rules)
|
||||
- [接口与数据追溯矩阵](#sec-rev-trace)
|
||||
- [REV-001 客户资料管理](#mod-rev-001)
|
||||
- [REV-002 抄表开账](#mod-rev-002)
|
||||
- [REV-003 营业收费](#mod-rev-003)
|
||||
@ -34,6 +36,34 @@ retrieval_priority: P1
|
||||
|
||||
# 营收业务详细设计
|
||||
|
||||
<a id="sec-rev-rules"></a>
|
||||
|
||||
## 营收模块统一约束
|
||||
|
||||
1. `SYS-002` 负责营收主流程，发票、支付结算、消息触达分别通过 `SYS-008`、`SYS-009`、`SYS-010` 协同完成，外部系统仅回写结果状态。
|
||||
2. 账单、收费、发票、代扣等关键状态变更必须通过业务流程驱动，不允许绕过业务校验直接改写主业务对象。
|
||||
3. 幂等控制遵循接口主键约束：支付以业务订单号为主，发票以申请单号或账单组合为主，代扣以批次号为主，消息以业务事件号为主。
|
||||
4. 账务调整、发票申请、催缴触达、银行批次下发等关键动作必须写入操作留痕，满足审计与问题追踪要求。
|
||||
5. 数据口径统一采用 `biz_*` 与 `bk_*` 命名体系，历史命名仅用于追溯，不作为本章节正式设计口径。
|
||||
|
||||
<a id="sec-rev-trace"></a>
|
||||
|
||||
## 接口与数据追溯矩阵
|
||||
|
||||
> 说明：详细字段与报文以 `../03_Technical_Design/03_Interface_Design.md` 为准，数据库字段口径以 `../03_Technical_Design/01_Database_Design.md` 为准。
|
||||
|
||||
| REV 模块 | 关键接口 | 核心数据域（摘要） | 主要协同对象 |
|
||||
|---|---|---|---|
|
||||
| REV-001 客户资料管理 | `IF-REV-001` | `biz_cust`、`biz_account`、`biz_cust_*` | 客户服务模块、报装模块 |
|
||||
| REV-002 抄表开账 | `IF-REV-004`、`IF-REV-005` | `biz_meter_book`、`biz_meter_read`、`biz_reading_*`、`biz_charge*` | 抄表APP、物联网集抄 |
|
||||
| REV-003 营业收费 | `IF-REV-006` | `biz_charge*`、`biz_collection`、`bk_transaction*` | `SYS-009` |
|
||||
| REV-004 账务处理 | `IF-REV-007` | `biz_charge*`、`biz_operat_log*` | 财务与营业人员 |
|
||||
| REV-005 发票与税务处理 | `IF-REV-008` | `biz_invoice*`、`biz_cust_invoice` | `SYS-008` |
|
||||
| REV-006 催缴与通知 | `IF-REV-009` | `biz_charge*`、催缴结果留痕 | `SYS-010` |
|
||||
| REV-007 统计分析 | `IF-REV-010` | 客户、抄表、收费、渠道聚合对象 | 统计分析端 |
|
||||
| REV-008 代收与银行业务 | `IF-REV-011` | `bk_withholding_*`、`bk_reconcile_*`、`bk_settlement_*` | `SYS-009`、银行 |
|
||||
| REV-009 业务参数配置 | `IF-REV-012` | `biz_parameter_settings`、`biz_page_settings*`、`biz_price_*` | 统一平台、营收模块 |
|
||||
|
||||
<a id="mod-rev-001"></a>
|
||||
|
||||
## REV-001 客户资料管理
|
||||
@ -64,6 +94,11 @@ retrieval_priority: P1
|
||||
- `biz_cust_no_rule`：客户编号规则。
|
||||
- `biz_cust_hub_marks`：集收号/集收标记关系。
|
||||
|
||||
### 接口映射
|
||||
|
||||
- `IF-REV-001`：客户档案、账户状态、联系人与水表绑定关系查询。
|
||||
- `IF-CS-001`、`IF-CS-002`：客户服务侧账户绑定与信息查询场景复用客户域数据。
|
||||
|
||||
### 落地边界
|
||||
|
||||
- **已落地**：客户主档、账户、联系人、分组、绑定、开票、托收/代扣关系。
|
||||
@ -121,6 +156,12 @@ flowchart TD
|
||||
- `biz_cost_component`：费用组成。
|
||||
- `biz_water_use_scheme`、`biz_water_use_scheme_tier`：计划用水方案与阶梯。
|
||||
|
||||
### 接口映射
|
||||
|
||||
- `IF-REV-004`：抄表数据提交与异常标记。
|
||||
- `IF-REV-005`：账单生成与开账结果返回。
|
||||
- `IF-METER-004`：远传抄表数据接收后进入开账流程。
|
||||
|
||||
### 落地边界
|
||||
|
||||
- **已落地**：册本、抄表数据、上次抄表、抄表日志、营业账主明细、价格模板与阶梯规则。
|
||||
@ -169,6 +210,11 @@ flowchart TD
|
||||
- `bk_transaction_callback`：支付回调记录。
|
||||
- `bk_transaction_exception`：支付异常记录。
|
||||
|
||||
### 接口映射
|
||||
|
||||
- `IF-REV-006`：创建收费记录、执行账单核销并回写状态。
|
||||
- `IF-CS-003`、`IF-CS-007`：客户渠道与柜面扫码支付场景复用收费核销链路。
|
||||
|
||||
### 落地边界
|
||||
|
||||
- **已落地**：营业账主明细、交易流水、回调、异常、托收/代扣主对象。
|
||||
@ -183,7 +229,20 @@ flowchart TD
|
||||
|
||||
承担水量调整、金额调整、违约金减免、退款、冲正、呆坏账申请等账务修正与审批处理能力，保证收费后账务结果可追溯、可审计。
|
||||
|
||||
### 关键设计
|
||||
### 业务流程
|
||||
|
||||
```mermaid
|
||||
flowchart TD
|
||||
A[发起账务调整申请] --> B[校验账单状态与权限]
|
||||
B --> C{是否通过}
|
||||
C -->|否| D[驳回并记录原因]
|
||||
C -->|是| E[执行重算或退款冲正]
|
||||
E --> F[更新账单与明细状态]
|
||||
F --> G[写入操作日志与审批留痕]
|
||||
G --> H[返回处理结果]
|
||||
```
|
||||
|
||||
### 关键规则
|
||||
|
||||
1. 调整类操作以营业账主明细为基础，并通过日志与审批留痕记录前后变化。
|
||||
2. 水量调整、金额调整、优惠调整等场景可引用价格模板、阶梯与优惠对象重新计算。
|
||||
@ -206,6 +265,11 @@ flowchart TD
|
||||
| 错误缴费冲正 | 修正误收/误核销记录 | 需关联原交易与账单状态 |
|
||||
| 呆坏账申请 | 对长期欠费进行分类处理 | 需结合账龄、客户状态与审批结果 |
|
||||
|
||||
### 接口映射
|
||||
|
||||
- `IF-REV-007`：账务调整、退款、冲正、坏账等处理入口。
|
||||
- `IF-REV-006`：与收费核销状态联动，确保调账后账单状态一致。
|
||||
|
||||
### 落地边界
|
||||
|
||||
- **已落地**：营业账主明细、操作日志、价格/方案相关重算支撑。
|
||||
@ -220,7 +284,20 @@ flowchart TD
|
||||
|
||||
负责发票申请、开票校验、开票结果回写、发票查询、作废与红冲处理，作为营收业务对发票服务的业务接入层。
|
||||
|
||||
### 关键设计
|
||||
### 业务流程
|
||||
|
||||
```mermaid
|
||||
flowchart TD
|
||||
A[提交发票申请] --> B[校验账单与开票信息]
|
||||
B --> C{是否满足开票条件}
|
||||
C -->|否| D[返回不可开票原因]
|
||||
C -->|是| E[生成发票申请记录]
|
||||
E --> F[调用SYS-008发票服务]
|
||||
F --> G[接收开票结果回写]
|
||||
G --> H[更新发票与账单关联状态]
|
||||
```
|
||||
|
||||
### 关键规则
|
||||
|
||||
1. 发票申请以客户信息、缴费记录、账单信息、税率配置为基础。
|
||||
2. 个人与企业开票均通过客户开票信息与税率表完成合法性校验。
|
||||
@ -233,6 +310,12 @@ flowchart TD
|
||||
- `biz_invoice_taxrate`：税率配置。
|
||||
- `biz_cust_invoice`：客户开票信息。
|
||||
|
||||
### 接口映射
|
||||
|
||||
- `IF-REV-008`：营收侧发票申请与票据状态查询。
|
||||
- `IF-CS-004`：客户侧电子发票申请入口，复用发票申请链路。
|
||||
- `IF-EXT-007`：发票结果回写协同接口（由发票服务侧回传）。
|
||||
|
||||
### 落地边界
|
||||
|
||||
- **已落地**：发票主记录、税率配置、客户开票信息。
|
||||
@ -247,7 +330,18 @@ flowchart TD
|
||||
|
||||
针对欠费账单按账龄、金额、客户类别等规则生成催缴任务，通过短信、微信、站内通知等方式触达客户，并回写催缴结果。
|
||||
|
||||
### 关键设计
|
||||
### 业务流程
|
||||
|
||||
```mermaid
|
||||
flowchart TD
|
||||
A[生成欠费客户清单] --> B[按策略分组催缴任务]
|
||||
B --> C[触发催缴接口]
|
||||
C --> D[调用SYS-010消息服务]
|
||||
D --> E[接收发送结果回写]
|
||||
E --> F[更新催缴状态与后续策略]
|
||||
```
|
||||
|
||||
### 关键规则
|
||||
|
||||
1. 催缴策略以营业账状态、欠费金额、账龄分布和客户类别为基础。
|
||||
2. 自动催缴与人工催缴可并行，支持停复水等后续处置联动。
|
||||
@ -259,6 +353,11 @@ flowchart TD
|
||||
- `biz_charge`、`biz_charge_detail`：催缴对象来源。
|
||||
- 催缴结果与通知日志：通过业务状态与消息结果联动留痕。
|
||||
|
||||
### 接口映射
|
||||
|
||||
- `IF-REV-009`：催缴名单生成、任务下发与执行结果返回。
|
||||
- `IF-EXT-008`：消息协同结果回写接口（由 `SYS-010` 协同）。
|
||||
|
||||
### 落地边界
|
||||
|
||||
- **已落地**：以营业账为基础的欠费识别与消息协同前提数据。
|
||||
@ -286,6 +385,10 @@ flowchart TD
|
||||
- 账务与收费维度：`biz_charge`、`biz_charge_detail`。
|
||||
- 渠道维度：`bk_transaction`、`bk_payment_channel`。
|
||||
|
||||
### 接口映射
|
||||
|
||||
- `IF-REV-010`：营收、收费、欠费、渠道、客户等统计查询接口。
|
||||
|
||||
### 落地边界
|
||||
|
||||
- **已落地**：主要统计源数据在客户、抄表、收费、渠道等领域均已具备。
|
||||
@ -300,7 +403,21 @@ flowchart TD
|
||||
|
||||
支持银行代收、银行代扣、实时收费、夜间批量扣款、对账与结算处理，是 SYS-002 面向 `SYS-009` 支付与银行结算能力的业务承接模块。
|
||||
|
||||
### 关键设计
|
||||
### 业务流程
|
||||
|
||||
```mermaid
|
||||
flowchart TD
|
||||
A[生成代扣批次] --> B[校验签约与待扣账单]
|
||||
B --> C[调用IF-REV-011下发批次]
|
||||
C --> D[SYS-009对接银行处理]
|
||||
D --> E[回写扣款结果]
|
||||
E --> F[执行对账与差异识别]
|
||||
F --> G{差异是否已处理}
|
||||
G -->|否| H[进入人工补偿]
|
||||
G -->|是| I[确认结算并更新状态]
|
||||
```
|
||||
|
||||
### 关键规则
|
||||
|
||||
1. 渠道、路由、接口配置、签约、交易、回调、异常、对账、结算形成完整银行业务链条。
|
||||
2. 实时收费场景由渠道交易流水驱动账单核销，批量代扣场景由签约关系与批次处理驱动。
|
||||
@ -319,6 +436,11 @@ flowchart TD
|
||||
- `bk_transaction`、`bk_transaction_callback`、`bk_transaction_exception`：交易、回调、异常。
|
||||
- `biz_collection`、`biz_withholding`：代收/代扣业务主对象。
|
||||
|
||||
### 接口映射
|
||||
|
||||
- `IF-REV-011`：代扣批次、对账与结算协同入口。
|
||||
- `IF-EXT-001`：银行代扣批次下发与回盘协同。
|
||||
|
||||
### 落地边界
|
||||
|
||||
- **已落地**：渠道、路由、交易、回调、异常、签约、批次、对账、结算等主链路对象。
|
||||
@ -346,3 +468,13 @@ flowchart TD
|
||||
- `biz_price_category`、`biz_price_template`、`biz_template_dept_rel`：价格归属与模板站点关系。
|
||||
- `biz_cust_no_rule`：客户编号规则。
|
||||
|
||||
### 接口映射
|
||||
|
||||
- `IF-REV-012`：查询与维护价格模板、业务参数、页面参数配置。
|
||||
- `IF-UP-004`：统一平台参数字典能力协同，为营收域参数提供基础字典支撑。
|
||||
|
||||
### 落地边界
|
||||
|
||||
- **已落地**：业务参数、页面配置、价格归属与模板站点关系、客户编号规则等核心配置对象。
|
||||
- **部分落地**：部分打印模板、通知策略等参数由统一平台或外部渠道参数共同承载，营收域仅保留业务侧映射。
|
||||
- **文档先行**：参数灰度发布、多版本并行生效等高级治理能力当前仅保留设计语义，不宣称为独立实现模块。
|
||||
|
||||
Loading…
x
Reference in New Issue
Block a user