4.6 KiB

Raw Blame History Unescape Escape

This file contains ambiguous Unicode characters that may be confused with others in your current locale. If your use case is intentional and legitimate, you can safely ignore this warning. Use the Escape button to highlight these characters.

RuoYi-Vue 架构文档

项目版本: 3.8.0 | 分析日期: 2026-06-28
前端: Vue 2.6.12 + Element UI 2.15.6 | 后端: Spring Boot 2.5.8 + JDK 1.8

文档清单

架构概览
- 系统总体架构（前后端分层图、模块依赖图）
- 技术栈总结（前端 15 项、后端 14 项、数据库）
- 模块划分（8 个 Maven 模块职责与依赖关系）
- 关键设计模式（MVC、AOP 切面、单例、工厂、策略、模板方法等）
前端架构分析
- 组件结构（22 个组件组、~40 个视图页面、复用程度分析）
- 路由权限（静态路由 + 动态路由 + 服务端路由，三层权限控制）
- 状态管理（Vuex 5 个模块、数据流向、状态持久化）
- API 调用层（Axios 封装、拦截器、错误处理、错误码映射）
- 问题清单（8 个问题 + 8 条优化建议）
后端架构分析
- 分层架构（Controller → Service → Mapper → Domain，四层架构详解）
- 安全配置（Spring Security 认证流程、JWT Token 机制、权限控制体系）
- AOP 切面（LogAspect、DataScopeAspect、DataSourceAspect、RateLimiterAspect）
- 模块依赖（Maven 多模块依赖图、模块职责、技术栈汇总）
- 问题清单（8 个问题及优化建议）
前后端交互规范
- API 接口清单（35 个前端模块、19 个 Controller、约 182 个端点）
- 请求/响应格式（AjaxResult、TableDataInfo、统一响应结构）
- 错误处理（前端响应拦截器、后端全局异常处理、错误码体系）
- 分页排序（PageHelper 实现、排序参数、过滤规范、SQL 注入防护）
- 问题清单（10 个问题 + 短/中/长期优化建议）
数据库结构分析
- 表结构清单（~49 张表：系统管理 21、Quartz 9、股票业务 11、账户记账 6）
- 表关系（ER 关系图、外键约束分析、多对多关系表）
- 索引分析（主键索引、唯一索引、索引覆盖度评估）
- 查询模式（常用查询、复杂关联查询、统计查询、性能瓶颈识别）
- 问题清单（10 个问题 + P0/P1/P2 三级优化建议含 SQL 脚本）
优化建议清单
- 15+ 条优化建议（来自上述文档的汇总提炼）
- 优先级排序（P0 紧急 / P1 重要 / P2 一般）
- 实施步骤（短期 1-2 周 / 中期 1-2 月 / 长期持续）

后续重构计划

基于本架构分析，后续将执行以下重构任务：

1. refactor-frontend-modernization — 前端重构

升级至 Vue 3 + Vite + Pinia
参考 demo-dashboard-heatmap.html 风格进行 UI 现代化
引入数据可视化组件（ECharts 升级）
统一权限校验核心模块，消除重复代码
引入统一状态持久化层
将业务组件从通用组件目录分离
抽取 CRUD Schema 驱动高阶组件

2. refactor-backend-api — 后端 API 规范化

统一 RESTful API 设计规范
优化错误处理（HTTP 状态码与业务状态码对齐）
添加 Swagger/OpenAPI 接口文档
替换 fastjson 为 fastjson2 或 Jackson
引入统一 DTO/VO 分层
补全 @Log 操作日志注解
清理调试代码（System.out.println → logger）

3. refactor-database-optimization — 数据库优化

修正主键类型（double → bigint）
为 trade_dates 等表添加主键
为核心查询字段添加索引（code、trade_day、user_id 等）
优化 find_in_set 查询（闭包表或整数数组方案）
修复 statistics 表字段拼写错误
时间查询优化（date_format → 范围查询）
为业务表添加审计字段与软删除机制

4. refactor-coding-standards — 编码规范

制定项目编码规范文档
集成 Checkstyle / SpotBugs 自动检查
集成 ESLint + Prettier 前端代码规范
统一命名规范（包名、类名、方法名、变量名）
规范注释与 Javadoc 编写
建立 Git Commit 信息规范（Conventional Commits）

文档导航

docs/architecture/
├── README.md                  ← 当前文件：文档索引与重构计划
├── architecture-overview.md   ← 系统总体架构概览
├── frontend-architecture.md   ← 前端架构详细分析
├── backend-architecture.md    ← 后端架构详细分析
├── api-interaction-spec.md    ← 前后端交互规范
├── database-structure.md      ← 数据库结构分析
└── optimization-suggestions.md ← 优化建议汇总清单

最后更新: 2026-06-28

4.6 KiB Raw Blame History Unescape Escape