fujian_water_biz_doc/water_biz_module_design.md

福建水务营收系统核心模块功能设计

一、系统功能模块概览

福建水务营收系统是一套现代化的水务管理系统，按照业务功能划分为若干个核心模块，每个模块负责特定的业务处理。本文档详细描述各个核心模块的功能设计。

二、用户管理模块

1. 功能概述

用户管理模块负责系统用户的信息管理、认证授权、密码安全策略等功能，是系统的基础管理模块。

2. 功能列表

• 用户信息管理：用户信息的添加、修改、删除、查询
• 用户认证：用户登录认证、密码修改、密码重置
• 角色管理：角色的添加、修改、删除、查询
• 权限管理：基于RBAC模型的权限控制
• 部门管理：部门的添加、修改、删除、查询
• 岗位管理：岗位的添加、修改、删除、查询
• 用户分组：用户按业务需求进行分组管理
• 操作日志：记录用户操作行为
• 登录日志：记录用户登录情况

3. 业务流程

graph TD
    A[用户登录] --> B{验证身份}
    B -- 成功 --> C[获取用户权限]
    B -- 失败 --> D[返回错误信息]
    C --> E[生成用户菜单]
    E --> F[进入系统]

4. 核心功能说明

1. 基于RBAC的权限控制

   • 支持菜单权限、功能权限、数据权限三级权限控制
   • 灵活的权限分配机制，支持角色继承
   • 完善的权限验证机制，确保系统安全

2. 多因素认证

   • 支持账号密码认证
   • 支持短信验证码认证
   • 支持验证码认证
   • 支持记住我功能

3. 安全策略

   • 密码复杂度要求
   • 密码定期更换
   • 账号锁定策略
   • 登录异常检测

三、水表管理模块

1. 功能概述

水表管理模块负责管理用户水表的基础信息、生命周期管理、状态变更等功能，为抄表和收费提供基础数据支持。

2. 功能列表

• 水表信息管理：水表基础信息的添加、修改、删除、查询
• 水表安装管理：记录水表安装信息，生成安装工单
• 水表更换管理：记录水表更换信息，生成更换工单
• 水表拆除管理：记录水表拆除信息，生成拆除工单
• 水表维修管理：记录水表维修信息，生成维修工单
• 水表巡检管理：记录水表巡检信息，生成巡检工单
• 水表状态管理：管理水表的运行状态
• 批量导入导出：支持批量导入导出水表信息
• 水表档案管理：维护水表的历史记录和档案资料

3. 业务流程

graph TD
    A[新增水表信息] --> B[生成水表编号]
    B --> C[关联用户信息]
    C --> D[初始化水表状态]
    D --> E[安装水表]
    E --> F[完成安装]
    
    G[水表故障] --> H[生成维修工单]
    H --> I[指派维修人员]
    I --> J[维修处理]
    J --> K[更新水表状态]
    
    L[水表报废] --> M[生成更换工单]
    M --> N[拆除旧表]
    N --> O[安装新表]
    O --> P[更新水表信息]

4. 核心功能说明

1. 水表生命周期管理

   • 安装：记录安装时间、安装位置、起始读数等信息
   • 维修：记录维修原因、维修时间、维修人员等信息
   • 更换：记录更换原因、更换时间、新旧表信息等
   • 拆除：记录拆除原因、拆除时间、最终读数等信息

2. 水表分类管理

   • 按类型分类：普通水表、智能水表、IC卡水表、远传水表等
   • 按口径分类：DN15、DN20、DN25等规格
   • 按用途分类：居民用水、商业用水、工业用水等

3. 水表批量操作

   • 批量导入：支持Excel导入水表信息
   • 批量更新：支持批量更新水表状态
   • 批量导出：支持导出水表数据进行分析

四、抄表管理模块

1. 功能概述

抄表管理模块负责水表读数的采集、审核、异常处理等功能，是水费计算的基础和前提。

2. 功能列表

• 抄表计划管理：抄表计划的制定、修改、删除、查询
• 抄表任务分配：根据抄表员区域分配抄表任务
• 抄表数据录入：支持多种方式录入抄表数据
• 抄表数据审核：对录入的抄表数据进行审核
• 异常数据处理：对异常抄表数据进行处理
• 抄表统计分析：抄表完成率、抄表准确率等统计
• 水量分析：用水量异常分析、同比环比分析
• 远程抄表管理：自动采集远传水表数据
• 抄表路线管理：规划优化抄表路线
• 抄表工作量统计：统计抄表员工作量

3. 业务流程

graph TD
    A[制定抄表计划] --> B[生成抄表任务]
    B --> C[分配抄表员]
    C --> D[抄表数据采集]
    D --> E{数据审核}
    E -- 正常 --> F[生成水费账单]
    E -- 异常 --> G[异常处理]
    G --> H[重新抄表]
    H --> E
    G -- 确认异常 --> I[人工核实]
    I --> F

4. 核心功能说明

1. 多种抄表方式支持

   • 人工抄表：通过手持终端录入数据
   • 远程抄表：自动采集远传水表数据
   • 用户自报：用户通过网站、APP自行上报读数
   • 图片识别：通过上传水表照片自动识别读数

2. 异常数据处理

   • 零水量：连续几个月无用水的异常处理
   • 用水量突增：较往常用水量突然增加的异常处理
   • 用水量突减：较往常用水量突然减少的异常处理
   • 重复录入：相同水表多次录入数据的处理
   • 倒走水量：当前读数小于上次读数的处理

3. 抄表质量控制

   • 抄表准确率考核
   • 抄表覆盖率考核
   • 抄表及时率考核
   • 抄表异常处理率考核

五、收费管理模块

1. 功能概述

收费管理模块负责水费的计算、收取、欠费管理等功能，是系统的核心业务模块。

2. 功能列表

• 水费计算：根据抄表数据和水价政策计算水费
• 水费账单生成：生成用户水费账单
• 水费收取：多渠道收取水费
• 催缴管理：欠费催缴通知和管理
• 优惠政策管理：各类用户优惠政策的设置和应用
• 水价管理：不同用户类型、阶梯水价的管理
• 缴费记录管理：记录和查询用户缴费历史
• 收费统计分析：收费率、收费金额等统计分析
• 坐收中心管理：营业厅收费管理
• 稽查管理：对违规用水行为的稽查和处理

3. 业务流程

graph TD
    A[抄表数据确认] --> B[计算水费]
    B --> C[生成账单]
    C --> D[通知用户]
    D --> E{用户缴费}
    E -- 按时缴费 --> F[完成缴费]
    E -- 逾期未缴 --> G[催缴通知]
    G --> H{是否缴费}
    H -- 是 --> F
    H -- 否 --> I[强制催缴]
    I --> J{是否缴费}
    J -- 是 --> F
    J -- 否 --> K[停水处理]
    K --> L{是否缴费}
    L -- 是 --> M[恢复供水]
    M --> F

4. 核心功能说明

1. 多种收费方式支持

   • 营业厅收费：用户前往营业厅缴费
   • 银行代扣：通过银行自动代扣水费
   • 网上支付：通过网站、APP在线支付
   • 微信支付：通过微信公众号、小程序支付
   • 支付宝支付：通过支付宝支付
   • 预存抵扣：预存水费自动抵扣
   • 第三方代收：通过合作的第三方机构代收

2. 水价政策管理

   • 基础水价设置
   • 阶梯水价设置
   • 特殊时期水价调整
   • 不同用户类型水价设置
   • 季节性水价调整

3. 欠费管理

   • 欠费记录管理
   • 催缴通知管理
   • 停水管理
   • 恢复供水管理
   • 滞纳金计算

六、账务管理模块

1. 功能概述

账务管理模块负责系统财务账务处理，包括收费入账、销账、退费等功能，是系统财务管理的核心模块。

2. 功能列表

• 收费入账：收费记录的财务入账处理
• 销账管理：已收费用的销账处理
• 退费管理：退费申请、审批、执行
• 坏账管理：无法收回的水费坏账处理
• 日结管理：每日收费的结算和统计
• 月结管理：每月收费的结算和统计
• 年结管理：年度收费的结算和统计
• 账务调整：账务数据的调整和修正
• 收费报表：各类收费统计报表生成
• 财务对账：与财务系统的对账功能

3. 业务流程

graph TD
    A[收费记录] --> B[收费入账]
    B --> C{是否需要退费}
    C -- 是 --> D[申请退费]
    D --> E[退费审批]
    E --> F[执行退费]
    F --> G[退费入账]
    C -- 否 --> H[正常销账]
    G --> H
    H --> I[日结处理]
    I --> J[月结处理]
    J --> K[年结处理]

4. 核心功能说明

1. 账务处理流程

   • 收费入账：记录收费金额、收费方式、收费时间等
   • 销账处理：标记账单已缴费，更新账务状态
   • 退费处理：处理用户退费申请，执行退费操作
   • 调账处理：对账务数据进行调整和修正

2. 财务统计功能

   • 日收费统计：统计每日收费情况
   • 月收费统计：统计每月收费情况
   • 年收费统计：统计年度收费情况
   • 收费方式统计：按收费方式统计收费情况
   • 欠费率统计：统计欠费率和欠费金额

3. 财务报表功能

   • 收费日报表：每日收费情况报表
   • 收费月报表：每月收费情况报表
   • 收费年报表：年度收费情况报表
   • 欠费统计报表：欠费情况统计报表
   • 坏账统计报表：坏账情况统计报表

七、票据管理模块

1. 功能概述

票据管理模块负责水费发票的开具、管理、查询等功能，确保票据管理的规范性和合法性。

2. 功能列表

• 发票开具：为用户开具水费发票
• 发票作废：对错误发票进行作废处理
• 发票查询：查询发票开具情况
• 发票补打：补打发票
• 发票领用管理：管理发票的领用和库存
• 发票使用统计：统计发票使用情况
• 电子发票管理：管理电子发票的开具和发送
• 票据日志：记录票据操作日志

3. 业务流程

graph TD
    A[用户缴费] --> B{需要发票}
    B -- 需要 --> C[选择发票类型]
    C --> D{电子发票/纸质发票}
    D -- 电子发票 --> E[生成电子发票]
    E --> F[发送至用户邮箱/手机]
    D -- 纸质发票 --> G[打印纸质发票]
    G --> H[交付用户]
    B -- 不需要 --> I[完成缴费]
    F --> I
    H --> I

4. 核心功能说明

1. 发票管理功能

   • 发票开具：根据用户缴费情况开具发票
   • 发票作废：对错误发票进行作废处理
   • 发票重打：对损坏的发票进行重新打印
   • 发票查询：查询发票开具情况和历史记录

2. 多种发票类型支持

   • 普通纸质发票
   • 增值税普通发票
   • 增值税专用发票
   • 电子发票

3. 电子发票功能

   • 电子发票生成
   • 电子发票发送（邮件、短信等）
   • 电子发票查验
   • 电子发票下载和打印

八、营业网点管理模块

1. 功能概述

营业网点管理模块负责管理水务公司的营业网点、窗口、人员等信息，为用户提供线下服务支持。

2. 功能列表

• 营业网点管理：网点的添加、修改、删除、查询
• 窗口管理：服务窗口的管理和配置
• 营业时间管理：网点营业时间的设置
• 人员排班管理：营业人员的排班安排
• 业务办理统计：各网点业务办理情况统计
• 网点评价管理：客户对网点服务的评价管理
• 客户查询：查询客户相关信息
• 业务办理：办理各类水务业务
• 现金管理：网点现金收取和管理

3. 业务流程

graph TD
    A[客户到访] --> B[取号排队]
    B --> C[窗口叫号]
    C --> D[业务受理]
    D --> E{是否需要缴费}
    E -- 是 --> F[缴费处理]
    F --> G[开具票据]
    G --> H[业务完成]
    E -- 否 --> H

4. 核心功能说明

1. 营业网点管理功能

   • 网点信息管理：地址、联系方式、营业时间等
   • 窗口设置：服务类型、窗口编号等
   • 人员安排：窗口工作人员安排
   • 业务统计：业务办理量、收费金额等统计

2. 排队叫号系统

   • 取号管理：客户取号
   • 叫号管理：窗口叫号
   • 业务分类：不同业务类型的排队管理
   • 优先级设置：特殊客户优先处理

3. 网点业务管理

   • 业务类型管理：可办理的业务类型
   • 业务流程管理：各类业务的办理流程
   • 业务量统计：统计各类业务办理情况
   • 服务质量评价：客户对服务的评价管理

九、报表管理模块

1. 功能概述

报表管理模块负责系统各类统计报表的生成、查询、导出等功能，为管理决策提供数据支持。

2. 功能列表

• 营收报表：收费情况统计报表
• 抄表报表：抄表情况统计报表
• 用水分析报表：用水量分析报表
• 客户报表：客户信息统计报表
• 综合分析报表：多维度综合分析报表
• 自定义报表：支持自定义报表配置
• 报表导出：报表数据导出为Excel、PDF等格式
• 报表打印：报表打印功能
• 数据可视化：图表、仪表盘等可视化展示

3. 业务流程

graph TD
    A[选择报表类型] --> B[设置查询条件]
    B --> C[生成报表]
    C --> D{操作选择}
    D -- 导出 --> E[选择导出格式]
    E --> F[保存报表文件]
    D -- 打印 --> G[报表打印]
    D -- 数据分析 --> H[数据钻取分析]

4. 核心功能说明

1. 预设报表功能

   • 营收报表：按日、周、月、年统计收费情况
   • 抄表报表：抄表率、抄表异常情况统计
   • 欠费报表：欠费金额、欠费率等统计
   • 用水分析报表：按用户类型、区域等分析用水情况

2. 报表定制功能

   • 自定义报表字段
   • 自定义报表条件
   • 自定义报表格式
   • 自定义报表展示方式

3. 数据可视化功能

   • 折线图：展示趋势变化
   • 柱状图：比较数量差异
   • 饼图：展示占比情况
   • 地图：展示地理分布
   • 仪表盘：直观展示关键指标

十、系统管理模块

1. 功能概述

系统管理模块负责系统基础配置、参数设置、日志管理等功能，确保系统正常运行。

2. 功能列表

• 菜单管理：系统菜单的添加、修改、删除、查询
• 字典管理：系统字典的管理
• 参数配置：系统参数的配置
• 通知公告：系统通知和公告管理
• 系统日志：记录系统操作日志
• 登录日志：记录用户登录日志
• 在线用户：查看当前在线用户
• 定时任务：系统定时任务的管理
• 系统监控：监控系统运行状态
• 数据备份：系统数据备份和恢复

3. 业务流程

graph TD
    A[系统运行] --> B[记录系统日志]
    A --> C[记录操作日志]
    A --> D[记录登录日志]
    A --> E[执行定时任务]
    E --> F[备份数据]
    B --> G[日志归档]
    C --> G
    D --> G
    G --> H[日志分析]

4. 核心功能说明

1. 系统配置管理

   • 系统参数配置：各类系统参数的设置
   • 字典管理：系统字典数据的维护
   • 菜单管理：系统菜单的维护
   • 接口管理：系统接口的配置和管理

2. 系统监控功能

   • 服务器监控：监控服务器CPU、内存、磁盘等使用情况
   • 数据库监控：监控数据库连接、性能等情况
   • 缓存监控：监控Redis缓存使用情况
   • 在线用户监控：监控当前在线用户情况

3. 日志管理功能

   • 操作日志：记录用户操作行为
   • 登录日志：记录用户登录情况
   • 系统日志：记录系统运行日志
   • 异常日志：记录系统异常情况

十一、集成接口模块

1. 功能概述

集成接口模块负责与外部系统的数据交换和集成，实现系统间的无缝连接。

2. 功能列表

• 银行支付接口：与银行系统对接，实现水费代扣
• 微信支付接口：与微信支付系统对接
• 支付宝支付接口：与支付宝支付系统对接
• 短信平台接口：与短信平台对接，发送短信通知
• 电子发票接口：与税务系统对接，开具电子发票
• GIS系统接口：与地理信息系统对接
• 物联网平台接口：与物联网平台对接，采集智能水表数据
• 数据交换接口：与其他业务系统进行数据交换

3. 业务流程

graph TD
    A[系统事件触发] --> B{接口类型}
    B -- 支付接口 --> C[发送支付请求]
    C --> D[接收支付结果]
    D --> E[更新支付状态]
    B -- 短信接口 --> F[组装短信内容]
    F --> G[调用短信发送]
    G --> H[记录发送结果]
    B -- 数据同步接口 --> I[准备同步数据]
    I --> J[调用同步接口]
    J --> K[处理同步结果]

4. 核心功能说明

1. 支付接口集成

   • 银行代扣接口：实现水费银行代扣功能
   • 微信支付接口：通过微信支付水费
   • 支付宝支付接口：通过支付宝支付水费
   • 支付结果处理：处理支付回调，更新支付状态

2. 通知接口集成

   • 短信通知：抄表通知、缴费通知、催缴通知等
   • 邮件通知：电子账单、电子发票等
   • 微信通知：通过微信公众号、小程序推送通知
   • APP推送：通过移动APP推送通知

3. 数据采集接口集成

   • 智能水表数据采集：远程采集智能水表读数
   • 物联网设备数据采集：采集物联网设备监测数据
   • 实时数据监控：监控关键设备的实时运行数据
   • 数据异常预警：对异常数据进行预警