更新水务业务系统架构文档,优化了各层级的可视化布局,增强了用户层、接入层、应用层、中间层、数据层及外部接口层的描述,增加了技术栈和部署架构信息,提升了文档的可读性和实用性。

This commit is contained in:
tangweijie 2025-05-09 15:09:14 +08:00
parent dd2558f95c
commit 7e364939ae

View File

@ -20,142 +20,163 @@
- 统一对外接口:提供标准的接口和能力
```mermaid
graph TD
%% 用户访问层
User1[Web端用户] --- Access
User2[移动端用户] --- Access
User3[营业厅操作人员] --- Access
%%{init: {'theme': 'neutral', 'flowchart': {'useMaxWidth': false, 'htmlLabels': true, 'curve': 'basis'}}}%%
flowchart TD
%% 定义样式 - 更紧凑的样式设计
classDef accessLayer fill:#e6f9ff,stroke:#0099cc,stroke-width:1px,color:#333,font-size:12px
classDef applicationLayer fill:#e6ffec,stroke:#00cc66,stroke-width:1px,color:#333,font-size:12px
classDef middleLayer fill:#fff2e6,stroke:#ff9933,stroke-width:1px,color:#333,font-size:12px
classDef dataLayer fill:#f9e6ff,stroke:#9933ff,stroke-width:1px,color:#333,font-size:12px
classDef externalLayer fill:#ffe6e6,stroke:#ff3366,stroke-width:1px,color:#333,font-size:12px
classDef securityLayer fill:#ffe6e6,stroke:#cc0000,stroke-width:2px,color:#cc0000,font-size:12px
classDef userLayer fill:#f2f2f2,stroke:#666666,stroke-width:1px,color:#333,font-size:12px
classDef tenantLayer fill:#e6f7ff,stroke:#3399ff,stroke-width:1px,color:#333,font-size:12px
classDef moduleStyle fill:#ffffff,stroke:#999999,stroke-width:1px,color:#333,rx:3,ry:3,font-size:11px
classDef labelStyle color:#666,font-size:10px
subgraph Access[接入层]
LoadBalancer[负载均衡]
Firewall[防火墙]
SSO[单点登录]
%% 用户层 - 缩小高度
subgraph Users["<b>👥 用户层</b>"]
User1["<div style='text-align:center'>🖥️<br><small>Web端用户</small></div>"]
User2["<div style='text-align:center'>📱<br><small>移动端用户</small></div>"]
User3["<div style='text-align:center'>🏢<br><small>营业厅操作人员</small></div>"]
end
Access --- AppLayer
%% 接入层 - 缩小高度
subgraph Access["<b>🔐 接入层</b>"]
LoadBalancer["<div style='text-align:center'>⚖️<br><small>负载均衡</small></div>"]
Firewall["<div style='text-align:center'>🛡️<br><small>防火墙</small></div>"]
SSO["<div style='text-align:center'>🔑<br><small>单点登录</small></div>"]
end
%% 应用层
subgraph AppLayer[应用层]
subgraph Platform[统一平台]
SysManage[系统管理]
WorkflowAlert[流程节点提醒]
%% 应用层 - 分组优化布局
subgraph AppLayer["<b>📊 应用层</b>"]
%% 平台基础
subgraph CorePlatform["<b>🧩 平台基础</b>"]
Platform["<div style='text-align:center'><b>统一平台</b><br><small>⚙️系统管理<br>📬流程提醒</small></div>"]
APIService["<div style='text-align:center'><b>接口服务</b><br><small>🛒API市场<br>🔒权限管理</small></div>"]
end
subgraph Revenue[营收系统]
Meter[抄表开账]
Charge[收费管理]
Account[账务处理]
Invoice[发票管理]
Collection[代收业务]
EnvSanitation[环卫系统]
BusinessOrders[业务工单]
%% 业务核心
subgraph CoreBusiness["<b>💼 业务核心</b>"]
Revenue["<div style='text-align:center'><b>营收系统</b><br><small>📝抄表开账<br>💳收费管理<br>📒账务处理<br>🧾发票管理</small></div>"]
MeterMgmt["<div style='text-align:center'><b>表务系统</b><br><small>🛠️表务工单<br>🏪表务仓库<br>📶物联网对接</small></div>"]
end
subgraph CustService[客户服务]
WeChatPay[微信/支付宝服务]
BillQuery[账单查询]
EInvoice[电子发票]
WebPortal[微网厅]
AIService[智能客服]
%% 客户服务
subgraph CustomerService["<b>👨‍💼 客户服务</b>"]
CustService["<div style='text-align:center'><b>客户服务</b><br><small>📲微信支付宝<br>🔍账单查询<br>🌐微网厅<br>🤖智能客服</small></div>"]
MeterApp["<div style='text-align:center'><b>抄表APP</b><br><small>🏠首页功能<br>📊抄表功能<br>📋工单管理</small></div>"]
end
subgraph MeterMgmt[表务系统]
MeterWork[表务工单]
MeterStore[表务仓库]
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[系统对外接口]
%% 业务管理
subgraph BusinessMgmt["<b>🏗️ 业务管理</b>"]
Installation["<div style='text-align:center'><b>报装管理</b><br><small>📝报装流程<br>🏠一户一表</small></div>"]
ProjectMgmt["<div style='text-align:center'><b>工程管理</b><br><small>📝工程申请<br>🚧工程施工<br>✅工程验收</small></div>"]
StatAnalysis["<div style='text-align:center'><b>统计分析</b><br><small>📈报表查询<br>💸欠费查询<br>💧用水分析</small></div>"]
end
end
AppLayer --- MiddleLayer
%% 中间层
subgraph MiddleLayer[中间层]
ESB[企业服务总线]
ReportPlatform[统一报表平台]
Cache[缓存服务]
Workflow[工作流引擎]
MessageQueue[消息队列]
%% 中间层 - 更紧凑的布局
subgraph MiddleLayer["<b>⚙️ 中间层</b>"]
ESB["<div style='text-align:center'>🔄<br><small>企业服务总线</small></div>"]
ReportPlatform["<div style='text-align:center'>📊<br><small>统一报表</small></div>"]
Cache["<div style='text-align:center'><br><small>缓存服务</small></div>"]
Workflow["<div style='text-align:center'>📑<br><small>工作流引擎</small></div>"]
MessageQueue["<div style='text-align:center'>📨<br><small>消息队列</small></div>"]
end
MiddleLayer --- DataLayer
%% 数据层
subgraph DataLayer[数据层]
DBCluster[数据库集群]
FileServer[文件服务器]
Backup[数据备份恢复]
DataIntegration[数据集成]
%% 数据层 - 更紧凑的布局
subgraph DataLayer["<b>💾 数据层</b>"]
DBCluster["<div style='text-align:center'>🗄️<br><small>数据库集群</small></div>"]
FileServer["<div style='text-align:center'>📂<br><small>文件服务器</small></div>"]
Backup["<div style='text-align:center'>🔄<br><small>数据备份</small></div>"]
DataIntegration["<div style='text-align:center'>🔄<br><small>数据集成</small></div>"]
end
%% 外部接口层
subgraph ExternalAPI[外部接口层]
BankAPI[银行接口]
PayAPI[支付接口]
SMSAPI[短信接口]
IoTAPI[物联网接口]
GovernmentAPI[政务系统接口]
HydrantAPI[消火栓系统接口]
EnvAPI[环卫系统接口]
OAAPI[OA系统接口]
%% 外部接口层 - 分组
subgraph ExternalAPI["<b>🌐 外部接口层</b>"]
%% 支付相关
subgraph PaymentAPI["<b>💳 支付相关</b>"]
BankAPI["<div style='text-align:center'>🏦<br><small>银行接口</small></div>"]
PayAPI["<div style='text-align:center'>💳<br><small>支付接口</small></div>"]
end
%% 通信相关
subgraph CommAPI["<b>📡 通信相关</b>"]
SMSAPI["<div style='text-align:center'>📱<br><small>短信接口</small></div>"]
IoTAPI["<div style='text-align:center'>📶<br><small>物联网接口</small></div>"]
end
%% 系统对接
subgraph SystemAPI["<b>🔌 系统对接</b>"]
GovernmentAPI["<div style='text-align:center'>🏛️<br><small>政务接口</small></div>"]
HydrantAPI["<div style='text-align:center'>🚿<br><small>消火栓</small></div>"]
EnvAPI["<div style='text-align:center'>♻️<br><small>环卫系统</small></div>"]
OAAPI["<div style='text-align:center'>📝<br><small>OA系统</small></div>"]
end
end
MiddleLayer --- ExternalAPI
%% 安全层
SecurityLayer[安全层\n网络安全 • 数据安全 • 应用安全] --- AppLayer
SecurityLayer --- MiddleLayer
SecurityLayer --- DataLayer
%% 多租户
subgraph Tenants[多租户架构]
Group[集团]
Branch[分公司]
Station[营业站点]
%% 安全层 - 垂直布局
subgraph SecurityLayer["<b>🔐 安全层</b>"]
NetSecurity["<div style='text-align:center'>🛡️<br><small>网络安全</small></div>"]
DataSecurity["<div style='text-align:center'>🔒<br><small>数据安全</small></div>"]
AppSecurity["<div style='text-align:center'>🛡️<br><small>应用安全</small></div>"]
end
%% 多租户 - 紧凑布局
subgraph Tenants["<b>🏢 多租户架构</b>"]
Group["<div style='text-align:center'>🏢<br><small>集团</small></div>"]
Branch["<div style='text-align:center'>🏪<br><small>分公司</small></div>"]
Station["<div style='text-align:center'>🏪<br><small>营业站点</small></div>"]
end
%% 技术栈信息 - 增加信息量
subgraph TechStack["<b>🔧 技术栈</b>"]
Backend["<div style='text-align:center'><b>后端技术</b><br><small>✓ Spring Boot 3.x<br>✓ MyBatis Plus<br>✓ Redis<br>✓ Flowable</small></div>"]
Frontend["<div style='text-align:center'><b>前端技术</b><br><small>✓ Vue 3.x<br>✓ Element Plus<br>✓ Pinia<br>✓ ECharts</small></div>"]
Mobile["<div style='text-align:center'><b>移动技术</b><br><small>✓ uni-app<br>✓ uview-ui<br>✓ 微信/支付宝<br>✓ 高德地图SDK</small></div>"]
end
%% 部署架构信息 - 增加信息量
subgraph Deployment["<b>🖥️ 部署架构</b>"]
ProdEnv["<div style='text-align:center'><b>生产环境</b><br><small>✓ 高可用集群<br>✓ 主从数据库<br>✓ Redis集群</small></div>"]
Container["<div style='text-align:center'><b>容器技术</b><br><small>✓ Docker<br>✓ Kubernetes<br>✓ 自动扩缩容</small></div>"]
end
%% 连接关系 - 使用更紧凑的箭头
Users --> Access
Access --> AppLayer
AppLayer --> MiddleLayer
MiddleLayer --> DataLayer
MiddleLayer <--> ExternalAPI
%% 技术栈与部署架构连接
AppLayer -.-> TechStack
DataLayer -.-> Deployment
%% 安全层垂直贯穿
SecurityLayer -.- Users
SecurityLayer -.- Access
SecurityLayer -.- AppLayer
SecurityLayer -.- MiddleLayer
SecurityLayer -.- DataLayer
SecurityLayer -.- ExternalAPI
%% 多租户关系
Tenants -.- AppLayer
classDef layer fill:#f9f9f9,stroke:#333,stroke-width:2px
class Access,AppLayer,MiddleLayer,DataLayer,ExternalAPI,Tenants layer
classDef security fill:#ffe6e6,stroke:#f66,stroke-width:2px
class SecurityLayer security
classDef platform fill:#e6f7ff,stroke:#1890ff,stroke-width:1px
class Platform,Revenue,CustService,MeterMgmt,Installation,StatAnalysis,ProjectMgmt,MeterApp,APIService platform
%% 应用样式
class Users userLayer
class Access accessLayer
class AppLayer,CorePlatform,CoreBusiness,CustomerService,BusinessMgmt applicationLayer
class Platform,Revenue,CustService,MeterMgmt,Installation,StatAnalysis,ProjectMgmt,MeterApp,APIService moduleStyle
class MiddleLayer middleLayer
class DataLayer dataLayer
class ExternalAPI,PaymentAPI,CommAPI,SystemAPI externalLayer
class SecurityLayer securityLayer
class Tenants tenantLayer
class TechStack,Backend,Frontend,Mobile applicationLayer
class Deployment,ProdEnv,Container dataLayer
```
## 2. 技术架构