系统架构设计 - 电子签章分层架构文档

架构特色

前后端分离

Vue3 + Spring Boot

微服务化

模块解耦、独立部署

安全可靠

Shiro + JWT认证

易扩展

高内聚低耦合

分层架构

五层架构，职责清晰，易于维护

前端应用层

Vue 3 Vite TypeScript Ant Design Pinia

API网关层

Nginx 负载均衡请求路由

后端服务层

Spring Boot 认证授权用户管理合同管理签署服务印章管理

存储层

MySQL Redis 文件存储证书存储

第三方服务

CA证书实名认证短信服务邮件服务

后端模块架构

kaifangqian-core

核心模块 - 基础支撑

• Shiro安全配置
• 统一异常处理
• 通用工具类
• JWT认证

kaifangqian-system

系统模块 - 核心业务

• opensign核心
• 证书管理
• 表单处理
• 存储管理

kaifangqian-tools

工具模块 - 功能增强

• PDF处理工具
• 存储工具
• 证书处理
• 第三方集成

数据流设计

用户认证流程

sequenceDiagram participant C as 客户端 participant S as 认证服务 participant D as 数据库 C->>S: 登录请求 S->>D: 查询用户 D-->>S: 用户信息 S->>S: 验证密码 S-->>C: 返回Token

合同签署流程

sequenceDiagram participant C as 客户端 participant B as 业务服务 participant F as 文件服务 participant D as 数据库 C->>B: 签署请求 B->>D: 查询合同 D-->>B: 合同信息 B->>F: 获取文件 F-->>B: PDF文件 B->>B: PDF签名 B->>F: 存储签名文件 B-->>C: 签署完成

核心特性

安全架构

JWT认证 - 无状态Token机制
RBAC权限 - 基于角色的访问控制
数据加密 - 敏感信息加密存储
审计日志 - 完整操作记录

性能优化

Redis缓存 - 提高数据访问速度
连接池优化 - 数据库连接池配置
异步处理 - 耗时操作异步化
前端优化 - 代码分割、懒加载

API设计

RESTful规范 - 标准API设计
统一响应 - 标准JSON格式
版本控制 - URL路径版本化
错误处理 - 统一错误码机制

技术栈

Spring Boot - 应用框架
MyBatis Plus - ORM框架
Apache PDFBox - PDF处理
Vue 3 + Vite - 前端框架