在水务业务系统设计文档中新增环卫系统和业务工单模块的详细描述,更新了用户权限和定时任务的相关内容,增强了文档的全面性和实用性,便于用户理解和操作各项业务。

This commit is contained in:
tangweijie 2025-05-09 14:58:36 +08:00
parent 13045c3ab6
commit dd2558f95c
2 changed files with 274 additions and 36 deletions

View File

@ -13,6 +13,8 @@
- [2.4 账务处理](#24-账务处理)
- [2.5 发票管理](#25-发票管理)
- [2.6 代收业务](#26-代收业务)
- [2.7 环卫系统](#27-环卫系统)
- [2.8 业务工单](#28-业务工单)
- [3. 表务系统](#3-表务系统)
- [3.1 表务工单](#31-表务工单)
- [3.2 表务仓库](#32-表务仓库)
@ -35,6 +37,8 @@
- [6.3 价格体系](#63-价格体系)
- [6.4 基本配置](#64-基本配置)
- [6.5 催缴管理](#65-催缴管理)
- [6.6 用户权限](#66-用户权限)
- [6.7 定时任务](#67-定时任务)
- [7. 系统接口](#7-系统接口)
- [7.1 银行接口](#71-银行接口)
- [7.2 支付宝/微信接口](#72-支付宝微信接口)
@ -42,6 +46,7 @@
- [7.4 集抄系统接口](#74-集抄系统接口)
- [7.5 政务系统接口](#75-政务系统接口)
- [7.6 消火栓系统接口](#76-消火栓系统接口)
- [7.7 其他系统对接](#77-其他系统对接)
- [8. 统计分析](#8-统计分析)
- [8.1 报表查询](#81-报表查询)
- [8.2 欠费查询](#82-欠费查询)
@ -52,6 +57,15 @@
- [9.2 工程施工](#92-工程施工)
- [9.3 工程验收](#93-工程验收)
- [9.4 工程查询](#94-工程查询)
- [10. 抄表APP](#10-抄表app)
- [10.1 首页功能](#101-首页功能)
- [10.2 抄表功能](#102-抄表功能)
- [10.3 工单管理](#103-工单管理)
- [11. 接口服务](#11-接口服务)
- [11.1 API市场](#111-api市场)
- [11.2 API管理](#112-api管理)
- [11.3 接口权限管理](#113-接口权限管理)
- [11.4 系统对外接口](#114-系统对外接口)
## 1. 统一平台
@ -186,6 +200,26 @@
- 银行托收:托收单生成、托收数据处理
- 代扣渠道管理:渠道维护、规则设置、效率分析
### 2.7 环卫系统
环卫系统模块负责管理与环卫相关的收费和计费业务,主要功能包括:
- 计费核定:环卫收费规则配置和业务字典维护
- 计费退补:退费和补缴规则配置,字典配置参与计算
- 计费减免:环卫费用减免规则配置和审批流程
- 环卫收费统计:环卫收费数据统计和分析
### 2.8 业务工单
业务工单模块负责管理日常业务工单的流转和处理,主要功能包括:
- 业务清单:查询通过系统办理的日常业务工单及进度信息
- 上报清单:新增、查询问题清单,包括通过手机端上报的问题
- 稽查工单:对手机端的稽查信息进行多条件查询和导出
- 移表工单:客户对需要进行移动的水表进行登记
- 换表工单:新增客户自报的换表和故障的水表等进行换表登记
- 工作流可视化:工作节点可视化展示和流程管理
## 3. 表务系统
表务系统负责水表的全生命周期管理,包括水表购置、安装、维修、更换等业务。
@ -346,6 +380,20 @@
- 催缴执行:记录催缴执行情况
- 催缴结果:统计催缴结果
### 6.6 用户权限
- 菜单权限:不同角色可访问的菜单权限配置
- 功能权限:不同角色可操作的功能权限配置
- 数据权限:通过查询字典权限控制不同用户业务取数权限
- 角色管理:自定义角色及权限组合
### 6.7 定时任务
- 任务配置:定时任务可视化配置,包含传参设置
- 任务监控:定时任务执行状态监控
- 任务日志:定时任务执行日志记录和查询
- 任务调度:任务优先级和执行顺序管理
## 7. 系统接口
系统接口模块提供与外部系统的集成和数据交换功能,实现业务数据的互通互联。
@ -404,6 +452,16 @@
- 剩余水量计算:计算用户剩余可用水量
- 取水控制:根据预存和剩余水量控制取水
### 7.7 其他系统对接
其他系统对接模块负责与周边系统进行数据交换和业务协同,主要功能包括:
- 环卫系统对接:实现与环卫系统的数据同步和业务流程对接
- 客服系统对接:实现与客服系统的工单同步和问题处理
- 工单系统对接:实现与工单系统的工单流转和状态同步
- OA系统对接实现与OA系统的审批流程对接和数据共享
- 智水擎平台对接:实现与智水擎平台的数据交换和业务协同
## 8. 统计分析
统计分析模块提供多维度的数据统计和分析功能,为管理决策提供数据支持。
@ -469,4 +527,67 @@
- 工程进度查询:查询工程进度情况
- 工程资料查询:查询工程相关资料
- 工程统计:统计工程数量、金额等信息
- 工程分析:分析工程实施情况
- 工程分析:分析工程实施情况
## 10. 抄表APP
抄表APP是针对移动端开发的抄表工具支持外勤人员进行现场抄表、问题处理和工单管理等业务操作。
### 10.1 首页功能
- 首页:显示当前登录用户信息、快捷搜索和主要和抄表业务相关的功能模块
- 个人信息:查看个人信息,可以进行密码、手机号信息修改,可以进行抄表设置
- 快捷查询:提供搜索栏,用户输入户号、户名、地址以及册本后,系统会自动检索到相关的信息
### 10.2 抄表功能
- 抄表任务:显示当前登录的抄表员抄表任务信息
- NFC抄表抄表设备感应NFC后自动弹出抄表页
- 扫码抄表:扫水表上二维码,搜集该表信息,弹出抄表页
- 数据采集:抄表数据现场采集功能
- AI录入对接AI接口实现智能读数
- 抄表轨迹:记录表的物理位置,在地图上点击后采集水表定位
- 抄表导航:指引抄表员前往下一个抄表点
- 抄表汇总:系统会根据当前登录的人员自动汇总抄表信息
- 账单查询:查询客户账单详情
- 欠费查询:显示当前登录的抄表员抄表用水客户的欠费情况
### 10.3 工单管理
- 问题上报:系统支持上报当前登录的抄表员抄表时遇到的用水问题
- 问题回填:问题上报后,可进行问题回填和处理
- 代办工单:显示当前登录的抄表员需要代办工单
- 平台工单管理:移动端提交工单后,系统会自动提交到工单处置平台进行受理、派发
- 停水复水工单:当客户存在欠费的情况下可以对该客户进行停水操作
- 稽查工单:实现抄表稽查和水价稽查
- 维修工单:提交坏表维修报修等工单
## 11. 接口服务
接口服务模块提供系统对外的API接口管理和服务能力实现与第三方系统的便捷集成。
### 11.1 API市场
- API展示展示系统提供的各类API接口
- API使用说明提供API接口的详细使用说明和示例
- API测试提供API接口的在线测试功能
### 11.2 API管理
- API申请第三方系统申请调用API的流程管理
- API调度看板监控API调用情况和性能指标
- 接口服务配置管理管理API接口的配置参数
- 接口限流熔断管理控制API接口的调用频率和熔断机制
### 11.3 接口权限管理
- 授权管理管理API接口的授权信息
- 白名单管理设置允许访问API的IP白名单
- 安全策略设置API调用的安全策略和防护措施
### 11.4 系统对外接口
- 查询接口:提供各类数据查询接口
- 业务处理接口:提供业务处理和操作接口
- 状态同步接口:提供状态信息同步接口
- 数据推送接口:提供数据推送和订阅接口

View File

@ -46,6 +46,9 @@ graph TD
Charge[收费管理]
Account[账务处理]
Invoice[发票管理]
Collection[代收业务]
EnvSanitation[环卫系统]
BusinessOrders[业务工单]
end
subgraph CustService[客户服务]
@ -53,18 +56,47 @@ graph TD
BillQuery[账单查询]
EInvoice[电子发票]
WebPortal[微网厅]
AIService[智能客服]
end
subgraph MeterMgmt[表务系统]
MeterWork[表务工单]
MeterStore[表务仓库]
MeterLifecycle[水表生命周期]
MeterParams[水表参数]
IoTIntegration[物联网对接]
end
subgraph Installation[报装管理]
InstallProcess[报装流程]
OneMeter[一户一表管理]
end
subgraph StatAnalysis[统计分析]
ReportQuery[报表查询]
DebtQuery[欠费查询]
PaymentRecord[缴费记录]
WaterAnalysis[用水分析]
end
subgraph ProjectMgmt[工程管理]
ProjectApply[工程申请]
ProjectConstruct[工程施工]
ProjectAccept[工程验收]
ProjectQuery[工程查询]
end
subgraph MeterApp[抄表APP]
AppHome[首页功能]
AppMeter[抄表功能]
AppOrder[工单管理]
end
subgraph APIService[接口服务]
APIMarket[API市场]
APIMgmt[API管理]
APIAuth[接口权限管理]
APIExtern[系统对外接口]
end
end
AppLayer --- MiddleLayer
@ -74,6 +106,8 @@ graph TD
ESB[企业服务总线]
ReportPlatform[统一报表平台]
Cache[缓存服务]
Workflow[工作流引擎]
MessageQueue[消息队列]
end
MiddleLayer --- DataLayer
@ -83,6 +117,7 @@ graph TD
DBCluster[数据库集群]
FileServer[文件服务器]
Backup[数据备份恢复]
DataIntegration[数据集成]
end
%% 外部接口层
@ -90,7 +125,11 @@ graph TD
BankAPI[银行接口]
PayAPI[支付接口]
SMSAPI[短信接口]
QueryAPI[外部查询接口]
IoTAPI[物联网接口]
GovernmentAPI[政务系统接口]
HydrantAPI[消火栓系统接口]
EnvAPI[环卫系统接口]
OAAPI[OA系统接口]
end
MiddleLayer --- ExternalAPI
@ -116,7 +155,7 @@ graph TD
class SecurityLayer security
classDef platform fill:#e6f7ff,stroke:#1890ff,stroke-width:1px
class Platform,Revenue,CustService,MeterMgmt,Installation platform
class Platform,Revenue,CustService,MeterMgmt,Installation,StatAnalysis,ProjectMgmt,MeterApp,APIService platform
```
## 2. 技术架构
@ -157,6 +196,8 @@ graph TD
- 核心框架uni-app跨平台
- 组件库uview-ui
- 小程序支持:微信小程序、支付宝小程序等
- 移动端地图高德地图SDK用于抄表轨迹和导航
- 设备接入NFC、扫码、相机等硬件设备接口
### 2.3 技术特性
- 单点登录OAuth2 + JWT实现统一认证
@ -173,55 +214,88 @@ graph TD
- 支持功能:
- 支付管理:微信支付、支付宝支付等
- 短信服务:阿里云、腾讯云等多家短信服务商
- CRM功能客户管理、销售管理、商机管理
- ERP功能采购管理、销售管理、库存管理
- AI模块集成AI大模型能力
- AI能力
- 智能客服基于AI的智能问答系统
- 智能抄表:基于图像识别的水表读数
- 异常分析基于AI的用水异常分析
- API网关支持API权限管理、限流熔断、白名单控制
## 3. 应用架构
系统应用架构基于业务域划分,主要包括以下核心应用模块:
### 3.1 统一平台
- 单点登录
- 系统管理(组织机构、权限管理、角色配置等)
- 流程节点提醒
- 单点登录:统一认证入口,支持多种登录方式
- 系统管理:组织机构、员工管理、角色权限管理、菜单配置等
- 流程节点提醒:工作流节点到期和状态变更提醒
### 3.2 营收系统
- 系统管理
- 抄表开账(册本管理、抄表录入、抄表数据审核等)
- 收费管理(柜台收费、结账、预付款管理等)
- 账务处理(未销调整、违约金减免、特殊开账等)
- 发票管理
- 系统管理:水价管理、用户档案管理、更名过户管理等
- 抄表开账:册本管理、抄表录入、复核开账等
- 收费管理:柜台收费、特殊开账、柜台结账、批量缴费等
- 账务处理:预存调整、未销调整、已销调整、分账调整等
- 发票管理:发票查询、发票开具、电子发票等
- 代收业务:实时收费、银行代扣、银行托收等
- 环卫系统:计费核定、计费退补、计费减免等
- 业务工单:业务清单、上报清单、稽查工单、移表工单等
### 3.3 客户服务
- 微信、支付宝服务窗
- 历史账单查询
- 电子发票
- 营业网点查询
- 账户流水查询
- 微网厅
- 微信、支付宝服务窗:账户绑定、用水查询、在线缴费等
- 历史账单:账单查询、用水分析、账单推送等
- 电子发票:发票申请、发票查询、发票下载等
- 营业网点:网点查询、网点导航、业务指南等
- 账户流水:流水查询、明细下载、交易统计等
- 微网厅:用户注册、信息查询、业务办理等
- 智能客服:常见问题、智能问答、业务指引等
### 3.4 表务系统
- 表务工单(换表、移表、拆表、复装、校表等)
- 表务仓库(入库、领用、出库、退库、报废等)
- 水表生命周期管理
- 表务工单:换表工单、移表工单、拆表工单、复装工单等
- 表务仓库:新表入库、水表检定、水表领用、水表出库等
- 水表参数与基础信息:水表厂家管理、水表型号管理等
- 物联网对接与数据同步:厂家设备信息管理、远程抄表数据同步等
### 3.5 报装管理
- 报装流程
- 一户一表管理
- 报装流程:报装申请、方案设计、合同签订、施工管理等
- 一户一表管理:改造计划、改造实施、用户转换等
### 3.6 外部集成
- 银行接口
- 支付接口
- 短信接口
- 外部查询接口
### 3.6 统计分析
- 报表查询:标准报表、自定义报表、报表导出打印等
- 欠费查询:欠费情况统计、欠费用户明细、欠费分析等
- 缴费记录:缴费情况统计、缴费明细查询、缴费趋势分析等
- 用水分析:用水量统计、用水趋势分析、异常用水分析等
### 3.7 工程管理
- 工程申请:工程立项、材料提交、前期勘察等
- 工程施工:施工计划、施工派工、施工记录等
- 工程验收:验收申请、验收检查、验收记录等
- 工程查询:工程进度查询、工程资料查询、工程统计等
### 3.8 抄表APP
- 首页功能:首页展示、个人信息、快捷查询等
- 抄表功能抄表任务、NFC抄表、扫码抄表、AI录入等
- 工单管理:问题上报、问题回填、代办工单、稽查工单等
### 3.9 接口服务
- API市场API展示、API使用说明、API测试等
- API管理API申请、API调度看板、接口服务配置管理等
- 接口权限管理:授权管理、白名单管理、安全策略等
- 系统对外接口:查询接口、业务处理接口、状态同步接口等
### 3.10 系统配置
- 水表参数:水表厂家、水表型号、水表量程等
- 地址参数:行政区划、地址编码、地址库等
- 价格体系:用水性质、水价标准、阶梯水价等
- 基本配置:系统参数、业务规则、打印模板等
- 催缴管理:催缴计划、催缴任务、催缴执行等
- 用户权限:菜单权限、功能权限、数据权限等
- 定时任务:任务配置、任务监控、任务日志等
## 4. 数据架构
系统数据架构基于客户关系数据库为核心和基础,实现客户全生命周期管理。
### 4.1 数据分层
- 数据采集层:负责从各业务系统采集原始数据
- 数据采集层:负责从各业务系统和物联网设备采集原始数据
- 数据存储层:统一数据存储,实现分布式数据管理
- 数据服务层:提供数据服务接口
- 数据展现层:提供数据分析和可视化功能
@ -229,13 +303,16 @@ graph TD
### 4.2 数据模型
- 客户信息模型:包含客户基础信息、表卡信息、账户信息、联系人信息等
- 业务数据模型:抄表数据、收费数据、账务数据、发票数据等
- 工单数据模型:表务工单、报装工单等
- 工单数据模型:表务工单、报装工单、业务工单
- 配置数据模型:系统参数、水表参数、价格体系等
- 报表数据模型:统计数据、分析数据、预测数据等
- 物联网数据模型:设备信息、状态信息、实时数据等
### 4.3 数据集成与共享
- 统一数据标准:定义统一的数据标准和数据字典
- 数据集成机制采用ESB实现系统间的数据集成
- 数据共享机制:基于统一的数据服务接口实现数据共享
- 数据同步策略:实时同步、定时同步、批量同步等
## 5. 安全架构
@ -245,16 +322,28 @@ graph TD
- 边界防护:防火墙、入侵检测/防御系统
- 访问控制:基于角色的访问控制
- 通信安全SSL/TLS加密传输
- 安全监控:实时监控网络安全状态
### 5.2 数据安全
- 数据加密:敏感数据加密存储
- 数据备份:定期数据备份和恢复机制
- 数据审计:关键操作的审计日志
- 数据脱敏:敏感数据的显示脱敏和处理脱敏
- 数据权限:基于多租户的数据隔离和访问控制
### 5.3 应用安全
- 身份认证:多因素认证
- 授权管理:细粒度的权限控制
- 安全审计:用户操作审计
- 密码策略:密码复杂度、定期更换、失败锁定等
- 会话管理:会话超时、并发限制等
### 5.4 接口安全
- 接口认证基于Token的接口认证
- 接口授权:基于角色的接口授权
- 接口加密:敏感数据的加密传输
- 接口防护:防重放、防篡改等安全措施
- 接口限流基于IP、用户、应用的限流策略
## 6. 部署架构
@ -262,6 +351,11 @@ graph TD
### 6.1 物理部署
- 生产环境:高可用集群部署
- 应用服务器2台或以上服务器负载均衡
- 数据库服务器:主从架构,实时同步
- 缓存服务器Redis集群
- 文件服务器:冗余存储
- 灾备环境:异地灾备,定期数据同步
- 测试环境:用于系统测试和验证
- 开发环境:用于系统开发和集成测试
@ -271,6 +365,14 @@ graph TD
- 文件服务器:负责文档和附件存储
- 缓存服务器:提高系统性能
- 负载均衡服务器:实现请求分发和负载均衡
- 移动应用服务提供移动端API服务
- API网关统一的接口管理和控制
### 6.3 容器部署
- 基于Docker容器技术实现微服务部署
- 使用Kubernetes进行容器编排和管理
- 支持容器的自动扩缩容和故障转移
- 实现服务的灰度发布和版本控制
## 7. 接口架构
@ -278,17 +380,32 @@ graph TD
### 7.1 外部接口
- 银行接口:实现与银行系统的对接,支持代扣、托收等功能
- 支付宝接口:支持支付宝支付功能
- 微信接口:支持微信支付和服务通知功能
- 支付宝/微信接口:支持在线支付功能
- 短信接口:支持短信通知和验证码功能
- 集抄系统接口:实现与智能水表集中抄表系统的对接
- 政务系统接口实现与地方政务平台和政务APP的对接
- 消火栓系统接口:实现与消火栓系统的对接
- 环卫系统接口:实现与环卫系统的对接
- OA系统接口实现与OA系统的工作流对接
### 7.2 内部接口
- ESB服务接口系统内部模块间的数据交换
- 报表接口:提供报表数据查询和生成功能
- 查询接口:提供数据查询功能
- 业务处理接口:提供业务处理功能
- 消息通知接口:提供消息推送和通知功能
- 工作流接口:提供工作流处理和状态查询功能
### 7.3 接口标准
- 接口协议RESTful API、WebService、消息队列等
- 数据格式JSON、XML等
- 接口安全:身份认证、授权、加密传输等
- 接口安全:身份认证、授权、加密传输等
- 接口文档:统一的接口文档和示例代码
- 接口测试:提供接口测试工具和环境
### 7.4 接口服务管理
- API网关统一的接口入口和管理
- 服务注册与发现:服务的自动注册和发现
- 服务路由:根据请求参数进行服务路由
- 服务降级:在服务不可用时提供降级策略
- 服务监控:实时监控服务的可用性和性能