tangweijie/fujian_water_biz_doc
1
0
Fork 0
Code Issues Pull Requests 12 Actions Packages Projects Releases 1 Wiki Activity

更新福建水务营收系统概要设计文档，对照操作手册补充缺失功能点，包括营收系统客户分组/集收/定额/册本、特殊开账/柜台结账/红冲、统计报表/欠费/缴费记录查询、代收实时收费/银行托收、业务参数配置，以及微网厅账户流水、机构切换/绑定/解绑/默认客户、退款/失败处理引导、预约/叫号/提醒、业务进度通知等功能模块，同步更新任务检查清单，提升功能覆盖与一致性，符合甲方A级交付标准。

Browse Source
This commit is contained in:
tangweijie 2025-08-22 13:48:35 +08:00
parent 694866eea0
commit 6c0cb35982
11 changed files with 1028 additions and 307 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

BIN
output/新-数据库设计说明书.docx
View File

Binary file not shown.

4
output/新-数据库设计说明书_processed.md
View File

@ -3309,14 +3309,14 @@ CJKmainfont: "PingFang SC"
**图表 1**
![图表 1](temp_mermaid_新-数据库设计说明书_47335/diagram_1.png)
![图表 1](temp_mermaid_新-数据库设计说明书_25255/diagram_1.png)
### 业务核心表关系图
**图表 2**
![图表 2](temp_mermaid_新-数据库设计说明书_47335/diagram_2.png)
![图表 2](temp_mermaid_新-数据库设计说明书_25255/diagram_2.png)
## 业务视图设计

BIN
output/新-概要设计说明书.docx
View File

Binary file not shown.

911
output/新-概要设计说明书_processed.md
View File

File diff suppressed because it is too large Load Diff

BIN
output/新-详细设计说明书.docx
View File

Binary file not shown.

64
output/新-详细设计说明书_processed.md
View File

@ -548,7 +548,7 @@ CJKmainfont: "PingFang SC"
**图表 1**
![图表 1](temp_mermaid_新-详细设计说明书_47335/diagram_1.png)
![图表 1](temp_mermaid_新-详细设计说明书_25255/diagram_1.png)
### 系统数据流向图
@ -556,7 +556,7 @@ CJKmainfont: "PingFang SC"
**图表 2**
![图表 2](temp_mermaid_新-详细设计说明书_47335/diagram_2.png)
![图表 2](temp_mermaid_新-详细设计说明书_25255/diagram_2.png)
### 表现层
@ -590,7 +590,7 @@ CJKmainfont: "PingFang SC"
**图表 3**
![图表 3](temp_mermaid_新-详细设计说明书_47335/diagram_3.png)
![图表 3](temp_mermaid_新-详细设计说明书_25255/diagram_3.png)
### 容器化部署架构
@ -598,7 +598,7 @@ CJKmainfont: "PingFang SC"
**图表 4**
![图表 4](temp_mermaid_新-详细设计说明书_47335/diagram_4.png)
![图表 4](temp_mermaid_新-详细设计说明书_25255/diagram_4.png)
### 硬件配置规格表
@ -1089,7 +1089,7 @@ h、**错误响应码**
**图表 5**
![图表 5](temp_mermaid_新-详细设计说明书_47335/diagram_5.png)
![图表 5](temp_mermaid_新-详细设计说明书_25255/diagram_5.png)
###### 数据设计
@ -1124,7 +1124,7 @@ h、**错误响应码**
**图表 6**
![图表 6](temp_mermaid_新-详细设计说明书_47335/diagram_6.png)
![图表 6](temp_mermaid_新-详细设计说明书_25255/diagram_6.png)
###### 业务规则
@ -1291,7 +1291,7 @@ f、**响应参数**
**图表 7**
![图表 7](temp_mermaid_新-详细设计说明书_47335/diagram_7.png)
![图表 7](temp_mermaid_新-详细设计说明书_25255/diagram_7.png)
###### 数据设计
@ -1425,7 +1425,7 @@ f、**响应参数**
**图表 8**
![图表 8](temp_mermaid_新-详细设计说明书_47335/diagram_8.png)
![图表 8](temp_mermaid_新-详细设计说明书_25255/diagram_8.png)
###### 输入输出数据
@ -1528,7 +1528,7 @@ f、**响应参数**
**图表 9**
![图表 9](temp_mermaid_新-详细设计说明书_47335/diagram_9.png)
![图表 9](temp_mermaid_新-详细设计说明书_25255/diagram_9.png)
###### 数据设计
@ -1589,7 +1589,7 @@ f、**响应参数**
**图表 10**
![图表 10](temp_mermaid_新-详细设计说明书_47335/diagram_10.png)
![图表 10](temp_mermaid_新-详细设计说明书_25255/diagram_10.png)
###### 数据设计
@ -1650,7 +1650,7 @@ f、**响应参数**
**图表 11**
![图表 11](temp_mermaid_新-详细设计说明书_47335/diagram_11.png)
![图表 11](temp_mermaid_新-详细设计说明书_25255/diagram_11.png)
###### 数据设计
@ -1710,7 +1710,7 @@ f、**响应参数**
**图表 12**
![图表 12](temp_mermaid_新-详细设计说明书_47335/diagram_12.png)
![图表 12](temp_mermaid_新-详细设计说明书_25255/diagram_12.png)
###### 数据设计
@ -1771,7 +1771,7 @@ f、**响应参数**
**图表 13**
![图表 13](temp_mermaid_新-详细设计说明书_47335/diagram_13.png)
![图表 13](temp_mermaid_新-详细设计说明书_25255/diagram_13.png)
###### 数据设计
@ -1832,7 +1832,7 @@ f、**响应参数**
**图表 14**
![图表 14](temp_mermaid_新-详细设计说明书_47335/diagram_14.png)
![图表 14](temp_mermaid_新-详细设计说明书_25255/diagram_14.png)
###### 数据设计
@ -1910,7 +1910,7 @@ f、**响应参数**
**图表 15**
![图表 15](temp_mermaid_新-详细设计说明书_47335/diagram_15.png)
![图表 15](temp_mermaid_新-详细设计说明书_25255/diagram_15.png)
###### 数据设计
@ -1988,7 +1988,7 @@ f、**响应参数**
**图表 16**
![图表 16](temp_mermaid_新-详细设计说明书_47335/diagram_16.png)
![图表 16](temp_mermaid_新-详细设计说明书_25255/diagram_16.png)
###### 数据设计
@ -2143,7 +2143,7 @@ f、**响应参数**
**图表 17**
![图表 17](temp_mermaid_新-详细设计说明书_47335/diagram_17.png)
![图表 17](temp_mermaid_新-详细设计说明书_25255/diagram_17.png)
###### 数据设计
@ -2190,7 +2190,7 @@ f、**响应参数**
**图表 18**
![图表 18](temp_mermaid_新-详细设计说明书_47335/diagram_18.png)
![图表 18](temp_mermaid_新-详细设计说明书_25255/diagram_18.png)
###### 业务规则
@ -2238,7 +2238,7 @@ f、**响应参数**
**图表 19**
![图表 19](temp_mermaid_新-详细设计说明书_47335/diagram_19.png)
![图表 19](temp_mermaid_新-详细设计说明书_25255/diagram_19.png)
###### 业务规则
@ -2271,7 +2271,7 @@ f、**响应参数**
**图表 20**
![图表 20](temp_mermaid_新-详细设计说明书_47335/diagram_20.png)
![图表 20](temp_mermaid_新-详细设计说明书_25255/diagram_20.png)
###### 业务规则
@ -2304,7 +2304,7 @@ f、**响应参数**
**图表 21**
![图表 21](temp_mermaid_新-详细设计说明书_47335/diagram_21.png)
![图表 21](temp_mermaid_新-详细设计说明书_25255/diagram_21.png)
###### 业务规则
@ -2588,14 +2588,14 @@ f、**响应参数**
**图表 22**
![图表 22](temp_mermaid_新-详细设计说明书_47335/diagram_22.png)
![图表 22](temp_mermaid_新-详细设计说明书_25255/diagram_22.png)
- 申请受理阶段
**图表 23**
![图表 23](temp_mermaid_新-详细设计说明书_47335/diagram_23.png)
![图表 23](temp_mermaid_新-详细设计说明书_25255/diagram_23.png)
- 现场勘查设计阶段
@ -2603,7 +2603,7 @@ f、**响应参数**
**图表 24**
![图表 24](temp_mermaid_新-详细设计说明书_47335/diagram_24.png)
![图表 24](temp_mermaid_新-详细设计说明书_25255/diagram_24.png)
- 工程施工阶段
@ -2611,7 +2611,7 @@ f、**响应参数**
**图表 25**
![图表 25](temp_mermaid_新-详细设计说明书_47335/diagram_25.png)
![图表 25](temp_mermaid_新-详细设计说明书_25255/diagram_25.png)
- 验收移交阶段
@ -2619,7 +2619,7 @@ f、**响应参数**
**图表 26**
![图表 26](temp_mermaid_新-详细设计说明书_47335/diagram_26.png)
![图表 26](temp_mermaid_新-详细设计说明书_25255/diagram_26.png)
###### 业务规则
@ -2967,7 +2967,7 @@ f、**响应参数**
**图表 27**
![图表 27](temp_mermaid_新-详细设计说明书_47335/diagram_27.png)
![图表 27](temp_mermaid_新-详细设计说明书_25255/diagram_27.png)
###### 界面设计要点
@ -3263,7 +3263,7 @@ flowchart TD
**图表 30**
![图表 30](temp_mermaid_新-详细设计说明书_47335/diagram_30.png)
![图表 30](temp_mermaid_新-详细设计说明书_25255/diagram_30.png)
###### 界面设计要点
@ -3601,7 +3601,7 @@ flowchart TD
**图表 32**
![图表 32](temp_mermaid_新-详细设计说明书_47335/diagram_32.png)
![图表 32](temp_mermaid_新-详细设计说明书_25255/diagram_32.png)
**接口参数：**
@ -3668,7 +3668,7 @@ flowchart TD
**图表 33**
![图表 33](temp_mermaid_新-详细设计说明书_47335/diagram_33.png)
![图表 33](temp_mermaid_新-详细设计说明书_25255/diagram_33.png)
**接口参数：**
@ -3707,7 +3707,7 @@ flowchart TD
**图表 34**
![图表 34](temp_mermaid_新-详细设计说明书_47335/diagram_34.png)
![图表 34](temp_mermaid_新-详细设计说明书_25255/diagram_34.png)
## 物联网接口
@ -3729,7 +3729,7 @@ flowchart TD
**图表 35**
![图表 35](temp_mermaid_新-详细设计说明书_47335/diagram_35.png)
![图表 35](temp_mermaid_新-详细设计说明书_25255/diagram_35.png)
## 政务系统接口

1
project_progress.md
View File

@ -160,6 +160,7 @@
| 2024-12-19 | 单点登录采用OAuth2.0协议 | 在三个设计文档中完善单点登录设计，明确采用OAuth2.0协议实现。包括：1. 详细设计说明书中新增OAuth2.0授权码模式流程、6个OAuth2.0接口设计、4个相关数据表；2. 概要设计说明书中更新单点登录模块描述，强调基于OAuth2.0协议；3. 数据库设计说明书中新增OAuth2.0客户端信息表、访问令牌表、刷新令牌表、授权码表。所有文档版本更新至V1.4 | 用户要求单点登录采用OAuth2.0协议 | 正面影响，OAuth2.0是业界标准的开放授权协议，具有良好的安全性和扩展性。支持授权码模式和客户端凭证模式，满足不同应用场景需求。完善的数据表设计支持令牌管理、客户端管理等功能，为系统的安全认证和第三方集成提供了标准化的技术基础 |
| 2024-12-19 | OAuth2.0表设计修正 | 根据实际SQL文件(oauth_table.sql)修正OAuth2.0表设计，确保文档与实际表结构保持一致。包括：1. 数据库设计说明书中更新5个OAuth2.0表的详细字段定义：system_oauth2_client、system_oauth2_access_token、system_oauth2_refresh_token、system_oauth2_code、system_oauth2_approve；2. 详细设计说明书中更新OAuth2.0数据表引用，修正表名为system_oauth2_*系列；3. 文档版本更新至V1.5 | 用户提供实际的OAuth2.0表SQL文件 | 正面影响，确保设计文档与实际SQL表结构完全一致，避免开发过程中的混乱。实际的表结构更加完善，包含了OAuth2.0批准表(system_oauth2_approve)，支持用户授权记录管理，字段设计更加规范，符合PostgreSQL数据库特性，为OAuth2.0功能的实现提供了准确的数据模型指导 |
| 2025-08-01 | 数据库对齐 | 明确约定：若`parsed_docs_new/数据库设计.md`存在对应表，以其为准；并完成关键对齐：`biz_meter_caliber`新增`code`字段，`meter_info`补充源设计字段，新增标准表`system_user_form_config`并保留`infra_user_form_config`兼容说明；在`新-详细/概要设计说明书.md`中加入统一对齐声明 | 对齐源数据库设计 | 正面影响，数据库定义一致性提升，开发实施口径统一，减少后续返工 |
| 2025-08-18 | 功能点对齐 | 对照《福建水投营收系统操作手册》《福建水投微网厅操作手册》，补充概要设计缺失功能点：客户分组/集收/定额/册本、特殊开账/柜台结账/红冲、统计报表/欠费/缴费记录查询、代收实时收费/银行托收、业务参数配置；微网厅账户流水、机构切换/绑定/解绑/默认客户、退款/失败处理引导、预约/叫号/提醒、业务进度通知 | 与操作手册保持一致 | 正面影响，提升功能覆盖与一致性 |
| 2024-12-19 | 业务工单模块设计整合 | 参考营收系统详细设计说明书，在新版设计文档中新增业务工单模块，并将表务系统的工单管理功能整合到业务工单中。包括：1. 详细设计说明书中新增营收系统模块9-业务工单，包含业务清单管理、上报清单管理、稽查工单管理、换表工单管理4个功能模块；2. 概要设计说明书中同步新增业务工单模块描述，调整表务系统模块结构；3. 数据库设计说明书中新增4个业务工单相关表：business_work_order、report_work_order、audit_work_order、work_order_log，并更新总表数量为147个 | 用户要求参考营收系统详细设计说明书添加业务工单模块，并将表务工单管理整合到业务工单中 | 正面影响，实现了工单管理的统一化设计，避免了功能重复。业务工单模块覆盖了客户服务、账务处理、投诉建议、故障报修等全业务场景，支持工单全生命周期管理。表务系统专注于仓库管理和设备档案管理，功能边界更加清晰。新增的4个工单表设计完善了工单数据模型，支持不同类型工单的差异化管理需求 |
| 2024-12-19 | 概要设计文档目录结构调整 | 按照用户要求调整新-概要设计说明书.md的目录结构，重新组织为：2系统总体设计、2.1任务概述、2.2设计概述、2.3系统架构设计、2.4子系统定义。参照202-营业收费管理系统需求规格说明书的任务概述写法，结合现有内容编写任务概述部分，包含系统总体目标、功能范围、系统涉众与用户特点。重新调整系统架构设计章节，分为逻辑架构设计和物理架构设计两个部分 | 用户要求按照标准的概要设计文档目录结构进行调整 | 正面影响，文档结构更加标准化和规范化，符合概要设计文档的标准格式要求。任务概述部分更加完整，包含了项目背景、目标、功能范围等关键信息。系统架构设计章节结构更加清晰，便于理解和使用 |
| 2024-12-19 | 微网厅子系统新增 | 根据福建水投微网厅操作手册，在新-概要设计说明书.md中新增微网厅子系统设计。包括：1. 新增子系统7-微网厅系统，设计6个核心模块：账户绑定管理、信息查询服务、在线缴费服务、电子发票服务、营业网点服务、业务办理服务；2. 更新子系统列表和关系图，将微网厅从客户服务中分离为独立子系统；3. 新增微网厅系统对外接口定义，包含5个主要接口；4. 完整的模块架构设计和业务流程图 | 用户要求根据微网厅操作手册添加微网厅子系统 | 正面影响，微网厅系统作为独立子系统，功能边界更加清晰，覆盖了基于微信公众号的完整客户服务流程。设计6个模块完整覆盖了用户认证、信息查询、在线缴费、发票管理、网点服务、业务办理等全流程，提供了完整的技术架构和业务流程设计，为微网厅的实际开发提供了全面的指导 |

4
scripts/unified_export.sh
View File

@ -657,9 +657,9 @@ main() {
# "water_biz_deployment_design.md"
# "water_biz_security_design.md"
# "water_biz_overview_design.md"
"新-详细设计说明书.md"
# "新-详细设计说明书.md"
"新-概要设计说明书.md"
"新-数据库设计说明书.md"
# "新-数据库设计说明书.md"
)
local processed_count=0

8
task_checklist.md
View File

@ -201,6 +201,14 @@
- [x] 将工单从营收系统中剥离为SYS-005 ✅
- [x] 更新子系统列表与关系图 ✅
- [x] 新增工单系统接口与架构图 ✅
### 📋 功能点对齐（操作手册 → 概要设计）(2025-08-18)
- [x] 营收系统：客户分组/集收/定额/册本功能补充 ✅
- [x] 营业收费：特殊开账/柜台结账/红冲子项补充 ✅
- [x] 统计分析：报表查询/欠费查询/缴费记录补充 ✅
- [x] 代收业务：实时收费/银行托收补充（经SYS-009）✅
- [x] 业务参数配置模块新增（价格体系/水表参数/基础配置）✅
- [x] 微网厅：账户流水、机构切换/绑定/解绑/默认客户、退款/失败处理引导、预约/叫号/提醒、业务进度通知补充 ✅
### 📋 安全设计完善

232
新-概要设计说明书.md
View File

@ -19,6 +19,7 @@
| 2025-08-01 | V1.3 | 唐伟杰 | 数据库系统变更：将OpenGauss替换为达梦数据库 8.0+，更新所有相关架构图和技术描述。 |
| 2025-08-01 | V1.4 | 唐伟杰 | 单点登录采用OAuth2.0+CAS协议：更新单点登录模块描述，强调基于OAuth2.0+CAS协议实现。 |
| 2025-08-18 | V1.5 | 唐伟杰 | 架构调整：将营收业务系统中的工单、表务、报装剥离为独立子系统（SYS-005/006/007），更新目录、功能范围、子系统列表、关系图与接口定义；保留客户服务模块在营收业务系统中的作用。 |
| 2025-08-18 | V1.6 | 唐伟杰 | 将第三方支付能力自SYS-009拆分为独立基础服务子系统（SYS-010 第三方支付子系统）；更新总体目标、功能范围、接口定义、子系统列表与相关架构图。 |
# 目录
@ -42,7 +43,8 @@
- [SYS-006 表务管理系统](#sys-006-表务管理系统)
- [SYS-007 报装业务系统](#sys-007-报装业务系统)
- [SYS-008 发票服务子系统（基础服务）](#sys-008-发票服务子系统基础服务)
- [SYS-009 支付与银行对接子系统（基础服务）](#sys-009-支付与银行对接子系统基础服务)
- [SYS-009 银行对接子系统（基础服务）](#sys-009-银行对接子系统基础服务)
- [SYS-010 第三方支付子系统（基础服务）](#sys-010-第三方支付子系统基础服务)
- [系统涉众与用户特点](#系统涉众与用户特点)
- [设计概述](#设计概述)
- [总体约束](#总体约束)
@ -103,6 +105,7 @@
- [模块6: 催缴管理](#模块6-催缴管理)
- [模块7: 统计分析](#模块7-统计分析)
- [模块8: 代收业务](#模块8-代收业务)
- [模块9: 业务参数配置](#模块9-业务参数配置)
- [客户服务模块群补充说明](#客户服务模块群补充说明)
- [子系统3设计: 手机抄表APP](#子系统3设计-手机抄表app)
- [任务概述](#任务概述-3)
@ -138,6 +141,8 @@
- [模块4: 电子发票服务](#模块4-电子发票服务)
- [模块5: 营业网点服务](#模块5-营业网点服务)
- [模块6: 业务办理服务](#模块6-业务办理服务)
- [模块7: 账户流水](#模块7-账户流水)
- [模块8: 账号与机构管理](#模块8-账号与机构管理)
- [关键技术特性](#关键技术特性)
- [微信平台集成](#微信平台集成)
- [响应式设计](#响应式设计)
@ -179,7 +184,7 @@
- [模块描述](#模块描述-6)
- [模块间关系](#模块间关系-7)
- [模块描述](#模块描述-7)
- [子系统9设计: 支付与银行对接子系统](#子系统9设计-支付与银行对接子系统)
- [子系统9设计: 银行对接子系统](#子系统9设计-银行对接子系统)
- [任务概述](#任务概述-9)
- [设计概述](#设计概述-9)
- [总体约束](#总体约束-7)
@ -189,6 +194,16 @@
- [模块定义](#模块定义-8)
- [模块间关系](#模块间关系-8)
- [模块描述](#模块描述-8)
- [子系统10设计: 第三方支付子系统](#子系统10设计-第三方支付子系统)
- [任务概述](#任务概述-10)
- [设计概述](#设计概述-10)
- [总体约束](#总体约束-8)
- [设计方案概述](#设计方案概述-9)
- [子系统外部接口](#子系统外部接口-9)
- [子系统架构设计](#子系统架构设计-9)
- [模块定义](#模块定义-9)
- [模块间关系](#模块间关系-9)
- [模块描述](#模块描述-9)
- [非功能性需求的设计](#非功能性需求的设计)
- [性能的考虑](#性能的考虑)
- [兼容性的考虑](#兼容性的考虑)
@ -277,7 +292,7 @@
营业收费系统采用分层解耦与子系统化建设，形成“业务服务层 + 基础服务层”的整体架构：
- 业务服务层：SYS-001 统一平台、SYS-002 营收业务系统、SYS-003 手机抄表APP、SYS-004 微网厅系统、SYS-005 工单管理系统、SYS-006 表务管理系统、SYS-007 报装业务系统
- 基础服务层：SYS-008 发票服务子系统（统一开票）、SYS-009 支付与银行对接子系统（统一支付/代扣）
- 基础服务层：SYS-008 发票服务子系统（统一开票）、SYS-009 银行对接子系统（统一代扣/对账/加解密）、SYS-010 第三方支付子系统（统一聚合支付）
通过系统的建设，实现福建省水投数字科技有限公司客户服务管理领域的业务流程梳理再造、组织架构的优化、管理制度的建设、绩效考核标准的建设。构建以客户为中心的一体化客户服务平台，将客户的所有信息进行有机的关联，方便企业对营收信息进行综合分析和管理，为客户提供更多、更便捷、更主动的个性化服务，提高客户服务的质量和客户满意度。
@ -294,7 +309,7 @@
### 功能范围
本系统功能涵盖水务企业完整的营收业务流程，包括客户资料管理、抄表开账、营业收费、账务处理、催缴管理、发票管理（经SYS-008）、表务管理、报装业务、客户服务、工单管理，以及统一支付/退款、银行代扣（经SYS-009）等；还包含查询统计与报表打印功能。
本系统功能涵盖水务企业完整的营收业务流程，包括客户资料管理、抄表开账、营业收费、账务处理、催缴管理、发票管理（经SYS-008）、表务管理、报装业务、客户服务、工单管理，以及银行代扣（经SYS-009）与聚合支付/退款（经SYS-010）等；还包含查询统计与报表打印功能。
**系统功能按子系统分布如下：**
@ -311,7 +326,7 @@
- 数据同步与个人管理：任务下载/数据上传（离线支持）、个人信息与设置
#### SYS-004 微网厅系统
- 账户绑定、账单/用水查询、在线缴费（经SYS-009）、电子发票查看（经SYS-008）、营业网点、业务办理
- 账户绑定、账单/用水查询、在线缴费（经SYS-010）、电子发票查看（经SYS-008）、营业网点、业务办理
#### SYS-005 工单管理系统
- 统一工单中心、流程引擎、监控预警、绩效统计，打通营收/表务/报装/微网厅/APP
@ -325,8 +340,11 @@
#### SYS-008 发票服务子系统（基础服务）
- 统一开票/作废与红冲/查询、供应商适配（航天优先、预留博思）、回执处理与存证
#### SYS-009 支付与银行对接子系统（基础服务）
- 统一支付/退款、银行代扣（送盘/回盘）、对账文件处理、加解密/签名，统一接入微信/支付宝/银联/银行
#### SYS-009 银行对接子系统（基础服务）
- 银行代扣（送盘/回盘）、对账文件处理、加解密/签名
#### SYS-010 第三方支付子系统（基础服务）
- 统一聚合支付/退款、渠道适配（微信/支付宝/银联聚合等）、支付结果通知
### 系统涉众与用户特点
@ -446,7 +464,7 @@
**基础服务层（Infrastructure Service Layer）**
- 提供通用的技术服务能力
- 包含权限、工作流、消息、文件、发票服务（统一开票能力）、支付与银行对接服务（统一支付/代扣能力）等基础服务
- 包含权限、工作流、消息、文件、发票服务（统一开票能力）、银行对接服务（代扣/对账/加解密）、第三方支付服务（聚合支付/退款）等基础服务
- 为业务服务提供统一的技术支撑
**数据层（Data Layer）**
@ -736,7 +754,8 @@ graph TB
| SYS-006 | 表务管理系统 | 表务基础管理、仓库与库存管理、设备档案管理 | 自行开发 |
| SYS-007 | 报装业务系统 | 报装流程管理、工程管理、档案管理 | 自行开发 |
| SYS-008 | 发票服务子系统 | 统一开票网关、供应商适配器（优先对接航天）、回执处理与存证 | 自行开发 |
| SYS-009 | 支付与银行对接子系统 | 统一支付/代扣网关、银行适配器、对账处理、加解密签名 | 自行开发 |
| SYS-009 | 银行对接子系统 | 银行代扣送盘/回盘、对账处理、加解密签名 | 自行开发 |
| SYS-010 | 第三方支付子系统 | 聚合支付/退款、渠道适配（微信/支付宝/银联）、支付通知 | 自行开发 |
### 子系统间关系
@ -782,8 +801,12 @@ graph TB
INVOICE_SYS[统一开票网关<br/>供应商适配器<br/>回执/存证]
end
subgraph "SYS-009 支付与银行对接子系统"
PAY_SYS[统一支付/代扣网关<br/>银行适配器<br/>对账处理]
subgraph "SYS-009 银行对接子系统"
PAY_BANK[代扣送盘/回盘<br/>银行适配器<br/>对账处理]
end
subgraph "SYS-010 第三方支付子系统"
PAY_TP[聚合支付/退款<br/>渠道适配<br/>支付通知]
end
%% 统一平台权限管理
@ -799,7 +822,8 @@ graph TB
REV_CORE -.->|库存状态/换表结果| METER_SYS
REV_CORE -.->|立户/工程结果| INSTALL_SYS
REV_CORE -.->|开票申请/作废/红冲| INVOICE_SYS
REV_CORE -.->|账单支付/代扣/对账| PAY_SYS
REV_CORE -.->|银行代扣/对账| PAY_BANK
REV_CORE -.->|聚合支付/退款| PAY_TP
REV_CORE -.->|业务异常/流程触发| WO_CENTER
CS_MOD -.->|客户申请/服务工单| WO_CENTER
@ -819,7 +843,7 @@ graph TB
WECHAT -.->|业务申请/服务工单| WO_CENTER
REV_CORE -.->|账单信息/缴费状态| WECHAT
INVOICE_SYS -.->|电子发票链接/推送| WECHAT
PAY_SYS -.->|支付结果通知| WECHAT
PAY_TP -.->|支付结果通知| WECHAT
WO_CENTER -.->|办理进度/结果通知| WECHAT
%% 样式定义
@ -878,7 +902,7 @@ graph TB
| 微信授权接口 | 处理微信用户授权登录 | 微信平台 | HTTP/REST |
| 账户绑定接口 | 处理用户账户绑定 | 微信客户端 | HTTP/REST |
| 账单查询接口 | 查询客户账单信息 | 微信客户端 | HTTP/REST |
| 缴费处理接口 | 处理在线缴费业务（经SYS-009） | 微信客户端 | HTTP/REST |
| 缴费处理接口 | 处理在线缴费业务（经SYS-010） | 微信客户端 | HTTP/REST |
| 业务申请接口 | 处理各类业务申请 | 微信客户端 | HTTP/REST |
| 电子发票查看接口 | 发票查看/下载 | 微信客户端 | HTTP/REST |
@ -909,15 +933,21 @@ graph TB
| 发票查询接口 | 查询发票状态/链接 | 营收/微网厅 | HTTP/REST |
| 供应商路由接口 | 供应商选择与路由（航天/博思/…） | 发票适配器 | 内部SPI |
**支付与银行对接子系统对外接口**
**银行对接子系统对外接口（SYS-009）**
| 接口名称 | 接口描述 | 调用方 | 接口协议 |
|---------|----------|--------|-----------|
| 统一支付接口 | 实时支付/退款 | 营收/微网厅 | HTTP/REST |
| 代扣送盘接口 | 代扣文件送盘 | 营收系统 | SFTP/HTTP |
| 代扣回盘接口 | 回盘解析与状态回填 | 营收系统 | SFTP/HTTP |
| 对账文件接口 | 银行对账文件处理 | 营收系统 | SFTP |
**第三方支付子系统对外接口（SYS-010）**
| 接口名称 | 接口描述 | 调用方 | 接口协议 |
|---------|----------|--------|-----------|
| 统一支付接口 | 聚合支付下单/关闭/退款 | 营收/微网厅 | HTTP/REST |
| 支付结果回调接口 | 渠道回调签名校验与结果入账 | 微网厅/营收 | HTTP/REST |
| 接口名称 | 接口描述 | 调用方 | 接口协议 |
|---------|----------|--------|-----------|
| 报装申请接口 | 提交报装信息与材料 | 微网厅/营收 | HTTP/REST |
@ -1512,6 +1542,16 @@ graph TB
- 模糊查询支持
- 高级筛选功能
**子功能扩展：**
- 客户分组：客户分组管理、分组内客户管理
- 集收管理：集收号管理、集收号内客户管理
- 立户建档：手工建档、批量立户
- 定额管理：定额共享（主/子客户）、定额核定
- 批量修改：手工修改、模板导入修改
- 客户业务办理：换表、加抄、更名、过户、低保、调价、停用/启用、注销/恢复
- 电子档案：高拍仪/附件采集与档案管理
**业务规则：**
- 客户编号系统自动生成，格式：部门代码+年份+6位流水号
@ -1545,6 +1585,14 @@ graph TB
- 账单生成
- 开账确认
**子功能扩展：**
- 册本信息：册本查询、册本详情
- 册本调整：新卡入册、册内序号调整、册本间调整
- 抄表录入：按册本/按抄表员、导入抄表数据
- 复核开账：复核开账查询/汇总、复核与开账
- 开账记录：历史查询与导出
**业务流程图：**
```mermaid
@ -1614,6 +1662,12 @@ flowchart TD
- 托收业务
- 自动扣费
**子功能扩展：**
- 特殊开账：特殊情形直接开账及查询导出
- 柜台结账：结账、红冲、打印凭证
- 红冲记录：红冲查询与导出
**业务流程图：**
```mermaid
@ -1715,6 +1769,9 @@ flowchart TD
- **收费统计**: 统计不同收费渠道、方式的收费情况。
- **欠费分析**: 多维度分析欠费构成和趋势。
- **自定义报表**: 提供灵活的报表自定义工具。
- **报表查询**: 业务分类报表树、统计条件与结果导出。
- **欠费查询**: 按账期/金额等条件查询客户欠费。
- **缴费记录**: 缴费记录检索与导出。
#### 模块8: 代收业务
@ -1727,6 +1784,23 @@ flowchart TD
- **银行代扣**: 与银行签订协议，实现自动批量扣费。
- **第三方支付**: 集成微信、支付宝等支付网关。
- **对账管理**: 定期与各渠道进行账务核对。
- **实时收费**: 渠道实时缴费处理（对接SYS-009）。
- **银行托收**: 托收文件处理与状态跟踪（对接SYS-009）。
#### 模块9: 业务参数配置
**功能概述：**
集中管理与营收业务相关的参数与基础资料，提升配置一致性与运营效率。
**核心功能：**
- 水表参数：水表厂家、型号、口径、量程
- 地址参数：营业站点、所属小区
- 价格体系：水价归属、费用组成、水价调整、调价历史、优惠方案、用水方案
- 基本配置：打印维护、自定义列、日志管理、水司账户、发票税率、银行信息、抄表状态、词语信息、参数配置
**备注：** 原“工程管理（工程申请/查询）”能力已并入`SYS-007 报装业务系统`统一承载。
#### 客户服务模块群补充说明
@ -1965,6 +2039,8 @@ graph TB
| WECHAT-004 | 电子发票服务 | 发票查看、发票推送、电子发票管理 | 中 |
| WECHAT-005 | 营业网点服务 | 网点查询、地图导航、距离计算 | 中 |
| WECHAT-006 | 业务办理服务 | 联系方式变更、开票方式变更、更名过户、水价变更、低保申请、换表申请、自主抄表 | 中 |
| WECHAT-007 | 账户流水 | 账户历史缴费流水查询与导出 | 中 |
| WECHAT-008 | 账号与机构管理 | 切换机构、添加/解绑客户、设置默认客户、客户详情 | 中 |
### 模块间关系
@ -2023,6 +2099,7 @@ sequenceDiagram
- 缴费记录查询
- 停水公告查看
- 账户基本信息查看
- 账户流水：缴费流水、付费汇总、导出
**接口依赖**：
- 营收业务系统客户信息接口
@ -2039,6 +2116,7 @@ sequenceDiagram
- 代缴功能
- 缴费确认
- 缴费结果查询
- 退款/失败处理引导
**支付流程**：
```mermaid
@ -2077,6 +2155,7 @@ sequenceDiagram
- 距离计算
- 营业时间查看
- 联系方式查看
- 预约/排队叫号/预约提醒（如启用）
#### 模块6: 业务办理服务
@ -2090,6 +2169,25 @@ sequenceDiagram
- 低保申请
- 换表申请
- 自主抄表上报
- 业务进度查询与消息通知
#### 模块7: 账户流水
**功能职责**：展示绑定客户的历史缴费流水与汇总。
**主要功能**：
- 流水列表、筛选与导出
- 账期/渠道统计汇总
#### 模块8: 账号与机构管理
**功能职责**：管理微信账号下的绑定客户与机构切换。
**主要功能**：
- 切换用水机构
- 添加/解绑绑定客户
- 设置默认客户
- 查看客户详情
**业务办理流程**：
```mermaid
@ -2430,29 +2528,28 @@ graph TD
- INST-PROJ 工程管理：计划排程、资源与材料、质量与安全检查、进度监控。
- INST-ARCH 档案管理：资料采集、签署与留痕、竣工档案归档与查询。
# 子系统9设计: 支付与银行对接子系统
# 子系统9设计: 银行对接子系统
## 任务概述
支付与银行对接子系统（SYS-009）统一承载实时支付、退款、银行代扣（送盘/回盘）、对账文件处理与安全加解密/签名能力，为营收系统与微网厅提供标准化、可扩展、合规可观测的金融对接能力。
银行对接子系统（SYS-009）统一承载银行代扣（送盘/回盘）、对账文件处理与安全加解密/签名能力，为营收系统提供标准化、可扩展、合规可观测的银行侧对接能力。
## 设计概述
### 总体约束
- 多渠道统一：支持微信、支付宝、银联与各银行代扣统一接入
- 银行渠道统一：支持各银行代扣统一接入
- 安全合规：SM2/SM4/3DES等算法，加解密/签名/验签；支持GBK/UTF-8编码要求
- 高可用与可观测：失败重试、限流熔断、事务保障、链路追踪与告警
### 设计方案概述
- 采用“统一支付/代扣网关 + 银行适配器 + 对账处理 + 加解密/签名”的分层模型；对上提供REST接口，对下通过HTTP/SFTP/SDK与银行/支付机构对接。
- 采用“代扣网关 + 银行适配器 + 对账处理 + 加解密/签名”的分层模型；对上提供REST接口，对下通过HTTP/SFTP/SDK与银行系统对接。
### 子系统外部接口
| 接口编号 | 接口名称 | 功能描述 | 调用方 |
|---|---|---|---|
| PAY-001 | 统一支付接口 | 实时支付/退款 | 营收/微网厅 |
| PAY-002 | 代扣送盘接口 | 代扣文件送盘 | 营收系统 |
| PAY-003 | 代扣回盘接口 | 回盘解析/状态回填 | 营收系统 |
| PAY-004 | 对账文件接口 | 银行对账文件处理 | 营收系统 |
@ -2461,8 +2558,8 @@ graph TD
```mermaid
graph TB
subgraph "支付与银行对接子系统"
GW[统一支付/代扣网关]
subgraph "银行对接子系统"
GW[代扣网关]
ADP_BANK[银行适配器]
RECON[对账处理]
CRYPTO[加解密/签名]
@ -2470,16 +2567,13 @@ graph TB
subgraph "上游系统"
REV[营收业务系统]
WECHAT[微网厅]
end
subgraph "外部机构"
BANK[银行]
PSP[第三方支付]
end
REV -.->|PAY-001/002/003/004| GW
WECHAT -.->|支付下单/结果| GW
REV -.->|PAY-002/003/004| GW
GW --> ADP_BANK --> BANK
ADP_BANK -.-> PSP
ADP_BANK -.-> RECON
@ -2490,8 +2584,8 @@ graph TB
| 模块编号 | 模块名称 | 功能描述 |
|---|---|---|
| PAY-GW | 统一支付/代扣网关 | 统一鉴权、参数校验、路由与限流、幂等控制 |
| PAY-ADP | 银行适配器 | 对接银行/支付机构协议、字段映射、错误码转换、编码/文件规范适配 |
| PAY-GW | 代扣网关 | 统一鉴权、参数校验、路由与限流、幂等控制 |
| PAY-ADP | 银行适配器 | 对接银行协议、字段映射、错误码转换、编码/文件规范适配 |
| PAY-RECON | 对账处理 | 对账文件接收/解析、差错处理、账务回填、对账报告 |
| PAY-CRYPTO | 加解密/签名 | SM2/SM4/3DES等算法实现与密钥管理、签名/验签 |
@ -2510,6 +2604,86 @@ graph TD
- PAY-RECON 对账处理：定时拉取/解析对账文件、差异识别、冲正/补记建议、对账报告生成、追踪链路与告警。
- PAY-CRYPTO 加解密/签名：国密/商密算法、密钥轮换、硬件加密机对接（可选）。
# 子系统10设计: 第三方支付子系统
## 任务概述
第三方支付子系统（SYS-010）提供统一的聚合支付/退款能力，屏蔽微信、支付宝、银联聚合等渠道差异，向上游系统提供标准化下单、关单、退款与回调验签能力。
## 设计概述
### 总体约束
- 多渠道聚合：微信/支付宝/银联聚合等统一接入
- 安全合规：签名/验签、回调防重放、幂等
- 高可用：限流熔断、重试补偿、灰度发布
### 设计方案概述
- 采用“聚合支付网关 + 渠道适配器 + 回调处理 + 对账对齐（可选）”分层；对上REST接口，对下各渠道SDK/HTTP对接。
### 子系统外部接口
| 接口编号 | 接口名称 | 功能描述 | 调用方 |
|---|---|---|---|
| TP-001 | 统一支付下单接口 | JSAPI/扫码/APP下单 | 营收/微网厅 |
| TP-002 | 统一关单接口 | 订单关闭/撤销 | 营收/微网厅 |
| TP-003 | 统一退款接口 | 原路/部分退款 | 营收/微网厅 |
| TP-004 | 支付回调接口 | 渠道回调验签入账 | 微网厅/营收 |
## 子系统架构设计
```mermaid
graph TB
subgraph "第三方支付子系统"
GW[聚合支付网关]
ADP[渠道适配器]
CB[回调处理]
end
subgraph "上游系统"
REV[营收业务系统]
WECHAT[微网厅]
end
subgraph "支付渠道"
WX[微信]
ALI[支付宝]
UPG[银联聚合]
end
REV -.->|TP-001/002/003| GW
WECHAT -.->|下单/查询| GW
GW --> ADP --> WX
ADP --> ALI
ADP --> UPG
WX -.-> CB
ALI -.-> CB
UPG -.-> CB
```
## 模块定义
| 模块编号 | 模块名称 | 功能描述 |
|---|---|---|
| TP-GW | 聚合支付网关 | 鉴权、参数校验、幂等、路由与限流 |
| TP-ADP | 渠道适配器 | 渠道参数映射、签名/验签、错误码转换 |
| TP-CB | 回调处理 | 回调验签、订单入账、补偿重试 |
### 模块间关系
```mermaid
graph TD
TP-GW --> TP-ADP --> TP-CB
TP-CB -.-> TP-GW
```
### 模块描述
- TP-GW 聚合支付网关：幂等键、重放保护、限流熔断、灰度路由。
- TP-ADP 渠道适配器：微信/支付宝/银联参数与签名规范适配、错误码转换。
- TP-CB 回调处理：回调验签、状态对齐、失败重试与告警。
# 非功能性需求的设计

111
福建水务营收系统整体架构图.html
View File

@ -109,6 +109,10 @@
gap: 10px;
}
.components.subsystems {
grid-template-columns: repeat(3, 1fr);
}
.component {
background: #f8f9fa;
border: 1px solid #dee2e6;
@ -247,6 +251,10 @@
.arrow {
transform: rotate(90deg);
}
.components.subsystems {
grid-template-columns: repeat(2, 1fr);
}
}
</style>
</head>
@ -254,7 +262,7 @@
<div class="container">
<div class="header">
<h1>福建水务营收系统整体架构图</h1>
<p>基于微服务架构的现代化水务营收管理平台 | 四大子系统完整架构</p>
<p>基于微服务架构的现代化水务营收管理平台 | 七大业务子系统 + 三大基础服务</p>
</div>
<div class="architecture">
@ -323,7 +331,7 @@
业务服务层 (Business Service Layer)
</div>
<div class="layer-description">
核心业务逻辑处理层，包含四大子系统，按业务域划分微服务，实现高内聚低耦合
核心业务逻辑处理层，包含七个业务子系统，按业务域划分微服务，实现高内聚低耦合
</div>
<!-- SYS-001 统一平台 -->
@ -353,22 +361,12 @@
<div class="component-title">营收核心模块群</div>
<div class="component-desc">客户管理、抄表开账、营业收费<br/>账务处理、发票管理、催缴管理<br/>统计分析、代收业务</div>
</div>
<div class="component">
<div class="component-title">表务管理模块群</div>
<div class="component-desc">表务基础管理、仓库库存管理<br/>设备档案管理</div>
</div>
<div class="component">
<div class="component-title">报装业务模块群</div>
<div class="component-desc">报装流程管理、工程管理<br/>档案管理</div>
</div>
<div class="component">
<div class="component-title">客户服务模块群</div>
<div class="component-desc">账户绑定、信息查询、在线缴费<br/>电子发票、营业网点、业务办理</div>
</div>
<div class="component">
<div class="component-title">工单管理模块群</div>
<div class="component-desc">业务工单中心、业务清单管理<br/>上报清单、稽查工单、换表工单</div>
</div>
</div>
</div>
@ -425,6 +423,77 @@
</div>
</div>
</div>
<!-- SYS-005 工单管理系统 -->
<div style="margin-bottom: 12px;">
<h4 style="color: #2c3e50; margin-bottom: 10px; font-size: 1.3rem; border-bottom: 2px solid #2c5282; padding-bottom: 6px;">
■ SYS-005 工单管理系统
</h4>
<div class="components">
<div class="component">
<div class="component-title">统一工单中心</div>
<div class="component-desc">受理/路由/分派/跟踪<br/>SLA策略</div>
</div>
<div class="component">
<div class="component-title">流程引擎</div>
<div class="component-desc">可视化编排、条件路由<br/>并行/互斥网关</div>
</div>
<div class="component">
<div class="component-title">监控预警</div>
<div class="component-desc">超时/积压/异常预警<br/>实时看板</div>
</div>
<div class="component">
<div class="component-title">绩效统计</div>
<div class="component-desc">环节时长、达成率<br/>考核报表</div>
</div>
</div>
</div>
<!-- SYS-006 表务管理系统 -->
<div style="margin-bottom: 12px;">
<h4 style="color: #2c3e50; margin-bottom: 10px; font-size: 1.3rem; border-bottom: 2px solid #2d5016; padding-bottom: 6px;">
■ SYS-006 表务管理系统
</h4>
<div class="components">
<div class="component">
<div class="component-title">基础参数</div>
<div class="component-desc">厂家/型号/口径/量程<br/>检定周期</div>
</div>
<div class="component">
<div class="component-title">仓库与库存</div>
<div class="component-desc">入出库/盘点/调拨<br/>库存预警</div>
</div>
<div class="component">
<div class="component-title">设备档案</div>
<div class="component-desc">电子档案、状态流转<br/>批次追溯</div>
</div>
</div>
</div>
<!-- SYS-007 报装业务系统 -->
<div style="margin-bottom: 12px;">
<h4 style="color: #2c3e50; margin-bottom: 10px; font-size: 1.3rem; border-bottom: 2px solid #8b5a3c; padding-bottom: 6px;">
■ SYS-007 报装业务系统
</h4>
<div class="components">
<div class="component">
<div class="component-title">申请受理</div>
<div class="component-desc">资料受理、资格初审<br/>工单触发</div>
</div>
<div class="component">
<div class="component-title">现场踏勘</div>
<div class="component-desc">踏勘派工与回填<br/>方案确认</div>
</div>
<div class="component">
<div class="component-title">施工管理</div>
<div class="component-desc">进度/资源/质量/安全<br/>过程留痕</div>
</div>
<div class="component">
<div class="component-title">验收通水/资料归档</div>
<div class="component-desc">竣工验收、通水<br/>档案归档</div>
</div>
</div>
</div>
</div>
<!-- 基础服务层 -->
@ -434,7 +503,7 @@
基础服务层 (Infrastructure Service Layer)
</div>
<div class="layer-description">
提供通用的技术服务能力，包含权限、工作流、消息、文件等基础服务，为业务服务提供统一的技术支撑
提供通用的技术服务能力，为业务服务提供统一的技术支撑
</div>
<div class="components">
<div class="component">
@ -454,8 +523,16 @@
<div class="component-desc">MinIO<br/>分布式文件存储</div>
</div>
<div class="component">
<div class="component-title">支付网关</div>
<div class="component-desc">微信、支付宝<br/>银行代扣</div>
<div class="component-title">发票服务子系统（SYS-008）</div>
<div class="component-desc">统一开票/作废/红冲<br/>供应商适配/回执存证</div>
</div>
<div class="component">
<div class="component-title">银行对接子系统（SYS-009）</div>
<div class="component-desc">代扣送盘/回盘<br/>对账处理/加解密</div>
</div>
<div class="component">
<div class="component-title">第三方支付子系统（SYS-010）</div>
<div class="component-desc">聚合支付/退款<br/>渠道适配/回调</div>
</div>
<div class="component">
<div class="component-title">通信服务</div>