tangweijie df5b63f998 重构系统总体设计章节，优化架构文档结构，新增任务概述和设计概述章节，细化逻辑架构和物理架构设计内容，完善子系统定义和关系描述，提升文档完整性和可读性，符合甲方A级交付标准。

2025-08-11 15:19:08 +08:00

62 KiB

Raw Blame History

福建水务数智营收管理系统概要设计说明书

文件状态：	文档密级：	公开
【√】草稿
【】修改稿
【】正式发布
	当前版本：	V1.4
	作者：	唐伟杰
	完成日期：	2025-08-01

版本历史

日期	版本号	作者	备注
2025-07-01	V1.0	唐伟杰	初版
2025-07-17	V1.1	唐伟杰	1. 同步详细设计中的模块，补充缺失模块。 2. 调整子系统划分与编号，确保逻辑清晰、编号连续。 3. 重构表务、报装、客户服务子系统，优化模块设计。 4. 统一概要设计与详细设计的结构，提升一致性。
2025-08-01	V1.2	唐伟杰	完善 APP相关的模块设计
2025-08-01	V1.3	唐伟杰	数据库系统变更：将OpenGauss替换为达梦数据库 8.0+，更新所有相关架构图和技术描述。
2025-08-01	V1.4	唐伟杰	单点登录采用OAuth2.0协议：更新单点登录模块描述，强调基于OAuth2.0协议实现。

福建水务数智营收管理系统概要设计说明书
- 版本历史
目录
前言
系统总体设计
子系统1设计: 统一平台
子系统2设计: 营收系统
子系统3设计: 表务系统
子系统4设计: 报装系统
- 功能与界面
- 模块设计
子系统5设计: 客户服务
子系统6设计: 手机抄表APP
非功能性需求的设计

前言

编写目的

本文档是《福建水务数智营收管理系统详细设计说明书》的前导文档，旨在从总体架构和概要设计的角度对系统进行全面的技术规划和设计。

主要目的：

总体架构规划：从系统整体角度进行技术架构规划，为详细设计提供宏观指导
技术方案论证：确定系统的技术选型、架构模式和实现策略
设计标准制定：建立统一的技术标准、开发规范和质量要求
风险评估分析：识别技术风险、制定应对策略
资源需求评估：确定系统开发、部署所需的技术资源和基础设施

预期读者：

系统架构师和技术负责人
项目经理和技术管理人员
详细设计和开发团队
测试团队和运维团队
甲方技术评审团队

背景与任务

福建水务数智营收管理系统是为满足福建省水投数字科技有限公司客户服务管理领域的业务需求而建设的综合管理平台。系统以客户关系数据库为核心和基础，实现客户全生命周期管理。

建设背景：

福建水投集团注册资本46亿元，在全省40多个县市区投资重大水利项目超过450亿元，拥有全级次子公司超过67家，职工人数超3500人。当前，集团正紧紧抓住城乡供水一体化建设的机遇，需要构建以客户为中心的客户服务平台。

主要任务：

业务流程再造：梳理和优化客户服务管理领域的业务流程
组织架构优化：配合业务流程重组，优化组织架构和管理制度
绩效体系建设：建立科学的绩效考核标准和评价体系
平台系统建设：构建以客户为中心的一体化客户服务平台
服务质量提升：全面提高客户服务质量和客户满意度

技术目标：

采用现代化微服务架构，支持大规模并发访问
支持多租户模式，满足集团化管理需求
实现移动化办公，提高工作效率
集成物联网技术，支持智能水表远程抄表
适配国产化环境，确保系统安全可控

术语与缩略语

术语、缩写	解释
SaaS	Software as a Service，软件即服务
RBAC	Role-Based Access Control，基于角色的访问控制
JWT	JSON Web Token，基于JSON的Web令牌
OAuth2	开放授权标准
RESTful	Representational State Transfer，表现层状态转化
OpenAPI	开放应用程序接口规范
DDL	Data Definition Language，数据定义语言
DML	Data Manipulation Language，数据操作语言
IoT	Internet of Things，物联网
DevOps	Development和Operations的组合词，开发运维一体化
站点	用于划分用户所属管辖区域，站点可以进行多级管理
册本	又称抄表本或抄表簿，根据抄表线路规划，按排相邻的一些水表给某一个抄表员进行抄表
用户编号	为签定了供用水合同的正式用户分配的唯一识别号
售水量	抄收水量+查处水量±调整水量
当期应收水费	当期售水量乘以不同类别的水价（到户价）所得的金额
水表抄见率	（当期应抄用户数-当期估表用户数）/当期应抄用户数×100%

参考资料

《福建水务数智营收管理系统需求规格说明书》
《福建水务数智营收管理系统详细设计说明书》
《福建水务数智营收管理系统数据库设计说明书》
《福建水务数智营收管理系统接口设计说明书》
GB/T 8556-2007 信息技术软件生存周期过程
GB/T 9385-2008 计算机软件需求规格说明规范
GB/T 8567-2006 计算机软件文档编制规范
《RuoYi-Vue-Pro技术架构文档》
《Spring Cloud微服务架构设计指南》

系统总体设计

任务概述

系统总体目标

福建水务数智营收管理系统主要包含统一平台、营收系统、表务系统、报装系统、客户服务和手机抄表APP等子系统，以及相关外部接口集成。

通过系统的建设，实现福建省水投数字科技有限公司客户服务管理领域的业务流程梳理再造、组织架构的优化、管理制度的建设、绩效考核标准的建设。构建以客户为中心的一体化客户服务平台，将客户的所有信息进行有机的关联，方便企业对营收信息进行综合分析和管理，为客户提供更多、更便捷、更主动的个性化服务，提高客户服务的质量和客户满意度。

功能范围

本系统的功能涵盖客户资料管理、抄表开账、营业收费、账务处理、催缴管理、发票管理、表务工单、银行代扣代缴、第三方支付（微信、支付宝）、报装系统、水表仓库管理；还包含系统业务必要的查询统计及报表打印功能。

功能列表如下：

统一平台：单点登录、用户管理、角色管理、权限管理、组织机构、系统配置、数据字典管理；
营收系统：客户资料管理、抄表开账、营业收费、账务处理、发票管理、催缴管理、统计分析、代收业务、业务工单；
表务系统：表务基础管理、仓库与库存管理、设备档案管理；
报装系统：报装流程管理、工程管理、档案管理；
客户服务：账户绑定管理、信息查询服务、在线缴费服务、电子发票服务；
手机抄表APP：登录模块、首页搜索、采集任务管理、换表工单、其他工单、个人信息与系统设置。

系统涉众与用户特点

系统涉众：

本系统主要涉及用户为各水务公司与系统相关的业务参与者、福建省水投数字科技有限公司研发运维团队。

用户特点：

公司领导：对信息化在企业生产经营管理活动中的积极作用有深刻认识，并具有前瞻视角。
公司管理层：有丰富的企业管理经验，有良好的业务管理类系统使用经验。
系统管理人员：具有本科以上教育背景，计算机操作熟练，具有良好的软件系统维护经验，主要维护系统的后台权限管理、人员管理、部门管理等功能。
操作人员：部分用户已经使用过其他厂商提供的营业收费系统，部分用户对软件系统使用经验不足。

设计概述

总体约束

技术约束：

采用现代化微服务架构，支持大规模并发访问
支持多租户模式，满足集团化管理需求
实现移动化办公，提高工作效率
集成物联网技术，支持智能水表远程抄表
适配国产化环境，确保系统安全可控

性能约束：

系统并发用户数不低于200个
移动设备同时登录系统的并发用户数不少于50个
系统响应时间不超过3秒
支持100万客户的业务量
系统可用性达到99.5%以上

安全约束：

系统满足国家信息安全等级保护要求
支持数据加密存储和传输
实现细粒度的权限控制
提供完整的审计日志功能

系统外部接口

本系统需要与以下外部系统进行接口集成：

接口类型	接口名称	功能描述	接口协议
金融支付	银行代扣接口	银行托收代扣缴费	HTTPS
金融支付	微信支付接口	微信在线支付	HTTPS
金融支付	支付宝支付接口	支付宝在线支付	HTTPS
通信服务	短信平台接口	短信通知发送	HTTPS
物联网	集抄系统接口	智能水表数据采集	TCP/HTTPS
税务服务	电子发票接口	第三方发票开具	HTTPS
认证服务	身份认证接口	第三方身份验证	HTTPS

设计方案概述

架构设计方案：

系统采用现代化的多层分布式架构，基于微服务设计思想，实现松耦合、高内聚的系统架构。整体架构分为表现层、网关层、业务服务层、基础服务层和数据层五个层次。

技术选型方案：

后端技术栈：Java 11+、Spring Boot 2.7+、Spring Cloud Gateway、MyBatis-Plus
前端技术栈：Vue 3、Element Plus、TypeScript
数据库：达梦数据库 8.0+（主从架构）
缓存：Redis 6.0+（集群模式）
消息队列：RabbitMQ 3.9+
文件存储：MinIO（分布式文件存储）
容器化：Docker + Docker Compose

部署方案：

采用容器化部署架构，支持多环境部署（开发、测试、生产），提供自动化部署脚本，支持弹性扩缩容。

系统架构设计

系统的逻辑架构设计

系统采用现代化的多层分布式架构，基于微服务设计思想，实现松耦合、高内聚的系统架构。

整体架构图

graph TB
    subgraph "表现层"
        A1[Web管理端<br/>Vue3 + Element Plus]
        A2[移动抄表端<br/>uni-app]
        A3[客户微信小程序]
        A4[客户支付宝小程序]
    end
    
    subgraph "网关层"
        B1[API网关<br/>Spring Cloud Gateway]
        B2[负载均衡<br/>Nginx]
        B3[认证授权<br/>Spring Security + JWT]
    end
    
    subgraph "业务服务层"
        C1[统一平台服务<br/>用户权限管理]
        C2[营收管理服务<br/>抄表收费核心业务]
        C3[表务管理服务<br/>水表全生命周期]
        C4[报装管理服务<br/>报装流程管理]
        C5[客户服务<br/>线上服务渠道]
    end
    
    subgraph "基础服务层"
        D1[权限服务<br/>RBAC权限控制]
        D2[工作流服务<br/>Flowable引擎]
        D3[消息服务<br/>异步消息处理]
        D4[文件服务<br/>文档附件管理]
        D5[支付服务<br/>第三方支付集成]
    end
    
    subgraph "数据层"
        E1[(达梦数据库 8.0+<br/>主从架构)]
        E2[(Redis 6.0+<br/>分布式缓存)]
        E3[MinIO<br/>分布式文件存储]
    end
    
    %% 层级间调用关系
    A1 --> B1
    A2 --> B1
    A3 --> B1
    A4 --> B1
    
    B1 --> C1
    B1 --> C2
    B1 --> C3
    B1 --> C4
    B1 --> C5
    
    C1 --> D1
    C2 --> D1
    C2 --> D2
    C2 --> D3
    C3 --> D2
    C4 --> D2
    C5 --> D5
    
    D1 --> E1
    D2 --> E1
    D3 --> E2
    D4 --> E3
    D5 --> E1

层级说明

表现层（Presentation Layer）

负责用户交互和界面展示
包含多种客户端形态：Web端、移动端、小程序端
采用前后端分离架构，提高开发效率和用户体验

网关层（Gateway Layer）

统一入口，负责请求路由和负载均衡
集中处理认证授权、限流熔断、监控日志
提供API版本管理和接口文档生成

业务服务层（Business Service Layer）

核心业务逻辑处理层
按业务域划分微服务，实现高内聚低耦合
支持独立部署、扩缩容和技术栈选择

基础服务层（Infrastructure Service Layer）

提供通用的技术服务能力
包含权限、工作流、消息、文件等基础服务
为业务服务提供统一的技术支撑

数据层（Data Layer）

数据持久化和缓存层
支持读写分离、分库分表、数据备份
提供高性能、高可用的数据服务

系统数据流向图

flowchart TD
    subgraph "数据采集层"
        A1[移动抄表APP<br/>数据采集]
        A2[智能水表<br/>远程数据]
        A3[Web管理端<br/>业务录入]
        A4[客户端小程序<br/>用户数据]
        A5[外部系统<br/>接口数据]
    end
    
    subgraph "数据接入层"
        B1[API网关<br/>数据验证]
        B2[数据清洗<br/>格式转换]
        B3[消息队列<br/>异步处理]
        B4[数据缓存<br/>临时存储]
    end
    
    subgraph "业务处理层"
        C1[抄表服务<br/>水量计算]
        C2[收费服务<br/>账单生成]
        C3[账务服务<br/>财务处理]
        C4[工单服务<br/>流程处理]
        C5[统计服务<br/>数据分析]
    end
    
    subgraph "数据存储层"
        D1[(达梦数据库主库<br/>核心业务数据)]
        D2[(达梦数据库从库<br/>查询数据)]
        D3[(Redis缓存<br/>热点数据)]
        D4[文件存储<br/>附件图片]
        D5[(备份库<br/>历史数据)]
    end
    
    subgraph "数据服务层"
        E1[查询服务<br/>数据检索]
        E2[报表服务<br/>统计分析]
        E3[接口服务<br/>对外开放]
        E4[推送服务<br/>消息通知]
    end
    
    subgraph "数据展现层"
        F1[管理后台<br/>业务操作]
        F2[统计大屏<br/>可视化展示]
        F3[移动端<br/>现场作业]
        F4[客户端<br/>自助服务]
        F5[第三方系统<br/>数据集成]
    end
    
    %% 数据流向关系
    A1 -.->|数据采集<br/>格式验证| B1
    A2 -.->|数据采集<br/>格式验证| B1
    A3 -.->|数据采集<br/>格式验证| B1
    A4 -.->|数据采集<br/>格式验证| B1
    A5 -.->|数据采集<br/>格式验证| B1
    
    B1 -.->|数据接入<br/>清洗转换| B2
    B2 -.->|数据接入<br/>清洗转换| B3
    B3 -.->|数据接入<br/>清洗转换| B4
    
    B4 -.->|业务处理<br/>数据持久化| C1
    B4 -.->|业务处理<br/>数据持久化| C2
    B4 -.->|业务处理<br/>数据持久化| C3
    B4 -.->|业务处理<br/>数据持久化| C4
    B4 -.->|业务处理<br/>数据持久化| C5
    
    C1 -.->|数据存储| D1
    C2 -.->|数据存储| D1
    C3 -.->|数据存储| D1
    C4 -.->|数据存储| D1
    C5 -.->|数据存储| D1
    
    D1 -.->|数据查询<br/>统计分析| E1
    D2 -.->|数据查询<br/>统计分析| E2
    D3 -.->|数据查询<br/>统计分析| E3
    D4 -.->|数据查询<br/>统计分析| E4
    
    E1 -.->|数据服务<br/>接口调用| F1
    E2 -.->|数据服务<br/>接口调用| F2
    E3 -.->|数据服务<br/>接口调用| F3
    E4 -.->|数据服务<br/>接口调用| F4
    E1 -.->|数据服务<br/>接口调用| F5

系统的物理架构设计

系统采用分布式部署架构，通过多个服务器集群实现高可用和高性能。

物理部署图

graph TB
    subgraph "DMZ区域"
        subgraph "负载均衡集群"
            LB1[Nginx 主<br/>8核16G]
            LB2[Nginx 备<br/>8核16G]
            WAF[Web应用防火墙]
        end
    end
    
    subgraph "应用服务区"
        subgraph "Web服务集群"
            WEB1[Web服务器1<br/>8核32G]
            WEB2[Web服务器2<br/>8核32G]
        end
        
        subgraph "应用服务集群"
            APP1[应用服务器1<br/>16核64G]
            APP2[应用服务器2<br/>16核64G]
        end
        
        subgraph "中间件集群"
            MQ1[消息队列1<br/>8核16G]
            MQ2[消息队列2<br/>8核16G]
        end
    end
    
    subgraph "数据服务区"
        subgraph "数据库集群"
            DB1[达梦数据库主库<br/>32核128G]
            DB2[达梦数据库从库<br/>32核128G]
            DB3[达梦数据库备库<br/>32核128G]
        end
        
        subgraph "缓存集群"
            REDIS1[Redis主节点<br/>16核32G]
            REDIS2[Redis从节点<br/>16核32G]
            REDIS3[Redis哨兵<br/>8核16G]
        end
        
        subgraph "文件存储集群"
            FILE1[MinIO节点1<br/>8核32G 10TB]
            FILE2[MinIO节点2<br/>8核32G 10TB]
            FILE3[MinIO节点3<br/>8核32G 10TB]
        end
    end
    
    subgraph "管理服务区"
        MONITOR[监控服务器<br/>Prometheus + Grafana<br/>8核16G]
        BACKUP[备份服务器<br/>8核32G 20TB]
        JUMP[跳板服务器<br/>4核8G]
        LOG[日志服务器<br/>ELK Stack<br/>16核32G]
    end

网络连接

graph TB

    Internet -.->|HTTPS| DMZ
    DMZ -.->|HTTP/RPC| APP
    APP -.->|数据访问| DATA
    MGMT -.->|监控管理| APP
    MGMT -.->|监控管理| DATA

硬件配置规格

DMZ区域配置

设备类型	配置规格	数量	主要作用
负载均衡器	8核16G，双网卡	2台	负载均衡、高可用
Web应用防火墙	硬件WAF设备	1台	安全防护

应用服务区配置

设备类型	配置规格	数量	主要作用
Web服务器	8核32G，1TB SSD	2台	前端应用部署
应用服务器	16核64G，2TB SSD	2台	后端服务部署
消息队列服务器	8核16G，1TB SSD	2台	异步消息处理

数据服务区配置

设备类型	配置规格	数量	主要作用
数据库服务器	32核128G，10TB SSD	3台	主从备数据库
缓存服务器	16核32G，1TB SSD	3台	Redis集群
文件存储服务器	8核32G，10TB HDD	3台	分布式文件存储

管理服务区配置

设备类型	配置规格	数量	主要作用
监控服务器	8核16G，1TB SSD	1台	系统监控
备份服务器	8核32G，20TB HDD	1台	数据备份
跳板服务器	4核8G，500GB SSD	1台	运维管理
日志服务器	16核32G，5TB SSD	1台	日志收集分析

达梦数据库分布式架构

系统采用达梦数据库分布式架构，支持高性能、高可用、高扩展性的数据存储服务。

graph TB
    subgraph "达梦数据库分布式架构"
        subgraph "协调节点"
            CN1[协调节点1<br/>Coordinator Node]
            CN2[协调节点2<br/>Coordinator Node]
        end
        
        subgraph "数据节点组1"
            DN1_1[数据节点1-主<br/>Datanode Primary]
            DN1_2[数据节点1-备<br/>Datanode Standby]
            DN1_1 -.->|主备同步| DN1_2
        end
        
        subgraph "数据节点组2"
            DN2_1[数据节点2-主<br/>Datanode Primary]
            DN2_2[数据节点2-备<br/>Datanode Standby]
            DN2_1 -.->|主备同步| DN2_2
        end
        
        subgraph "GTM节点"
            GTM[全局事务管理器<br/>GTM Master]
            GTM_S[GTM备节点<br/>GTM Standby]
            GTM -.->|备份| GTM_S
        end
    end
    
    %% 分布式架构调用关系
    CN1 -.->|分片路由<br/>查询协调| DN1_1
    CN1 -.->|分片路由<br/>查询协调| DN2_1
    CN2 -.->|分片路由<br/>查询协调| DN1_1
    CN2 -.->|分片路由<br/>查询协调| DN2_1
    CN1 -.->|事务管理<br/>全局一致性| GTM
    CN2 -.->|事务管理<br/>全局一致性| GTM

容器化部署架构

系统采用Docker容器化部署，使用Docker Compose进行服务编排，支持快速部署和弹性扩缩容。

graph TB
    subgraph "容器化部署架构"
        subgraph "前端服务层"
            WEB_CONTAINER[前端容器<br/>Nginx + Vue3]
        end
        
        subgraph "后端服务层"
            APP_CONTAINER[后端容器<br/>Spring Boot]
        end
        
        subgraph "数据存储层"
            DB_CONTAINER[数据库容器<br/>达梦数据库]
            CACHE_CONTAINER[缓存容器<br/>Redis]
            FILE_CONTAINER[文件存储容器<br/>MinIO]
        end
        
        subgraph "监控服务层"
            MONITOR_CONTAINER[监控容器<br/>Prometheus + Grafana]
            LOG_CONTAINER[日志容器<br/>ELK Stack]
        end
    end
    
    %% 容器服务调用关系
    WEB_CONTAINER -.->|API请求<br/>静态资源| APP_CONTAINER
    APP_CONTAINER -.->|数据操作| DB_CONTAINER
    APP_CONTAINER -.->|缓存访问| CACHE_CONTAINER
    APP_CONTAINER -.->|文件存储| FILE_CONTAINER
    APP_CONTAINER -.->|监控数据| MONITOR_CONTAINER
    APP_CONTAINER -.->|日志数据| LOG_CONTAINER

子系统定义

子系统列表

子系统编号	子系统名称（标识）	功能描述	开发方式
SYS-001	统一平台	单点登录、系统管理、权限管理、租户管理	自行开发
SYS-002	营收系统	客户管理、抄表开账、营业收费、账务处理、发票管理、催缴管理	自行开发
SYS-003	表务系统	表务工单、表务仓库、水表全生命周期管理	自行开发
SYS-004	报装系统	报装流程管理、现场踏勘、合同签订、施工验收	自行开发
SYS-005	客户服务	微信小程序、支付宝小程序、客户自助服务	自行开发
SYS-006	手机抄表APP	移动端抄表、工单处理、数据同步	自行开发

子系统间关系

子系统调用关系图

graph TB
    subgraph "统一平台"
        UP[用户权限管理<br/>组织架构管理<br/>系统配置管理]
    end
    
    subgraph "营收系统"
        REV[客户管理<br/>抄表开账<br/>营业收费<br/>账务处理]
    end
    
    subgraph "表务系统"
        METER[表务工单<br/>表务仓库<br/>设备管理]
    end
    
    subgraph "报装系统"
        INSTALL[报装流程<br/>现场踏勘<br/>施工验收]
    end
    
    subgraph "客户服务"
        CS[微信小程序<br/>支付宝小程序<br/>在线缴费]
    end

    subgraph "手机抄表APP"
        APP[移动抄表<br/>工单处理]
    end
    
    %% 调用关系
    UP -.->|用户认证<br/>权限验证| REV
    UP -.->|用户认证<br/>权限验证| METER
    UP -.->|用户认证<br/>权限验证| INSTALL
    UP -.->|用户认证<br/>权限验证| CS
    UP -.->|用户认证<br/>权限验证| APP

    REV -.->|客户信息<br/>水表信息| METER
    REV -.->|新用户立户| INSTALL
    REV -.->|账单信息<br/>缴费接口| CS
    REV -.->|抄表任务<br/>欠费信息| APP
    
    METER -.->|换表通知<br/>库存信息| REV
    METER -.->|工单信息| APP

    INSTALL -.->|立户信息| REV
    CS -.->|缴费记录| REV

    APP -.->|抄表数据<br/>工单回填| REV
    APP -.->|工单回填| METER

主要接口定义

统一平台对外接口

接口名称	接口描述	调用方	接口协议
用户认证接口	验证用户身份和权限	所有子系统	HTTP/REST
组织信息接口	获取部门和员工信息	营收系统、表务系统	HTTP/REST
权限验证接口	验证用户操作权限	所有子系统	HTTP/REST

营收系统对外接口

接口名称	接口描述	调用方	接口协议
客户信息查询接口	查询客户基本信息	表务系统、客户服务	HTTP/REST
账单查询接口	查询客户账单信息	客户服务	HTTP/REST
缴费处理接口	处理在线缴费	客户服务	HTTP/REST
立户接口	新客户立户	报装系统	HTTP/REST
抄表任务接口	下发抄表任务和客户信息	手机抄表APP	HTTP/REST
抄表数据上传接口	上传抄表数据	手机抄表APP	HTTP/REST

表务系统对外接口

接口名称	接口描述	调用方	接口协议
水表库存查询接口	查询水表库存信息	营收系统	HTTP/REST
换表通知接口	换表完成通知	营收系统	HTTP/REST
工单查询接口	查询待办工单	手机抄表APP	HTTP/REST
工单回填接口	回填工单处理结果	手机抄表APP	HTTP/REST

子系统1设计: 统一平台

功能与界面

统一平台是整个系统的基础支撑平台，提供统一的用户认证、权限管理、组织管理等功能。作为SaaS多租户平台的核心，统一平台确保了系统的安全性、可扩展性和可管理性。

主要功能包括：

单点登录：提供统一的登录入口，支持多种认证方式
用户管理：管理系统用户的基本信息、状态和权限
角色管理：定义和管理系统角色，实现基于角色的权限控制
权限管理：细粒度的功能权限和数据权限控制
组织管理：管理企业的部门结构和人员归属
租户管理：支持多租户模式，实现数据隔离和个性化配置
系统监控：实时监控系统运行状态和用户在线情况

模块列表

模块编号	模块名称（标识）	功能描述	开发方式
UP-001	单点登录模块	用户认证、授权管理、多种登录方式支持	自行开发
UP-002	系统管理模块	用户、角色、部门、菜单等基础数据管理	自行开发
UP-003	权限控制模块	RBAC权限模型、菜单权限、数据权限	自行开发
UP-004	租户管理模块	多租户数据隔离、租户配置管理	自行开发
UP-005	系统监控模块	在线用户监控、系统性能监控、操作日志	自行开发

模块间关系

权限管理功能群

权限管理功能群是统一平台的核心，实现了完整的RBAC权限控制模型。

graph TB
    subgraph "权限管理功能群"
        A[用户管理模块]
        B[角色管理模块]
        C[菜单管理模块]
        D[部门管理模块]
        E[权限控制模块]
    end
    
    A -->|用户角色关联| B
    B -->|角色权限关联| C
    A -->|用户部门关联| D
    E -->|权限验证| A
    E -->|权限验证| B
    E -->|权限验证| C
    
    A -.->|数据权限| D
    B -.->|功能权限| C

功能群说明：

用户管理模块负责用户基本信息维护
角色管理模块定义系统角色和权限
菜单管理模块配置系统功能菜单
部门管理模块维护组织架构
权限控制模块实现统一的权限验证

系统监控功能群

系统监控功能群提供对整个系统运行状态的监控和管理。

graph TB
    subgraph "系统监控功能群"
        F[在线用户监控]
        G[系统性能监控]
        H[操作日志管理]
        I[系统配置管理]
    end
    
    F -->|用户行为| H
    G -->|性能数据| H
    I -->|配置变更| H
    
    F -.->|实时监控| G
    H -.->|日志分析| G

模块设计

模块1: 单点登录

功能描述：

单点登录模块基于OAuth2.0协议实现，提供统一的用户认证入口，支持多种登录方式和安全策略。该模块是整个系统安全的第一道防线，确保只有合法用户才能访问系统。

主要功能：

用户名密码登录：传统的用户名密码认证方式
手机号短信登录：基于短信验证码的快速登录
第三方登录：支持微信、支付宝等第三方平台登录
OAuth2.0单点登录：基于OAuth2.0协议，一次登录，多系统访问
自动登录：支持"记住我"功能
安全控制：密码策略、登录限制、验证码等

技术实现：

基于JWT令牌的无状态认证
Redis存储用户会话信息
Spring Security实现安全控制
支持多种加密算法

模块2: 系统管理

功能描述：

系统管理模块提供系统基础数据的维护功能，包括用户、角色、部门、菜单等核心数据的管理。

主要功能：

用户管理：用户信息的增删改查、状态管理、权限分配
角色管理：角色定义、权限分配、角色用户关联
部门管理：组织架构的维护、层级关系管理
菜单管理：系统菜单的配置、权限关联
字典管理：系统字典数据的维护
参数管理：系统参数的配置和管理

业务规则：

用户名全局唯一
手机号不能重复
超级管理员不能被删除
部门删除前需要先移除下属用户

中间件和其他设计

缓存

Redis缓存设计：

缓存类型	Key格式	Value类型	过期时间	用途说明
用户会话	user:session:{userId}	Hash	2小时	存储用户登录信息
用户权限	user:permission:{userId}	Set	30分钟	缓存用户权限列表
系统配置	system:config:{configKey}	String	24小时	系统配置参数
数据字典	system:dict:{dictType}	List	24小时	字典数据缓存
验证码	captcha:{uuid}	String	5分钟	图形验证码
短信验证码	sms:code:{mobile}	String	5分钟	短信验证码

消息队列

RabbitMQ消息队列设计：

Queue名称	Exchange	Routing Key	消费者	用途说明
user.operation	topic.exchange	user.*	UserOperationConsumer	用户操作日志
system.notification	topic.exchange	system.*	NotificationConsumer	系统通知消息
sms.send	direct.exchange	sms.send	SmsConsumer	短信发送队列
email.send	direct.exchange	email.send	EmailConsumer	邮件发送队列

定时任务

任务名称	Cron表达式	执行频率	功能描述
清理过期会话	0 0 2 * * ?	每日凌晨2点	清理过期的用户会话
同步用户状态	0 /10 * * ?	每10分钟	同步用户在线状态
清理操作日志	0 0 3 * * ?	每日凌晨3点	清理30天前的操作日志
系统健康检查	0 /5 * * ?	每5分钟	检查系统组件健康状态

对外接口

接口类型	接口名称（标识）	功能描述	接口协议	备注
REST API	用户认证接口	用户登录认证和令牌生成	HTTP/REST	详见《接口设计说明书》
REST API	权限验证接口	验证用户访问权限	HTTP/REST	供其他子系统调用
REST API	用户信息接口	获取用户基本信息	HTTP/REST	供其他子系统调用
REST API	组织架构接口	获取部门和员工信息	HTTP/REST	供其他子系统调用
WebSocket	实时通知接口	推送系统通知消息	WebSocket	实时消息推送

子系统2设计: 营收系统

功能与界面

营收系统是整个水务管理平台的核心业务系统，负责处理从客户管理到账务处理的完整营收业务流程。

核心业务流程： 客户建档 → 抄表录入 → 复核开账 → 营业收费 → 账务处理 → 发票管理 → 催缴管理

主要功能模块：

客户资料管理：客户档案建立、信息维护、分组管理
抄表开账：抄表数据录入、复核确认、自动开账
营业收费：柜台收费、移动收费、在线缴费
账务处理：账务调整、退款处理、坏账管理
发票管理：发票开具、查询、重开、作废
催缴管理：欠费统计、催缴通知、停水管理

模块列表

模块编号	模块名称（标识）	功能描述	开发方式
REV-001	客户资料管理	客户档案管理、客户分组、信息变更	自行开发
REV-002	抄表开账	抄表录入、复核开账、异常处理	自行开发
REV-003	营业收费	柜台收费、移动收费、在线缴费	自行开发
REV-004	账务处理	账务调整、退款处理、坏账管理	自行开发
REV-005	发票管理	发票开具、查询管理、电子发票	自行开发
REV-006	催缴管理	欠费催缴、短信通知、停水管理	自行开发
REV-007	统计分析	提供多维度的数据统计和报表分析功能	自行开发
REV-008	代收业务	集成银行、第三方支付等代收渠道	自行开发

模块间关系

营收核心业务群

营收核心业务群实现了完整的营收业务流程，各模块之间存在严格的业务依赖关系。

graph LR
    A[客户资料管理] --> B[抄表开账]
    B --> C[营业收费]
    C --> D[账务处理]
    D --> E[发票管理]
    
    A -.->|客户信息| C
    A -.->|客户信息| E
    B -.->|账单信息| D
    C -.->|收费记录| E

客户服务业务群

客户服务业务群围绕客户服务展开，提供完整的客户服务链条。

graph TB
    F[客户资料管理] --> G[催缴管理]
    G --> H[营业收费]
    H --> I[发票管理]
    
    F -.->|客户联系方式| G
    G -.->|催缴结果| H
    H -.->|缴费凭证| I

模块设计

模块1: 客户资料管理

功能概述：

客户资料管理模块是营收系统的基础，负责维护所有用水客户的基本信息和档案资料。

核心功能：

客户档案管理
- 新客户建档
- 客户信息修改
- 客户状态管理（正常、停用、注销）
- 客户变更历史记录
客户分组管理
- 按区域分组
- 按用水性质分组
- 按客户类型分组
- 自定义分组
客户查询服务
- 多条件组合查询
- 模糊查询支持
- 高级筛选功能

业务规则：

客户编号系统自动生成，格式：部门代码+年份+6位流水号
身份证号码必须通过实名认证
客户状态变更需要审批流程
存在未结清账务的客户不允许注销

模块2: 抄表开账

功能概述：

抄表开账模块实现了从抄表数据录入到自动生成账单的完整业务流程。

核心功能：

抄表数据录入
- 手工抄表录入
- PDA抄表导入
- 远传抄表自动采集
- Excel批量导入
抄表数据复核
- 数据有效性验证
- 异常用水量检测
- 人工复核确认
- 批量复核处理
自动开账处理
- 水量计算
- 费用计算
- 账单生成
- 开账确认

业务流程图：

flowchart TD
    A[开始抄表] --> B{选择抄表方式}
    B -->|手工抄表| C[手工录入抄表数据]
    B -->|PDA抄表| D[PDA现场抄表]
    B -->|远传抄表| E[自动采集抄表数据]
    B -->|批量导入| F[Excel批量导入]
    
    C --> G[系统数据验证]
    D --> H[PDA数据上传]
    E --> I[远传数据同步]
    F --> J[批量数据校验]
    
    H --> G
    I --> G
    J --> G
    
    G --> K{数据是否有效?}
    K -->|否| L[数据修正]
    L --> G
    K -->|是| M[抄表数据复核]
    
    M --> N{复核是否通过?}
    N -->|否| O[标记异常数据]
    O --> P[人工处理异常]
    P --> M
    N -->|是| Q[计算用水量]
    
    Q --> R[计算水费金额]
    R --> S[生成账单]
    S --> T[开账确认]
    T --> U[结束]

业务规则：

抄表状态：正常、故障、估读、拒抄、空房等
用水量计算：本期读数 - 上期读数
异常判断：超过历史平均值2倍为量高，低于0.5倍为量低
复核规则：抄表人员不能复核自己录入的数据

模块3: 营业收费

功能概述：

营业收费模块提供完整的收费业务流程管理，支持多种收费方式和支付渠道。

核心功能：

柜台收费
- 实时收费处理
- 多种支付方式
- 收费凭证打印
- 柜台结账管理
在线缴费
- 微信支付接入
- 支付宝支付接入
- 银行卡支付
- 代扣代缴服务
批量收费
- 批量缴费处理
- 预付款管理
- 托收业务
- 自动扣费

业务流程图：

flowchart TD
    A[客户缴费] --> B{选择缴费方式}
    B -->|柜台缴费| C[到营业厅缴费]
    B -->|在线缴费| D[选择在线支付]
    B -->|银行代扣| E[银行自动扣费]
    
    C --> F[查询客户账单]
    D --> G[微信/支付宝支付]
    E --> H[银行代扣处理]
    
    F --> I{账单是否正确?}
    I -->|否| J[账单调整]
    J --> F
    I -->|是| K[选择支付方式]
    
    K --> L{支付方式}
    L -->|现金| M[现金收费]
    L -->|POS机| N[刷卡收费]
    L -->|扫码| O[扫码支付]
    
    G --> P[第三方支付确认]
    H --> Q[银行扣费确认]
    M --> R[收费确认]
    N --> R
    O --> R
    P --> R
    Q --> R
    
    R --> S[更新账单状态]
    S --> T[生成收费凭证]
    T --> U{需要发票?}
    U -->|是| V[开具发票]
    U -->|否| W[完成收费]
    V --> W
    W --> X[结束]

业务规则：

收费员每日下班前必须进行"柜台结账"
结账前，收错的账款可以执行"红冲"操作
支持现金、POS机、微信、支付宝等多种支付方式
在线支付需要实时确认支付结果
银行代扣需要客户事先签约授权

模块4: 账务处理

功能概述:

负责处理各类复杂的账务调整、退款、坏账等业务，确保账务的准确性和合规性。

核心功能:

未销账调整: 对未支付账单进行调整。
分账调整: 将一笔总账单拆分为多笔子账单。
预付款退款: 处理客户预付款的退还流程。
呆坏账处理: 对长期无法收回的欠款进行核销。

模块5: 发票管理

功能概述:

提供全面的发票管理功能，支持电子发票和纸质发票的开具、查询、作废等操作。

核心功能:

发票开具: 根据缴费记录为客户开具发票。
发票查询与管理: 查询发票历史，处理红冲、作废等请求。
电子发票集成: 对接第三方电子发票平台，实现自动开具和推送。

模块6: 催缴管理

功能概述:

对逾期未缴费的客户进行有效的催缴管理，提高水费回收率。

核心功能:

欠费分析: 统计和分析欠费客户数据。
催缴通知: 通过短信、电话、通知单等多种方式进行催缴。
停复水管理: 对恶意欠费用户执行停水，缴清后进行复水操作。

模块7: 统计分析

功能概述:

提供多维度的数据统计和报表分析功能，为管理决策提供数据支持。

核心功能:

售水统计: 按日、月、年统计售水量、售水收入等。
收费统计: 统计不同收费渠道、方式的收费情况。
欠费分析: 多维度分析欠费构成和趋势。
自定义报表: 提供灵活的报表自定义工具。

模块8: 代收业务

功能概述:

集成银行、第三方支付等代收渠道，方便客户缴费。

核心功能:

银行代扣: 与银行签订协议，实现自动批量扣费。
第三方支付: 集成微信、支付宝等支付网关。
对账管理: 定期与各渠道进行账务核对。

模块9: 业务工单

功能概述:

业务工单模块负责管理水务系统中的各类业务工单，实现工单的统一管理和流转，整合了原表务系统的工单管理功能。

核心功能:

业务清单管理: 查询和管理通过系统办理的日常业务工单及其进度信息。
上报清单管理: 处理通过移动端上报的问题工单，包括现场发现的问题。
稽查工单管理: 处理抄表稽查和水价稽查工单，确保数据准确性。
换表工单管理: 处理水表更换相关的工单，与表务仓库系统协同作业。

业务规则:

工单编号系统自动生成，支持不同类型的编号规则
紧急工单需要在规定时间内快速响应
工单处理过程需要详细记录操作日志
换表工单需要与表务仓库系统同步水表状态

中间件和其他设计

缓存设计：

缓存类型	Key格式	用途说明	过期时间
客户信息	customer:info:{id}	客户基本信息缓存	1小时
价格信息	price:info:{type}	价格政策缓存	12小时
抄表任务	reading:task:{bookId}	抄表任务缓存	24小时

消息队列：

Queue名称	用途说明	消费者
billing.generate	账单生成队列	BillingConsumer
sms.arrears	欠费短信队列	SmsConsumer
email.invoice	发票邮件队列	EmailConsumer

对外接口

接口类型	接口名称（标识）	功能描述	接口协议	备注
REST API	客户查询接口	查询客户基本信息	HTTP/REST	供其他系统调用
REST API	账单查询接口	查询客户账单信息	HTTP/REST	供客户服务系统调用
REST API	缴费处理接口	处理在线缴费业务	HTTP/REST	供客户服务系统调用
REST API	立户接口	新客户立户	HTTP/REST	供报装系统调用

子系统3设计: 表务系统

功能与界面

表务系统负责水表全生命周期管理，从采购入库到报废退库的完整管理流程。其核心是确保水表资产的准确、高效流转，并为营收计量提供可靠的设备保障。

模块列表

模块编号	模块名称（标识）	功能描述	开发方式
METER-001	表务基础管理	管理水表相关的基础参数	自行开发
METER-002	仓库与库存管理	管理水表的入库、出库、盘点和调拨	自行开发
METER-003	设备档案管理	管理每一块水表的唯一电子档案	自行开发

注意: 表务工单管理功能已整合到营收系统的业务工单模块中，实现统一的工单管理。

模块设计

模块1: 表务基础管理

功能描述: 定义和维护表务管理所需的基础数据和配置参数。
核心功能:
- 水表厂家管理: 维护水表供应商信息。
- 水表口径管理: 管理不同口径水表的规格、检定周期等。
- 水表型号管理: 根据厂家和口径，管理具体的水表型号。
- 水表量程管理: 定义水表的计量范围。

模块2: 仓库与库存管理

功能描述: 负责水表的实物管理，与工单流程解耦，作为一个独立的资源中心。
核心功能:
- 入库管理: 包括新表采购入库、旧表回收（维修或报废）入库。
- 出库管理: 根据工单领料申请，发放新水表。
- 库存管理: 提供库存查询、盘点、调拨、库存预警等功能。

模块3: 设备档案管理

功能描述: 作为表务系统的核心，统一管理所有水表的基础信息和生命周期状态。
核心功能:
- 水表信息登录: 记录新购水表的型号、规格、供应商、批次等信息。
- 水表档案建立: 为每一块入库的水表建立唯一的、全生命周期跟踪的电子档案。
- 状态管理: 实时更新水表的状态（如：在库、在用、待检、报废等）。

子系统4设计: 报装系统

功能与界面

报装系统管理新用户从申请到通水的全过程业务流程。

主要功能：

报装流程管理：管理从申请、踏勘到合同签订的完整流程。
工程管理：负责施工、验收和通水环节。
档案管理：对报装过程中的所有文档进行归档和管理。

模块设计

模块1: 报装流程管理

功能描述: 统一管理新用户报装的核心流程，确保各环节顺畅衔接。
核心功能:
- 报装申请: 用户资料收集、申请材料审核、受理登记。
- 现场踏勘: 安排并记录现场勘查、制定初步设计方案、进行工程预算。
- 合同管理: 根据方案制作、签订供水合同，并收取相关费用。

模块2: 工程管理

功能描述: 聚焦于报装工程的现场实施与交付。
核心功能:
- 施工管理: 施工派工、进度监控、质量检查与整改。
- 竣工验收: 组织相关部门进行联合验收，确保工程质量达标。
- 立户通水: 验收通过后，同步信息至营收系统进行客户立户，并最终开通供水。

模块3: 档案管理

功能描述: 负责报装全流程的资料归档和查询。
核心功能:
- 资料归档: 对报装申请、踏勘记录、合同、施工图纸等所有文档进行电子化归档。
- 档案查询: 提供便捷的查询功能，可按客户名称、报装编号等多种条件检索历史档案。

新用户报装业务流程图：

flowchart TD
    A[用户报装申请] --> B[资料收集]
    B --> C[申请材料审核]
    C --> D{材料是否齐全?}
    D -->|否| E[补充材料]
    E --> C
    D -->|是| F[受理登记]
    
    F --> G[分配报装编号]
    G --> H[安排现场踏勘]
    H --> I[现场勘查]
    I --> J[工程设计]
    J --> K[制定施工方案]
    K --> L[费用预算]
    
    L --> M[方案审批]
    M --> N{审批是否通过?}
    N -->|否| O[方案修改]
    O --> M
    N -->|是| P[制作供水合同]
    
    P --> Q[通知用户签约]
    Q --> R[合同签订]
    R --> S[收取相关费用]
    S --> T[安排施工]
    
    T --> U[施工队伍派工]
    U --> V[现场施工]
    V --> W[施工进度监控]
    W --> X[施工质量检查]
    X --> Y{质量是否合格?}
    Y -->|否| Z[返工整改]
    Z --> V
    Y -->|是| AA[竣工验收]
    
    AA --> BB[资料归档]
    BB --> CC[信息同步营收系统]
    CC --> DD[客户立户]
    DD --> EE[开通供水]
    EE --> FF[结束]

业务规则：

受理规则：用户提交报装申请及完整材料后3个工作日内完成受理
踏勘规则：受理后5个工作日内完成现场踏勘和方案设计
审批规则：设计方案需要经过技术部门和管理部门双重审批
施工规则：合同签订并收费后10个工作日内开始施工
验收规则：施工完成后由工程部门、质检部门联合验收
归档规则：验收合格后所有资料必须完整归档并同步系统信息

子系统5设计: 客户服务

功能与界面

客户服务系统为用水客户提供多渠道、便捷的线上自助服务，主要通过微信和支付宝小程序实现。

模块列表

模块编号	模块名称（标识）	功能描述	开发方式
SERVICE-001	账户绑定管理	客户账户绑定和管理	自行开发
SERVICE-002	信息查询服务	各类信息查询服务	自行开发
SERVICE-003	在线缴费服务	多渠道在线缴费服务	自行开发
SERVICE-004	电子发票服务	电子发票管理服务	自行开发

模块设计

客户服务系统围绕功能维度进行组织，渠道作为功能的实现方式。

模块1: 账户绑定管理

功能描述: 提供客户账户的绑定、解绑及多户管理功能。
核心功能:
- 账户绑定: 客户通过客户编号、手机号、身份证等信息绑定水务账户。
- 绑定验证: 通过短信验证码等方式确保绑定安全。
- 多账户管理: 一个微信/支付宝账户可以绑定多个水务账户。
- 账户管理: 支持启用、停用绑定关系，处理账户异常情况。

模块2: 信息查询服务

功能描述: 提供全面的用水信息查询服务。
核心功能:
- 账单查询: 查询当期账单、历史账单、欠费信息等。
- 用水历史: 以图表形式展示历史用水量趋势。
- 缴费记录: 查询历史缴费记录详情。
- 停水公告: 查看所在区域的计划性或临时性停水通知。

模块3: 在线缴费服务

功能描述: 提供多种在线支付方式，为客户提供便捷的缴费服务。
核心功能:
- 多渠道支付: 支持微信支付、支付宝支付、银行卡支付等多种支付方式。
- 支付限额: 单次支付金额不超过5000元，确保资金安全。
- 支付确认: 支付完成后实时更新账户状态，推送缴费成功通知。
- 退款处理: 支持支付失败和错误支付的退款处理。

模块4: 电子发票服务

功能描述: 提供电子发票申请、查询、下载等服务。
核心功能:
- 发票申请: 客户可为已缴费项目申请电子发票，支持个人和企业发票。
- 发票管理: 查看已开具的电子发票列表和详情。
- 发票下载: 下载PDF格式的电子发票文件。
- 发票推送: 发票开具成功后自动推送给客户。

子系统6设计: 手机抄表APP

功能与界面

为抄表员、外勤人员提供移动作业工具，支持离线操作，提升现场工作效率。

核心业务流程： 任务下载 → 现场抄表 → 问题上报 → 工单处理 → 数据上传 → 结果同步

主要功能特点：

多维度搜索：支持户号、户名、地址、钢印号、手机号等多种搜索方式
离线作业：支持无网络环境下的现场抄表和工单处理
智能采集：提供定位、NFC、扫码三种数据采集方式
工单闭环：从问题上报到工单完成的完整处理流程
数据同步：网络恢复后自动同步本地数据到服务器

模块列表

模块编号	模块名称（标识）	功能描述	开发方式
MOBILE-001	登录模块	机构编号、用户名密码认证、自动登录	自行开发
MOBILE-002	首页搜索模块	多维度搜索、最近搜索记录、抄表任务	自行开发
MOBILE-003	采集任务管理模块	任务列表管理、批量下载、单户采集	自行开发
MOBILE-004	换表工单模块	换表工单处理、设备信息录入	自行开发
MOBILE-005	其他工单模块	复水、稽查、问题上报等工单处理	自行开发
MOBILE-006	个人信息与系统设置模块	个人信息管理、系统设置维护	自行开发

模块设计

模块1: 登录模块

功能描述: 提供移动端用户登录认证功能，支持机构编号、用户名、密码三要素登录。
核心功能:
- 核心登录功能: 机构编号、用户名、密码三要素认证，支持自动登录选项
- 登录辅助功能: 登录问题支持、版权标识展示
- 安全控制: 密码自动掩码显示、登录状态保持

模块2: 首页搜索模块

功能描述: 提供多维度客户搜索功能，实现快速定位客户信息。
核心功能:
- 搜索框功能: 支持户号、户名、地址、钢印号、手机号等多维度搜索
- 最近搜索记录: 自动保存搜索历史，支持去重和快速访问
- 抄表任务列表: 展示当前抄表员的任务列表，支持直接跳转

模块3: 采集任务管理模块

功能描述: 管理抄表员的采集任务，包括任务下载、现场采集等功能。
核心功能:
- 任务列表管理: 数据统计面板、任务筛选分类、批量下载操作
- 单户采集详情: 住户档案展示、多种采集方式（定位、NFC、扫码）
- 户间导航: 支持按任务列表顺序进行上一户/下一户切换

模块4: 换表工单模块

功能描述: 处理换表工单的完整流程，从工单接收到完成提交。
核心功能:
- 换表工单处理: 待办工单列表、工单信息填写、设备信息录入
- 附件管理: 支持图片和视频上传，作为现场证据
- 工单操作: 支持工单完成提交和退单处理

模块5: 其他工单模块

功能描述: 处理除换表外的其他类型工单，实现外勤业务闭环。
核心功能:
- 复水工单: 欠费状态校验、二次确认操作
- 稽查任务: 双模式入口、实时进度显示
- 抄表稽查: 用户档案核对、稽查结论填写、过程存证
- 问题上报: 问题类型选择、处理时效设置、溯源证据上传

模块6: 个人信息与系统设置模块

功能描述: 管理个人信息和系统设置，提供系统维护功能。
核心功能:
- 个人信息管理: 姓名修改、手机号设置、信息查看
- 账户安全配置: 密码修改、退出登录
- 系统维护选项: 日志上传、缓存清理、数据备份、版本信息

关键技术特性

离线作业能力

离线操作: 已下载任务支持无网络环境操作
数据缓存: 本地缓存用户档案、抄表记录、工单信息
自动同步: 网络恢复后自动同步本地数据到服务器

数据安全保障

数据校验: 必填字段验证、格式校验、数值合理性检查
状态一致性: 任务状态管理、工单状态流转控制
防误操作: 二次确认机制、数据完整性保护

用户体验优化

界面友好: 清晰的界面布局、直观的操作流程
智能搜索: 实时搜索、关键词高亮、历史记录
便捷导航: 户间切换、快速定位、批量操作

非功能性需求的设计

性能的考虑

设计目标：

系统响应时间：≤3秒（95%的请求）
并发用户数：≥200个在线用户
数据库查询：≤1秒（单表查询）
批量处理：≥1000条/分钟

设计措施：

数据库优化
- 采用达梦数据库主从架构，读写分离
- 对核心业务表建立合适索引
- 大表分区存储，历史数据归档
- 连接池配置优化
缓存策略
- Redis缓存热点数据
- 应用级缓存配置信息
- CDN加速静态资源
- 浏览器缓存优化
应用优化
- 异步处理非核心业务
- 批量操作优化
- SQL语句优化
- 业务逻辑优化

兼容性的考虑

浏览器兼容性：

Chrome 80+（推荐）
Firefox 75+
Safari 13+
Edge 80+

数据库兼容性：

主要支持：达梦数据库 8.0+
备选方案：PostgreSQL 12+
预留接口：MySQL 8.0+

操作系统兼容性：

服务器：Linux CentOS 7.6+/Ubuntu 18.04+
客户端：Windows 10+/macOS 10.15+

安全的考虑

身份认证：

基于OAuth2.0协议的单点登录
基于JWT的无状态认证
支持多因子认证（MFA）
OAuth2第三方登录集成
密码复杂度策略

权限控制：

RBAC角色权限模型
细粒度功能权限控制
数据权限隔离
多租户数据隔离

数据安全：

敏感数据加密存储
数据传输HTTPS加密
数据库连接加密
定期数据备份

系统安全：

SQL注入防护
XSS攻击防护
CSRF攻击防护
接口访问频率限制

可移植性的考虑

平台无关性：

基于Java 11+，支持跨平台部署
容器化部署，支持Docker/Kubernetes
数据库抽象层，支持多种数据库
配置外部化，环境隔离

云平台适配：

支持阿里云、腾讯云、华为云部署
适配云原生架构
支持弹性扩缩容
云存储服务集成

集成与测试的考虑

集成策略：

采用自底向上的集成方式
先完成基础服务开发测试
再进行业务服务集成
最后进行端到端集成测试

测试策略：

单元测试：代码覆盖率≥80%
集成测试：覆盖主要业务流程
性能测试：验证性能指标
安全测试：安全漏洞扫描

可扩展性的考虑

架构扩展：

微服务架构支持水平扩展
数据库分库分表支持
缓存集群扩展
负载均衡扩展

功能扩展：

插件化架构设计
开放API接口
工作流引擎支持
配置化业务规则

可靠性的考虑

高可用设计：

应用服务集群部署
数据库主从备份
负载均衡器冗余
自动故障切换

容错机制：

服务降级策略
熔断器模式
重试机制
异常处理策略

数据备份：

数据库实时备份
定期全量备份
增量备份策略
异地备份存储

可维护性的考虑

代码质量：

统一编码规范
代码审查制度
自动化测试
持续集成/持续部署

运维友好：

完善的部署文档
运维监控dashboard
日志集中管理
性能监控告警

文档管理：

API文档自动生成
系统架构文档
运维操作手册
故障处理手册

62 KiB Raw Blame History Unescape Escape

福建水务数智营收管理系统概要设计说明书

版本历史

目录

前言

编写目的

背景与任务

术语与缩略语

参考资料

系统总体设计

任务概述

系统总体目标

功能范围

系统涉众与用户特点

设计概述

总体约束

系统外部接口

设计方案概述

系统架构设计

系统的逻辑架构设计

整体架构图

层级说明

系统数据流向图

系统的物理架构设计

物理部署图

网络连接

硬件配置规格

达梦数据库分布式架构

容器化部署架构

子系统定义

子系统列表

子系统间关系

子系统调用关系图

主要接口定义

子系统1设计: 统一平台

功能与界面

模块列表

模块间关系

权限管理功能群

系统监控功能群

模块设计

模块1: 单点登录

模块2: 系统管理

中间件和其他设计

缓存

消息队列

定时任务

对外接口

子系统2设计: 营收系统

功能与界面

模块列表

模块间关系

营收核心业务群

客户服务业务群

模块设计

模块1: 客户资料管理

模块2: 抄表开账

模块3: 营业收费

模块4: 账务处理

模块5: 发票管理

模块6: 催缴管理

模块7: 统计分析

模块8: 代收业务

模块9: 业务工单

中间件和其他设计

对外接口

子系统3设计: 表务系统

功能与界面

模块列表

模块设计

模块1: 表务基础管理

模块2: 仓库与库存管理

模块3: 设备档案管理

子系统4设计: 报装系统

功能与界面

模块设计

模块1: 报装流程管理

模块2: 工程管理

模块3: 档案管理

子系统5设计: 客户服务

62 KiB

Raw Blame History