From df5b63f998894a2af39c4896cb0a2fd95c532fbf Mon Sep 17 00:00:00 2001 From: tangweijie <877588133@qq.com> Date: Mon, 11 Aug 2025 15:19:08 +0800 Subject: [PATCH] =?UTF-8?q?=E9=87=8D=E6=9E=84=E7=B3=BB=E7=BB=9F=E6=80=BB?= =?UTF-8?q?=E4=BD=93=E8=AE=BE=E8=AE=A1=E7=AB=A0=E8=8A=82=EF=BC=8C=E4=BC=98?= =?UTF-8?q?=E5=8C=96=E6=9E=B6=E6=9E=84=E6=96=87=E6=A1=A3=E7=BB=93=E6=9E=84?= =?UTF-8?q?=EF=BC=8C=E6=96=B0=E5=A2=9E=E4=BB=BB=E5=8A=A1=E6=A6=82=E8=BF=B0?= =?UTF-8?q?=E5=92=8C=E8=AE=BE=E8=AE=A1=E6=A6=82=E8=BF=B0=E7=AB=A0=E8=8A=82?= =?UTF-8?q?=EF=BC=8C=E7=BB=86=E5=8C=96=E9=80=BB=E8=BE=91=E6=9E=B6=E6=9E=84?= =?UTF-8?q?=E5=92=8C=E7=89=A9=E7=90=86=E6=9E=B6=E6=9E=84=E8=AE=BE=E8=AE=A1?= =?UTF-8?q?=E5=86=85=E5=AE=B9=EF=BC=8C=E5=AE=8C=E5=96=84=E5=AD=90=E7=B3=BB?= =?UTF-8?q?=E7=BB=9F=E5=AE=9A=E4=B9=89=E5=92=8C=E5=85=B3=E7=B3=BB=E6=8F=8F?= =?UTF-8?q?=E8=BF=B0=EF=BC=8C=E6=8F=90=E5=8D=87=E6=96=87=E6=A1=A3=E5=AE=8C?= =?UTF-8?q?=E6=95=B4=E6=80=A7=E5=92=8C=E5=8F=AF=E8=AF=BB=E6=80=A7=EF=BC=8C?= =?UTF-8?q?=E7=AC=A6=E5=90=88=E7=94=B2=E6=96=B9A=E7=BA=A7=E4=BA=A4?= =?UTF-8?q?=E4=BB=98=E6=A0=87=E5=87=86=E3=80=82?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- 新-概要设计说明书.md | 184 +++++++++++++++++++++++++++++++++---------- 1 file changed, 144 insertions(+), 40 deletions(-) diff --git a/新-概要设计说明书.md b/新-概要设计说明书.md index 5c000ca..35371c2 100644 --- a/新-概要设计说明书.md +++ b/新-概要设计说明书.md @@ -30,21 +30,30 @@ - [术语与缩略语](#术语与缩略语) - [参考资料](#参考资料) - [系统总体设计](#系统总体设计) - - [逻辑架构](#逻辑架构) - - [整体架构图](#整体架构图) - - [层级说明](#层级说明) + - [任务概述](#任务概述) + - [系统总体目标](#系统总体目标) + - [功能范围](#功能范围) + - [系统涉众与用户特点](#系统涉众与用户特点) + - [设计概述](#设计概述) + - [总体约束](#总体约束) + - [系统外部接口](#系统外部接口) + - [设计方案概述](#设计方案概述) + - [系统架构设计](#系统架构设计) + - [系统的逻辑架构设计](#系统的逻辑架构设计) + - [整体架构图](#整体架构图) + - [层级说明](#层级说明) - [系统数据流向图](#系统数据流向图) - - [物理架构](#物理架构) - - [物理部署图](#物理部署图) - - [网络连接](#网络连接) - - [硬件配置规格](#硬件配置规格) - - [达梦数据库分布式架构](#达梦数据库分布式架构) - - [容器化部署架构](#容器化部署架构) - - [对外接口](#对外接口) - - [子系统列表](#子系统列表) - - [子系统相互关系与接口](#子系统相互关系与接口) - - [子系统调用关系图](#子系统调用关系图) - - [主要接口定义](#主要接口定义) + - [系统的物理架构设计](#系统的物理架构设计) + - [物理部署图](#物理部署图) + - [网络连接](#网络连接) + - [硬件配置规格](#硬件配置规格) + - [达梦数据库分布式架构](#达梦数据库分布式架构) + - [容器化部署架构](#容器化部署架构) + - [子系统定义](#子系统定义) + - [子系统列表](#子系统列表) + - [子系统间关系](#子系统间关系) + - [子系统调用关系图](#子系统调用关系图) + - [主要接口定义](#主要接口定义) - [子系统1设计: 统一平台](#子系统1设计-统一平台) - [功能与界面](#功能与界面) - [模块列表](#模块列表) @@ -58,7 +67,7 @@ - [缓存](#缓存) - [消息队列](#消息队列) - [定时任务](#定时任务) - - [对外接口](#对外接口-1) + - [对外接口](#对外接口) - [子系统2设计: 营收系统](#子系统2设计-营收系统) - [功能与界面](#功能与界面-1) - [模块列表](#模块列表-1) @@ -76,7 +85,7 @@ - [模块8: 代收业务](#模块8-代收业务) - [模块9: 业务工单](#模块9-业务工单) - [中间件和其他设计](#中间件和其他设计-1) - - [对外接口](#对外接口-2) + - [对外接口](#对外接口-1) - [子系统3设计: 表务系统](#子系统3设计-表务系统) - [功能与界面](#功能与界面-2) - [模块列表](#模块列表-2) @@ -202,11 +211,116 @@ # 系统总体设计 -## 逻辑架构 +## 任务概述 + +### 系统总体目标 + +福建水务数智营收管理系统主要包含统一平台、营收系统、表务系统、报装系统、客户服务和手机抄表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 + +**部署方案**： + +采用容器化部署架构，支持多环境部署（开发、测试、生产），提供自动化部署脚本，支持弹性扩缩容。 + +## 系统架构设计 + +### 系统的逻辑架构设计 系统采用现代化的多层分布式架构，基于微服务设计思想，实现松耦合、高内聚的系统架构。 -### 整体架构图 +#### 整体架构图 ```mermaid graph TB @@ -272,7 +386,7 @@ graph TB D5 --> E1 ``` -### 层级说明 +#### 层级说明 **表现层（Presentation Layer）** - 负责用户交互和界面展示 @@ -384,11 +498,11 @@ flowchart TD E1 -.->|数据服务
接口调用| F5 ``` -## 物理架构 +### 系统的物理架构设计 系统采用分布式部署架构，通过多个服务器集群实现高可用和高性能。 -### 物理部署图 +#### 物理部署图 ```mermaid graph TB @@ -446,7 +560,7 @@ graph TB ``` -### 网络连接 +#### 网络连接 ```mermaid graph TB @@ -457,7 +571,7 @@ graph TB MGMT -.->|监控管理| DATA ``` -### 硬件配置规格 +#### 硬件配置规格 **DMZ区域配置** @@ -491,7 +605,7 @@ graph TB | 跳板服务器 | 4核8G，500GB SSD | 1台 | 运维管理 | | 日志服务器 | 16核32G，5TB SSD | 1台 | 日志收集分析 | -### 达梦数据库分布式架构 +#### 达梦数据库分布式架构 系统采用达梦数据库分布式架构，支持高性能、高可用、高扩展性的数据存储服务。 @@ -531,7 +645,7 @@ graph TB CN2 -.->|事务管理
全局一致性| GTM ``` -### 容器化部署架构 +#### 容器化部署架构 系统采用Docker容器化部署，使用Docker Compose进行服务编排，支持快速部署和弹性扩缩容。 @@ -567,19 +681,9 @@ graph TB APP_CONTAINER -.->|日志数据| LOG_CONTAINER ``` -## 对外接口 +## 子系统定义 -| 接口编号 | 接口名称（标识） | 功能描述 | 接口协议 | 输入参数 | 输出结果 | -|---|---|---|---|---|---| -| EXT-001 | 银行代扣接口 | 银行托收代扣缴费 | HTTPS | 用户信息、缴费金额、银行账户 | 扣款结果、交易流水号 | -| EXT-002 | 微信支付接口 | 微信在线支付 | HTTPS | 订单信息、金额、用户OpenID | 支付结果、微信交易号 | -| EXT-003 | 支付宝支付接口 | 支付宝在线支付 | HTTPS | 订单信息、金额、支付宝用户ID | 支付结果、支付宝交易号 | -| EXT-004 | 短信平台接口 | 短信通知发送 | HTTPS | 手机号、短信内容、模板ID | 发送结果、消息ID | -| EXT-005 | 集抄系统接口 | 智能水表数据采集 | TCP/HTTPS | 水表编号、采集时间 | 抄表数据、设备状态 | -| EXT-006 | 电子发票接口 | 第三方发票开具 | HTTPS | 开票信息、税务信息 | 发票文件、发票号码 | -| EXT-007 | 身份认证接口 | 第三方身份验证 | HTTPS | 身份证号、姓名 | 验证结果、认证状态 | - -## 子系统列表 +### 子系统列表 | 子系统编号 | 子系统名称（标识） | 功能描述 | 开发方式 | |---|---|---|---| @@ -590,9 +694,9 @@ graph TB | SYS-005 | 客户服务 | 微信小程序、支付宝小程序、客户自助服务 | 自行开发 | | SYS-006 | 手机抄表APP | 移动端抄表、工单处理、数据同步 | 自行开发 | -## 子系统相互关系与接口 +### 子系统间关系 -### 子系统调用关系图 +#### 子系统调用关系图 ```mermaid graph TB @@ -642,7 +746,7 @@ graph TB APP -.->|工单回填| METER ``` -### 主要接口定义 +#### 主要接口定义 **统一平台对外接口**