From dd2558f95cbb3cf8e11443012bbdbcc950654739 Mon Sep 17 00:00:00 2001 From: tangweijie <877588133@qq.com> Date: Fri, 9 May 2025 14:58:36 +0800 Subject: [PATCH] =?UTF-8?q?=E5=9C=A8=E6=B0=B4=E5=8A=A1=E4=B8=9A=E5=8A=A1?= =?UTF-8?q?=E7=B3=BB=E7=BB=9F=E8=AE=BE=E8=AE=A1=E6=96=87=E6=A1=A3=E4=B8=AD?= =?UTF-8?q?=E6=96=B0=E5=A2=9E=E7=8E=AF=E5=8D=AB=E7=B3=BB=E7=BB=9F=E5=92=8C?= =?UTF-8?q?=E4=B8=9A=E5=8A=A1=E5=B7=A5=E5=8D=95=E6=A8=A1=E5=9D=97=E7=9A=84?= =?UTF-8?q?=E8=AF=A6=E7=BB=86=E6=8F=8F=E8=BF=B0=EF=BC=8C=E6=9B=B4=E6=96=B0?= =?UTF-8?q?=E4=BA=86=E7=94=A8=E6=88=B7=E6=9D=83=E9=99=90=E5=92=8C=E5=AE=9A?= =?UTF-8?q?=E6=97=B6=E4=BB=BB=E5=8A=A1=E7=9A=84=E7=9B=B8=E5=85=B3=E5=86=85?= =?UTF-8?q?=E5=AE=B9=EF=BC=8C=E5=A2=9E=E5=BC=BA=E4=BA=86=E6=96=87=E6=A1=A3?= =?UTF-8?q?=E7=9A=84=E5=85=A8=E9=9D=A2=E6=80=A7=E5=92=8C=E5=AE=9E=E7=94=A8?= =?UTF-8?q?=E6=80=A7=EF=BC=8C=E4=BE=BF=E4=BA=8E=E7=94=A8=E6=88=B7=E7=90=86?= =?UTF-8?q?=E8=A7=A3=E5=92=8C=E6=93=8D=E4=BD=9C=E5=90=84=E9=A1=B9=E4=B8=9A?= =?UTF-8?q?=E5=8A=A1=E3=80=82?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- water_biz_module_design.md | 123 +++++++++++++++++++- water_biz_system_architecture.md | 187 +++++++++++++++++++++++++------ 2 files changed, 274 insertions(+), 36 deletions(-) diff --git a/water_biz_module_design.md b/water_biz_module_design.md index 0d2b500..7231090 100644 --- a/water_biz_module_design.md +++ b/water_biz_module_design.md @@ -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 @@ - 工程进度查询：查询工程进度情况 - 工程资料查询：查询工程相关资料 - 工程统计：统计工程数量、金额等信息 -- 工程分析：分析工程实施情况 \ No newline at end of file +- 工程分析：分析工程实施情况 + +## 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 系统对外接口 + +- 查询接口：提供各类数据查询接口 +- 业务处理接口：提供业务处理和操作接口 +- 状态同步接口：提供状态信息同步接口 +- 数据推送接口：提供数据推送和订阅接口 \ No newline at end of file diff --git a/water_biz_system_architecture.md b/water_biz_system_architecture.md index bd094ed..96a2d08 100644 --- a/water_biz_system_architecture.md +++ b/water_biz_system_architecture.md @@ -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等 -- 接口安全：身份认证、授权、加密传输等 \ No newline at end of file +- 接口安全：身份认证、授权、加密传输等 +- 接口文档：统一的接口文档和示例代码 +- 接口测试：提供接口测试工具和环境 + +### 7.4 接口服务管理 +- API网关：统一的接口入口和管理 +- 服务注册与发现：服务的自动注册和发现 +- 服务路由：根据请求参数进行服务路由 +- 服务降级：在服务不可用时提供降级策略 +- 服务监控：实时监控服务的可用性和性能 \ No newline at end of file