新增微网厅子系统设计，在概要设计说明书中添加子系统7-微网厅系统，包含账户绑定管理、信息查询服务、在线缴费服务、电子发票服务、营业网点服务和业务办理服务6个核心模块，更新子系统列表和关系图，新增5个主要接口定义，提供完整模块架构和业务流程图，提升设计文档完整性，符合甲方A级交付标准。
This commit is contained in:
parent
d3bf845022
commit
59469fe2eb
Binary file not shown.
@ -3309,14 +3309,14 @@ CJKmainfont: "PingFang SC"
|
||||
|
||||
**图表 1**
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
### 业务核心表关系图
|
||||
|
||||
**图表 2**
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
## 业务视图设计
|
||||
|
||||
Binary file not shown.
@ -9,7 +9,7 @@ mainfont: "PingFang SC"
|
||||
CJKmainfont: "PingFang SC"
|
||||
---
|
||||
|
||||
# 福建水务数智营收管理系统概要设计说明书
|
||||
# 营业收费系统概要设计说明书
|
||||
|
||||
| 文件状态： | 文档密级： | 公开 |
|
||||
| :--- | :--- | :--- |
|
||||
@ -28,16 +28,16 @@ CJKmainfont: "PingFang SC"
|
||||
| 2025-07-17 | V1.1 | 唐伟杰 | 1. 同步详细设计中的模块，补充缺失模块。<br>2. 调整子系统划分与编号，确保逻辑清晰、编号连续。<br>3. 重构表务、报装、客户服务子系统，优化模块设计。<br>4. 统一概要设计与详细设计的结构，提升一致性。 |
|
||||
| 2025-08-01 | V1.2 | 唐伟杰 | 完善 APP相关的模块设计 |
|
||||
| 2025-08-01 | V1.3 | 唐伟杰 | 数据库系统变更：将OpenGauss替换为达梦数据库 8.0+，更新所有相关架构图和技术描述。 |
|
||||
| 2025-08-01 | V1.4 | 唐伟杰 | 单点登录采用OAuth2.0协议：更新单点登录模块描述，强调基于OAuth2.0协议实现。 |
|
||||
| 2025-08-01 | V1.4 | 唐伟杰 | 单点登录采用OAuth2.0+CAS协议：更新单点登录模块描述，强调基于OAuth2.0+CAS协议实现。 |
|
||||
|
||||
# 目录
|
||||
|
||||
- [福建水务数智营收管理系统概要设计说明书](#福建水务数智营收管理系统概要设计说明书)
|
||||
- [营业收费系统概要设计说明书](#营业收费系统概要设计说明书)
|
||||
- [版本历史](#版本历史)
|
||||
- [目录](#目录)
|
||||
- [前言](#前言)
|
||||
- [编写目的](#编写目的)
|
||||
- [背景与任务](#背景与任务)
|
||||
- [背景](#背景)
|
||||
- [术语与缩略语](#术语与缩略语)
|
||||
- [参考资料](#参考资料)
|
||||
- [系统总体设计](#系统总体设计)
|
||||
@ -76,6 +76,8 @@ CJKmainfont: "PingFang SC"
|
||||
- [模块列表](#模块列表)
|
||||
- [模块间关系](#模块间关系)
|
||||
- [模块描述](#模块描述)
|
||||
- [模块1: 单点登录](#模块1-单点登录)
|
||||
- [模块2: 系统管理](#模块2-系统管理)
|
||||
- [子系统2设计: 营收系统](#子系统2设计-营收系统)
|
||||
- [任务概述](#任务概述-2)
|
||||
- [设计概述](#设计概述-2)
|
||||
@ -87,6 +89,15 @@ CJKmainfont: "PingFang SC"
|
||||
- [模块列表](#模块列表-1)
|
||||
- [模块间关系](#模块间关系-1)
|
||||
- [模块描述](#模块描述-1)
|
||||
- [模块1: 客户资料管理](#模块1-客户资料管理)
|
||||
- [模块2: 抄表开账](#模块2-抄表开账)
|
||||
- [模块3: 营业收费](#模块3-营业收费)
|
||||
- [模块4: 账务处理](#模块4-账务处理)
|
||||
- [模块5: 发票管理](#模块5-发票管理)
|
||||
- [模块6: 催缴管理](#模块6-催缴管理)
|
||||
- [模块7: 统计分析](#模块7-统计分析)
|
||||
- [模块8: 代收业务](#模块8-代收业务)
|
||||
- [模块9: 业务工单](#模块9-业务工单)
|
||||
- [子系统3设计: 表务系统](#子系统3设计-表务系统)
|
||||
- [任务概述](#任务概述-3)
|
||||
- [设计概述](#设计概述-3)
|
||||
@ -98,6 +109,9 @@ CJKmainfont: "PingFang SC"
|
||||
- [模块列表](#模块列表-2)
|
||||
- [模块间关系](#模块间关系-2)
|
||||
- [模块描述](#模块描述-2)
|
||||
- [模块1: 表务基础管理](#模块1-表务基础管理)
|
||||
- [模块2: 仓库与库存管理](#模块2-仓库与库存管理)
|
||||
- [模块3: 设备档案管理](#模块3-设备档案管理)
|
||||
- [子系统4设计: 报装系统](#子系统4设计-报装系统)
|
||||
- [任务概述](#任务概述-4)
|
||||
- [设计概述](#设计概述-4)
|
||||
@ -108,17 +122,52 @@ CJKmainfont: "PingFang SC"
|
||||
- [模块定义](#模块定义-3)
|
||||
- [模块列表](#模块列表-3)
|
||||
- [模块描述](#模块描述-3)
|
||||
- [模块1: 报装流程管理](#模块1-报装流程管理)
|
||||
- [模块2: 工程管理](#模块2-工程管理)
|
||||
- [模块3: 档案管理](#模块3-档案管理)
|
||||
- [子系统5设计: 客户服务](#子系统5设计-客户服务)
|
||||
- [功能与界面](#功能与界面)
|
||||
- [模块列表](#模块列表-4)
|
||||
- [模块设计](#模块设计)
|
||||
- [模块1: 账户绑定管理](#模块1-账户绑定管理)
|
||||
- [模块2: 信息查询服务](#模块2-信息查询服务)
|
||||
- [模块3: 在线缴费服务](#模块3-在线缴费服务)
|
||||
- [模块4: 电子发票服务](#模块4-电子发票服务)
|
||||
- [子系统6设计: 手机抄表APP](#子系统6设计-手机抄表app)
|
||||
- [功能与界面](#功能与界面-1)
|
||||
- [模块列表](#模块列表-5)
|
||||
- [模块设计](#模块设计-1)
|
||||
- [模块1: 登录模块](#模块1-登录模块)
|
||||
- [模块2: 首页搜索模块](#模块2-首页搜索模块)
|
||||
- [模块3: 采集任务管理模块](#模块3-采集任务管理模块)
|
||||
- [模块4: 换表工单模块](#模块4-换表工单模块)
|
||||
- [模块5: 其他工单模块](#模块5-其他工单模块)
|
||||
- [模块6: 个人信息与系统设置模块](#模块6-个人信息与系统设置模块)
|
||||
- [关键技术特性](#关键技术特性)
|
||||
- [离线作业能力](#离线作业能力)
|
||||
- [数据安全保障](#数据安全保障)
|
||||
- [用户体验优化](#用户体验优化)
|
||||
- [子系统7设计: 微网厅系统](#子系统7设计-微网厅系统)
|
||||
- [任务概述](#任务概述-5)
|
||||
- [设计概述](#设计概述-5)
|
||||
- [总体约束](#总体约束-5)
|
||||
- [子系统外部接口](#子系统外部接口-4)
|
||||
- [设计方案概述](#设计方案概述-5)
|
||||
- [子系统架构设计](#子系统架构设计-4)
|
||||
- [模块定义](#模块定义-4)
|
||||
- [子系统6设计: 手机抄表APP](#子系统6设计-手机抄表app)
|
||||
- [任务概述](#任务概述-6)
|
||||
- [设计概述](#设计概述-6)
|
||||
- [子系统架构设计](#子系统架构设计-5)
|
||||
- [模块定义](#模块定义-5)
|
||||
- [关键技术特性](#关键技术特性)
|
||||
- [模块列表](#模块列表-6)
|
||||
- [模块间关系](#模块间关系-3)
|
||||
- [模块描述](#模块描述-4)
|
||||
- [模块1: 账户绑定管理](#模块1-账户绑定管理-1)
|
||||
- [模块2: 信息查询服务](#模块2-信息查询服务-1)
|
||||
- [模块3: 在线缴费服务](#模块3-在线缴费服务-1)
|
||||
- [模块4: 电子发票服务](#模块4-电子发票服务-1)
|
||||
- [模块5: 营业网点服务](#模块5-营业网点服务)
|
||||
- [模块6: 业务办理服务](#模块6-业务办理服务)
|
||||
- [关键技术特性](#关键技术特性-1)
|
||||
- [微信平台集成](#微信平台集成)
|
||||
- [响应式设计](#响应式设计)
|
||||
- [安全保障](#安全保障)
|
||||
- [非功能性需求的设计](#非功能性需求的设计)
|
||||
- [性能的考虑](#性能的考虑)
|
||||
- [兼容性的考虑](#兼容性的考虑)
|
||||
@ -133,7 +182,7 @@ CJKmainfont: "PingFang SC"
|
||||
|
||||
## 编写目的
|
||||
|
||||
本文档是《福建水务数智营收管理系统详细设计说明书》的前导文档，旨在从总体架构和概要设计的角度对系统进行全面的技术规划和设计。
|
||||
本文档是《营业收费系统详细设计说明书》的前导文档，旨在从总体架构和概要设计的角度对系统进行全面的技术规划和设计。
|
||||
|
||||
**主要目的：**
|
||||
|
||||
@ -150,29 +199,14 @@ CJKmainfont: "PingFang SC"
|
||||
- 测试团队和运维团队
|
||||
- 甲方技术评审团队
|
||||
|
||||
## 背景与任务
|
||||
## 背景
|
||||
|
||||
福建水务数智营收管理系统是为满足福建省水投数字科技有限公司客户服务管理领域的业务需求而建设的综合管理平台。系统以客户关系数据库为核心和基础，实现客户全生命周期管理。
|
||||
营业收费系统是为满足福建省水投数字科技有限公司客户服务管理领域的业务需求而建设的综合管理平台。系统以客户关系数据库为核心和基础，实现客户全生命周期管理。
|
||||
|
||||
**建设背景：**
|
||||
|
||||
福建水投集团注册资本46亿元，在全省40多个县市区投资重大水利项目超过450亿元，拥有全级次子公司超过67家，职工人数超3500人。当前，集团正紧紧抓住城乡供水一体化建设的机遇，需要构建以客户为中心的客户服务平台。
|
||||
|
||||
**主要任务：**
|
||||
|
||||
1. **业务流程再造**：梳理和优化客户服务管理领域的业务流程
|
||||
2. **组织架构优化**：配合业务流程重组，优化组织架构和管理制度
|
||||
3. **绩效体系建设**：建立科学的绩效考核标准和评价体系
|
||||
4. **平台系统建设**：构建以客户为中心的一体化客户服务平台
|
||||
5. **服务质量提升**：全面提高客户服务质量和客户满意度
|
||||
|
||||
**技术目标：**
|
||||
|
||||
- 采用现代化微服务架构，支持大规模并发访问
|
||||
- 支持多租户模式，满足集团化管理需求
|
||||
- 实现移动化办公，提高工作效率
|
||||
- 集成物联网技术，支持智能水表远程抄表
|
||||
- 适配国产化环境，确保系统安全可控
|
||||
|
||||
## 术语与缩略语
|
||||
|
||||
@ -197,10 +231,6 @@ CJKmainfont: "PingFang SC"
|
||||
|
||||
## 参考资料
|
||||
|
||||
- 《福建水务数智营收管理系统需求规格说明书》
|
||||
- 《福建水务数智营收管理系统详细设计说明书》
|
||||
- 《福建水务数智营收管理系统数据库设计说明书》
|
||||
- 《福建水务数智营收管理系统接口设计说明书》
|
||||
- GB/T 8556-2007 信息技术软件生存周期过程
|
||||
- GB/T 9385-2008 计算机软件需求规格说明规范
|
||||
- GB/T 8567-2006 计算机软件文档编制规范
|
||||
@ -213,7 +243,7 @@ CJKmainfont: "PingFang SC"
|
||||
|
||||
### 系统总体目标
|
||||
|
||||
福建水务数智营收管理系统主要包含统一平台、营收系统、表务系统、报装系统、客户服务和手机抄表APP等子系统，以及相关外部接口集成。
|
||||
营业收费系统主要包含统一平台、营收系统、表务系统、报装系统、客户服务和手机抄表APP等子系统，以及相关外部接口集成。
|
||||
|
||||
通过系统的建设，实现福建省水投数字科技有限公司客户服务管理领域的业务流程梳理再造、组织架构的优化、管理制度的建设、绩效考核标准的建设。构建以客户为中心的一体化客户服务平台，将客户的所有信息进行有机的关联，方便企业对营收信息进行综合分析和管理，为客户提供更多、更便捷、更主动的个性化服务，提高客户服务的质量和客户满意度。
|
||||
|
||||
@ -291,6 +321,12 @@ CJKmainfont: "PingFang SC"
|
||||
| 物联网 | 集抄系统接口 | 智能水表数据采集 | TCP/HTTPS |
|
||||
| 税务服务 | 电子发票接口 | 第三方发票开具 | HTTPS |
|
||||
| 认证服务 | 身份认证接口 | 第三方身份验证 | HTTPS |
|
||||
| 认证服务 | CAS单点登录 | 第三方身份验证 | HTTPS |
|
||||
| 认证服务 | OAuth2.0单点登录 | 第三方身份验证 | HTTPS |
|
||||
| 外部系统 | 微信消息推送 | 微信消息推送 | HTTPS |
|
||||
| 外部系统 | 大工单系统 | 大工单系统 | HTTPS |
|
||||
| 外部系统 | 报装系统 | 报装系统 | HTTPS |
|
||||
|
||||
|
||||
### 设计方案概述
|
||||
|
||||
@ -306,7 +342,7 @@ CJKmainfont: "PingFang SC"
|
||||
- **缓存**：Redis 6.0+（集群模式）
|
||||
- **消息队列**：RabbitMQ 3.9+
|
||||
- **文件存储**：MinIO（分布式文件存储）
|
||||
- **容器化**：Docker + Docker Compose
|
||||
- **容器化**：基于Docker的容器化部署，使用Docker Compose进行容器编排，使用Kubernetes进行容器编排和调度。
|
||||
|
||||
**部署方案**：
|
||||
|
||||
@ -323,14 +359,14 @@ CJKmainfont: "PingFang SC"
|
||||
|
||||
**图表 1**
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
#### 层级说明
|
||||
|
||||
**表现层（Presentation Layer）**
|
||||
- 负责用户交互和界面展示
|
||||
- 包含多种客户端形态：Web端、移动端、小程序端
|
||||
- 包含多种客户端形态：Web端、微网厅（微信、支付宝）
|
||||
- 采用前后端分离架构，提高开发效率和用户体验
|
||||
|
||||
**网关层（Gateway Layer）**
|
||||
@ -358,25 +394,25 @@ CJKmainfont: "PingFang SC"
|
||||
|
||||
**图表 2**
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
### 系统的物理架构设计
|
||||
|
||||
系统采用分布式部署架构，通过多个服务器集群实现高可用和高性能。
|
||||
系统采用分布式部署架构，通过多个服务器集群实现高可用和高性能，支持 DevOps 持续交付。
|
||||
|
||||
#### 物理部署图
|
||||
|
||||
|
||||
**图表 3**
|
||||
|
||||
|
||||
|
||||
|
||||
#### 网络连接
|
||||
|
||||
**图表 4**
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
#### 硬件配置规格
|
||||
@ -393,7 +429,7 @@ CJKmainfont: "PingFang SC"
|
||||
| 设备类型 | 配置规格 | 数量 | 主要作用 |
|
||||
|---------|---------|------|----------|
|
||||
| Web服务器 | 8核32G，1TB SSD | 2台 | 前端应用部署 |
|
||||
| 应用服务器 | 16核64G，2TB SSD | 2台 | 后端服务部署 |
|
||||
| 应用服务器 | 32核128G，2TB SSD | 3台 | 后端服务部署 |
|
||||
| 消息队列服务器 | 8核16G，1TB SSD | 2台 | 异步消息处理 |
|
||||
|
||||
**数据服务区配置**
|
||||
@ -420,17 +456,17 @@ CJKmainfont: "PingFang SC"
|
||||
|
||||
**图表 5**
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
#### 容器化部署架构
|
||||
|
||||
系统采用Docker容器化部署，使用Docker Compose进行服务编排，支持快速部署和弹性扩缩容。
|
||||
系统采用基于Docker的容器化部署，使用Docker Compose进行容器编排，使用Kubernetes进行容器编排和调度,支持DevOps持续交付。
|
||||
|
||||
|
||||
**图表 6**
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
## 子系统定义
|
||||
@ -443,8 +479,9 @@ CJKmainfont: "PingFang SC"
|
||||
| SYS-002 | 营收系统 | 客户管理、抄表开账、营业收费、账务处理、发票管理、催缴管理 | 自行开发 |
|
||||
| SYS-003 | 表务系统 | 表务工单、表务仓库、水表全生命周期管理 | 自行开发 |
|
||||
| SYS-004 | 报装系统 | 报装流程管理、现场踏勘、合同签订、施工验收 | 自行开发 |
|
||||
| SYS-005 | 客户服务 | 微信小程序、支付宝小程序、客户自助服务 | 自行开发 |
|
||||
| SYS-005 | 客户服务 | 客户自助服务、在线服务支持 | 自行开发 |
|
||||
| SYS-006 | 手机抄表APP | 移动端抄表、工单处理、数据同步 | 自行开发 |
|
||||
| SYS-007 | 微网厅系统 | 微信公众号服务、账户绑定管理、在线缴费、业务办理 | 自行开发 |
|
||||
|
||||
### 子系统间关系
|
||||
|
||||
@ -453,7 +490,7 @@ CJKmainfont: "PingFang SC"
|
||||
|
||||
**图表 7**
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
#### 主要接口定义
|
||||
@ -470,9 +507,9 @@ CJKmainfont: "PingFang SC"
|
||||
|
||||
| 接口名称 | 接口描述 | 调用方 | 接口协议 |
|
||||
|---------|----------|--------|----------|
|
||||
| 客户信息查询接口 | 查询客户基本信息 | 表务系统、客户服务 | HTTP/REST |
|
||||
| 账单查询接口 | 查询客户账单信息 | 客户服务 | HTTP/REST |
|
||||
| 缴费处理接口 | 处理在线缴费 | 客户服务 | HTTP/REST |
|
||||
| 客户信息查询接口 | 查询客户基本信息 | 表务系统、微网厅系统 | HTTP/REST |
|
||||
| 账单查询接口 | 查询客户账单信息 | 微网厅系统 | HTTP/REST |
|
||||
| 缴费处理接口 | 处理在线缴费 | 微网厅系统 | HTTP/REST |
|
||||
| 立户接口 | 新客户立户 | 报装系统 | HTTP/REST |
|
||||
| 抄表任务接口 | 下发抄表任务和客户信息 | 手机抄表APP | HTTP/REST |
|
||||
| 抄表数据上传接口 | 上传抄表数据 | 手机抄表APP | HTTP/REST |
|
||||
@ -486,11 +523,21 @@ CJKmainfont: "PingFang SC"
|
||||
| 工单查询接口 | 查询待办工单 | 手机抄表APP | HTTP/REST |
|
||||
| 工单回填接口 | 回填工单处理结果 | 手机抄表APP | HTTP/REST |
|
||||
|
||||
**微网厅系统对外接口**
|
||||
|
||||
| 接口名称 | 接口描述 | 调用方 | 接口协议 |
|
||||
|---------|----------|--------|-----------|
|
||||
| 微信授权接口 | 处理微信用户授权登录 | 微信公众号 | HTTP/REST |
|
||||
| 账户绑定接口 | 处理用户账户绑定和解绑 | 微信公众号 | HTTP/REST |
|
||||
| 缴费接口 | 处理在线缴费业务 | 微信、支付宝 | HTTP/REST |
|
||||
| 业务办理接口 | 处理各类业务申请 | 微信公众号 | HTTP/REST |
|
||||
| 发票管理接口 | 处理电子发票开具和推送 | 微信公众号 | HTTP/REST |
|
||||
|
||||
# 子系统1设计: 统一平台
|
||||
|
||||
## 任务概述
|
||||
|
||||
统一平台是整个福建水务数智营收管理系统的基础支撑平台，负责为所有子系统提供统一的用户认证、权限管理、组织管理等基础服务。
|
||||
统一平台是整个营业收费系统的基础支撑平台，负责为所有子系统提供统一的用户认证、权限管理、组织管理等基础服务。
|
||||
|
||||
**设计目标：**
|
||||
|
||||
@ -515,7 +562,7 @@ CJKmainfont: "PingFang SC"
|
||||
|
||||
**技术约束：**
|
||||
|
||||
- 基于Spring Security + OAuth2.0协议实现认证授权
|
||||
- 基于Spring Security + OAuth2.0+CAS协议实现认证授权
|
||||
- 采用JWT令牌实现无状态认证
|
||||
- 支持Redis分布式会话存储
|
||||
- 遵循RBAC权限控制模型
|
||||
@ -548,11 +595,11 @@ CJKmainfont: "PingFang SC"
|
||||
|
||||
**架构设计：**
|
||||
|
||||
统一平台采用基于Spring Boot的微服务架构，使用Spring Security + OAuth2.0实现认证授权，Redis存储会话和缓存数据，支持水平扩展。
|
||||
统一平台采用基于Spring Boot的微服务架构，使用Spring Security + OAuth2.0+CAS协议实现认证授权，Redis存储会话和缓存数据，支持水平扩展。
|
||||
|
||||
**技术选型：**
|
||||
|
||||
- **认证授权**：Spring Security + OAuth2.0 + JWT
|
||||
- **认证授权**：Spring Security + OAuth2.0 + CAS协议 + JWT
|
||||
- **缓存存储**：Redis 6.0+（分布式缓存）
|
||||
- **数据库**：达梦数据库 8.0+
|
||||
- **消息队列**：RabbitMQ（异步通知）
|
||||
@ -565,7 +612,7 @@ CJKmainfont: "PingFang SC"
|
||||
|
||||
**图表 8**
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
## 模块定义
|
||||
@ -589,7 +636,7 @@ CJKmainfont: "PingFang SC"
|
||||
|
||||
**图表 9**
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
**功能群说明：**
|
||||
@ -606,7 +653,7 @@ CJKmainfont: "PingFang SC"
|
||||
|
||||
**图表 10**
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
### 模块描述
|
||||
@ -615,14 +662,14 @@ CJKmainfont: "PingFang SC"
|
||||
|
||||
**功能描述：**
|
||||
|
||||
单点登录模块基于OAuth2.0协议实现，提供统一的用户认证入口，支持多种登录方式和安全策略。该模块是整个系统安全的第一道防线，确保只有合法用户才能访问系统。
|
||||
单点登录模块基于OAuth2.0+CAS协议实现，提供统一的用户认证入口，支持多种登录方式和安全策略。该模块是整个系统安全的第一道防线，确保只有合法用户才能访问系统。
|
||||
|
||||
**主要功能：**
|
||||
|
||||
1. **用户名密码登录**：传统的用户名密码认证方式
|
||||
2. **手机号短信登录**：基于短信验证码的快速登录
|
||||
3. **第三方登录**：支持微信、支付宝等第三方平台登录
|
||||
4. **OAuth2.0单点登录**：基于OAuth2.0协议，一次登录，多系统访问
|
||||
4. **OAuth2.0单点登录**：基于OAuth2.0+CAS协议，一次登录，多系统访问
|
||||
5. **自动登录**：支持"记住我"功能
|
||||
6. **安全控制**：密码策略、登录限制、验证码等
|
||||
|
||||
@ -659,7 +706,7 @@ CJKmainfont: "PingFang SC"
|
||||
|
||||
## 任务概述
|
||||
|
||||
营收系统是整个福建水务数智营收管理系统的核心业务系统，负责处理从客户管理到账务处理的完整营收业务流程。
|
||||
营收系统是整个营业收费系统的核心业务系统，负责处理从客户管理到账务处理的完整营收业务流程。
|
||||
|
||||
**设计目标：**
|
||||
|
||||
@ -740,7 +787,7 @@ CJKmainfont: "PingFang SC"
|
||||
|
||||
**图表 11**
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
## 模块定义
|
||||
@ -768,7 +815,7 @@ CJKmainfont: "PingFang SC"
|
||||
|
||||
**图表 12**
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
**客户服务业务群：**
|
||||
@ -778,7 +825,7 @@ CJKmainfont: "PingFang SC"
|
||||
|
||||
**图表 13**
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
### 模块描述
|
||||
@ -846,7 +893,7 @@ CJKmainfont: "PingFang SC"
|
||||
|
||||
**图表 14**
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
**业务规则：**
|
||||
@ -887,7 +934,7 @@ CJKmainfont: "PingFang SC"
|
||||
|
||||
**图表 15**
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
**业务规则：**
|
||||
@ -1053,7 +1100,7 @@ CJKmainfont: "PingFang SC"
|
||||
|
||||
**图表 16**
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
## 模块定义
|
||||
@ -1075,7 +1122,7 @@ CJKmainfont: "PingFang SC"
|
||||
|
||||
**图表 17**
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
### 模块描述
|
||||
@ -1201,7 +1248,7 @@ CJKmainfont: "PingFang SC"
|
||||
|
||||
**图表 18**
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
**业务规则：**
|
||||
@ -1217,7 +1264,7 @@ CJKmainfont: "PingFang SC"
|
||||
|
||||
## 功能与界面
|
||||
|
||||
客户服务系统为用水客户提供多渠道、便捷的线上自助服务，主要通过微信和支付宝小程序实现。
|
||||
客户服务系统为用水客户提供多渠道、便捷的线上自助服务，主要通过微网厅（微信、支付宝）实现。
|
||||
|
||||
## 模块列表
|
||||
|
||||
@ -1354,6 +1401,384 @@ CJKmainfont: "PingFang SC"
|
||||
- **智能搜索**: 实时搜索、关键词高亮、历史记录
|
||||
- **便捷导航**: 户间切换、快速定位、批量操作
|
||||
|
||||
# 子系统7设计: 微网厅系统
|
||||
|
||||
## 任务概述
|
||||
|
||||
微网厅系统是基于微信公众号平台的客户自助服务系统，为用水客户提供便捷的线上服务渠道。
|
||||
|
||||
**设计目标：**
|
||||
|
||||
- 构建一流的客户服务平台，让百姓足不出户就能办理日常业务
|
||||
- 实现企业对外服务的标准化、统一化管理
|
||||
- 提升企业管理水平和客户满意度
|
||||
- 加速企业实现数字化转型进程
|
||||
|
||||
**功能范围：**
|
||||
|
||||
- **账户绑定管理**：微信授权、账户绑定与解绑、多账户管理
|
||||
- **信息查询服务**：账单查询、用水历史、缴费记录、停水公告
|
||||
- **在线缴费服务**：快捷缴费、充值服务、多种支付方式
|
||||
- **电子发票服务**：发票查看、发票推送、电子发票管理
|
||||
- **营业网点服务**：网点查询、地图导航、距离计算
|
||||
- **业务办理服务**：联系方式变更、开票方式变更、更名过户、水价变更、低保申请、换表申请、自主抄表
|
||||
|
||||
## 设计概述
|
||||
|
||||
### 总体约束
|
||||
|
||||
**技术约束：**
|
||||
|
||||
- 基于微信公众号开发，使用微信公众平台API
|
||||
- 采用响应式设计，适配移动端浏览器
|
||||
- 遵循微信开发规范和安全要求
|
||||
- 支持微信支付和第三方支付集成
|
||||
|
||||
**性能约束：**
|
||||
|
||||
- 支持10万+注册用户
|
||||
- 页面加载时间≤3秒
|
||||
- 支持并发用户≥1000个
|
||||
- 缴费交易响应时间≤2秒
|
||||
|
||||
**安全约束：**
|
||||
|
||||
- 微信OAuth2.0用户认证
|
||||
- 账户绑定安全验证
|
||||
- 支付安全保障
|
||||
- 敏感信息加密传输
|
||||
|
||||
### 子系统外部接口
|
||||
|
||||
| 接口编号 | 接口名称（标识） | 功能描述 | 接口协议 | 输入参数 | 输出结果 |
|
||||
|---|---|---|---|---|---|
|
||||
| WECHAT-001 | 微信授权接口 | 处理微信用户授权登录 | HTTP/REST | 微信授权码 | 用户信息、访问令牌 |
|
||||
| WECHAT-002 | 账户绑定接口 | 处理用户账户绑定 | HTTP/REST | 客户编号、手机号 | 绑定结果 |
|
||||
| WECHAT-003 | 账单查询接口 | 查询客户账单信息 | HTTP/REST | 客户编号、查询条件 | 账单详情 |
|
||||
| WECHAT-004 | 缴费处理接口 | 处理在线缴费业务 | HTTP/REST | 订单信息、支付方式 | 缴费结果 |
|
||||
| WECHAT-005 | 业务申请接口 | 处理各类业务申请 | HTTP/REST | 业务类型、申请材料 | 申请结果 |
|
||||
|
||||
### 设计方案概述
|
||||
|
||||
**架构设计：**
|
||||
|
||||
微网厅系统采用前后端分离架构，前端基于微信公众号H5页面，后端提供RESTful API服务，通过微信公众平台实现用户认证和消息推送。
|
||||
|
||||
**技术选型：**
|
||||
|
||||
- **前端技术**：微信公众号H5、Vue.js、WeUI组件库
|
||||
- **后端技术**：Spring Boot + Spring Security
|
||||
- **认证授权**：微信OAuth2.0 + JWT
|
||||
- **支付集成**：微信支付、支付宝支付
|
||||
- **消息推送**：微信模板消息、微信客服消息
|
||||
|
||||
## 子系统架构设计
|
||||
|
||||
微网厅系统采用基于微信公众号的服务架构，通过微信平台提供统一的用户入口和服务渠道。
|
||||
|
||||
|
||||
**图表 19**
|
||||
|
||||
|
||||
|
||||
|
||||
## 模块定义
|
||||
|
||||
### 模块列表
|
||||
|
||||
| 模块编号 | 模块名称（标识） | 功能描述 | 开发方式 |
|
||||
|---|---|---|---|
|
||||
| WECHAT-001 | 账户绑定管理 | 微信用户认证、账户绑定与解绑、多账户管理 | 自行开发 |
|
||||
| WECHAT-002 | 信息查询服务 | 账单查询、用水历史、缴费记录、停水公告 | 自行开发 |
|
||||
| WECHAT-003 | 在线缴费服务 | 快捷缴费、充值服务、多种支付方式 | 自行开发 |
|
||||
| WECHAT-004 | 电子发票服务 | 发票查看、发票推送、电子发票下载 | 自行开发 |
|
||||
| WECHAT-005 | 营业网点服务 | 网点查询、地图导航、营业时间查询 | 自行开发 |
|
||||
| WECHAT-006 | 业务办理服务 | 各类业务在线申请、进度查询、审批流程 | 自行开发 |
|
||||
|
||||
### 模块间关系
|
||||
|
||||
微网厅系统各模块围绕用户服务形成完整的服务链条，从账户绑定到业务办理的全流程覆盖。
|
||||
|
||||
|
||||
**图表 20**
|
||||
|
||||
|
||||
|
||||
|
||||
### 模块描述
|
||||
|
||||
#### 模块1: 账户绑定管理
|
||||
|
||||
**功能描述：**
|
||||
|
||||
账户绑定管理模块是微网厅系统的基础模块，负责处理微信用户与水务账户的绑定关系。
|
||||
|
||||
**核心功能：**
|
||||
|
||||
1. **微信授权认证**
|
||||
- 微信网页授权登录
|
||||
- 用户基本信息获取
|
||||
- 授权状态管理
|
||||
- 快捷登录支持
|
||||
|
||||
2. **账户绑定管理**
|
||||
- 自动绑定：根据手机号自动匹配客户信息
|
||||
- 手工绑定：通过客户编号手动绑定
|
||||
- 批量绑定：支持一个微信账号绑定多个水务账户
|
||||
- 绑定验证：短信验证码确保绑定安全
|
||||
|
||||
3. **多账户管理**
|
||||
- 默认账户设置
|
||||
- 账户切换功能
|
||||
- 账户信息查看
|
||||
- 账户解绑操作
|
||||
|
||||
**业务规则：**
|
||||
|
||||
- 每个微信账号最多绑定10个水务账户
|
||||
- 绑定时需要手机号验证或客户编号验证
|
||||
- 解绑操作需要二次确认
|
||||
- 支持设置默认显示账户
|
||||
|
||||
#### 模块2: 信息查询服务
|
||||
|
||||
**功能描述：**
|
||||
|
||||
信息查询服务模块提供全面的用水信息查询功能，为客户提供便捷的信息获取渠道。
|
||||
|
||||
**核心功能：**
|
||||
|
||||
1. **账单查询**
|
||||
- 当期账单查询
|
||||
- 历史账单查询
|
||||
- 账单详情展示
|
||||
- 欠费统计分析
|
||||
|
||||
2. **用水分析**
|
||||
- 用水量趋势图表
|
||||
- 同期用水对比
|
||||
- 用水量统计分析
|
||||
- 节水建议推送
|
||||
|
||||
3. **缴费记录查询**
|
||||
- 历史缴费记录
|
||||
- 缴费方式统计
|
||||
- 缴费凭证查看
|
||||
- 退费记录查询
|
||||
|
||||
4. **停水公告查询**
|
||||
- 计划停水通知
|
||||
- 临时停水公告
|
||||
- 区域停水查询
|
||||
- 停水时间提醒
|
||||
|
||||
**业务规则：**
|
||||
|
||||
- 查询范围限制为已绑定的账户
|
||||
- 历史数据保留最近24个月
|
||||
- 敏感信息脱敏显示
|
||||
- 支持按时间范围筛选
|
||||
|
||||
#### 模块3: 在线缴费服务
|
||||
|
||||
**功能描述：**
|
||||
|
||||
在线缴费服务模块提供便捷的线上缴费功能，支持多种支付方式和缴费场景。
|
||||
|
||||
**核心功能：**
|
||||
|
||||
1. **快捷缴费**
|
||||
- 欠费快捷缴纳
|
||||
- 预付款充值
|
||||
- 分期缴费支持
|
||||
- 代缴功能
|
||||
|
||||
2. **多渠道支付**
|
||||
- 微信支付
|
||||
- 支付宝支付
|
||||
- 银行卡支付
|
||||
- 数字人民币支付
|
||||
|
||||
3. **缴费管理**
|
||||
- 缴费确认
|
||||
- 支付状态查询
|
||||
- 缴费失败处理
|
||||
- 退款申请
|
||||
|
||||
4. **支付安全**
|
||||
- 支付限额控制
|
||||
- 支付密码验证
|
||||
- 异常交易监控
|
||||
- 资金安全保障
|
||||
|
||||
**业务流程图：**
|
||||
|
||||
|
||||
**图表 21**
|
||||
|
||||
|
||||
|
||||
|
||||
**业务规则：**
|
||||
|
||||
- 单次支付金额不超过5000元
|
||||
- 支付超时时间为15分钟
|
||||
- 支付失败自动退款
|
||||
- 支持部分缴费和全额缴费
|
||||
|
||||
#### 模块4: 电子发票服务
|
||||
|
||||
**功能描述：**
|
||||
|
||||
电子发票服务模块提供电子发票的开具、查询、推送等全流程服务。
|
||||
|
||||
**核心功能：**
|
||||
|
||||
1. **发票开具**
|
||||
- 缴费后自动开票
|
||||
- 手动申请开票
|
||||
- 个人发票开具
|
||||
- 企业发票开具
|
||||
|
||||
2. **发票管理**
|
||||
- 发票列表查看
|
||||
- 发票详情展示
|
||||
- 发票状态跟踪
|
||||
- 发票作废申请
|
||||
|
||||
3. **发票推送**
|
||||
- 邮箱推送
|
||||
- 微信推送
|
||||
- 短信通知
|
||||
- 下载链接分享
|
||||
|
||||
4. **发票下载**
|
||||
- PDF格式下载
|
||||
- 图片格式保存
|
||||
- 批量下载
|
||||
- 云端存储
|
||||
|
||||
**业务规则：**
|
||||
|
||||
- 发票开具时效为缴费后7天内
|
||||
- 电子发票与纸质发票具有同等法律效力
|
||||
- 发票信息一经开具不可修改
|
||||
- 支持发票红冲和重开
|
||||
|
||||
#### 模块5: 营业网点服务
|
||||
|
||||
**功能描述：**
|
||||
|
||||
营业网点服务模块提供营业网点查询和导航服务，帮助客户就近办理业务。
|
||||
|
||||
**核心功能：**
|
||||
|
||||
1. **网点查询**
|
||||
- 按距离排序
|
||||
- 按区域筛选
|
||||
- 按服务类型筛选
|
||||
- 关键词搜索
|
||||
|
||||
2. **网点信息**
|
||||
- 网点地址详情
|
||||
- 营业时间查询
|
||||
- 联系电话
|
||||
- 服务项目
|
||||
|
||||
3. **地图导航**
|
||||
- 位置标注展示
|
||||
- 路线规划
|
||||
- 实时导航
|
||||
- 距离计算
|
||||
|
||||
4. **服务预约**
|
||||
- 业务预约
|
||||
- 排队叫号
|
||||
- 预约提醒
|
||||
- 预约取消
|
||||
|
||||
**业务规则：**
|
||||
|
||||
- 支持GPS定位和手动定位
|
||||
- 显示范围限制在50公里内
|
||||
- 实时更新营业状态
|
||||
- 支持收藏常用网点
|
||||
|
||||
#### 模块6: 业务办理服务
|
||||
|
||||
**功能描述：**
|
||||
|
||||
业务办理服务模块提供各类水务业务的在线申请和办理功能。
|
||||
|
||||
**核心功能：**
|
||||
|
||||
1. **业务申请**
|
||||
- 联系方式变更
|
||||
- 开票方式变更
|
||||
- 更名过户业务
|
||||
- 一户多人口申请
|
||||
- 水价变更申请
|
||||
- 低保优惠申请
|
||||
- 换表维修申请
|
||||
- 自主抄表申请
|
||||
|
||||
2. **申请材料管理**
|
||||
- 材料清单提示
|
||||
- 在线拍照上传
|
||||
- 文件格式转换
|
||||
- 材料完整性检查
|
||||
|
||||
3. **业务进度跟踪**
|
||||
- 申请状态查询
|
||||
- 审批进度展示
|
||||
- 办理结果通知
|
||||
- 业务历史记录
|
||||
|
||||
4. **客服互动**
|
||||
- 在线咨询
|
||||
- 业务指导
|
||||
- 问题反馈
|
||||
- 满意度评价
|
||||
|
||||
**业务流程图：**
|
||||
|
||||
|
||||
**图表 22**
|
||||
|
||||
|
||||
|
||||
|
||||
**业务规则：**
|
||||
|
||||
- 业务申请需要实名认证
|
||||
- 上传材料单次最多9张
|
||||
- 支持的图片格式：JPG、PNG、PDF
|
||||
- 申请提交后不可撤销
|
||||
- 办理时效按业务类型确定
|
||||
|
||||
## 关键技术特性
|
||||
|
||||
### 微信平台集成
|
||||
|
||||
- **微信OAuth2.0认证**：安全的用户身份验证
|
||||
- **微信JS-SDK**：调用微信原生功能
|
||||
- **微信支付**：便捷的支付体验
|
||||
- **微信消息推送**：及时的业务通知
|
||||
|
||||
### 响应式设计
|
||||
|
||||
- **移动端适配**：完美适配各种移动设备
|
||||
- **触屏优化**：优化的触屏交互体验
|
||||
- **加载优化**：快速的页面加载速度
|
||||
- **离线支持**：基础功能离线可用
|
||||
|
||||
### 安全保障
|
||||
|
||||
- **数据加密**：敏感数据传输加密
|
||||
- **身份验证**：多重身份验证机制
|
||||
- **支付安全**：完善的支付安全策略
|
||||
- **隐私保护**：严格的用户隐私保护
|
||||
|
||||
# 非功能性需求的设计
|
||||
|
||||
## 性能的考虑
|
||||
@ -1409,10 +1834,10 @@ CJKmainfont: "PingFang SC"
|
||||
|
||||
**身份认证：**
|
||||
|
||||
- 基于OAuth2.0协议的单点登录
|
||||
- 基于OAuth2.0+CAS协议的单点登录
|
||||
- 基于JWT的无状态认证
|
||||
- 支持多因子认证（MFA）
|
||||
- OAuth2第三方登录集成
|
||||
- OAuth2+CAS第三方登录集成
|
||||
- 密码复杂度策略
|
||||
|
||||
**权限控制：**
|
||||
|
||||
Binary file not shown.
@ -548,7 +548,7 @@ CJKmainfont: "PingFang SC"
|
||||
|
||||
**图表 1**
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
### 系统数据流向图
|
||||
@ -556,7 +556,7 @@ CJKmainfont: "PingFang SC"
|
||||
|
||||
**图表 2**
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
### 表现层
|
||||
@ -590,7 +590,7 @@ CJKmainfont: "PingFang SC"
|
||||
|
||||
**图表 3**
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
### 容器化部署架构
|
||||
@ -598,7 +598,7 @@ CJKmainfont: "PingFang SC"
|
||||
|
||||
**图表 4**
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
### 硬件配置规格表
|
||||
@ -1089,7 +1089,7 @@ h、**错误响应码**
|
||||
|
||||
**图表 5**
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
###### 数据设计
|
||||
@ -1124,7 +1124,7 @@ h、**错误响应码**
|
||||
|
||||
**图表 6**
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
###### 业务规则
|
||||
@ -1291,7 +1291,7 @@ f、**响应参数**
|
||||
|
||||
**图表 7**
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
###### 数据设计
|
||||
@ -1425,7 +1425,7 @@ f、**响应参数**
|
||||
|
||||
**图表 8**
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
###### 输入输出数据
|
||||
@ -1528,7 +1528,7 @@ f、**响应参数**
|
||||
|
||||
**图表 9**
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
###### 数据设计
|
||||
@ -1589,7 +1589,7 @@ f、**响应参数**
|
||||
|
||||
**图表 10**
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
###### 数据设计
|
||||
@ -1650,7 +1650,7 @@ f、**响应参数**
|
||||
|
||||
**图表 11**
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
###### 数据设计
|
||||
@ -1710,7 +1710,7 @@ f、**响应参数**
|
||||
|
||||
**图表 12**
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
###### 数据设计
|
||||
@ -1771,7 +1771,7 @@ f、**响应参数**
|
||||
|
||||
**图表 13**
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
###### 数据设计
|
||||
@ -1832,7 +1832,7 @@ f、**响应参数**
|
||||
|
||||
**图表 14**
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
###### 数据设计
|
||||
@ -1910,7 +1910,7 @@ f、**响应参数**
|
||||
|
||||
**图表 15**
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
###### 数据设计
|
||||
@ -1988,7 +1988,7 @@ f、**响应参数**
|
||||
|
||||
**图表 16**
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
###### 数据设计
|
||||
@ -2143,7 +2143,7 @@ f、**响应参数**
|
||||
|
||||
**图表 17**
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
###### 数据设计
|
||||
@ -2190,7 +2190,7 @@ f、**响应参数**
|
||||
|
||||
**图表 18**
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
###### 业务规则
|
||||
@ -2238,7 +2238,7 @@ f、**响应参数**
|
||||
|
||||
**图表 19**
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
###### 业务规则
|
||||
@ -2271,7 +2271,7 @@ f、**响应参数**
|
||||
|
||||
**图表 20**
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
###### 业务规则
|
||||
@ -2304,7 +2304,7 @@ f、**响应参数**
|
||||
|
||||
**图表 21**
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
###### 业务规则
|
||||
@ -2588,14 +2588,14 @@ f、**响应参数**
|
||||
|
||||
**图表 22**
|
||||
|
||||
|
||||
|
||||
|
||||
- 申请受理阶段
|
||||
|
||||
|
||||
**图表 23**
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
- 现场勘查设计阶段
|
||||
@ -2603,7 +2603,7 @@ f、**响应参数**
|
||||
|
||||
**图表 24**
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
- 工程施工阶段
|
||||
@ -2611,7 +2611,7 @@ f、**响应参数**
|
||||
|
||||
**图表 25**
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
- 验收移交阶段
|
||||
@ -2619,7 +2619,7 @@ f、**响应参数**
|
||||
|
||||
**图表 26**
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
###### 业务规则
|
||||
@ -2967,7 +2967,7 @@ f、**响应参数**
|
||||
|
||||
**图表 27**
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
###### 界面设计要点
|
||||
@ -3263,7 +3263,7 @@ flowchart TD
|
||||
|
||||
**图表 30**
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
###### 界面设计要点
|
||||
@ -3601,7 +3601,7 @@ flowchart TD
|
||||
|
||||
**图表 32**
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
**接口参数：**
|
||||
@ -3668,7 +3668,7 @@ flowchart TD
|
||||
|
||||
**图表 33**
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
**接口参数：**
|
||||
@ -3707,7 +3707,7 @@ flowchart TD
|
||||
|
||||
**图表 34**
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
## 物联网接口
|
||||
@ -3729,7 +3729,7 @@ flowchart TD
|
||||
|
||||
**图表 35**
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
## 政务系统接口
|
||||
|
||||
@ -26,7 +26,7 @@
|
||||
| `water_biz_security_design.md` | ✅ 已完成 | 100% | A级 | 2024-12-19 | 已剔除等保三级内容，移除标题序号 |
|
||||
| `新-数据库设计说明书.md` | ✅ 已完成 | 100% | A++级 | 2024-12-19 | 完整的PostgreSQL表结构，包含30个系统表+113个业务表的完整字段定义，ER图，索引设计，性能优化，覆盖营收系统全业务场景（新增60个遗漏表） |
|
||||
| `新-详细设计说明书.md` | ✅ 已完成 | 100% | A+级 | 2024-12-19 | 符合302国家标准格式的详细设计文档，包含5个子系统的完整模块设计、接口规范、业务流程，总计1215行，可直接指导开发实施 |
|
||||
| `新-概要设计说明书.md` | ✅ 已完成 | 100% | A+级 | 2024-12-19 | 符合301国家标准格式的概要设计文档，按照用户要求调整为标准目录结构（2系统总体设计-2.1任务概述-2.2设计概述-2.3系统架构设计-2.4子系统定义），包含6个子系统概要设计、非功能性需求等章节，形成完整设计文档体系 |
|
||||
| `新-概要设计说明书.md` | ✅ 已完成 | 100% | A+级 | 2024-12-19 | 符合301国家标准格式的概要设计文档，新增微网厅子系统设计，现包含7个子系统概要设计、非功能性需求等章节，形成更加完整的设计文档体系 |
|
||||
|
||||
### 补充文档 (可选交付)
|
||||
|
||||
@ -159,6 +159,7 @@
|
||||
| 2025-08-01 | 数据库对齐 | 明确约定：若`parsed_docs_new/数据库设计.md`存在对应表，以其为准；并完成关键对齐：`biz_meter_caliber`新增`code`字段，`meter_info`补充源设计字段，新增标准表`system_user_form_config`并保留`infra_user_form_config`兼容说明；在`新-详细/概要设计说明书.md`中加入统一对齐声明 | 对齐源数据库设计 | 正面影响，数据库定义一致性提升，开发实施口径统一，减少后续返工 |
|
||||
| 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个模块完整覆盖了用户认证、信息查询、在线缴费、发票管理、网点服务、业务办理等全流程，提供了完整的技术架构和业务流程设计，为微网厅的实际开发提供了全面的指导 |
|
||||
|
||||
## 项目完成总结
|
||||
|
||||
|
||||
@ -28,6 +28,12 @@
|
||||
- [x] 符合概要设计抽象层次要求 ✅
|
||||
- [x] 提升文档可读性和专业性 ✅
|
||||
|
||||
- [x] **微网厅子系统新增** ✅ (2024-12-19)
|
||||
- [x] 根据微网厅操作手册添加微网厅子系统设计 ✅
|
||||
- [x] 添加微网厅子系统到子系统列表和关系图 ✅
|
||||
- [x] 设计微网厅的6个核心模块：账户绑定管理、信息查询服务、在线缴费服务、电子发票服务、营业网点服务、业务办理服务 ✅
|
||||
- [x] 更新项目管理文件记录变更 ✅
|
||||
|
||||
### 📋 数据库设计文档 (`water_biz_database_design.md`)
|
||||
|
||||
- [x] **数据库设计简化** ✅ (2024-12-19)
|
||||
|
||||
641
新-概要设计说明书.md
641
新-概要设计说明书.md
@ -1,4 +1,4 @@
|
||||
# 福建水务数智营收管理系统概要设计说明书
|
||||
# 营业收费系统概要设计说明书
|
||||
|
||||
| 文件状态： | 文档密级： | 公开 |
|
||||
| :--- | :--- | :--- |
|
||||
@ -17,16 +17,16 @@
|
||||
| 2025-07-17 | V1.1 | 唐伟杰 | 1. 同步详细设计中的模块，补充缺失模块。<br>2. 调整子系统划分与编号，确保逻辑清晰、编号连续。<br>3. 重构表务、报装、客户服务子系统，优化模块设计。<br>4. 统一概要设计与详细设计的结构，提升一致性。 |
|
||||
| 2025-08-01 | V1.2 | 唐伟杰 | 完善 APP相关的模块设计 |
|
||||
| 2025-08-01 | V1.3 | 唐伟杰 | 数据库系统变更：将OpenGauss替换为达梦数据库 8.0+，更新所有相关架构图和技术描述。 |
|
||||
| 2025-08-01 | V1.4 | 唐伟杰 | 单点登录采用OAuth2.0协议：更新单点登录模块描述，强调基于OAuth2.0协议实现。 |
|
||||
| 2025-08-01 | V1.4 | 唐伟杰 | 单点登录采用OAuth2.0+CAS协议：更新单点登录模块描述，强调基于OAuth2.0+CAS协议实现。 |
|
||||
|
||||
# 目录
|
||||
|
||||
- [福建水务数智营收管理系统概要设计说明书](#福建水务数智营收管理系统概要设计说明书)
|
||||
- [营业收费系统概要设计说明书](#营业收费系统概要设计说明书)
|
||||
- [版本历史](#版本历史)
|
||||
- [目录](#目录)
|
||||
- [前言](#前言)
|
||||
- [编写目的](#编写目的)
|
||||
- [背景与任务](#背景与任务)
|
||||
- [背景](#背景)
|
||||
- [术语与缩略语](#术语与缩略语)
|
||||
- [参考资料](#参考资料)
|
||||
- [系统总体设计](#系统总体设计)
|
||||
@ -65,6 +65,8 @@
|
||||
- [模块列表](#模块列表)
|
||||
- [模块间关系](#模块间关系)
|
||||
- [模块描述](#模块描述)
|
||||
- [模块1: 单点登录](#模块1-单点登录)
|
||||
- [模块2: 系统管理](#模块2-系统管理)
|
||||
- [子系统2设计: 营收系统](#子系统2设计-营收系统)
|
||||
- [任务概述](#任务概述-2)
|
||||
- [设计概述](#设计概述-2)
|
||||
@ -76,6 +78,15 @@
|
||||
- [模块列表](#模块列表-1)
|
||||
- [模块间关系](#模块间关系-1)
|
||||
- [模块描述](#模块描述-1)
|
||||
- [模块1: 客户资料管理](#模块1-客户资料管理)
|
||||
- [模块2: 抄表开账](#模块2-抄表开账)
|
||||
- [模块3: 营业收费](#模块3-营业收费)
|
||||
- [模块4: 账务处理](#模块4-账务处理)
|
||||
- [模块5: 发票管理](#模块5-发票管理)
|
||||
- [模块6: 催缴管理](#模块6-催缴管理)
|
||||
- [模块7: 统计分析](#模块7-统计分析)
|
||||
- [模块8: 代收业务](#模块8-代收业务)
|
||||
- [模块9: 业务工单](#模块9-业务工单)
|
||||
- [子系统3设计: 表务系统](#子系统3设计-表务系统)
|
||||
- [任务概述](#任务概述-3)
|
||||
- [设计概述](#设计概述-3)
|
||||
@ -87,6 +98,9 @@
|
||||
- [模块列表](#模块列表-2)
|
||||
- [模块间关系](#模块间关系-2)
|
||||
- [模块描述](#模块描述-2)
|
||||
- [模块1: 表务基础管理](#模块1-表务基础管理)
|
||||
- [模块2: 仓库与库存管理](#模块2-仓库与库存管理)
|
||||
- [模块3: 设备档案管理](#模块3-设备档案管理)
|
||||
- [子系统4设计: 报装系统](#子系统4设计-报装系统)
|
||||
- [任务概述](#任务概述-4)
|
||||
- [设计概述](#设计概述-4)
|
||||
@ -97,17 +111,52 @@
|
||||
- [模块定义](#模块定义-3)
|
||||
- [模块列表](#模块列表-3)
|
||||
- [模块描述](#模块描述-3)
|
||||
- [模块1: 报装流程管理](#模块1-报装流程管理)
|
||||
- [模块2: 工程管理](#模块2-工程管理)
|
||||
- [模块3: 档案管理](#模块3-档案管理)
|
||||
- [子系统5设计: 客户服务](#子系统5设计-客户服务)
|
||||
- [功能与界面](#功能与界面)
|
||||
- [模块列表](#模块列表-4)
|
||||
- [模块设计](#模块设计)
|
||||
- [模块1: 账户绑定管理](#模块1-账户绑定管理)
|
||||
- [模块2: 信息查询服务](#模块2-信息查询服务)
|
||||
- [模块3: 在线缴费服务](#模块3-在线缴费服务)
|
||||
- [模块4: 电子发票服务](#模块4-电子发票服务)
|
||||
- [子系统6设计: 手机抄表APP](#子系统6设计-手机抄表app)
|
||||
- [功能与界面](#功能与界面-1)
|
||||
- [模块列表](#模块列表-5)
|
||||
- [模块设计](#模块设计-1)
|
||||
- [模块1: 登录模块](#模块1-登录模块)
|
||||
- [模块2: 首页搜索模块](#模块2-首页搜索模块)
|
||||
- [模块3: 采集任务管理模块](#模块3-采集任务管理模块)
|
||||
- [模块4: 换表工单模块](#模块4-换表工单模块)
|
||||
- [模块5: 其他工单模块](#模块5-其他工单模块)
|
||||
- [模块6: 个人信息与系统设置模块](#模块6-个人信息与系统设置模块)
|
||||
- [关键技术特性](#关键技术特性)
|
||||
- [离线作业能力](#离线作业能力)
|
||||
- [数据安全保障](#数据安全保障)
|
||||
- [用户体验优化](#用户体验优化)
|
||||
- [子系统7设计: 微网厅系统](#子系统7设计-微网厅系统)
|
||||
- [任务概述](#任务概述-5)
|
||||
- [设计概述](#设计概述-5)
|
||||
- [总体约束](#总体约束-5)
|
||||
- [子系统外部接口](#子系统外部接口-4)
|
||||
- [设计方案概述](#设计方案概述-5)
|
||||
- [子系统架构设计](#子系统架构设计-4)
|
||||
- [模块定义](#模块定义-4)
|
||||
- [子系统6设计: 手机抄表APP](#子系统6设计-手机抄表app)
|
||||
- [任务概述](#任务概述-6)
|
||||
- [设计概述](#设计概述-6)
|
||||
- [子系统架构设计](#子系统架构设计-5)
|
||||
- [模块定义](#模块定义-5)
|
||||
- [关键技术特性](#关键技术特性)
|
||||
- [模块列表](#模块列表-6)
|
||||
- [模块间关系](#模块间关系-3)
|
||||
- [模块描述](#模块描述-4)
|
||||
- [模块1: 账户绑定管理](#模块1-账户绑定管理-1)
|
||||
- [模块2: 信息查询服务](#模块2-信息查询服务-1)
|
||||
- [模块3: 在线缴费服务](#模块3-在线缴费服务-1)
|
||||
- [模块4: 电子发票服务](#模块4-电子发票服务-1)
|
||||
- [模块5: 营业网点服务](#模块5-营业网点服务)
|
||||
- [模块6: 业务办理服务](#模块6-业务办理服务)
|
||||
- [关键技术特性](#关键技术特性-1)
|
||||
- [微信平台集成](#微信平台集成)
|
||||
- [响应式设计](#响应式设计)
|
||||
- [安全保障](#安全保障)
|
||||
- [非功能性需求的设计](#非功能性需求的设计)
|
||||
- [性能的考虑](#性能的考虑)
|
||||
- [兼容性的考虑](#兼容性的考虑)
|
||||
@ -122,7 +171,7 @@
|
||||
|
||||
## 编写目的
|
||||
|
||||
本文档是《福建水务数智营收管理系统详细设计说明书》的前导文档，旨在从总体架构和概要设计的角度对系统进行全面的技术规划和设计。
|
||||
本文档是《营业收费系统详细设计说明书》的前导文档，旨在从总体架构和概要设计的角度对系统进行全面的技术规划和设计。
|
||||
|
||||
**主要目的：**
|
||||
|
||||
@ -139,29 +188,14 @@
|
||||
- 测试团队和运维团队
|
||||
- 甲方技术评审团队
|
||||
|
||||
## 背景与任务
|
||||
## 背景
|
||||
|
||||
福建水务数智营收管理系统是为满足福建省水投数字科技有限公司客户服务管理领域的业务需求而建设的综合管理平台。系统以客户关系数据库为核心和基础，实现客户全生命周期管理。
|
||||
营业收费系统是为满足福建省水投数字科技有限公司客户服务管理领域的业务需求而建设的综合管理平台。系统以客户关系数据库为核心和基础，实现客户全生命周期管理。
|
||||
|
||||
**建设背景：**
|
||||
|
||||
福建水投集团注册资本46亿元，在全省40多个县市区投资重大水利项目超过450亿元，拥有全级次子公司超过67家，职工人数超3500人。当前，集团正紧紧抓住城乡供水一体化建设的机遇，需要构建以客户为中心的客户服务平台。
|
||||
|
||||
**主要任务：**
|
||||
|
||||
1. **业务流程再造**：梳理和优化客户服务管理领域的业务流程
|
||||
2. **组织架构优化**：配合业务流程重组，优化组织架构和管理制度
|
||||
3. **绩效体系建设**：建立科学的绩效考核标准和评价体系
|
||||
4. **平台系统建设**：构建以客户为中心的一体化客户服务平台
|
||||
5. **服务质量提升**：全面提高客户服务质量和客户满意度
|
||||
|
||||
**技术目标：**
|
||||
|
||||
- 采用现代化微服务架构，支持大规模并发访问
|
||||
- 支持多租户模式，满足集团化管理需求
|
||||
- 实现移动化办公，提高工作效率
|
||||
- 集成物联网技术，支持智能水表远程抄表
|
||||
- 适配国产化环境，确保系统安全可控
|
||||
|
||||
## 术语与缩略语
|
||||
|
||||
@ -186,10 +220,6 @@
|
||||
|
||||
## 参考资料
|
||||
|
||||
- 《福建水务数智营收管理系统需求规格说明书》
|
||||
- 《福建水务数智营收管理系统详细设计说明书》
|
||||
- 《福建水务数智营收管理系统数据库设计说明书》
|
||||
- 《福建水务数智营收管理系统接口设计说明书》
|
||||
- GB/T 8556-2007 信息技术软件生存周期过程
|
||||
- GB/T 9385-2008 计算机软件需求规格说明规范
|
||||
- GB/T 8567-2006 计算机软件文档编制规范
|
||||
@ -202,7 +232,7 @@
|
||||
|
||||
### 系统总体目标
|
||||
|
||||
福建水务数智营收管理系统主要包含统一平台、营收系统、表务系统、报装系统、客户服务和手机抄表APP等子系统，以及相关外部接口集成。
|
||||
营业收费系统主要包含统一平台、营收系统、表务系统、报装系统、客户服务和手机抄表APP等子系统，以及相关外部接口集成。
|
||||
|
||||
通过系统的建设，实现福建省水投数字科技有限公司客户服务管理领域的业务流程梳理再造、组织架构的优化、管理制度的建设、绩效考核标准的建设。构建以客户为中心的一体化客户服务平台，将客户的所有信息进行有机的关联，方便企业对营收信息进行综合分析和管理，为客户提供更多、更便捷、更主动的个性化服务，提高客户服务的质量和客户满意度。
|
||||
|
||||
@ -280,6 +310,12 @@
|
||||
| 物联网 | 集抄系统接口 | 智能水表数据采集 | TCP/HTTPS |
|
||||
| 税务服务 | 电子发票接口 | 第三方发票开具 | HTTPS |
|
||||
| 认证服务 | 身份认证接口 | 第三方身份验证 | HTTPS |
|
||||
| 认证服务 | CAS单点登录 | 第三方身份验证 | HTTPS |
|
||||
| 认证服务 | OAuth2.0单点登录 | 第三方身份验证 | HTTPS |
|
||||
| 外部系统 | 微信消息推送 | 微信消息推送 | HTTPS |
|
||||
| 外部系统 | 大工单系统 | 大工单系统 | HTTPS |
|
||||
| 外部系统 | 报装系统 | 报装系统 | HTTPS |
|
||||
|
||||
|
||||
### 设计方案概述
|
||||
|
||||
@ -295,7 +331,7 @@
|
||||
- **缓存**：Redis 6.0+（集群模式）
|
||||
- **消息队列**：RabbitMQ 3.9+
|
||||
- **文件存储**：MinIO（分布式文件存储）
|
||||
- **容器化**：Docker + Docker Compose
|
||||
- **容器化**：基于Docker的容器化部署，使用Docker Compose进行容器编排，使用Kubernetes进行容器编排和调度。
|
||||
|
||||
**部署方案**：
|
||||
|
||||
@ -314,8 +350,9 @@ graph TB
|
||||
subgraph "表现层"
|
||||
A1[Web管理端<br/>Vue3 + Element Plus]
|
||||
A2[移动抄表端<br/>uni-app]
|
||||
A3[客户微信小程序]
|
||||
A4[客户支付宝小程序]
|
||||
|
||||
A3[微网厅<br/>微信]
|
||||
A4[微网厅<br/>支付宝]
|
||||
end
|
||||
|
||||
subgraph "网关层"
|
||||
@ -377,7 +414,7 @@ graph TB
|
||||
|
||||
**表现层（Presentation Layer）**
|
||||
- 负责用户交互和界面展示
|
||||
- 包含多种客户端形态：Web端、移动端、小程序端
|
||||
- 包含多种客户端形态：Web端、微网厅（微信、支付宝）
|
||||
- 采用前后端分离架构，提高开发效率和用户体验
|
||||
|
||||
**网关层（Gateway Layer）**
|
||||
@ -408,7 +445,7 @@ flowchart TD
|
||||
A1[移动抄表APP<br/>数据采集]
|
||||
A2[智能水表<br/>远程数据]
|
||||
A3[Web管理端<br/>业务录入]
|
||||
A4[客户端小程序<br/>用户数据]
|
||||
A4[微网厅<br/>用户数据]
|
||||
A5[外部系统<br/>接口数据]
|
||||
end
|
||||
|
||||
@ -487,7 +524,7 @@ flowchart TD
|
||||
|
||||
### 系统的物理架构设计
|
||||
|
||||
系统采用分布式部署架构，通过多个服务器集群实现高可用和高性能。
|
||||
系统采用分布式部署架构，通过多个服务器集群实现高可用和高性能，支持 DevOps 持续交付。
|
||||
|
||||
#### 物理部署图
|
||||
|
||||
@ -572,7 +609,7 @@ graph TB
|
||||
| 设备类型 | 配置规格 | 数量 | 主要作用 |
|
||||
|---------|---------|------|----------|
|
||||
| Web服务器 | 8核32G，1TB SSD | 2台 | 前端应用部署 |
|
||||
| 应用服务器 | 16核64G，2TB SSD | 2台 | 后端服务部署 |
|
||||
| 应用服务器 | 32核128G，2TB SSD | 3台 | 后端服务部署 |
|
||||
| 消息队列服务器 | 8核16G，1TB SSD | 2台 | 异步消息处理 |
|
||||
|
||||
**数据服务区配置**
|
||||
@ -634,7 +671,7 @@ graph TB
|
||||
|
||||
#### 容器化部署架构
|
||||
|
||||
系统采用Docker容器化部署，使用Docker Compose进行服务编排，支持快速部署和弹性扩缩容。
|
||||
系统采用基于Docker的容器化部署，使用Docker Compose进行容器编排，使用Kubernetes进行容器编排和调度,支持DevOps持续交付。
|
||||
|
||||
```mermaid
|
||||
graph TB
|
||||
@ -678,8 +715,9 @@ graph TB
|
||||
| SYS-002 | 营收系统 | 客户管理、抄表开账、营业收费、账务处理、发票管理、催缴管理 | 自行开发 |
|
||||
| SYS-003 | 表务系统 | 表务工单、表务仓库、水表全生命周期管理 | 自行开发 |
|
||||
| SYS-004 | 报装系统 | 报装流程管理、现场踏勘、合同签订、施工验收 | 自行开发 |
|
||||
| SYS-005 | 客户服务 | 微信小程序、支付宝小程序、客户自助服务 | 自行开发 |
|
||||
| SYS-005 | 客户服务 | 客户自助服务、在线服务支持 | 自行开发 |
|
||||
| SYS-006 | 手机抄表APP | 移动端抄表、工单处理、数据同步 | 自行开发 |
|
||||
| SYS-007 | 微网厅系统 | 微信公众号服务、账户绑定管理、在线缴费、业务办理 | 自行开发 |
|
||||
|
||||
### 子系统间关系
|
||||
|
||||
@ -704,30 +742,37 @@ graph TB
|
||||
end
|
||||
|
||||
subgraph "客户服务"
|
||||
CS[微信小程序<br/>支付宝小程序<br/>在线缴费]
|
||||
CS[客户自助服务<br/>在线服务支持]
|
||||
end
|
||||
|
||||
subgraph "手机抄表APP"
|
||||
APP[移动抄表<br/>工单处理]
|
||||
end
|
||||
|
||||
subgraph "微网厅系统"
|
||||
WECHAT[微信公众号服务<br/>账户绑定管理<br/>在线缴费<br/>业务办理]
|
||||
end
|
||||
|
||||
%% 调用关系
|
||||
UP -.->|用户认证<br/>权限验证| REV
|
||||
UP -.->|用户认证<br/>权限验证| METER
|
||||
UP -.->|用户认证<br/>权限验证| INSTALL
|
||||
UP -.->|用户认证<br/>权限验证| CS
|
||||
UP -.->|用户认证<br/>权限验证| APP
|
||||
UP -.->|用户认证<br/>权限验证| WECHAT
|
||||
|
||||
REV -.->|客户信息<br/>水表信息| METER
|
||||
REV -.->|新用户立户| INSTALL
|
||||
REV -.->|账单信息<br/>缴费接口| CS
|
||||
REV -.->|抄表任务<br/>欠费信息| APP
|
||||
REV -.->|客户信息<br/>账单查询<br/>缴费处理| WECHAT
|
||||
|
||||
METER -.->|换表通知<br/>库存信息| REV
|
||||
METER -.->|工单信息| APP
|
||||
|
||||
INSTALL -.->|立户信息| REV
|
||||
CS -.->|缴费记录| REV
|
||||
WECHAT -.->|缴费记录<br/>业务申请| REV
|
||||
|
||||
APP -.->|抄表数据<br/>工单回填| REV
|
||||
APP -.->|工单回填| METER
|
||||
@ -747,9 +792,9 @@ graph TB
|
||||
|
||||
| 接口名称 | 接口描述 | 调用方 | 接口协议 |
|
||||
|---------|----------|--------|----------|
|
||||
| 客户信息查询接口 | 查询客户基本信息 | 表务系统、客户服务 | HTTP/REST |
|
||||
| 账单查询接口 | 查询客户账单信息 | 客户服务 | HTTP/REST |
|
||||
| 缴费处理接口 | 处理在线缴费 | 客户服务 | HTTP/REST |
|
||||
| 客户信息查询接口 | 查询客户基本信息 | 表务系统、微网厅系统 | HTTP/REST |
|
||||
| 账单查询接口 | 查询客户账单信息 | 微网厅系统 | HTTP/REST |
|
||||
| 缴费处理接口 | 处理在线缴费 | 微网厅系统 | HTTP/REST |
|
||||
| 立户接口 | 新客户立户 | 报装系统 | HTTP/REST |
|
||||
| 抄表任务接口 | 下发抄表任务和客户信息 | 手机抄表APP | HTTP/REST |
|
||||
| 抄表数据上传接口 | 上传抄表数据 | 手机抄表APP | HTTP/REST |
|
||||
@ -763,11 +808,21 @@ graph TB
|
||||
| 工单查询接口 | 查询待办工单 | 手机抄表APP | HTTP/REST |
|
||||
| 工单回填接口 | 回填工单处理结果 | 手机抄表APP | HTTP/REST |
|
||||
|
||||
**微网厅系统对外接口**
|
||||
|
||||
| 接口名称 | 接口描述 | 调用方 | 接口协议 |
|
||||
|---------|----------|--------|-----------|
|
||||
| 微信授权接口 | 处理微信用户授权登录 | 微信公众号 | HTTP/REST |
|
||||
| 账户绑定接口 | 处理用户账户绑定和解绑 | 微信公众号 | HTTP/REST |
|
||||
| 缴费接口 | 处理在线缴费业务 | 微信、支付宝 | HTTP/REST |
|
||||
| 业务办理接口 | 处理各类业务申请 | 微信公众号 | HTTP/REST |
|
||||
| 发票管理接口 | 处理电子发票开具和推送 | 微信公众号 | HTTP/REST |
|
||||
|
||||
# 子系统1设计: 统一平台
|
||||
|
||||
## 任务概述
|
||||
|
||||
统一平台是整个福建水务数智营收管理系统的基础支撑平台，负责为所有子系统提供统一的用户认证、权限管理、组织管理等基础服务。
|
||||
统一平台是整个营业收费系统的基础支撑平台，负责为所有子系统提供统一的用户认证、权限管理、组织管理等基础服务。
|
||||
|
||||
**设计目标：**
|
||||
|
||||
@ -792,7 +847,7 @@ graph TB
|
||||
|
||||
**技术约束：**
|
||||
|
||||
- 基于Spring Security + OAuth2.0协议实现认证授权
|
||||
- 基于Spring Security + OAuth2.0+CAS协议实现认证授权
|
||||
- 采用JWT令牌实现无状态认证
|
||||
- 支持Redis分布式会话存储
|
||||
- 遵循RBAC权限控制模型
|
||||
@ -825,11 +880,11 @@ graph TB
|
||||
|
||||
**架构设计：**
|
||||
|
||||
统一平台采用基于Spring Boot的微服务架构，使用Spring Security + OAuth2.0实现认证授权，Redis存储会话和缓存数据，支持水平扩展。
|
||||
统一平台采用基于Spring Boot的微服务架构，使用Spring Security + OAuth2.0+CAS协议实现认证授权，Redis存储会话和缓存数据，支持水平扩展。
|
||||
|
||||
**技术选型：**
|
||||
|
||||
- **认证授权**：Spring Security + OAuth2.0 + JWT
|
||||
- **认证授权**：Spring Security + OAuth2.0 + CAS协议 + JWT
|
||||
- **缓存存储**：Redis 6.0+（分布式缓存）
|
||||
- **数据库**：达梦数据库 8.0+
|
||||
- **消息队列**：RabbitMQ（异步通知）
|
||||
@ -962,14 +1017,14 @@ graph TB
|
||||
|
||||
**功能描述：**
|
||||
|
||||
单点登录模块基于OAuth2.0协议实现，提供统一的用户认证入口，支持多种登录方式和安全策略。该模块是整个系统安全的第一道防线，确保只有合法用户才能访问系统。
|
||||
单点登录模块基于OAuth2.0+CAS协议实现，提供统一的用户认证入口，支持多种登录方式和安全策略。该模块是整个系统安全的第一道防线，确保只有合法用户才能访问系统。
|
||||
|
||||
**主要功能：**
|
||||
|
||||
1. **用户名密码登录**：传统的用户名密码认证方式
|
||||
2. **手机号短信登录**：基于短信验证码的快速登录
|
||||
3. **第三方登录**：支持微信、支付宝等第三方平台登录
|
||||
4. **OAuth2.0单点登录**：基于OAuth2.0协议，一次登录，多系统访问
|
||||
4. **OAuth2.0单点登录**：基于OAuth2.0+CAS协议，一次登录，多系统访问
|
||||
5. **自动登录**：支持"记住我"功能
|
||||
6. **安全控制**：密码策略、登录限制、验证码等
|
||||
|
||||
@ -1006,7 +1061,7 @@ graph TB
|
||||
|
||||
## 任务概述
|
||||
|
||||
营收系统是整个福建水务数智营收管理系统的核心业务系统，负责处理从客户管理到账务处理的完整营收业务流程。
|
||||
营收系统是整个营业收费系统的核心业务系统，负责处理从客户管理到账务处理的完整营收业务流程。
|
||||
|
||||
**设计目标：**
|
||||
|
||||
@ -1767,7 +1822,7 @@ flowchart TD
|
||||
|
||||
## 功能与界面
|
||||
|
||||
客户服务系统为用水客户提供多渠道、便捷的线上自助服务，主要通过微信和支付宝小程序实现。
|
||||
客户服务系统为用水客户提供多渠道、便捷的线上自助服务，主要通过微网厅（微信、支付宝）实现。
|
||||
|
||||
## 模块列表
|
||||
|
||||
@ -1904,6 +1959,480 @@ flowchart TD
|
||||
- **智能搜索**: 实时搜索、关键词高亮、历史记录
|
||||
- **便捷导航**: 户间切换、快速定位、批量操作
|
||||
|
||||
# 子系统7设计: 微网厅系统
|
||||
|
||||
## 任务概述
|
||||
|
||||
微网厅系统是基于微信公众号平台的客户自助服务系统，为用水客户提供便捷的线上服务渠道。
|
||||
|
||||
**设计目标：**
|
||||
|
||||
- 构建一流的客户服务平台，让百姓足不出户就能办理日常业务
|
||||
- 实现企业对外服务的标准化、统一化管理
|
||||
- 提升企业管理水平和客户满意度
|
||||
- 加速企业实现数字化转型进程
|
||||
|
||||
**功能范围：**
|
||||
|
||||
- **账户绑定管理**：微信授权、账户绑定与解绑、多账户管理
|
||||
- **信息查询服务**：账单查询、用水历史、缴费记录、停水公告
|
||||
- **在线缴费服务**：快捷缴费、充值服务、多种支付方式
|
||||
- **电子发票服务**：发票查看、发票推送、电子发票管理
|
||||
- **营业网点服务**：网点查询、地图导航、距离计算
|
||||
- **业务办理服务**：联系方式变更、开票方式变更、更名过户、水价变更、低保申请、换表申请、自主抄表
|
||||
|
||||
## 设计概述
|
||||
|
||||
### 总体约束
|
||||
|
||||
**技术约束：**
|
||||
|
||||
- 基于微信公众号开发，使用微信公众平台API
|
||||
- 采用响应式设计，适配移动端浏览器
|
||||
- 遵循微信开发规范和安全要求
|
||||
- 支持微信支付和第三方支付集成
|
||||
|
||||
**性能约束：**
|
||||
|
||||
- 支持10万+注册用户
|
||||
- 页面加载时间≤3秒
|
||||
- 支持并发用户≥1000个
|
||||
- 缴费交易响应时间≤2秒
|
||||
|
||||
**安全约束：**
|
||||
|
||||
- 微信OAuth2.0用户认证
|
||||
- 账户绑定安全验证
|
||||
- 支付安全保障
|
||||
- 敏感信息加密传输
|
||||
|
||||
### 子系统外部接口
|
||||
|
||||
| 接口编号 | 接口名称（标识） | 功能描述 | 接口协议 | 输入参数 | 输出结果 |
|
||||
|---|---|---|---|---|---|
|
||||
| WECHAT-001 | 微信授权接口 | 处理微信用户授权登录 | HTTP/REST | 微信授权码 | 用户信息、访问令牌 |
|
||||
| WECHAT-002 | 账户绑定接口 | 处理用户账户绑定 | HTTP/REST | 客户编号、手机号 | 绑定结果 |
|
||||
| WECHAT-003 | 账单查询接口 | 查询客户账单信息 | HTTP/REST | 客户编号、查询条件 | 账单详情 |
|
||||
| WECHAT-004 | 缴费处理接口 | 处理在线缴费业务 | HTTP/REST | 订单信息、支付方式 | 缴费结果 |
|
||||
| WECHAT-005 | 业务申请接口 | 处理各类业务申请 | HTTP/REST | 业务类型、申请材料 | 申请结果 |
|
||||
|
||||
### 设计方案概述
|
||||
|
||||
**架构设计：**
|
||||
|
||||
微网厅系统采用前后端分离架构，前端基于微信公众号H5页面，后端提供RESTful API服务，通过微信公众平台实现用户认证和消息推送。
|
||||
|
||||
**技术选型：**
|
||||
|
||||
- **前端技术**：微信公众号H5、Vue.js、WeUI组件库
|
||||
- **后端技术**：Spring Boot + Spring Security
|
||||
- **认证授权**：微信OAuth2.0 + JWT
|
||||
- **支付集成**：微信支付、支付宝支付
|
||||
- **消息推送**：微信模板消息、微信客服消息
|
||||
|
||||
## 子系统架构设计
|
||||
|
||||
微网厅系统采用基于微信公众号的服务架构，通过微信平台提供统一的用户入口和服务渠道。
|
||||
|
||||
```mermaid
|
||||
graph TB
|
||||
subgraph "微网厅系统架构"
|
||||
subgraph "微信平台层"
|
||||
A1[微信公众号菜单]
|
||||
A2[微信网页授权]
|
||||
A3[微信支付接口]
|
||||
A4[微信消息推送]
|
||||
end
|
||||
|
||||
subgraph "前端展示层"
|
||||
B1[账户绑定页面]
|
||||
B2[信息查询页面]
|
||||
B3[缴费服务页面]
|
||||
B4[业务办理页面]
|
||||
B5[发票管理页面]
|
||||
B6[网点查询页面]
|
||||
end
|
||||
|
||||
subgraph "业务服务层"
|
||||
C1[账户绑定服务]
|
||||
C2[信息查询服务]
|
||||
C3[缴费处理服务]
|
||||
C4[发票管理服务]
|
||||
C5[网点查询服务]
|
||||
C6[业务办理服务]
|
||||
end
|
||||
|
||||
subgraph "数据接口层"
|
||||
D1[营收系统接口]
|
||||
D2[支付平台接口]
|
||||
D3[发票系统接口]
|
||||
D4[短信平台接口]
|
||||
end
|
||||
end
|
||||
|
||||
A1 --> B1
|
||||
A2 --> B2
|
||||
A3 --> B3
|
||||
A4 --> B4
|
||||
|
||||
B1 --> C1
|
||||
B2 --> C2
|
||||
B3 --> C3
|
||||
B4 --> C6
|
||||
B5 --> C4
|
||||
B6 --> C5
|
||||
|
||||
C1 --> D1
|
||||
C2 --> D1
|
||||
C3 --> D1
|
||||
C3 --> D2
|
||||
C4 --> D3
|
||||
C6 --> D4
|
||||
```
|
||||
|
||||
## 模块定义
|
||||
|
||||
### 模块列表
|
||||
|
||||
| 模块编号 | 模块名称（标识） | 功能描述 | 开发方式 |
|
||||
|---|---|---|---|
|
||||
| WECHAT-001 | 账户绑定管理 | 微信用户认证、账户绑定与解绑、多账户管理 | 自行开发 |
|
||||
| WECHAT-002 | 信息查询服务 | 账单查询、用水历史、缴费记录、停水公告 | 自行开发 |
|
||||
| WECHAT-003 | 在线缴费服务 | 快捷缴费、充值服务、多种支付方式 | 自行开发 |
|
||||
| WECHAT-004 | 电子发票服务 | 发票查看、发票推送、电子发票下载 | 自行开发 |
|
||||
| WECHAT-005 | 营业网点服务 | 网点查询、地图导航、营业时间查询 | 自行开发 |
|
||||
| WECHAT-006 | 业务办理服务 | 各类业务在线申请、进度查询、审批流程 | 自行开发 |
|
||||
|
||||
### 模块间关系
|
||||
|
||||
微网厅系统各模块围绕用户服务形成完整的服务链条，从账户绑定到业务办理的全流程覆盖。
|
||||
|
||||
```mermaid
|
||||
graph TB
|
||||
A[账户绑定管理] --> B[信息查询服务]
|
||||
B --> C[在线缴费服务]
|
||||
C --> D[电子发票服务]
|
||||
A --> E[营业网点服务]
|
||||
A --> F[业务办理服务]
|
||||
|
||||
A -.->|用户身份认证| B
|
||||
B -.->|账单信息| C
|
||||
C -.->|缴费记录| D
|
||||
E -.->|网点信息| F
|
||||
F -.->|业务进度| B
|
||||
```
|
||||
|
||||
### 模块描述
|
||||
|
||||
#### 模块1: 账户绑定管理
|
||||
|
||||
**功能描述：**
|
||||
|
||||
账户绑定管理模块是微网厅系统的基础模块，负责处理微信用户与水务账户的绑定关系。
|
||||
|
||||
**核心功能：**
|
||||
|
||||
1. **微信授权认证**
|
||||
- 微信网页授权登录
|
||||
- 用户基本信息获取
|
||||
- 授权状态管理
|
||||
- 快捷登录支持
|
||||
|
||||
2. **账户绑定管理**
|
||||
- 自动绑定：根据手机号自动匹配客户信息
|
||||
- 手工绑定：通过客户编号手动绑定
|
||||
- 批量绑定：支持一个微信账号绑定多个水务账户
|
||||
- 绑定验证：短信验证码确保绑定安全
|
||||
|
||||
3. **多账户管理**
|
||||
- 默认账户设置
|
||||
- 账户切换功能
|
||||
- 账户信息查看
|
||||
- 账户解绑操作
|
||||
|
||||
**业务规则：**
|
||||
|
||||
- 每个微信账号最多绑定10个水务账户
|
||||
- 绑定时需要手机号验证或客户编号验证
|
||||
- 解绑操作需要二次确认
|
||||
- 支持设置默认显示账户
|
||||
|
||||
#### 模块2: 信息查询服务
|
||||
|
||||
**功能描述：**
|
||||
|
||||
信息查询服务模块提供全面的用水信息查询功能，为客户提供便捷的信息获取渠道。
|
||||
|
||||
**核心功能：**
|
||||
|
||||
1. **账单查询**
|
||||
- 当期账单查询
|
||||
- 历史账单查询
|
||||
- 账单详情展示
|
||||
- 欠费统计分析
|
||||
|
||||
2. **用水分析**
|
||||
- 用水量趋势图表
|
||||
- 同期用水对比
|
||||
- 用水量统计分析
|
||||
- 节水建议推送
|
||||
|
||||
3. **缴费记录查询**
|
||||
- 历史缴费记录
|
||||
- 缴费方式统计
|
||||
- 缴费凭证查看
|
||||
- 退费记录查询
|
||||
|
||||
4. **停水公告查询**
|
||||
- 计划停水通知
|
||||
- 临时停水公告
|
||||
- 区域停水查询
|
||||
- 停水时间提醒
|
||||
|
||||
**业务规则：**
|
||||
|
||||
- 查询范围限制为已绑定的账户
|
||||
- 历史数据保留最近24个月
|
||||
- 敏感信息脱敏显示
|
||||
- 支持按时间范围筛选
|
||||
|
||||
#### 模块3: 在线缴费服务
|
||||
|
||||
**功能描述：**
|
||||
|
||||
在线缴费服务模块提供便捷的线上缴费功能，支持多种支付方式和缴费场景。
|
||||
|
||||
**核心功能：**
|
||||
|
||||
1. **快捷缴费**
|
||||
- 欠费快捷缴纳
|
||||
- 预付款充值
|
||||
- 分期缴费支持
|
||||
- 代缴功能
|
||||
|
||||
2. **多渠道支付**
|
||||
- 微信支付
|
||||
- 支付宝支付
|
||||
- 银行卡支付
|
||||
- 数字人民币支付
|
||||
|
||||
3. **缴费管理**
|
||||
- 缴费确认
|
||||
- 支付状态查询
|
||||
- 缴费失败处理
|
||||
- 退款申请
|
||||
|
||||
4. **支付安全**
|
||||
- 支付限额控制
|
||||
- 支付密码验证
|
||||
- 异常交易监控
|
||||
- 资金安全保障
|
||||
|
||||
**业务流程图：**
|
||||
|
||||
```mermaid
|
||||
flowchart TD
|
||||
A[客户选择缴费] --> B[选择缴费账户]
|
||||
B --> C[查询待缴费账单]
|
||||
C --> D{是否有欠费?}
|
||||
D -->|是| E[显示欠费金额]
|
||||
D -->|否| F[选择充值金额]
|
||||
E --> G[选择支付方式]
|
||||
F --> G
|
||||
G --> H{支付方式}
|
||||
H -->|微信支付| I[调用微信支付]
|
||||
H -->|支付宝支付| J[调用支付宝支付]
|
||||
H -->|银行卡支付| K[调用银行支付]
|
||||
I --> L[支付确认]
|
||||
J --> L
|
||||
K --> L
|
||||
L --> M{支付成功?}
|
||||
M -->|是| N[更新账户状态]
|
||||
M -->|否| O[支付失败处理]
|
||||
N --> P[发送缴费成功通知]
|
||||
O --> Q[重新支付或取消]
|
||||
P --> R[结束]
|
||||
Q --> G
|
||||
```
|
||||
|
||||
**业务规则：**
|
||||
|
||||
- 单次支付金额不超过5000元
|
||||
- 支付超时时间为15分钟
|
||||
- 支付失败自动退款
|
||||
- 支持部分缴费和全额缴费
|
||||
|
||||
#### 模块4: 电子发票服务
|
||||
|
||||
**功能描述：**
|
||||
|
||||
电子发票服务模块提供电子发票的开具、查询、推送等全流程服务。
|
||||
|
||||
**核心功能：**
|
||||
|
||||
1. **发票开具**
|
||||
- 缴费后自动开票
|
||||
- 手动申请开票
|
||||
- 个人发票开具
|
||||
- 企业发票开具
|
||||
|
||||
2. **发票管理**
|
||||
- 发票列表查看
|
||||
- 发票详情展示
|
||||
- 发票状态跟踪
|
||||
- 发票作废申请
|
||||
|
||||
3. **发票推送**
|
||||
- 邮箱推送
|
||||
- 微信推送
|
||||
- 短信通知
|
||||
- 下载链接分享
|
||||
|
||||
4. **发票下载**
|
||||
- PDF格式下载
|
||||
- 图片格式保存
|
||||
- 批量下载
|
||||
- 云端存储
|
||||
|
||||
**业务规则：**
|
||||
|
||||
- 发票开具时效为缴费后7天内
|
||||
- 电子发票与纸质发票具有同等法律效力
|
||||
- 发票信息一经开具不可修改
|
||||
- 支持发票红冲和重开
|
||||
|
||||
#### 模块5: 营业网点服务
|
||||
|
||||
**功能描述：**
|
||||
|
||||
营业网点服务模块提供营业网点查询和导航服务，帮助客户就近办理业务。
|
||||
|
||||
**核心功能：**
|
||||
|
||||
1. **网点查询**
|
||||
- 按距离排序
|
||||
- 按区域筛选
|
||||
- 按服务类型筛选
|
||||
- 关键词搜索
|
||||
|
||||
2. **网点信息**
|
||||
- 网点地址详情
|
||||
- 营业时间查询
|
||||
- 联系电话
|
||||
- 服务项目
|
||||
|
||||
3. **地图导航**
|
||||
- 位置标注展示
|
||||
- 路线规划
|
||||
- 实时导航
|
||||
- 距离计算
|
||||
|
||||
4. **服务预约**
|
||||
- 业务预约
|
||||
- 排队叫号
|
||||
- 预约提醒
|
||||
- 预约取消
|
||||
|
||||
**业务规则：**
|
||||
|
||||
- 支持GPS定位和手动定位
|
||||
- 显示范围限制在50公里内
|
||||
- 实时更新营业状态
|
||||
- 支持收藏常用网点
|
||||
|
||||
#### 模块6: 业务办理服务
|
||||
|
||||
**功能描述：**
|
||||
|
||||
业务办理服务模块提供各类水务业务的在线申请和办理功能。
|
||||
|
||||
**核心功能：**
|
||||
|
||||
1. **业务申请**
|
||||
- 联系方式变更
|
||||
- 开票方式变更
|
||||
- 更名过户业务
|
||||
- 一户多人口申请
|
||||
- 水价变更申请
|
||||
- 低保优惠申请
|
||||
- 换表维修申请
|
||||
- 自主抄表申请
|
||||
|
||||
2. **申请材料管理**
|
||||
- 材料清单提示
|
||||
- 在线拍照上传
|
||||
- 文件格式转换
|
||||
- 材料完整性检查
|
||||
|
||||
3. **业务进度跟踪**
|
||||
- 申请状态查询
|
||||
- 审批进度展示
|
||||
- 办理结果通知
|
||||
- 业务历史记录
|
||||
|
||||
4. **客服互动**
|
||||
- 在线咨询
|
||||
- 业务指导
|
||||
- 问题反馈
|
||||
- 满意度评价
|
||||
|
||||
**业务流程图：**
|
||||
|
||||
```mermaid
|
||||
flowchart TD
|
||||
A[客户选择业务类型] --> B[填写申请信息]
|
||||
B --> C[上传申请材料]
|
||||
C --> D{材料是否完整?}
|
||||
D -->|否| E[提示补充材料]
|
||||
E --> C
|
||||
D -->|是| F[提交业务申请]
|
||||
F --> G[系统自动审核]
|
||||
G --> H{自动审核结果}
|
||||
H -->|通过| I[进入人工审核]
|
||||
H -->|不通过| J[申请驳回]
|
||||
I --> K{人工审核结果}
|
||||
K -->|通过| L[业务受理成功]
|
||||
K -->|不通过| J
|
||||
L --> M[安排现场处理]
|
||||
M --> N[现场处理完成]
|
||||
N --> O[业务办结]
|
||||
O --> P[客户满意度评价]
|
||||
J --> Q[通知客户重新申请]
|
||||
P --> R[结束]
|
||||
Q --> A
|
||||
```
|
||||
|
||||
**业务规则：**
|
||||
|
||||
- 业务申请需要实名认证
|
||||
- 上传材料单次最多9张
|
||||
- 支持的图片格式：JPG、PNG、PDF
|
||||
- 申请提交后不可撤销
|
||||
- 办理时效按业务类型确定
|
||||
|
||||
## 关键技术特性
|
||||
|
||||
### 微信平台集成
|
||||
|
||||
- **微信OAuth2.0认证**：安全的用户身份验证
|
||||
- **微信JS-SDK**：调用微信原生功能
|
||||
- **微信支付**：便捷的支付体验
|
||||
- **微信消息推送**：及时的业务通知
|
||||
|
||||
### 响应式设计
|
||||
|
||||
- **移动端适配**：完美适配各种移动设备
|
||||
- **触屏优化**：优化的触屏交互体验
|
||||
- **加载优化**：快速的页面加载速度
|
||||
- **离线支持**：基础功能离线可用
|
||||
|
||||
### 安全保障
|
||||
|
||||
- **数据加密**：敏感数据传输加密
|
||||
- **身份验证**：多重身份验证机制
|
||||
- **支付安全**：完善的支付安全策略
|
||||
- **隐私保护**：严格的用户隐私保护
|
||||
|
||||
# 非功能性需求的设计
|
||||
|
||||
## 性能的考虑
|
||||
@ -1959,10 +2488,10 @@ flowchart TD
|
||||
|
||||
**身份认证：**
|
||||
|
||||
- 基于OAuth2.0协议的单点登录
|
||||
- 基于OAuth2.0+CAS协议的单点登录
|
||||
- 基于JWT的无状态认证
|
||||
- 支持多因子认证（MFA）
|
||||
- OAuth2第三方登录集成
|
||||
- OAuth2+CAS第三方登录集成
|
||||
- 密码复杂度策略
|
||||
|
||||
**权限控制：**
|
||||
|
||||
3133
新-概要设计说明书AI版本.md
Normal file
3133
新-概要设计说明书AI版本.md
Normal file
File diff suppressed because it is too large
Load Diff
Loading…
x
Reference in New Issue
Block a user