更新福建水务营收系统概要设计文档,新增子系统5(客户服务)和子系统6(手机抄表APP)设计内容,补充任务概述、设计概述、模块定义及模块间关系,完善功能描述和核心功能,更新相关Mermaid图表,提升文档的完整性和可读性,符合甲方A级交付标准。

This commit is contained in:
tangweijie 2025-08-14 11:11:54 +08:00
parent 59469fe2eb
commit f39a3e6d25
7 changed files with 604 additions and 156 deletions

View File

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

View File

@ -126,28 +126,6 @@ CJKmainfont: "PingFang SC"
- [模块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)
@ -155,9 +133,45 @@ CJKmainfont: "PingFang SC"
- [设计方案概述](#设计方案概述-5)
- [子系统架构设计](#子系统架构设计-4)
- [模块定义](#模块定义-4)
- [模块列表](#模块列表-6)
- [模块列表](#模块列表-4)
- [模块间关系](#模块间关系-3)
- [模块描述](#模块描述-4)
- [模块1: 账户绑定管理](#模块1-账户绑定管理)
- [模块2: 信息查询服务](#模块2-信息查询服务)
- [模块3: 在线缴费服务](#模块3-在线缴费服务)
- [模块4: 电子发票服务](#模块4-电子发票服务)
- [子系统6设计: 手机抄表APP](#子系统6设计-手机抄表app)
- [任务概述](#任务概述-6)
- [设计概述](#设计概述-6)
- [总体约束](#总体约束-6)
- [子系统外部接口](#子系统外部接口-5)
- [设计方案概述](#设计方案概述-6)
- [子系统架构设计](#子系统架构设计-5)
- [模块定义](#模块定义-5)
- [模块列表](#模块列表-5)
- [模块间关系](#模块间关系-4)
- [模块描述](#模块描述-5)
- [模块1: 登录模块](#模块1-登录模块)
- [模块2: 首页搜索模块](#模块2-首页搜索模块)
- [模块3: 采集任务管理模块](#模块3-采集任务管理模块)
- [模块4: 换表工单模块](#模块4-换表工单模块)
- [模块5: 其他工单模块](#模块5-其他工单模块)
- [模块6: 个人信息与系统设置模块](#模块6-个人信息与系统设置模块)
- [关键技术特性](#关键技术特性)
- [离线作业能力](#离线作业能力)
- [数据安全保障](#数据安全保障)
- [用户体验优化](#用户体验优化)
- [子系统7设计: 微网厅系统](#子系统7设计-微网厅系统)
- [任务概述](#任务概述-7)
- [设计概述](#设计概述-7)
- [总体约束](#总体约束-7)
- [子系统外部接口](#子系统外部接口-6)
- [设计方案概述](#设计方案概述-7)
- [子系统架构设计](#子系统架构设计-6)
- [模块定义](#模块定义-6)
- [模块列表](#模块列表-6)
- [模块间关系](#模块间关系-5)
- [模块描述](#模块描述-6)
- [模块1: 账户绑定管理](#模块1-账户绑定管理-1)
- [模块2: 信息查询服务](#模块2-信息查询服务-1)
- [模块3: 在线缴费服务](#模块3-在线缴费服务-1)
@ -359,7 +373,7 @@ CJKmainfont: "PingFang SC"
**图表 1**
![图表 1](temp_mermaid_新-概要设计说明书_18870/diagram_1.png)
![图表 1](temp_mermaid_新-概要设计说明书_1151/diagram_1.png)
#### 层级说明
@ -394,7 +408,7 @@ CJKmainfont: "PingFang SC"
**图表 2**
![图表 2](temp_mermaid_新-概要设计说明书_18870/diagram_2.png)
![图表 2](temp_mermaid_新-概要设计说明书_1151/diagram_2.png)
### 系统的物理架构设计
@ -406,13 +420,13 @@ CJKmainfont: "PingFang SC"
**图表 3**
![图表 3](temp_mermaid_新-概要设计说明书_18870/diagram_3.png)
![图表 3](temp_mermaid_新-概要设计说明书_1151/diagram_3.png)
#### 网络连接
**图表 4**
![图表 4](temp_mermaid_新-概要设计说明书_18870/diagram_4.png)
![图表 4](temp_mermaid_新-概要设计说明书_1151/diagram_4.png)
#### 硬件配置规格
@ -456,7 +470,7 @@ CJKmainfont: "PingFang SC"
**图表 5**
![图表 5](temp_mermaid_新-概要设计说明书_18870/diagram_5.png)
![图表 5](temp_mermaid_新-概要设计说明书_1151/diagram_5.png)
#### 容器化部署架构
@ -466,7 +480,7 @@ CJKmainfont: "PingFang SC"
**图表 6**
![图表 6](temp_mermaid_新-概要设计说明书_18870/diagram_6.png)
![图表 6](temp_mermaid_新-概要设计说明书_1151/diagram_6.png)
## 子系统定义
@ -490,7 +504,7 @@ CJKmainfont: "PingFang SC"
**图表 7**
![图表 7](temp_mermaid_新-概要设计说明书_18870/diagram_7.png)
![图表 7](temp_mermaid_新-概要设计说明书_1151/diagram_7.png)
#### 主要接口定义
@ -612,7 +626,7 @@ CJKmainfont: "PingFang SC"
**图表 8**
![图表 8](temp_mermaid_新-概要设计说明书_18870/diagram_8.png)
![图表 8](temp_mermaid_新-概要设计说明书_1151/diagram_8.png)
## 模块定义
@ -636,7 +650,7 @@ CJKmainfont: "PingFang SC"
**图表 9**
![图表 9](temp_mermaid_新-概要设计说明书_18870/diagram_9.png)
![图表 9](temp_mermaid_新-概要设计说明书_1151/diagram_9.png)
**功能群说明:**
@ -653,7 +667,7 @@ CJKmainfont: "PingFang SC"
**图表 10**
![图表 10](temp_mermaid_新-概要设计说明书_18870/diagram_10.png)
![图表 10](temp_mermaid_新-概要设计说明书_1151/diagram_10.png)
### 模块描述
@ -787,7 +801,7 @@ CJKmainfont: "PingFang SC"
**图表 11**
![图表 11](temp_mermaid_新-概要设计说明书_18870/diagram_11.png)
![图表 11](temp_mermaid_新-概要设计说明书_1151/diagram_11.png)
## 模块定义
@ -815,7 +829,7 @@ CJKmainfont: "PingFang SC"
**图表 12**
![图表 12](temp_mermaid_新-概要设计说明书_18870/diagram_12.png)
![图表 12](temp_mermaid_新-概要设计说明书_1151/diagram_12.png)
**客户服务业务群:**
@ -825,7 +839,7 @@ CJKmainfont: "PingFang SC"
**图表 13**
![图表 13](temp_mermaid_新-概要设计说明书_18870/diagram_13.png)
![图表 13](temp_mermaid_新-概要设计说明书_1151/diagram_13.png)
### 模块描述
@ -893,7 +907,7 @@ CJKmainfont: "PingFang SC"
**图表 14**
![图表 14](temp_mermaid_新-概要设计说明书_18870/diagram_14.png)
![图表 14](temp_mermaid_新-概要设计说明书_1151/diagram_14.png)
**业务规则:**
@ -934,7 +948,7 @@ CJKmainfont: "PingFang SC"
**图表 15**
![图表 15](temp_mermaid_新-概要设计说明书_18870/diagram_15.png)
![图表 15](temp_mermaid_新-概要设计说明书_1151/diagram_15.png)
**业务规则:**
@ -1100,7 +1114,7 @@ CJKmainfont: "PingFang SC"
**图表 16**
![图表 16](temp_mermaid_新-概要设计说明书_18870/diagram_16.png)
![图表 16](temp_mermaid_新-概要设计说明书_1151/diagram_16.png)
## 模块定义
@ -1122,7 +1136,7 @@ CJKmainfont: "PingFang SC"
**图表 17**
![图表 17](temp_mermaid_新-概要设计说明书_18870/diagram_17.png)
![图表 17](temp_mermaid_新-概要设计说明书_1151/diagram_17.png)
### 模块描述
@ -1248,7 +1262,7 @@ CJKmainfont: "PingFang SC"
**图表 18**
![图表 18](temp_mermaid_新-概要设计说明书_18870/diagram_18.png)
![图表 18](temp_mermaid_新-概要设计说明书_1151/diagram_18.png)
**业务规则:**
@ -1262,11 +1276,84 @@ CJKmainfont: "PingFang SC"
# 子系统5设计: 客户服务
## 功能与界面
## 任务概述
客户服务系统为用水客户提供多渠道、便捷的线上自助服务,主要通过微网厅(微信、支付宝)实现
客户服务系统为用水客户提供多渠道、便捷的线上自助服务,构建一站式客户服务平台
## 模块列表
**设计目标:**
- 提供便民的客户自助服务渠道
- 实现多渠道统一的服务体验
- 降低人工服务成本,提高服务效率
- 增强客户满意度和服务质量
**功能范围:**
- **账户绑定管理**:客户账户绑定和管理
- **信息查询服务**:各类信息查询服务
- **在线缴费服务**:多渠道在线缴费服务
- **电子发票服务**:电子发票管理服务
## 设计概述
### 总体约束
**技术约束:**
- 基于RESTful API架构设计
- 支持多渠道接入微信、支付宝、APP
- 采用响应式设计适配移动端
- 遵循第三方平台开发规范
**性能约束:**
- 支持10万+注册用户
- 页面响应时间≤3秒
- 支持并发用户≥1000个
- 缴费交易成功率≥99%
**安全约束:**
- 第三方平台OAuth认证
- 账户绑定安全验证
- 支付安全保障
- 敏感信息加密传输
### 子系统外部接口
| 接口编号 | 接口名称(标识) | 功能描述 | 接口协议 | 输入参数 | 输出结果 |
|---|---|---|---|---|---|
| SERVICE-001 | 账户绑定接口 | 处理用户账户绑定 | HTTP/REST | 客户编号、手机号 | 绑定结果 |
| SERVICE-002 | 账单查询接口 | 查询客户账单信息 | HTTP/REST | 客户编号、查询条件 | 账单详情 |
| SERVICE-003 | 缴费处理接口 | 处理在线缴费业务 | HTTP/REST | 订单信息、支付方式 | 缴费结果 |
| SERVICE-004 | 发票申请接口 | 处理电子发票申请 | HTTP/REST | 缴费记录、发票信息 | 申请结果 |
### 设计方案概述
**架构设计:**
客户服务系统采用前后端分离架构,通过统一的服务接口为多种客户端提供服务支持。
**技术选型:**
- **后端服务**Spring Boot + Spring Security
- **前端技术**响应式Web设计
- **第三方集成**:微信公众号、支付宝生活号
- **支付集成**:微信支付、支付宝支付
## 子系统架构设计
客户服务系统采用多渠道统一架构,为不同客户端提供一致的服务体验。
**图表 19**
![图表 19](temp_mermaid_新-概要设计说明书_1151/diagram_19.png)
## 模块定义
### 模块列表
| 模块编号 | 模块名称(标识) | 功能描述 | 开发方式 |
|---|---|---|---|
@ -1275,12 +1362,19 @@ CJKmainfont: "PingFang SC"
| SERVICE-003 | 在线缴费服务 | 多渠道在线缴费服务 | 自行开发 |
| SERVICE-004 | 电子发票服务 | 电子发票管理服务 | 自行开发 |
### 模块间关系
## 模块设计
客户服务系统各模块形成完整的服务链条,从账户绑定到业务办理的全流程覆盖。
客户服务系统围绕功能维度进行组织,渠道作为功能的实现方式。
### 模块1: 账户绑定管理
**图表 20**
![图表 20](temp_mermaid_新-概要设计说明书_1151/diagram_20.png)
### 模块描述
#### 模块1: 账户绑定管理
- **功能描述**: 提供客户账户的绑定、解绑及多户管理功能。
- **核心功能**:
- **账户绑定**: 客户通过客户编号、手机号、身份证等信息绑定水务账户。
@ -1288,7 +1382,7 @@ CJKmainfont: "PingFang SC"
- **多账户管理**: 一个微信/支付宝账户可以绑定多个水务账户。
- **账户管理**: 支持启用、停用绑定关系,处理账户异常情况。
### 模块2: 信息查询服务
#### 模块2: 信息查询服务
- **功能描述**: 提供全面的用水信息查询服务。
- **核心功能**:
- **账单查询**: 查询当期账单、历史账单、欠费信息等。
@ -1296,7 +1390,7 @@ CJKmainfont: "PingFang SC"
- **缴费记录**: 查询历史缴费记录详情。
- **停水公告**: 查看所在区域的计划性或临时性停水通知。
### 模块3: 在线缴费服务
#### 模块3: 在线缴费服务
- **功能描述**: 提供多种在线支付方式,为客户提供便捷的缴费服务。
- **核心功能**:
- **多渠道支付**: 支持微信支付、支付宝支付、银行卡支付等多种支付方式。
@ -1304,7 +1398,7 @@ CJKmainfont: "PingFang SC"
- **支付确认**: 支付完成后实时更新账户状态,推送缴费成功通知。
- **退款处理**: 支持支付失败和错误支付的退款处理。
### 模块4: 电子发票服务
#### 模块4: 电子发票服务
- **功能描述**: 提供电子发票申请、查询、下载等服务。
- **核心功能**:
- **发票申请**: 客户可为已缴费项目申请电子发票,支持个人和企业发票。
@ -1314,21 +1408,90 @@ CJKmainfont: "PingFang SC"
# 子系统6设计: 手机抄表APP
## 功能与界面
## 任务概述
为抄表员、外勤人员提供移动作业工具,支持离线操作,提升现场工作效率。
手机抄表APP为抄表员、外勤人员提供移动作业工具支持离线操作提升现场工作效率。
**设计目标:**
- 实现移动化抄表作业,提高工作效率
- 支持离线作业,确保在无网络环境下正常工作
- 构建完整的工单闭环处理流程
- 提供直观友好的移动端用户体验
**功能范围:**
- **登录认证**:机构编号、用户名密码认证、自动登录
- **首页搜索**:多维度搜索、最近搜索记录、抄表任务
- **采集任务管理**:任务列表管理、批量下载、单户采集
- **换表工单**:换表工单处理、设备信息录入
- **其他工单**:复水、稽查、问题上报等工单处理
- **个人设置**:个人信息管理、系统设置维护
**核心业务流程:**
任务下载 → 现场抄表 → 问题上报 → 工单处理 → 数据上传 → 结果同步
**主要功能特点:**
- **多维度搜索**:支持户号、户名、地址、钢印号、手机号等多种搜索方式
- **离线作业**:支持无网络环境下的现场抄表和工单处理
- **智能采集**提供定位、NFC、扫码三种数据采集方式
- **工单闭环**:从问题上报到工单完成的完整处理流程
- **数据同步**:网络恢复后自动同步本地数据到服务器
## 设计概述
## 模块列表
### 总体约束
**技术约束:**
- 基于uni-app跨平台开发框架
- 支持Android和iOS双平台
- 采用离线存储技术保证无网络作业
- 遵循移动端UI设计规范
**性能约束:**
- 支持10000+用户档案本地存储
- 离线任务处理能力≥500户
- 应用启动时间≤3秒
- 数据同步成功率≥99%
**安全约束:**
- 本地数据加密存储
- 用户认证和权限控制
- 工单操作审计日志
- 敏感数据防泄露保护
### 子系统外部接口
| 接口编号 | 接口名称(标识) | 功能描述 | 接口协议 | 输入参数 | 输出结果 |
|---|---|---|---|---|---|
| MOBILE-001 | 用户认证接口 | 移动端用户登录认证 | HTTP/REST | 机构编号、用户名、密码 | 认证结果、用户信息 |
| MOBILE-002 | 任务下载接口 | 下载抄表任务和客户信息 | HTTP/REST | 用户ID、任务范围 | 任务详情、客户档案 |
| MOBILE-003 | 数据上传接口 | 上传抄表数据和工单信息 | HTTP/REST | 抄表数据、工单数据 | 上传结果 |
| MOBILE-004 | 工单接收接口 | 接收和处理各类工单 | HTTP/REST | 工单类型、工单信息 | 工单详情 |
### 设计方案概述
**架构设计:**
手机抄表APP采用本地优先的架构设计通过离线存储和数据同步机制确保在各种网络环境下的稳定运行。
**技术选型:**
- **跨平台框架**uni-appVue.js
- **本地存储**SQLite数据库
- **数据同步**HTTP/REST API
- **地图定位**高德地图SDK
- **扫码识别**ZXing扫码库
## 子系统架构设计
手机抄表APP采用离线优先的架构设计确保在各种网络环境下的稳定运行。
**图表 21**
![图表 21](temp_mermaid_新-概要设计说明书_1151/diagram_21.png)
## 模块定义
### 模块列表
| 模块编号 | 模块名称(标识) | 功能描述 | 开发方式 |
|---|---|---|---|
@ -1339,37 +1502,47 @@ CJKmainfont: "PingFang SC"
| MOBILE-005 | 其他工单模块 | 复水、稽查、问题上报等工单处理 | 自行开发 |
| MOBILE-006 | 个人信息与系统设置模块 | 个人信息管理、系统设置维护 | 自行开发 |
## 模块设计
### 模块间关系
### 模块1: 登录模块
手机抄表APP各模块围绕移动作业流程组织形成完整的现场作业管理系统。
**图表 22**
![图表 22](temp_mermaid_新-概要设计说明书_1151/diagram_22.png)
### 模块描述
#### 模块1: 登录模块
- **功能描述**: 提供移动端用户登录认证功能,支持机构编号、用户名、密码三要素登录。
- **核心功能**:
- **核心登录功能**: 机构编号、用户名、密码三要素认证,支持自动登录选项
- **登录辅助功能**: 登录问题支持、版权标识展示
- **安全控制**: 密码自动掩码显示、登录状态保持
### 模块2: 首页搜索模块
#### 模块2: 首页搜索模块
- **功能描述**: 提供多维度客户搜索功能,实现快速定位客户信息。
- **核心功能**:
- **搜索框功能**: 支持户号、户名、地址、钢印号、手机号等多维度搜索
- **最近搜索记录**: 自动保存搜索历史,支持去重和快速访问
- **抄表任务列表**: 展示当前抄表员的任务列表,支持直接跳转
### 模块3: 采集任务管理模块
#### 模块3: 采集任务管理模块
- **功能描述**: 管理抄表员的采集任务,包括任务下载、现场采集等功能。
- **核心功能**:
- **任务列表管理**: 数据统计面板、任务筛选分类、批量下载操作
- **单户采集详情**: 住户档案展示、多种采集方式定位、NFC、扫码
- **户间导航**: 支持按任务列表顺序进行上一户/下一户切换
### 模块4: 换表工单模块
#### 模块4: 换表工单模块
- **功能描述**: 处理换表工单的完整流程,从工单接收到完成提交。
- **核心功能**:
- **换表工单处理**: 待办工单列表、工单信息填写、设备信息录入
- **附件管理**: 支持图片和视频上传,作为现场证据
- **工单操作**: 支持工单完成提交和退单处理
### 模块5: 其他工单模块
#### 模块5: 其他工单模块
- **功能描述**: 处理除换表外的其他类型工单,实现外勤业务闭环。
- **核心功能**:
- **复水工单**: 欠费状态校验、二次确认操作
@ -1377,7 +1550,7 @@ CJKmainfont: "PingFang SC"
- **抄表稽查**: 用户档案核对、稽查结论填写、过程存证
- **问题上报**: 问题类型选择、处理时效设置、溯源证据上传
### 模块6: 个人信息与系统设置模块
#### 模块6: 个人信息与系统设置模块
- **功能描述**: 管理个人信息和系统设置,提供系统维护功能。
- **核心功能**:
- **个人信息管理**: 姓名修改、手机号设置、信息查看
@ -1477,9 +1650,9 @@ CJKmainfont: "PingFang SC"
微网厅系统采用基于微信公众号的服务架构,通过微信平台提供统一的用户入口和服务渠道。
**图表 19**
**图表 23**
![图表 19](temp_mermaid_新-概要设计说明书_18870/diagram_19.png)
![图表 23](temp_mermaid_新-概要设计说明书_1151/diagram_23.png)
## 模块定义
@ -1500,9 +1673,9 @@ CJKmainfont: "PingFang SC"
微网厅系统各模块围绕用户服务形成完整的服务链条,从账户绑定到业务办理的全流程覆盖。
**图表 20**
**图表 24**
![图表 20](temp_mermaid_新-概要设计说明书_18870/diagram_20.png)
![图表 24](temp_mermaid_新-概要设计说明书_1151/diagram_24.png)
### 模块描述
@ -1614,9 +1787,9 @@ CJKmainfont: "PingFang SC"
**业务流程图:**
**图表 21**
**图表 25**
![图表 21](temp_mermaid_新-概要设计说明书_18870/diagram_21.png)
![图表 25](temp_mermaid_新-概要设计说明书_1151/diagram_25.png)
**业务规则:**
@ -1743,9 +1916,9 @@ CJKmainfont: "PingFang SC"
**业务流程图:**
**图表 22**
**图表 26**
![图表 22](temp_mermaid_新-概要设计说明书_18870/diagram_22.png)
![图表 26](temp_mermaid_新-概要设计说明书_1151/diagram_26.png)
**业务规则:**

View File

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

View File

@ -115,28 +115,6 @@
- [模块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)
@ -144,9 +122,45 @@
- [设计方案概述](#设计方案概述-5)
- [子系统架构设计](#子系统架构设计-4)
- [模块定义](#模块定义-4)
- [模块列表](#模块列表-6)
- [模块列表](#模块列表-4)
- [模块间关系](#模块间关系-3)
- [模块描述](#模块描述-4)
- [模块1: 账户绑定管理](#模块1-账户绑定管理)
- [模块2: 信息查询服务](#模块2-信息查询服务)
- [模块3: 在线缴费服务](#模块3-在线缴费服务)
- [模块4: 电子发票服务](#模块4-电子发票服务)
- [子系统6设计: 手机抄表APP](#子系统6设计-手机抄表app)
- [任务概述](#任务概述-6)
- [设计概述](#设计概述-6)
- [总体约束](#总体约束-6)
- [子系统外部接口](#子系统外部接口-5)
- [设计方案概述](#设计方案概述-6)
- [子系统架构设计](#子系统架构设计-5)
- [模块定义](#模块定义-5)
- [模块列表](#模块列表-5)
- [模块间关系](#模块间关系-4)
- [模块描述](#模块描述-5)
- [模块1: 登录模块](#模块1-登录模块)
- [模块2: 首页搜索模块](#模块2-首页搜索模块)
- [模块3: 采集任务管理模块](#模块3-采集任务管理模块)
- [模块4: 换表工单模块](#模块4-换表工单模块)
- [模块5: 其他工单模块](#模块5-其他工单模块)
- [模块6: 个人信息与系统设置模块](#模块6-个人信息与系统设置模块)
- [关键技术特性](#关键技术特性)
- [离线作业能力](#离线作业能力)
- [数据安全保障](#数据安全保障)
- [用户体验优化](#用户体验优化)
- [子系统7设计: 微网厅系统](#子系统7设计-微网厅系统)
- [任务概述](#任务概述-7)
- [设计概述](#设计概述-7)
- [总体约束](#总体约束-7)
- [子系统外部接口](#子系统外部接口-6)
- [设计方案概述](#设计方案概述-7)
- [子系统架构设计](#子系统架构设计-6)
- [模块定义](#模块定义-6)
- [模块列表](#模块列表-6)
- [模块间关系](#模块间关系-5)
- [模块描述](#模块描述-6)
- [模块1: 账户绑定管理](#模块1-账户绑定管理-1)
- [模块2: 信息查询服务](#模块2-信息查询服务-1)
- [模块3: 在线缴费服务](#模块3-在线缴费服务-1)
@ -1820,11 +1834,126 @@ flowchart TD
# 子系统5设计: 客户服务
## 功能与界面
## 任务概述
客户服务系统为用水客户提供多渠道、便捷的线上自助服务,主要通过微网厅(微信、支付宝)实现
客户服务系统为用水客户提供多渠道、便捷的线上自助服务,构建一站式客户服务平台
## 模块列表
**设计目标:**
- 提供便民的客户自助服务渠道
- 实现多渠道统一的服务体验
- 降低人工服务成本,提高服务效率
- 增强客户满意度和服务质量
**功能范围:**
- **账户绑定管理**:客户账户绑定和管理
- **信息查询服务**:各类信息查询服务
- **在线缴费服务**:多渠道在线缴费服务
- **电子发票服务**:电子发票管理服务
## 设计概述
### 总体约束
**技术约束:**
- 基于RESTful API架构设计
- 支持多渠道接入微信、支付宝、APP
- 采用响应式设计适配移动端
- 遵循第三方平台开发规范
**性能约束:**
- 支持10万+注册用户
- 页面响应时间≤3秒
- 支持并发用户≥1000个
- 缴费交易成功率≥99%
**安全约束:**
- 第三方平台OAuth认证
- 账户绑定安全验证
- 支付安全保障
- 敏感信息加密传输
### 子系统外部接口
| 接口编号 | 接口名称(标识) | 功能描述 | 接口协议 | 输入参数 | 输出结果 |
|---|---|---|---|---|---|
| SERVICE-001 | 账户绑定接口 | 处理用户账户绑定 | HTTP/REST | 客户编号、手机号 | 绑定结果 |
| SERVICE-002 | 账单查询接口 | 查询客户账单信息 | HTTP/REST | 客户编号、查询条件 | 账单详情 |
| SERVICE-003 | 缴费处理接口 | 处理在线缴费业务 | HTTP/REST | 订单信息、支付方式 | 缴费结果 |
| SERVICE-004 | 发票申请接口 | 处理电子发票申请 | HTTP/REST | 缴费记录、发票信息 | 申请结果 |
### 设计方案概述
**架构设计:**
客户服务系统采用前后端分离架构,通过统一的服务接口为多种客户端提供服务支持。
**技术选型:**
- **后端服务**Spring Boot + Spring Security
- **前端技术**响应式Web设计
- **第三方集成**:微信公众号、支付宝生活号
- **支付集成**:微信支付、支付宝支付
## 子系统架构设计
客户服务系统采用多渠道统一架构,为不同客户端提供一致的服务体验。
```mermaid
graph TB
subgraph "客户服务系统架构"
subgraph "客户端层"
A1[微信公众号]
A2[支付宝生活号]
A3[移动APP]
A4[Web网站]
end
subgraph "服务接入层"
B1[微信接入服务]
B2[支付宝接入服务]
B3[移动端接入服务]
B4[Web接入服务]
end
subgraph "业务服务层"
C1[账户绑定服务]
C2[信息查询服务]
C3[缴费处理服务]
C4[发票管理服务]
end
subgraph "数据接口层"
D1[营收系统接口]
D2[支付平台接口]
D3[发票系统接口]
D4[短信平台接口]
end
end
A1 --> B1
A2 --> B2
A3 --> B3
A4 --> B4
B1 --> C1
B2 --> C2
B3 --> C3
B4 --> C4
C1 --> D1
C2 --> D1
C3 --> D2
C4 --> D3
```
## 模块定义
### 模块列表
| 模块编号 | 模块名称(标识) | 功能描述 | 开发方式 |
|---|---|---|---|
@ -1833,12 +1962,24 @@ flowchart TD
| SERVICE-003 | 在线缴费服务 | 多渠道在线缴费服务 | 自行开发 |
| SERVICE-004 | 电子发票服务 | 电子发票管理服务 | 自行开发 |
### 模块间关系
## 模块设计
客户服务系统各模块形成完整的服务链条,从账户绑定到业务办理的全流程覆盖。
客户服务系统围绕功能维度进行组织,渠道作为功能的实现方式。
```mermaid
graph TB
A[账户绑定管理] --> B[信息查询服务]
B --> C[在线缴费服务]
C --> D[电子发票服务]
A -.->|身份认证| B
B -.->|账单信息| C
C -.->|缴费记录| D
```
### 模块1: 账户绑定管理
### 模块描述
#### 模块1: 账户绑定管理
- **功能描述**: 提供客户账户的绑定、解绑及多户管理功能。
- **核心功能**:
- **账户绑定**: 客户通过客户编号、手机号、身份证等信息绑定水务账户。
@ -1846,7 +1987,7 @@ flowchart TD
- **多账户管理**: 一个微信/支付宝账户可以绑定多个水务账户。
- **账户管理**: 支持启用、停用绑定关系,处理账户异常情况。
### 模块2: 信息查询服务
#### 模块2: 信息查询服务
- **功能描述**: 提供全面的用水信息查询服务。
- **核心功能**:
- **账单查询**: 查询当期账单、历史账单、欠费信息等。
@ -1854,7 +1995,7 @@ flowchart TD
- **缴费记录**: 查询历史缴费记录详情。
- **停水公告**: 查看所在区域的计划性或临时性停水通知。
### 模块3: 在线缴费服务
#### 模块3: 在线缴费服务
- **功能描述**: 提供多种在线支付方式,为客户提供便捷的缴费服务。
- **核心功能**:
- **多渠道支付**: 支持微信支付、支付宝支付、银行卡支付等多种支付方式。
@ -1862,7 +2003,7 @@ flowchart TD
- **支付确认**: 支付完成后实时更新账户状态,推送缴费成功通知。
- **退款处理**: 支持支付失败和错误支付的退款处理。
### 模块4: 电子发票服务
#### 模块4: 电子发票服务
- **功能描述**: 提供电子发票申请、查询、下载等服务。
- **核心功能**:
- **发票申请**: 客户可为已缴费项目申请电子发票,支持个人和企业发票。
@ -1872,21 +2013,136 @@ flowchart TD
# 子系统6设计: 手机抄表APP
## 功能与界面
## 任务概述
为抄表员、外勤人员提供移动作业工具,支持离线操作,提升现场工作效率。
手机抄表APP为抄表员、外勤人员提供移动作业工具支持离线操作提升现场工作效率。
**设计目标:**
- 实现移动化抄表作业,提高工作效率
- 支持离线作业,确保在无网络环境下正常工作
- 构建完整的工单闭环处理流程
- 提供直观友好的移动端用户体验
**功能范围:**
- **登录认证**:机构编号、用户名密码认证、自动登录
- **首页搜索**:多维度搜索、最近搜索记录、抄表任务
- **采集任务管理**:任务列表管理、批量下载、单户采集
- **换表工单**:换表工单处理、设备信息录入
- **其他工单**:复水、稽查、问题上报等工单处理
- **个人设置**:个人信息管理、系统设置维护
**核心业务流程:**
任务下载 → 现场抄表 → 问题上报 → 工单处理 → 数据上传 → 结果同步
**主要功能特点:**
- **多维度搜索**:支持户号、户名、地址、钢印号、手机号等多种搜索方式
- **离线作业**:支持无网络环境下的现场抄表和工单处理
- **智能采集**提供定位、NFC、扫码三种数据采集方式
- **工单闭环**:从问题上报到工单完成的完整处理流程
- **数据同步**:网络恢复后自动同步本地数据到服务器
## 设计概述
## 模块列表
### 总体约束
**技术约束:**
- 基于uni-app跨平台开发框架
- 支持Android和iOS双平台
- 采用离线存储技术保证无网络作业
- 遵循移动端UI设计规范
**性能约束:**
- 支持10000+用户档案本地存储
- 离线任务处理能力≥500户
- 应用启动时间≤3秒
- 数据同步成功率≥99%
**安全约束:**
- 本地数据加密存储
- 用户认证和权限控制
- 工单操作审计日志
- 敏感数据防泄露保护
### 子系统外部接口
| 接口编号 | 接口名称(标识) | 功能描述 | 接口协议 | 输入参数 | 输出结果 |
|---|---|---|---|---|---|
| MOBILE-001 | 用户认证接口 | 移动端用户登录认证 | HTTP/REST | 机构编号、用户名、密码 | 认证结果、用户信息 |
| MOBILE-002 | 任务下载接口 | 下载抄表任务和客户信息 | HTTP/REST | 用户ID、任务范围 | 任务详情、客户档案 |
| MOBILE-003 | 数据上传接口 | 上传抄表数据和工单信息 | HTTP/REST | 抄表数据、工单数据 | 上传结果 |
| MOBILE-004 | 工单接收接口 | 接收和处理各类工单 | HTTP/REST | 工单类型、工单信息 | 工单详情 |
### 设计方案概述
**架构设计:**
手机抄表APP采用本地优先的架构设计通过离线存储和数据同步机制确保在各种网络环境下的稳定运行。
**技术选型:**
- **跨平台框架**uni-appVue.js
- **本地存储**SQLite数据库
- **数据同步**HTTP/REST API
- **地图定位**高德地图SDK
- **扫码识别**ZXing扫码库
## 子系统架构设计
手机抄表APP采用离线优先的架构设计确保在各种网络环境下的稳定运行。
```mermaid
graph TB
subgraph "手机抄表APP架构"
subgraph "用户界面层"
A1[登录界面]
A2[首页搜索界面]
A3[任务管理界面]
A4[工单处理界面]
A5[设置界面]
end
subgraph "业务逻辑层"
B1[认证管理]
B2[任务管理]
B3[采集管理]
B4[工单管理]
B5[数据同步]
end
subgraph "数据访问层"
C1[本地数据库]
C2[文件存储]
C3[网络接口]
C4[设备接口]
end
subgraph "基础服务层"
D1[地图定位]
D2[扫码识别]
D3[图片处理]
D4[设备权限]
end
end
A1 --> B1
A2 --> B2
A3 --> B3
A4 --> B4
A5 --> B5
B1 --> C1
B2 --> C1
B3 --> C2
B4 --> C3
B5 --> C3
B2 --> D1
B3 --> D2
B4 --> D3
B5 --> D4
```
## 模块定义
### 模块列表
| 模块编号 | 模块名称(标识) | 功能描述 | 开发方式 |
|---|---|---|---|
@ -1897,37 +2153,56 @@ flowchart TD
| MOBILE-005 | 其他工单模块 | 复水、稽查、问题上报等工单处理 | 自行开发 |
| MOBILE-006 | 个人信息与系统设置模块 | 个人信息管理、系统设置维护 | 自行开发 |
## 模块设计
### 模块间关系
### 模块1: 登录模块
手机抄表APP各模块围绕移动作业流程组织形成完整的现场作业管理系统。
```mermaid
graph TB
A[登录模块] --> B[首页搜索模块]
B --> C[采集任务管理模块]
C --> D[换表工单模块]
C --> E[其他工单模块]
A --> F[个人信息与系统设置模块]
A -.->|身份认证| C
B -.->|任务导航| C
C -.->|工单处理| D
C -.->|工单处理| E
F -.->|系统配置| B
```
### 模块描述
#### 模块1: 登录模块
- **功能描述**: 提供移动端用户登录认证功能,支持机构编号、用户名、密码三要素登录。
- **核心功能**:
- **核心登录功能**: 机构编号、用户名、密码三要素认证,支持自动登录选项
- **登录辅助功能**: 登录问题支持、版权标识展示
- **安全控制**: 密码自动掩码显示、登录状态保持
### 模块2: 首页搜索模块
#### 模块2: 首页搜索模块
- **功能描述**: 提供多维度客户搜索功能,实现快速定位客户信息。
- **核心功能**:
- **搜索框功能**: 支持户号、户名、地址、钢印号、手机号等多维度搜索
- **最近搜索记录**: 自动保存搜索历史,支持去重和快速访问
- **抄表任务列表**: 展示当前抄表员的任务列表,支持直接跳转
### 模块3: 采集任务管理模块
#### 模块3: 采集任务管理模块
- **功能描述**: 管理抄表员的采集任务,包括任务下载、现场采集等功能。
- **核心功能**:
- **任务列表管理**: 数据统计面板、任务筛选分类、批量下载操作
- **单户采集详情**: 住户档案展示、多种采集方式定位、NFC、扫码
- **户间导航**: 支持按任务列表顺序进行上一户/下一户切换
### 模块4: 换表工单模块
#### 模块4: 换表工单模块
- **功能描述**: 处理换表工单的完整流程,从工单接收到完成提交。
- **核心功能**:
- **换表工单处理**: 待办工单列表、工单信息填写、设备信息录入
- **附件管理**: 支持图片和视频上传,作为现场证据
- **工单操作**: 支持工单完成提交和退单处理
### 模块5: 其他工单模块
#### 模块5: 其他工单模块
- **功能描述**: 处理除换表外的其他类型工单,实现外勤业务闭环。
- **核心功能**:
- **复水工单**: 欠费状态校验、二次确认操作
@ -1935,7 +2210,7 @@ flowchart TD
- **抄表稽查**: 用户档案核对、稽查结论填写、过程存证
- **问题上报**: 问题类型选择、处理时效设置、溯源证据上传
### 模块6: 个人信息与系统设置模块
#### 模块6: 个人信息与系统设置模块
- **功能描述**: 管理个人信息和系统设置,提供系统维护功能。
- **核心功能**:
- **个人信息管理**: 姓名修改、手机号设置、信息查看