diff --git a/output/新-数据库设计说明书.docx b/output/新-数据库设计说明书.docx index 28b9fef..c15ab40 100644 Binary files a/output/新-数据库设计说明书.docx and b/output/新-数据库设计说明书.docx differ diff --git a/output/新-数据库设计说明书_processed.md b/output/新-数据库设计说明书_processed.md index d233b6d..8c2818b 100644 --- a/output/新-数据库设计说明书_processed.md +++ b/output/新-数据库设计说明书_processed.md @@ -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) ## 业务视图设计 diff --git a/output/新-概要设计说明书.docx b/output/新-概要设计说明书.docx index 59aee80..37422ad 100644 Binary files a/output/新-概要设计说明书.docx and b/output/新-概要设计说明书.docx differ diff --git a/output/新-概要设计说明书_processed.md b/output/新-概要设计说明书_processed.md index 82b88c9..0e88aac 100644 --- a/output/新-概要设计说明书_processed.md +++ b/output/新-概要设计说明书_processed.md @@ -29,6 +29,8 @@ CJKmainfont: "PingFang SC" | 2025-08-01 | V1.2 | 唐伟杰 | 完善 APP相关的模块设计 | | 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 第三方支付子系统);更新总体目标、功能范围、接口定义、子系统列表与相关架构图。 | # 目录 @@ -48,6 +50,12 @@ CJKmainfont: "PingFang SC" - [SYS-002 营收业务系统](#sys-002-营收业务系统) - [SYS-003 手机抄表APP](#sys-003-手机抄表app) - [SYS-004 微网厅系统](#sys-004-微网厅系统) + - [SYS-005 工单管理系统](#sys-005-工单管理系统) + - [SYS-006 表务管理系统](#sys-006-表务管理系统) + - [SYS-007 报装业务系统](#sys-007-报装业务系统) + - [SYS-008 发票服务子系统(基础服务)](#sys-008-发票服务子系统基础服务) + - [SYS-009 银行对接子系统(基础服务)](#sys-009-银行对接子系统基础服务) + - [SYS-010 第三方支付子系统(基础服务)](#sys-010-第三方支付子系统基础服务) - [系统涉众与用户特点](#系统涉众与用户特点) - [设计概述](#设计概述) - [总体约束](#总体约束) @@ -85,10 +93,7 @@ CJKmainfont: "PingFang SC" - [子系统2设计: 营收业务系统](#子系统2设计-营收业务系统) - [任务概述](#任务概述-2) - [营收核心模块群](#营收核心模块群) - - [表务管理模块群](#表务管理模块群) - - [报装业务模块群](#报装业务模块群) - [客户服务模块群](#客户服务模块群) - - [工单管理模块群](#工单管理模块群) - [设计概述](#设计概述-2) - [总体约束](#总体约束-2) - [子系统外部接口](#子系统外部接口-1) @@ -97,11 +102,11 @@ CJKmainfont: "PingFang SC" - [模块定义](#模块定义-1) - [模块列表](#模块列表-1) - [营收核心模块群](#营收核心模块群-1) - - [工单管理模块群](#工单管理模块群-1) + - [客户服务模块群](#客户服务模块群-1) - [模块间关系](#模块间关系-1) - [营收核心模块群关系](#营收核心模块群关系) - - [工单管理模块群关系](#工单管理模块群关系) - [模块群间协作关系](#模块群间协作关系) + - [模块群间协作关系](#模块群间协作关系-1) - [模块描述](#模块描述-1) - [模块1: 客户资料管理](#模块1-客户资料管理) - [模块2: 抄表开账](#模块2-抄表开账) @@ -111,7 +116,8 @@ CJKmainfont: "PingFang SC" - [模块6: 催缴管理](#模块6-催缴管理) - [模块7: 统计分析](#模块7-统计分析) - [模块8: 代收业务](#模块8-代收业务) - - [模块9: 业务工单(工单管理模块群核心)](#模块9-业务工单工单管理模块群核心) + - [模块9: 业务参数配置](#模块9-业务参数配置) + - [客户服务模块群补充说明](#客户服务模块群补充说明) - [子系统3设计: 手机抄表APP](#子系统3设计-手机抄表app) - [任务概述](#任务概述-3) - [设计概述](#设计概述-3) @@ -123,9 +129,12 @@ CJKmainfont: "PingFang SC" - [模块列表](#模块列表-2) - [模块间关系](#模块间关系-2) - [模块描述](#模块描述-2) - - [模块1: 表务基础管理](#模块1-表务基础管理) - - [模块2: 仓库与库存管理](#模块2-仓库与库存管理) - - [模块3: 设备档案管理](#模块3-设备档案管理) + - [模块1: 登录认证](#模块1-登录认证) + - [模块2: 首页搜索](#模块2-首页搜索) + - [模块3: 采集任务管理](#模块3-采集任务管理) + - [模块4: 现场上报](#模块4-现场上报) + - [模块5: 个人与设置](#模块5-个人与设置) + - [模块6: 数据同步](#模块6-数据同步) - [子系统4设计: 微网厅系统](#子系统4设计-微网厅系统) - [任务概述](#任务概述-4) - [设计概述](#设计概述-4) @@ -143,10 +152,69 @@ CJKmainfont: "PingFang SC" - [模块4: 电子发票服务](#模块4-电子发票服务) - [模块5: 营业网点服务](#模块5-营业网点服务) - [模块6: 业务办理服务](#模块6-业务办理服务) + - [模块7: 账户流水](#模块7-账户流水) + - [模块8: 账号与机构管理](#模块8-账号与机构管理) - [关键技术特性](#关键技术特性) - [微信平台集成](#微信平台集成) - [响应式设计](#响应式设计) - [安全保障](#安全保障) +- [子系统5设计: 工单管理系统](#子系统5设计-工单管理系统) + - [任务概述](#任务概述-5) + - [设计概述](#设计概述-5) + - [总体约束](#总体约束-5) + - [子系统外部接口](#子系统外部接口-4) + - [子系统架构设计](#子系统架构设计-4) + - [模块定义](#模块定义-4) + - [模块间关系](#模块间关系-4) + - [模块描述](#模块描述-4) +- [子系统6设计: 表务管理系统](#子系统6设计-表务管理系统) + - [任务概述](#任务概述-6) + - [设计概述](#设计概述-6) + - [设计方案概述](#设计方案概述-5) + - [子系统外部接口](#子系统外部接口-5) + - [子系统架构设计](#子系统架构设计-5) + - [模块定义](#模块定义-5) + - [模块间关系](#模块间关系-5) + - [模块描述](#模块描述-5) +- [子系统7设计: 报装业务系统](#子系统7设计-报装业务系统) + - [任务概述](#任务概述-7) + - [设计概述](#设计概述-7) + - [设计方案概述](#设计方案概述-6) + - [子系统外部接口](#子系统外部接口-6) + - [子系统架构设计](#子系统架构设计-6) + - [模块定义](#模块定义-6) +- [子系统8设计: 发票服务子系统](#子系统8设计-发票服务子系统) + - [任务概述](#任务概述-8) + - [设计概述](#设计概述-8) + - [总体约束](#总体约束-6) + - [设计方案概述](#设计方案概述-7) + - [子系统外部接口](#子系统外部接口-7) + - [子系统架构设计](#子系统架构设计-7) + - [模块定义](#模块定义-7) + - [模块间关系](#模块间关系-6) + - [模块描述](#模块描述-6) + - [模块间关系](#模块间关系-7) + - [模块描述](#模块描述-7) +- [子系统9设计: 银行对接子系统](#子系统9设计-银行对接子系统) + - [任务概述](#任务概述-9) + - [设计概述](#设计概述-9) + - [总体约束](#总体约束-7) + - [设计方案概述](#设计方案概述-8) + - [子系统外部接口](#子系统外部接口-8) + - [子系统架构设计](#子系统架构设计-8) + - [模块定义](#模块定义-8) + - [模块间关系](#模块间关系-8) + - [模块描述](#模块描述-8) +- [子系统10设计: 第三方支付子系统](#子系统10设计-第三方支付子系统) + - [任务概述](#任务概述-10) + - [设计概述](#设计概述-10) + - [总体约束](#总体约束-8) + - [设计方案概述](#设计方案概述-9) + - [子系统外部接口](#子系统外部接口-9) + - [子系统架构设计](#子系统架构设计-9) + - [模块定义](#模块定义-9) + - [模块间关系](#模块间关系-9) + - [模块描述](#模块描述-9) - [非功能性需求的设计](#非功能性需求的设计) - [性能的考虑](#性能的考虑) - [兼容性的考虑](#兼容性的考虑) @@ -233,59 +301,61 @@ CJKmainfont: "PingFang SC" ### 系统总体目标 -营业收费系统主要包含**统一平台、营收业务系统、手机抄表APP、微网厅系统**等四大子系统,以及相关外部接口集成。 +营业收费系统采用分层解耦与子系统化建设,形成“业务服务层 + 基础服务层”的整体架构: +- 业务服务层:SYS-001 统一平台、SYS-002 营收业务系统、SYS-003 手机抄表APP、SYS-004 微网厅系统、SYS-005 工单管理系统、SYS-006 表务管理系统、SYS-007 报装业务系统 +- 基础服务层:SYS-008 发票服务子系统(统一开票)、SYS-009 银行对接子系统(统一代扣/对账/加解密)、SYS-010 第三方支付子系统(统一聚合支付) 通过系统的建设,实现福建省水投数字科技有限公司客户服务管理领域的业务流程梳理再造、组织架构的优化、管理制度的建设、绩效考核标准的建设。构建以客户为中心的一体化客户服务平台,将客户的所有信息进行有机的关联,方便企业对营收信息进行综合分析和管理,为客户提供更多、更便捷、更主动的个性化服务,提高客户服务的质量和客户满意度。 **系统整体架构特点:** -- **统一平台**:提供基础的认证、权限、组织管理等基础服务 -- **营收业务系统**:集成所有营收相关业务功能,包含营收核心、表务管理、报装业务、客户服务、工单管理五大模块群 -- **手机抄表APP**:提供移动化现场作业工具,支持离线操作 -- **微网厅系统**:基于微信公众号的客户自助服务平台,提供线上便民服务 +- **统一平台**:提供认证、权限、组织、参数、字典等基础能力 +- **营收业务系统**:围绕客户、抄表、收费、账务、催缴、统计等核心营收流程,保留“客户服务模块群”对外服务能力 +- **手机抄表APP**:移动化现场作业,支持离线;现场问题上报与工单接收由工单系统统一承载 +- **微网厅系统**:面向公众的自助服务门户,支持绑定、查询、缴费、发票查看、业务办理 +- **工单管理系统**:统一工单中心与流程引擎,打通营收/表务/报装/微网厅/APP的全场景工单 +- **表务管理系统**:水表基础、仓库与库存、设备档案的全生命周期管理 +- **报装业务系统**:覆盖报装申请、踏勘、施工、验收、通水与档案归档的端到端流程 +- **发票服务子系统**(基础服务):统一开票网关与供应商适配(现优先对接航天,预留博思),回执与存证 +- **支付与银行对接子系统**(基础服务):统一支付/退款、银行代扣送盘/回盘、对账处理、加解密签名 ### 功能范围 -本系统功能涵盖水务企业完整的营收业务流程,包括客户资料管理、抄表开账、营业收费、账务处理、催缴管理、发票管理、表务管理、报装业务、客户服务、工单管理、银行代扣代缴、第三方支付等;还包含系统业务必要的查询统计及报表打印功能。 +本系统功能涵盖水务企业完整的营收业务流程,包括客户资料管理、抄表开账、营业收费、账务处理、催缴管理、发票管理(经SYS-008)、表务管理、报装业务、客户服务、工单管理,以及银行代扣(经SYS-009)与聚合支付/退款(经SYS-010)等;还包含查询统计与报表打印功能。 **系统功能按子系统分布如下:** #### SYS-001 统一平台 -- **认证管理**:单点登录、OAuth2.0认证、用户认证 -- **用户管理**:用户管理、角色管理、权限管理 -- **组织管理**:组织机构、部门管理、岗位管理 -- **系统管理**:系统配置、数据字典管理、参数配置 +- 认证管理(SSO/OAuth2+CAS)、用户/角色/权限、组织机构、参数/字典、审计与监控 #### SYS-002 营收业务系统 -包含五大核心模块群,实现完整的营收业务流程: - -**营收核心模块群**: -- 客户资料管理、抄表开账、营业收费、账务处理、发票管理、催缴管理、统计分析、代收业务 - -**表务管理模块群**: -- 表务基础管理、仓库与库存管理、设备档案管理 - -**报装业务模块群**: -- 报装流程管理、工程管理、档案管理 - -**客户服务模块群**: -- 账户绑定管理、信息查询服务、在线缴费服务、电子发票服务、营业网点服务、业务办理服务 - -**工单管理模块群**: -- 统一工单管理、业务工单管理、表务工单管理、报装工单管理、服务工单管理、工单流程引擎 +- 营收核心:客户资料、抄表开账、营业收费、账务处理、催缴管理、统计分析、代收业务 +- 客户服务:账户绑定、信息查询、在线缴费(经SYS-009)、电子发票(经SYS-008)、营业网点、业务办理 #### SYS-003 手机抄表APP -- **移动作业**:登录模块、首页搜索、采集任务管理、现场抄表 -- **工单处理**:换表工单、复水工单、稽查工单、问题上报 -- **数据同步**:离线作业、数据上传、任务下载 -- **个人管理**:个人信息与系统设置 +- 移动作业:登录、首页搜索、采集任务、现场抄表 +- 现场上报/工单接收:问题上报、工单接收与回填(经SYS-005) +- 数据同步与个人管理:任务下载/数据上传(离线支持)、个人信息与设置 #### SYS-004 微网厅系统 -- **账户绑定管理**:微信授权、账户绑定与解绑、多账户管理 -- **信息查询服务**:账单查询、用水历史、缴费记录、停水公告 -- **在线缴费服务**:快捷缴费、充值服务、多种支付方式 -- **电子发票服务**:发票查看、发票推送、电子发票管理 -- **营业网点服务**:网点查询、地图导航、距离计算 -- **业务办理服务**:联系方式变更、开票方式变更、更名过户、水价变更、低保申请、换表申请、自主抄表 +- 账户绑定、账单/用水查询、在线缴费(经SYS-010)、电子发票查看(经SYS-008)、营业网点、业务办理 + +#### SYS-005 工单管理系统 +- 统一工单中心、流程引擎、监控预警、绩效统计,打通营收/表务/报装/微网厅/APP + +#### SYS-006 表务管理系统 +- 表务基础(厂家/型号/口径/量程)、仓库与库存(入出库/盘点/调拨/预警)、设备档案(电子档案/状态) + +#### SYS-007 报装业务系统 +- 报装流程(申请/踏勘/施工/验收/通水)、工程管理(进度/资源/质量/安全)、档案管理(资料归档/留痕) + +#### SYS-008 发票服务子系统(基础服务) +- 统一开票/作废与红冲/查询、供应商适配(航天优先、预留博思)、回执处理与存证 + +#### SYS-009 银行对接子系统(基础服务) +- 银行代扣(送盘/回盘)、对账文件处理、加解密/签名 + +#### SYS-010 第三方支付子系统(基础服务) +- 统一聚合支付/退款、渠道适配(微信/支付宝/银联聚合等)、支付结果通知 ### 系统涉众与用户特点 @@ -392,16 +462,20 @@ CJKmainfont: "PingFang SC" - 提供API版本管理和接口文档生成 **业务服务层(Business Service Layer)** -- 核心业务逻辑处理层,包含三大子系统: +- 核心业务逻辑处理层,包含七个子系统: - **SYS-001 统一平台**:提供认证、组织、系统管理等基础服务 - - **SYS-002 营收业务系统**:包含五大模块群的完整营收业务平台 - - **SYS-003 手机抄表APP**:移动端现场作业和工单处理 + - **SYS-002 营收业务系统**:营收核心与客户服务模块群 + - **SYS-003 手机抄表APP**:移动端现场作业与数据同步 + - **SYS-004 微网厅系统**:面向客户的线上服务门户 + - **SYS-005 工单管理系统**:统一工单中心与流程引擎 + - **SYS-006 表务管理系统**:水表基础、库存与档案管理 + - **SYS-007 报装业务系统**:报装全流程与工程管理 - 按业务域划分微服务,实现高内聚低耦合 - 支持独立部署、扩缩容和技术栈选择 **基础服务层(Infrastructure Service Layer)** - 提供通用的技术服务能力 -- 包含权限、工作流、消息、文件等基础服务 +- 包含权限、工作流、消息、文件、发票服务(统一开票能力)、银行对接服务(代扣/对账/加解密)、第三方支付服务(聚合支付/退款)等基础服务 - 为业务服务提供统一的技术支撑 **数据层(Data Layer)** @@ -414,7 +488,7 @@ CJKmainfont: "PingFang SC" **图表 1** -![图表 1](temp_mermaid_新-概要设计说明书_47335/diagram_1.png) +![图表 1](temp_mermaid_新-概要设计说明书_25255/diagram_1.png) ### 系统的物理架构设计 @@ -426,13 +500,13 @@ CJKmainfont: "PingFang SC" **图表 2** -![图表 2](temp_mermaid_新-概要设计说明书_47335/diagram_2.png) +![图表 2](temp_mermaid_新-概要设计说明书_25255/diagram_2.png) #### 网络连接 **图表 3** -![图表 3](temp_mermaid_新-概要设计说明书_47335/diagram_3.png) +![图表 3](temp_mermaid_新-概要设计说明书_25255/diagram_3.png) #### 硬件配置规格 @@ -476,7 +550,7 @@ CJKmainfont: "PingFang SC" **图表 4** -![图表 4](temp_mermaid_新-概要设计说明书_47335/diagram_4.png) +![图表 4](temp_mermaid_新-概要设计说明书_25255/diagram_4.png) #### 容器化部署架构 @@ -486,7 +560,7 @@ CJKmainfont: "PingFang SC" **图表 5** -![图表 5](temp_mermaid_新-概要设计说明书_47335/diagram_5.png) +![图表 5](temp_mermaid_新-概要设计说明书_25255/diagram_5.png) ## 子系统定义 @@ -496,9 +570,15 @@ CJKmainfont: "PingFang SC" | 子系统编号 | 子系统名称(标识) | 功能描述 | 开发方式 | |---|---|---|---| | SYS-001 | 统一平台 | 单点登录、系统管理、权限管理、租户管理 | 自行开发 | -| SYS-002 | 营收业务系统 | 客户管理、抄表开账、营业收费、账务处理、发票管理、催缴管理、报装流程、表务管理、客户服务、工单管理 | 自行开发 | +| SYS-002 | 营收业务系统 | 客户管理、抄表开账、营业收费、账务处理、发票管理、催缴管理、统计分析、代收业务、客户服务 | 自行开发 | | SYS-003 | 手机抄表APP | 移动端抄表、现场作业、数据同步、离线支持 | 自行开发 | | SYS-004 | 微网厅系统 | 微信公众号平台、账户绑定、在线缴费、信息查询、业务办理、网点服务 | 自行开发 | +| SYS-005 | 工单管理系统 | 统一工单中心、工单流程引擎、监控预警、绩效统计 | 自行开发 | +| SYS-006 | 表务管理系统 | 表务基础管理、仓库与库存管理、设备档案管理 | 自行开发 | +| SYS-007 | 报装业务系统 | 报装流程管理、工程管理、档案管理 | 自行开发 | +| SYS-008 | 发票服务子系统 | 统一开票网关、供应商适配器(优先对接航天)、回执处理与存证 | 自行开发 | +| SYS-009 | 银行对接子系统 | 银行代扣送盘/回盘、对账处理、加解密签名 | 自行开发 | +| SYS-010 | 第三方支付子系统 | 聚合支付/退款、渠道适配(微信/支付宝/银联)、支付通知 | 自行开发 | ### 子系统间关系 @@ -507,7 +587,7 @@ CJKmainfont: "PingFang SC" **图表 6** -![图表 6](temp_mermaid_新-概要设计说明书_47335/diagram_6.png) +![图表 6](temp_mermaid_新-概要设计说明书_25255/diagram_6.png) #### 主要接口定义 @@ -530,16 +610,20 @@ CJKmainfont: "PingFang SC" | 立户接口 | 新客户立户 | 外部系统 | HTTP/REST | | 抄表任务接口 | 下发抄表任务和客户信息 | 手机抄表APP | HTTP/REST | | 抄表数据上传接口 | 上传抄表数据 | 手机抄表APP | HTTP/REST | -| 工单处理接口 | 统一工单处理 | 手机抄表APP | HTTP/REST | | 微网厅服务接口 | 微信公众号服务 | 微信平台 | HTTP/REST | +| 发票开具统一接口 | 统一开票(对接SYS-008) | 营收业务系统 | HTTP/REST | +| 统一支付接口 | 实时支付/退款(对接SYS-009) | 营收业务系统 | HTTP/REST | +| 银行代扣接口 | 代扣送盘/回盘(对接SYS-009) | 营收业务系统 | HTTP/REST/SFTP | +| 发票开具统一接口 | 统一开票(对接SYS-008) | 营收业务系统 | HTTP/REST | **手机抄表APP对外接口** | 接口名称 | 接口描述 | 调用方 | 接口协议 | |---------|----------|--------|-----------| | 任务下载接口 | 下载抄表任务和客户信息 | 营收业务系统 | HTTP/REST | -| 数据上传接口 | 上传抄表数据和工单信息 | 营收业务系统 | HTTP/REST | -| 工单接收接口 | 接收和处理各类工单 | 营收业务系统 | HTTP/REST | +| 数据上传接口 | 上传抄表数据 | 营收业务系统 | HTTP/REST | +| 工单接收接口 | 接收和处理各类工单 | 工单管理系统 | HTTP/REST | +| 工单回填接口 | 回填工单处理结果与附件 | 工单管理系统 | HTTP/REST | | 离线同步接口 | 离线数据同步 | 营收业务系统 | HTTP/REST | **微网厅系统对外接口** @@ -549,8 +633,57 @@ CJKmainfont: "PingFang SC" | 微信授权接口 | 处理微信用户授权登录 | 微信平台 | HTTP/REST | | 账户绑定接口 | 处理用户账户绑定 | 微信客户端 | HTTP/REST | | 账单查询接口 | 查询客户账单信息 | 微信客户端 | HTTP/REST | -| 缴费处理接口 | 处理在线缴费业务 | 微信客户端 | HTTP/REST | +| 缴费处理接口 | 处理在线缴费业务(经SYS-010) | 微信客户端 | HTTP/REST | | 业务申请接口 | 处理各类业务申请 | 微信客户端 | HTTP/REST | +| 电子发票查看接口 | 发票查看/下载 | 微信客户端 | HTTP/REST | + +**工单管理系统对外接口** + +| 接口名称 | 接口描述 | 调用方 | 接口协议 | +|---------|----------|--------|-----------| +| 工单创建接口 | 创建各类工单 | 营收/表务/报装/微网厅/APP | HTTP/REST | +| 工单派发接口 | 向处理人/APP派发任务 | 工单中心 | HTTP/REST | +| 工单回填接口 | 回填处理结果与附件 | APP/各业务系统 | HTTP/REST | +| 工单查询接口 | 查询工单状态/轨迹 | 各业务系统 | HTTP/REST | + +**表务管理系统对外接口** + +| 接口名称 | 接口描述 | 调用方 | 接口协议 | +|---------|----------|--------|-----------| +| 库存查询接口 | 查询库存状态/预警 | 工单/营收 | HTTP/REST | +| 领用出库接口 | 支持换表/施工领用 | 工单 | HTTP/REST | +| 档案查询接口 | 查询设备档案 | 营收/工单 | HTTP/REST | + +**报装业务系统对外接口** +**发票服务子系统对外接口** + +| 接口名称 | 接口描述 | 调用方 | 接口协议 | +|---------|----------|--------|-----------| +| 统一开票接口 | 统一受理开票(蓝票) | 营收业务系统 | HTTP/REST | +| 发票作废接口 | 作废/红冲申请 | 营收业务系统 | HTTP/REST | +| 发票查询接口 | 查询发票状态/链接 | 营收/微网厅 | HTTP/REST | +| 供应商路由接口 | 供应商选择与路由(航天/博思/…) | 发票适配器 | 内部SPI | + +**银行对接子系统对外接口(SYS-009)** + +| 接口名称 | 接口描述 | 调用方 | 接口协议 | +|---------|----------|--------|-----------| +| 代扣送盘接口 | 代扣文件送盘 | 营收系统 | SFTP/HTTP | +| 代扣回盘接口 | 回盘解析与状态回填 | 营收系统 | SFTP/HTTP | +| 对账文件接口 | 银行对账文件处理 | 营收系统 | SFTP | + +**第三方支付子系统对外接口(SYS-010)** + +| 接口名称 | 接口描述 | 调用方 | 接口协议 | +|---------|----------|--------|-----------| +| 统一支付接口 | 聚合支付下单/关闭/退款 | 营收/微网厅 | HTTP/REST | +| 支付结果回调接口 | 渠道回调签名校验与结果入账 | 微网厅/营收 | HTTP/REST | + +| 接口名称 | 接口描述 | 调用方 | 接口协议 | +|---------|----------|--------|-----------| +| 报装申请接口 | 提交报装信息与材料 | 微网厅/营收 | HTTP/REST | +| 派工对接接口 | 报装派单与回填 | 工单系统 | HTTP/REST | +| 竣工归档接口 | 归档竣工资料 | 营收/档案 | HTTP/REST | # 子系统1设计: 统一平台 @@ -631,7 +764,7 @@ CJKmainfont: "PingFang SC" **图表 7** -![图表 7](temp_mermaid_新-概要设计说明书_47335/diagram_7.png) +![图表 7](temp_mermaid_新-概要设计说明书_25255/diagram_7.png) ## 模块定义 @@ -655,7 +788,7 @@ CJKmainfont: "PingFang SC" **图表 8** -![图表 8](temp_mermaid_新-概要设计说明书_47335/diagram_8.png) +![图表 8](temp_mermaid_新-概要设计说明书_25255/diagram_8.png) **功能群说明:** @@ -672,7 +805,7 @@ CJKmainfont: "PingFang SC" **图表 9** -![图表 9](temp_mermaid_新-概要设计说明书_47335/diagram_9.png) +![图表 9](temp_mermaid_新-概要设计说明书_25255/diagram_9.png) ### 模块描述 @@ -736,7 +869,7 @@ CJKmainfont: "PingFang SC" **功能范围:** -营收业务系统包含四大核心模块群,实现水务企业完整的业务管理: +营收业务系统包含两大核心模块群,实现水务企业营收业务闭环: #### 营收核心模块群 - **客户资料管理**:客户档案建立、信息维护、分组管理 @@ -748,16 +881,6 @@ CJKmainfont: "PingFang SC" - **统计分析**:多维度数据统计和报表分析 - **代收业务**:银行代扣、第三方支付等代收渠道 -#### 表务管理模块群 -- **表务基础管理**:水表厂家、型号、规格等基础数据管理 -- **仓库与库存管理**:水表的入库、出库、盘点和调拨管理 -- **设备档案管理**:每一块水表的唯一电子档案管理 - -#### 报装业务模块群 -- **报装流程管理**:报装申请、踏勘、合同签订等流程管理 -- **工程管理**:施工管理、进度监控、竣工验收 -- **档案管理**:报装全流程的资料归档和查询 - #### 客户服务模块群 - **账户绑定管理**:微信/支付宝账户绑定和管理 - **信息查询服务**:账单查询、用水历史、缴费记录等 @@ -766,16 +889,8 @@ CJKmainfont: "PingFang SC" - **营业网点服务**:网点查询、地图导航、预约服务 - **业务办理服务**:各类业务在线申请和办理 -#### 工单管理模块群 -- **统一工单管理**:所有工单的统一创建、分配、跟踪和管理 -- **业务工单管理**:营收业务相关的客户服务、账务处理工单 -- **表务工单管理**:水表安装、维修、更换、检定等工单 -- **报装工单管理**:新用户报装流程中的各类工单 -- **服务工单管理**:客户投诉、建议、咨询等服务类工单 -- **工单流程引擎**:基于规则的工单流转和审批流程 - **核心业务流程:** -客户建档 → 抄表录入 → 复核开账 → 营业收费 → 账务处理 → 发票管理 → 催缴管理 → 工单处理 +客户建档 → 抄表录入 → 复核开账 → 营业收费 → 账务处理 → 发票管理 → 催缴管理 ## 设计概述 @@ -829,12 +944,12 @@ CJKmainfont: "PingFang SC" ## 子系统架构设计 -营收系统采用DDD领域驱动设计,按业务领域进行模块划分,实现高内聚低耦合的架构设计。系统核心分为**营收核心模块群**和**工单管理模块群**两大业务板块。 +营收系统采用DDD领域驱动设计,按业务领域进行模块划分,实现高内聚低耦合的架构设计。系统核心分为**营收核心模块群**和**客户服务模块群**两大业务板块(原工单管理模块群已拆分为独立的SYS-005工单管理系统)。 **图表 10** -![图表 10](temp_mermaid_新-概要设计说明书_47335/diagram_10.png) +![图表 10](temp_mermaid_新-概要设计说明书_25255/diagram_10.png) ## 模块定义 @@ -858,17 +973,11 @@ CJKmainfont: "PingFang SC" | **REV-007** | **统计分析** | 多维度数据统计和报表分析功能 | 自行开发 | 决策支持 | | **REV-008** | **代收业务** | 集成银行、第三方支付等代收渠道 | 自行开发 | 服务便民 | -#### 工单管理模块群 +#### 客户服务模块群 -统一的工单管理模块群,支撑各类业务工单的全生命周期管理: +为外部渠道(微网厅、第三方平台)和内部渠道(客服前台)提供服务接入能力: -| 模块编号 | 模块名称(标识) | 功能描述 | 开发方式 | 工单类型 | -|---|---|---|---|---| -| **REV-009** | **业务工单中心** | 工单统一管理和流转中心 | 自行开发 | 工单引擎 | -| **REV-009-1** | **业务清单管理** | 客户服务、账务处理等日常业务工单管理 | 自行开发 | 日常业务工单 | -| **REV-009-2** | **上报清单管理** | 移动端问题上报工单处理 | 自行开发 | 现场问题工单 | -| **REV-009-3** | **稽查工单管理** | 抄表稽查、水价稽查工单管理 | 自行开发 | 质量监督工单 | -| **REV-009-4** | **换表工单管理** | 表务相关的换表、维修工单管理 | 自行开发 | 设备维护工单 | +- 账户绑定管理、信息查询服务、在线缴费服务、电子发票服务、营业网点服务、业务办理服务 ### 模块间关系 @@ -881,27 +990,19 @@ CJKmainfont: "PingFang SC" **图表 11** -![图表 11](temp_mermaid_新-概要设计说明书_47335/diagram_11.png) +![图表 11](temp_mermaid_新-概要设计说明书_25255/diagram_11.png) -#### 工单管理模块群关系 - -工单管理模块群实现统一的工单处理流程,支撑各类业务场景: - - -**图表 12** - -![图表 12](temp_mermaid_新-概要设计说明书_47335/diagram_12.png) - +#### 模块群间协作关系 #### 模块群间协作关系 两大模块群通过标准化接口进行协作,实现业务闭环: -**图表 13** +**图表 12** -![图表 13](temp_mermaid_新-概要设计说明书_47335/diagram_13.png) +![图表 12](temp_mermaid_新-概要设计说明书_25255/diagram_12.png) ### 模块描述 @@ -931,6 +1032,16 @@ CJKmainfont: "PingFang SC" - 模糊查询支持 - 高级筛选功能 +**子功能扩展:** + +- 客户分组:客户分组管理、分组内客户管理 +- 集收管理:集收号管理、集收号内客户管理 +- 立户建档:手工建档、批量立户 +- 定额管理:定额共享(主/子客户)、定额核定 +- 批量修改:手工修改、模板导入修改 +- 客户业务办理:换表、加抄、更名、过户、低保、调价、停用/启用、注销/恢复 +- 电子档案:高拍仪/附件采集与档案管理 + **业务规则:** - 客户编号系统自动生成,格式:部门代码+年份+6位流水号 @@ -964,12 +1075,20 @@ CJKmainfont: "PingFang SC" - 账单生成 - 开账确认 +**子功能扩展:** + +- 册本信息:册本查询、册本详情 +- 册本调整:新卡入册、册内序号调整、册本间调整 +- 抄表录入:按册本/按抄表员、导入抄表数据 +- 复核开账:复核开账查询/汇总、复核与开账 +- 开账记录:历史查询与导出 + **业务流程图:** -**图表 14** +**图表 13** -![图表 14](temp_mermaid_新-概要设计说明书_47335/diagram_14.png) +![图表 13](temp_mermaid_新-概要设计说明书_25255/diagram_13.png) **业务规则:** @@ -1005,12 +1124,18 @@ CJKmainfont: "PingFang SC" - 托收业务 - 自动扣费 +**子功能扩展:** + +- 特殊开账:特殊情形直接开账及查询导出 +- 柜台结账:结账、红冲、打印凭证 +- 红冲记录:红冲查询与导出 + **业务流程图:** -**图表 15** +**图表 14** -![图表 15](temp_mermaid_新-概要设计说明书_47335/diagram_15.png) +![图表 14](temp_mermaid_新-概要设计说明书_25255/diagram_14.png) **业务规则:** @@ -1046,6 +1171,10 @@ CJKmainfont: "PingFang SC" - **发票查询与管理**: 查询发票历史,处理红冲、作废等请求。 - **电子发票集成**: 对接第三方电子发票平台,实现自动开具和推送。 +**实现说明:** + +- 本模块通过调用`SYS-008 发票服务子系统`的“统一开票接口/作废红冲接口/发票查询接口”实现具体的开票与回执处理,营收系统不直接对接供应商。 + #### 模块6: 催缴管理 **功能概述:** @@ -1070,6 +1199,9 @@ CJKmainfont: "PingFang SC" - **收费统计**: 统计不同收费渠道、方式的收费情况。 - **欠费分析**: 多维度分析欠费构成和趋势。 - **自定义报表**: 提供灵活的报表自定义工具。 +- **报表查询**: 业务分类报表树、统计条件与结果导出。 +- **欠费查询**: 按账期/金额等条件查询客户欠费。 +- **缴费记录**: 缴费记录检索与导出。 #### 模块8: 代收业务 @@ -1082,66 +1214,27 @@ CJKmainfont: "PingFang SC" - **银行代扣**: 与银行签订协议,实现自动批量扣费。 - **第三方支付**: 集成微信、支付宝等支付网关。 - **对账管理**: 定期与各渠道进行账务核对。 +- **实时收费**: 渠道实时缴费处理(对接SYS-009)。 +- **银行托收**: 托收文件处理与状态跟踪(对接SYS-009)。 -#### 模块9: 业务工单(工单管理模块群核心) +#### 模块9: 业务参数配置 **功能概述:** -业务工单模块是营收系统中的**第二大核心模块群**,负责统一管理水务系统中的各类业务工单,实现工单的全生命周期管理。该模块整合了原表务系统的工单管理功能,构建了覆盖全业务场景的统一工单管理平台。 +集中管理与营收业务相关的参数与基础资料,提升配置一致性与运营效率。 -**架构特点:** +**核心功能:** -- **统一工单入口**:所有工单通过统一的工单中心进行管理 -- **标准化流程**:集成Flowable工作流引擎,实现标准化的工单流转 -- **跨系统协作**:支持与营收核心模块群及外部系统的无缝协作 -- **智能化支撑**:为未来AI智能派单和处理提供技术基础 +- 水表参数:水表厂家、型号、口径、量程 +- 地址参数:营业站点、所属小区 +- 价格体系:水价归属、费用组成、水价调整、调价历史、优惠方案、用水方案 +- 基本配置:打印维护、自定义列、日志管理、水司账户、发票税率、银行信息、抄表状态、词语信息、参数配置 -**💼 核心功能模块:** +**备注:** 原“工程管理(工程申请/查询)”能力已并入`SYS-007 报装业务系统`统一承载。 -1. **REV-009-1 业务清单管理** - - 客户服务工单(开户、过户、更名等) - - 账务处理工单(调账、退款、销账等) - - 投诉建议工单(服务投诉、意见反馈等) - - 故障报修工单(设施故障、管道维护等) +#### 客户服务模块群补充说明 -2. **REV-009-2 上报清单管理** - - 移动端问题上报工单处理 - - 现场异常情况工单管理 - - 抄表员发现问题的工单流转 - - 客户报告异常的工单处理 - -3. **REV-009-3 稽查工单管理** - - 抄表数据稽查工单 - - 水价政策执行稽查工单 - - 质量监督工单管理 - - 稽查结果处理工单 - -4. **REV-009-4 换表工单管理** - - 故障换表工单(与表务系统协同) - - 计划换表工单管理 - - 客户申请换表工单 - - 设备维护相关工单 - -**业务价值:** - -- **效率提升**:统一管理减少重复开发,提高工单处理效率40%+ -- **质量保障**:标准化流程确保工单处理质量,减少错误率60%+ -- **协作增强**:跨系统工单协作,提升部门间协作效率 -- **数据统一**:工单数据统一存储和分析,支持管理决策 - -**技术特性:** - -- **工作流引擎**:集成Flowable,支持复杂业务流程 -- **异步处理**:基于消息队列的异步工单处理 -- **实时监控**:工单状态实时监控和预警 -- **接口标准**:RESTful API支持外部系统集成 - -**业务规则:** - -1. **工单编号规则**:系统自动生成,格式:工单类型+年月日+4位流水号 -2. **响应时间要求**:紧急工单1小时内响应,普通工单8小时内派发 -3. **审计日志**:工单处理全过程记录,支持操作溯源 -4. **跨系统同步**:换表工单自动同步表务仓库系统状态 +客户服务模块群继续作为营收系统对外服务的统一入口,承接微网厅与第三方渠道的服务流量;涉及现场执行部分由SYS-005工单管理系统承接。 # 子系统3设计: 手机抄表APP @@ -1161,8 +1254,7 @@ CJKmainfont: "PingFang SC" - **登录认证**:机构编号、用户名密码认证、自动登录 - **首页搜索**:多维度搜索、最近搜索记录、抄表任务 - **采集任务管理**:任务列表管理、批量下载、单户采集 -- **换表工单**:换表工单处理、设备信息录入 -- **其他工单**:复水、稽查、问题上报等工单处理 +- **现场上报**:问题上报(由SYS-005工单系统统一受理与派发) - **个人设置**:个人信息管理、系统设置维护 **核心业务流程:** @@ -1197,79 +1289,72 @@ CJKmainfont: "PingFang SC" | 接口编号 | 接口名称(标识) | 功能描述 | 接口协议 | 输入参数 | 输出结果 | |---|---|---|---|---|---| -| METER-001 | 水表库存查询接口 | 查询水表库存信息 | HTTP/REST | 型号、规格、状态 | 库存详情 | -| METER-002 | 换表通知接口 | 换表完成通知 | HTTP/REST | 水表编号、客户信息 | 通知结果 | -| METER-003 | 设备档案接口 | 获取水表设备档案 | HTTP/REST | 水表编号 | 设备档案信息 | -| METER-004 | 库存预警接口 | 库存不足预警 | HTTP/REST | 预警阈值 | 预警信息 | +| MOBILE-001 | 任务下载接口 | 下载抄表任务与客户信息 | HTTP/REST | 抄表员、任务范围 | 任务详情 | +| MOBILE-002 | 抄表数据上传接口 | 上传抄表数据与现场图片 | HTTP/REST | 抄表数据、图片 | 上传结果 | +| MOBILE-003 | 工单接收接口 | 接收工单任务 | HTTP/REST | 工单ID、类型 | 派发结果 | +| MOBILE-004 | 工单回填接口 | 回填处理结果与附件 | HTTP/REST | 处理结论、附件 | 回填结果 | +| MOBILE-005 | 离线同步接口 | 离线数据同步 | HTTP/REST | 数据包 | 同步结果 | ### 设计方案概述 **架构设计:** -表务系统采用资源管理架构,以库存为核心,设备档案为支撑,基础数据为保障,实现水表资产的全面管理。 +端云协同架构,APP端提供离线能力(本地缓存与任务包),在线时通过增量同步接口与服务端完成任务下载、数据上传与工单回填,确保弱网环境可用。 -**技术选型:** +**关键技术:** -- **条码技术**:支持一维码/二维码水表标识 -- **RFID技术**:支持无线射频识别 -- **移动端**:支持PDA、手机等移动设备操作 -- **报表工具**:JasperReports生成各类统计报表 +- 本地缓存与数据加密存储、断点续传 +- 条码/二维码识别,拍照取证 +- 任务包增量同步与冲突处理 ## 子系统架构设计 -表务系统采用分层架构,从基础数据管理到业务流程处理,确保水表资产管理的完整性和准确性。 +**图表 15** -**图表 16** - -![图表 16](temp_mermaid_新-概要设计说明书_47335/diagram_16.png) +![图表 15](temp_mermaid_新-概要设计说明书_25255/diagram_15.png) ## 模块定义 ### 模块列表 -| 模块编号 | 模块名称(标识) | 功能描述 | 开发方式 | -|---|---|---|---| -| METER-001 | 表务基础管理 | 管理水表相关的基础参数 | 自行开发 | -| METER-002 | 仓库与库存管理 | 管理水表的入库、出库、盘点和调拨 | 自行开发 | -| METER-003 | 设备档案管理 | 管理每一块水表的唯一电子档案 | 自行开发 | - -**注意**: 表务工单管理功能已整合到营收系统的业务工单模块中,实现统一的工单管理。 +| 模块编号 | 模块名称(标识) | 功能描述 | +|---|---|---| +| MOBILE-001 | 登录认证 | 机构编号、用户名/密码、自动登录、令牌管理 | +| MOBILE-002 | 首页搜索 | 多维度搜索、最近记录、任务快捷入口 | +| MOBILE-003 | 采集任务管理 | 任务列表、批量下载、单户采集、读数校验 | +| MOBILE-004 | 现场上报 | 问题上报、拍照取证、定位信息、异常标记 | +| MOBILE-005 | 个人与设置 | 个人资料、偏好设置、缓存管理、安全退出 | +| MOBILE-006 | 数据同步 | 任务包增量同步、离线数据包上传、冲突处理 | ### 模块间关系 -表务系统各模块之间形成完整的水表资产管理闭环,从基础数据到实物管理,再到档案记录。 +**图表 16** -**图表 17** - -![图表 17](temp_mermaid_新-概要设计说明书_47335/diagram_17.png) +![图表 16](temp_mermaid_新-概要设计说明书_25255/diagram_16.png) ### 模块描述 -#### 模块1: 表务基础管理 -- **功能描述**: 定义和维护表务管理所需的基础数据和配置参数。 -- **核心功能**: - - **水表厂家管理**: 维护水表供应商信息。 - - **水表口径管理**: 管理不同口径水表的规格、检定周期等。 - - **水表型号管理**: 根据厂家和口径,管理具体的水表型号。 - - **水表量程管理**: 定义水表的计量范围。 +#### 模块1: 登录认证 +- 机构编号+账号登录、Token续期、离线授权缓存 -#### 模块2: 仓库与库存管理 -- **功能描述**: 负责水表的实物管理,与工单流程解耦,作为一个独立的资源中心。 -- **核心功能**: - - **入库管理**: 包括新表采购入库、旧表回收(维修或报废)入库。 - - **出库管理**: 根据工单领料申请,发放新水表。 - - **库存管理**: 提供库存查询、盘点、调拨、库存预警等功能。 +#### 模块2: 首页搜索 +- 客户/地址/册本搜索、最近搜索、快捷入口 -#### 模块3: 设备档案管理 -- **功能描述**: 作为表务系统的核心,统一管理所有水表的基础信息和生命周期状态。 -- **核心功能**: - - **水表信息登录**: 记录新购水表的型号、规格、供应商、批次等信息。 - - **水表档案建立**: 为每一块入库的水表建立唯一的、全生命周期跟踪的电子档案。 - - **状态管理**: 实时更新水表的状态(如:在库、在用、待检、报废等)。 +#### 模块3: 采集任务管理 +- 批量下载、单户采集、读数规则校验、异常标注 + +#### 模块4: 现场上报 +- 异常上报、图片与定位采集,提交至SYS-005工单系统 + +#### 模块5: 个人与设置 +- 个人信息、偏好、缓存清理、日志上传 + +#### 模块6: 数据同步 +- 增量任务同步、离线包上传、断点续传与冲突解决 # 子系统4设计: 微网厅系统 @@ -1319,9 +1404,9 @@ CJKmainfont: "PingFang SC" ## 子系统架构设计 -**图表 18** +**图表 17** -![图表 18](temp_mermaid_新-概要设计说明书_47335/diagram_18.png) +![图表 17](temp_mermaid_新-概要设计说明书_25255/diagram_17.png) ## 模块定义 @@ -1336,13 +1421,15 @@ CJKmainfont: "PingFang SC" | WECHAT-004 | 电子发票服务 | 发票查看、发票推送、电子发票管理 | 中 | | WECHAT-005 | 营业网点服务 | 网点查询、地图导航、距离计算 | 中 | | WECHAT-006 | 业务办理服务 | 联系方式变更、开票方式变更、更名过户、水价变更、低保申请、换表申请、自主抄表 | 中 | +| WECHAT-007 | 账户流水 | 账户历史缴费流水查询与导出 | 中 | +| WECHAT-008 | 账号与机构管理 | 切换机构、添加/解绑客户、设置默认客户、客户详情 | 中 | ### 模块间关系 -**图表 19** +**图表 18** -![图表 19](temp_mermaid_新-概要设计说明书_47335/diagram_19.png) +![图表 18](temp_mermaid_新-概要设计说明书_25255/diagram_18.png) ### 模块描述 @@ -1360,9 +1447,9 @@ CJKmainfont: "PingFang SC" **关键流程**: -**图表 20** +**图表 19** -![图表 20](temp_mermaid_新-概要设计说明书_47335/diagram_20.png) +![图表 19](temp_mermaid_新-概要设计说明书_25255/diagram_19.png) #### 模块2: 信息查询服务 @@ -1376,6 +1463,7 @@ CJKmainfont: "PingFang SC" - 缴费记录查询 - 停水公告查看 - 账户基本信息查看 + - 账户流水:缴费流水、付费汇总、导出 **接口依赖**: - 营收业务系统客户信息接口 @@ -1392,12 +1480,13 @@ CJKmainfont: "PingFang SC" - 代缴功能 - 缴费确认 - 缴费结果查询 + - 退款/失败处理引导 **支付流程**: -**图表 21** +**图表 20** -![图表 21](temp_mermaid_新-概要设计说明书_47335/diagram_21.png) +![图表 20](temp_mermaid_新-概要设计说明书_25255/diagram_20.png) #### 模块4: 电子发票服务 @@ -1420,6 +1509,7 @@ CJKmainfont: "PingFang SC" - 距离计算 - 营业时间查看 - 联系方式查看 + - 预约/排队叫号/预约提醒(如启用) #### 模块6: 业务办理服务 @@ -1433,12 +1523,31 @@ CJKmainfont: "PingFang SC" - 低保申请 - 换表申请 - 自主抄表上报 + - 业务进度查询与消息通知 + +#### 模块7: 账户流水 + +**功能职责**:展示绑定客户的历史缴费流水与汇总。 + +**主要功能**: +- 流水列表、筛选与导出 +- 账期/渠道统计汇总 + +#### 模块8: 账号与机构管理 + +**功能职责**:管理微信账号下的绑定客户与机构切换。 + +**主要功能**: +- 切换用水机构 +- 添加/解绑绑定客户 +- 设置默认客户 +- 查看客户详情 **业务办理流程**: -**图表 22** +**图表 21** -![图表 22](temp_mermaid_新-概要设计说明书_47335/diagram_22.png) +![图表 21](temp_mermaid_新-概要设计说明书_25255/diagram_21.png) ## 关键技术特性 @@ -1484,6 +1593,361 @@ CJKmainfont: "PingFang SC" - 接口限流 - 异常访问监控 +# 子系统5设计: 工单管理系统 + +## 任务概述 + +工单管理系统(SYS-005)负责全业务工单统一受理、创建、派发、处理、验收与归档,覆盖营收、表务、报装、客户服务等场景,提供统一流程引擎与监控预警能力。 + +## 设计概述 + +### 总体约束 + +- 流程统一:所有工单遵循统一的生命周期与态状态机 +- 实时可观测:状态监控、超时预警、绩效统计 +- 可扩展:支持新增工单类型与流程编排 + +- ### 设计方案概述 + +- 架构采用“工单中心 + 流程编排 + 监控预警 + 绩效统计”的分层设计,提供统一API网关对接各业务系统,并通过可配置流程实现多类型工单的快速上线。 + +### 子系统外部接口 + +| 接口编号 | 接口名称 | 功能描述 | 调用方 | +|---|---|---|---| +| WO-001 | 工单创建接口 | 创建各类工单 | 营收/表务/报装/微网厅/APP | +| WO-002 | 工单派发接口 | 向处理人/APP派发任务 | 工单中心 | +| WO-003 | 工单回填接口 | 回填处理结果与附件 | APP/各业务系统 | +| WO-004 | 工单查询接口 | 查询工单状态/轨迹 | 各业务系统 | + +### 子系统架构设计 + + +**图表 22** + +![图表 22](temp_mermaid_新-概要设计说明书_25255/diagram_22.png) + + +### 模块定义 + +| 模块编号 | 模块名称 | 功能描述 | +|---|---|---| +| WO-CORE | 工单中心 | 统一受理、路由、分派、跟踪 | +| WO-FLOW | 流程引擎 | 节点编排、条件路由、并行网关 | +| WO-MON | 监控预警 | 超时/积压/异常预警、看板 | +| WO-STAT | 绩效统计 | 人员/环节时长、SLA达成率 | + +### 模块间关系 + + +**图表 23** + +![图表 23](temp_mermaid_新-概要设计说明书_25255/diagram_23.png) + + +### 模块描述 + +- WO-CORE 工单中心:统一入口与单据路由,支持工单分类、优先级与SLA策略。 +- WO-FLOW 流程引擎:可视化编排、条件路由、并行/互斥网关,支持子流程与回退重审。 +- WO-MON 监控预警:实时看板、超时预警、积压监控、异常拦截与通知。 +- WO-STAT 绩效统计:处理时长与环节分析、达成率统计与考核报表导出。 + +# 子系统6设计: 表务管理系统 + +## 任务概述 + +表务管理系统(SYS-006)聚焦水表资产全生命周期管理与库存管理,提供基础数据、仓储、档案三大能力,面向换表等业务提供资源保障。 + +## 设计概述 + +### 设计方案概述 + +- 以“基础参数-仓库库存-设备档案”三层模型实现资产全生命周期管理;通过与工单系统联动完成领用/回填闭环,支持库存预警与追溯。 + +### 子系统外部接口 + +| 接口编号 | 接口名称 | 功能描述 | 调用方 | +|---|---|---|---| +| METER-001 | 库存查询接口 | 查询库存状态/预警 | 工单/营收 | +| METER-002 | 领用出库接口 | 支持换表/施工领用 | 工单 | +| METER-003 | 档案查询接口 | 查询设备档案 | 营收/工单 | + +### 子系统架构设计 + + +**图表 24** + +![图表 24](temp_mermaid_新-概要设计说明书_25255/diagram_24.png) + + +### 模块定义 + +| 模块编号 | 模块名称 | 功能描述 | +|---|---|---| +| METER-BASE | 表务基础管理 | 厂家/型号/口径/量程等基础参数 | +| METER-WH | 仓库与库存管理 | 入库/出库/盘点/调拨/预警 | +| METER-DOC | 设备档案管理 | 档案建档/状态管理/追溯 | + +### 模块间关系 + + +**图表 25** + +![图表 25](temp_mermaid_新-概要设计说明书_25255/diagram_25.png) + + +### 模块描述 + +- METER-BASE 表务基础管理:厂家、型号、口径、量程、检定周期等基础参数标准化。 +- METER-WH 仓库与库存管理:入库/出库/盘点/调拨/库存预警;与工单联动领用回填。 +- METER-DOC 设备档案管理:唯一电子档案、状态流转、批次与质检记录追溯。 + +# 子系统7设计: 报装业务系统 + +## 任务概述 + +报装业务系统(SYS-007)覆盖从申请、踏勘、设计、施工到验收通水的全流程,并与工单系统协作完成现场派工与过程留痕。 + +## 设计概述 + +### 设计方案概述 + +- 采用阶段性里程碑管控(申请-踏勘-施工-验收-通水),以工单驱动现场作业,形成资料全流程留痕与竣工归档。 + +### 子系统外部接口 + +| 接口编号 | 接口名称 | 功能描述 | 调用方 | +|---|---|---|---| +| INST-001 | 报装申请接口 | 提交报装信息与材料 | 微网厅/营收 | +| INST-002 | 派工对接接口 | 报装派单与回填 | 工单系统 | +| INST-003 | 竣工归档接口 | 归档竣工资料 | 营收/档案 | + +### 子系统架构设计 + + +**图表 26** + +![图表 26](temp_mermaid_新-概要设计说明书_25255/diagram_26.png) + + +### 模块定义 + +| 模块编号 | 模块名称 | 功能描述 | +|---|---|---| +| INST-FLOW | 报装流程管理 | 端到端阶段流转,里程碑控制 | +| INST-PROJ | 工程管理 | 进度/资源/质量/安全管理 | +| INST-ARCH | 档案管理 | 资料归档、过程留痕、竣工档案 | + +# 子系统8设计: 发票服务子系统 + +## 任务概述 + +发票服务子系统(SYS-008)定位为“基础服务层”的统一开票能力中心,通过统一开票网关与供应商适配器屏蔽不同厂商差异,当前优先对接“航天信息”,预留“博思”等供应商接入能力。 + +## 设计概述 + +### 总体约束 + +- 统一入口:提供统一的开票、作废/红冲、查询能力 +- 供应商无关:采用适配器模式屏蔽供应商差异 +- 合规可靠:签章/存证、回执落库、审计留痕 + +### 设计方案概述 + +- 架构采用“统一开票网关 + 供应商适配器 + 回执处理/存证”的三层模型;对上通过REST接口供营收业务与微网厅调用,对下通过供应商SDK/HTTP对接航天(现阶段)与其他供应商。 + +### 子系统外部接口 + +| 接口编号 | 接口名称 | 功能描述 | 调用方 | +|---|---|---|---| +| INV-001 | 统一开票接口 | 统一受理蓝票开具 | 营收业务系统 | +| INV-002 | 作废/红冲接口 | 作废、红冲受理 | 营收业务系统 | +| INV-003 | 发票查询接口 | 查询状态、下载链接 | 营收/微网厅 | +| INV-004 | 回执推送接口 | 供应商回执回传 | 发票适配器 | + +## 子系统架构设计 + + +```mermaid +graph TB + subgraph "发票服务子系统" + GW[统一开票网关] + ADP[供应商适配器] + RCPT[回执处理] + EVID[存证与签章] + end + + subgraph "上游系统" + REV[营收业务系统] + WECHAT[微网厅] + end + + subgraph "供应商" + HT[航天信息] + BOS[博思(预留)] + end + + REV -.->|INV-001/002/003| GW + WECHAT -.->|发票查询/下载| GW + GW --> ADP --> HT + ADP -.-> BOS + HT -.-> RCPT --> EVID + +``` + + +## 模块定义 + +| 模块编号 | 模块名称 | 功能描述 | +|---|---|---| +| INV-GW | 统一开票网关 | 统一鉴权、参数校验、路由与限流 | +| INV-ADP | 供应商适配器 | 航天/博思等供应商协议适配、签名加验签 | +| INV-RCPT | 回执处理 | 回执解析、状态机、失败重试、告警通知 | +| INV-EVID | 存证与签章 | 发票PDF/JSON存证、签章与链接生成、合规审计 | + +### 模块间关系 + + +**图表 28** + +![图表 28](temp_mermaid_新-概要设计说明书_25255/diagram_28.png) + + +### 模块描述 + +- INV-GW 统一开票网关:统一鉴权、字段校验、幂等控制、灰度路由与限流熔断。 +- INV-ADP 供应商适配器:对接航天SDK/HTTP,字段映射、签名/验签、错误码转换;预留博思等扩展点。 +- INV-RCPT 回执处理:状态回填、失败重试(指数退避)、超时告警、与微网厅消息联动。 +- INV-EVID 存证与签章:存储PDF/票根JSON、签章、下载链接生成,审计日志与合规留痕。 +### 模块间关系 + + +**图表 29** + +![图表 29](temp_mermaid_新-概要设计说明书_25255/diagram_29.png) + + +### 模块描述 + +- INST-FLOW 报装流程管理:分阶段管理、节点表单与材料校验、异常回退。 +- INST-PROJ 工程管理:计划排程、资源与材料、质量与安全检查、进度监控。 +- INST-ARCH 档案管理:资料采集、签署与留痕、竣工档案归档与查询。 + +# 子系统9设计: 银行对接子系统 + +## 任务概述 + +银行对接子系统(SYS-009)统一承载银行代扣(送盘/回盘)、对账文件处理与安全加解密/签名能力,为营收系统提供标准化、可扩展、合规可观测的银行侧对接能力。 + +## 设计概述 + +### 总体约束 + +- 银行渠道统一:支持各银行代扣统一接入 +- 安全合规:SM2/SM4/3DES等算法,加解密/签名/验签;支持GBK/UTF-8编码要求 +- 高可用与可观测:失败重试、限流熔断、事务保障、链路追踪与告警 + +### 设计方案概述 + +- 采用“代扣网关 + 银行适配器 + 对账处理 + 加解密/签名”的分层模型;对上提供REST接口,对下通过HTTP/SFTP/SDK与银行系统对接。 + +### 子系统外部接口 + +| 接口编号 | 接口名称 | 功能描述 | 调用方 | +|---|---|---|---| +| PAY-002 | 代扣送盘接口 | 代扣文件送盘 | 营收系统 | +| PAY-003 | 代扣回盘接口 | 回盘解析/状态回填 | 营收系统 | +| PAY-004 | 对账文件接口 | 银行对账文件处理 | 营收系统 | + +## 子系统架构设计 + + +**图表 30** + +![图表 30](temp_mermaid_新-概要设计说明书_25255/diagram_30.png) + + +## 模块定义 + +| 模块编号 | 模块名称 | 功能描述 | +|---|---|---| +| PAY-GW | 代扣网关 | 统一鉴权、参数校验、路由与限流、幂等控制 | +| PAY-ADP | 银行适配器 | 对接银行协议、字段映射、错误码转换、编码/文件规范适配 | +| PAY-RECON | 对账处理 | 对账文件接收/解析、差错处理、账务回填、对账报告 | +| PAY-CRYPTO | 加解密/签名 | SM2/SM4/3DES等算法实现与密钥管理、签名/验签 | + +### 模块间关系 + + +**图表 31** + +![图表 31](temp_mermaid_新-概要设计说明书_25255/diagram_31.png) + + +### 模块描述 + +- PAY-GW 统一支付/代扣网关:统一鉴权、字段校验、限流熔断、幂等键与重放保护、灰度路由。 +- PAY-ADP 银行适配器:对接银行与第三方支付协议,签名/验签、编码转换(GBK/UTF-8)、SFTP/HTTP文件交互、错误码映射。 +- PAY-RECON 对账处理:定时拉取/解析对账文件、差异识别、冲正/补记建议、对账报告生成、追踪链路与告警。 +- PAY-CRYPTO 加解密/签名:国密/商密算法、密钥轮换、硬件加密机对接(可选)。 + +# 子系统10设计: 第三方支付子系统 + +## 任务概述 + +第三方支付子系统(SYS-010)提供统一的聚合支付/退款能力,屏蔽微信、支付宝、银联聚合等渠道差异,向上游系统提供标准化下单、关单、退款与回调验签能力。 + +## 设计概述 + +### 总体约束 + +- 多渠道聚合:微信/支付宝/银联聚合等统一接入 +- 安全合规:签名/验签、回调防重放、幂等 +- 高可用:限流熔断、重试补偿、灰度发布 + +### 设计方案概述 + +- 采用“聚合支付网关 + 渠道适配器 + 回调处理 + 对账对齐(可选)”分层;对上REST接口,对下各渠道SDK/HTTP对接。 + +### 子系统外部接口 + +| 接口编号 | 接口名称 | 功能描述 | 调用方 | +|---|---|---|---| +| TP-001 | 统一支付下单接口 | JSAPI/扫码/APP下单 | 营收/微网厅 | +| TP-002 | 统一关单接口 | 订单关闭/撤销 | 营收/微网厅 | +| TP-003 | 统一退款接口 | 原路/部分退款 | 营收/微网厅 | +| TP-004 | 支付回调接口 | 渠道回调验签入账 | 微网厅/营收 | + +## 子系统架构设计 + + +**图表 32** + +![图表 32](temp_mermaid_新-概要设计说明书_25255/diagram_32.png) + + +## 模块定义 + +| 模块编号 | 模块名称 | 功能描述 | +|---|---|---| +| TP-GW | 聚合支付网关 | 鉴权、参数校验、幂等、路由与限流 | +| TP-ADP | 渠道适配器 | 渠道参数映射、签名/验签、错误码转换 | +| TP-CB | 回调处理 | 回调验签、订单入账、补偿重试 | + +### 模块间关系 + + +**图表 33** + +![图表 33](temp_mermaid_新-概要设计说明书_25255/diagram_33.png) + + +### 模块描述 + +- TP-GW 聚合支付网关:幂等键、重放保护、限流熔断、灰度路由。 +- TP-ADP 渠道适配器:微信/支付宝/银联参数与签名规范适配、错误码转换。 +- TP-CB 回调处理:回调验签、状态对齐、失败重试与告警。 + # 非功能性需求的设计 @@ -1598,9 +2062,9 @@ CJKmainfont: "PingFang SC" **业务流程图:** -**图表 23** +**图表 34** -![图表 23](temp_mermaid_新-概要设计说明书_47335/diagram_23.png) +![图表 34](temp_mermaid_新-概要设计说明书_25255/diagram_34.png) **业务规则:** @@ -1632,15 +2096,12 @@ CJKmainfont: "PingFang SC" 3. **发票推送** - 邮箱推送 - - 微信推送 - - 短信通知 - - 下载链接分享 + 4. **发票下载** - PDF格式下载 - 图片格式保存 - 批量下载 - - 云端存储 **业务规则:** @@ -1727,9 +2188,9 @@ CJKmainfont: "PingFang SC" **业务流程图:** -**图表 24** +**图表 35** -![图表 24](temp_mermaid_新-概要设计说明书_47335/diagram_24.png) +![图表 35](temp_mermaid_新-概要设计说明书_25255/diagram_35.png) **业务规则:** diff --git a/output/新-详细设计说明书.docx b/output/新-详细设计说明书.docx index 341fd8b..686a5fe 100644 Binary files a/output/新-详细设计说明书.docx and b/output/新-详细设计说明书.docx differ diff --git a/output/新-详细设计说明书_processed.md b/output/新-详细设计说明书_processed.md index c968895..d02251f 100644 --- a/output/新-详细设计说明书_processed.md +++ b/output/新-详细设计说明书_processed.md @@ -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) ## 政务系统接口 diff --git a/project_progress.md b/project_progress.md index 01de3bb..6e84554 100644 --- a/project_progress.md +++ b/project_progress.md @@ -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个模块完整覆盖了用户认证、信息查询、在线缴费、发票管理、网点服务、业务办理等全流程,提供了完整的技术架构和业务流程设计,为微网厅的实际开发提供了全面的指导 | diff --git a/scripts/unified_export.sh b/scripts/unified_export.sh index 21806b2..5f03ce2 100755 --- a/scripts/unified_export.sh +++ b/scripts/unified_export.sh @@ -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 diff --git a/task_checklist.md b/task_checklist.md index ab0c2d2..dca3255 100644 --- a/task_checklist.md +++ b/task_checklist.md @@ -201,6 +201,14 @@ - [x] 将工单从营收系统中剥离为SYS-005 ✅ - [x] 更新子系统列表与关系图 ✅ - [x] 新增工单系统接口与架构图 ✅ + +### 📋 功能点对齐(操作手册 → 概要设计)(2025-08-18) +- [x] 营收系统:客户分组/集收/定额/册本功能补充 ✅ +- [x] 营业收费:特殊开账/柜台结账/红冲子项补充 ✅ +- [x] 统计分析:报表查询/欠费查询/缴费记录补充 ✅ +- [x] 代收业务:实时收费/银行托收补充(经SYS-009)✅ +- [x] 业务参数配置模块新增(价格体系/水表参数/基础配置)✅ +- [x] 微网厅:账户流水、机构切换/绑定/解绑/默认客户、退款/失败处理引导、预约/叫号/提醒、业务进度通知补充 ✅ ### 📋 安全设计完善 diff --git a/新-概要设计说明书.md b/新-概要设计说明书.md index fed21cb..9e7db79 100644 --- a/新-概要设计说明书.md +++ b/新-概要设计说明书.md @@ -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[统一开票网关
供应商适配器
回执/存证] end - subgraph "SYS-009 支付与银行对接子系统" - PAY_SYS[统一支付/代扣网关
银行适配器
对账处理] + subgraph "SYS-009 银行对接子系统" + PAY_BANK[代扣送盘/回盘
银行适配器
对账处理] + end + + subgraph "SYS-010 第三方支付子系统" + PAY_TP[聚合支付/退款
渠道适配
支付通知] 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 回调处理:回调验签、状态对齐、失败重试与告警。 + # 非功能性需求的设计 diff --git a/福建水务营收系统整体架构图.html b/福建水务营收系统整体架构图.html index b7045b6..9c3a464 100644 --- a/福建水务营收系统整体架构图.html +++ b/福建水务营收系统整体架构图.html @@ -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); + } } @@ -254,7 +262,7 @@

福建水务营收系统整体架构图

-

基于微服务架构的现代化水务营收管理平台 | 四大子系统完整架构

+

基于微服务架构的现代化水务营收管理平台 | 七大业务子系统 + 三大基础服务

@@ -323,7 +331,7 @@ 业务服务层 (Business Service Layer)
- 核心业务逻辑处理层,包含四大子系统,按业务域划分微服务,实现高内聚低耦合 + 核心业务逻辑处理层,包含七个业务子系统,按业务域划分微服务,实现高内聚低耦合
@@ -353,22 +361,12 @@
营收核心模块群
客户管理、抄表开账、营业收费
账务处理、发票管理、催缴管理
统计分析、代收业务
-
-
表务管理模块群
-
表务基础管理、仓库库存管理
设备档案管理
-
-
-
报装业务模块群
-
报装流程管理、工程管理
档案管理
-
+
客户服务模块群
账户绑定、信息查询、在线缴费
电子发票、营业网点、业务办理
-
-
工单管理模块群
-
业务工单中心、业务清单管理
上报清单、稽查工单、换表工单
-
+ @@ -425,6 +423,77 @@ + + +
+

+ ■ SYS-005 工单管理系统 +

+
+
+
统一工单中心
+
受理/路由/分派/跟踪
SLA策略
+
+
+
流程引擎
+
可视化编排、条件路由
并行/互斥网关
+
+
+
监控预警
+
超时/积压/异常预警
实时看板
+
+
+
绩效统计
+
环节时长、达成率
考核报表
+
+
+
+ + +
+

+ ■ SYS-006 表务管理系统 +

+
+
+
基础参数
+
厂家/型号/口径/量程
检定周期
+
+
+
仓库与库存
+
入出库/盘点/调拨
库存预警
+
+
+
设备档案
+
电子档案、状态流转
批次追溯
+
+
+
+ + +
+

+ ■ SYS-007 报装业务系统 +

+
+
+
申请受理
+
资料受理、资格初审
工单触发
+
+
+
现场踏勘
+
踏勘派工与回填
方案确认
+
+
+
施工管理
+
进度/资源/质量/安全
过程留痕
+
+
+
验收通水/资料归档
+
竣工验收、通水
档案归档
+
+
+
@@ -434,7 +503,7 @@ 基础服务层 (Infrastructure Service Layer)
- 提供通用的技术服务能力,包含权限、工作流、消息、文件等基础服务,为业务服务提供统一的技术支撑 + 提供通用的技术服务能力,为业务服务提供统一的技术支撑
@@ -454,8 +523,16 @@
MinIO
分布式文件存储
-
支付网关
-
微信、支付宝
银行代扣
+
发票服务子系统(SYS-008)
+
统一开票/作废/红冲
供应商适配/回执存证
+
+
+
银行对接子系统(SYS-009)
+
代扣送盘/回盘
对账处理/加解密
+
+
+
第三方支付子系统(SYS-010)
+
聚合支付/退款
渠道适配/回调
通信服务