491 lines
17 KiB
Markdown
491 lines
17 KiB
Markdown
# 项目结构分析报告
|
||
|
||
## 📋 项目概述
|
||
|
||
**项目名称**：AI心理健康测评系统 (ry-xinli)
|
||
**项目类型**：心理健康测评管理系统
|
||
**技术架构**：前后端分离 + 移动端
|
||
**开发框架**：基于 RuoYi-Vue 框架改造
|
||
**版本**：1.0.0
|
||
**开发者**：wanxiubin
|
||
|
||
---
|
||
|
||
## 🏗️ 整体架构
|
||
|
||
### 架构分层
|
||
|
||
```
|
||
┌─────────────────────────────────────────────────────────────┐
|
||
│ 用户层 │
|
||
│ 桌面浏览器 │ 移动浏览器 │ 微信小程序 │ 第三方系统API │
|
||
└─────────────────────────────────────────────────────────────┘
|
||
↕
|
||
┌─────────────────────────────────────────────────────────────┐
|
||
│ 前端应用层 │
|
||
│ Vue 2.6 + Element UI + Vuex + Router │
|
||
└─────────────────────────────────────────────────────────────┘
|
||
↕ (HTTP/RESTful API)
|
||
┌─────────────────────────────────────────────────────────────┐
|
||
│ 应用服务层 │
|
||
│ Spring Boot 2.5 + Spring Security │
|
||
│ Controller层 → Service层 → Mapper层 (MyBatis) │
|
||
└─────────────────────────────────────────────────────────────┘
|
||
↕
|
||
┌─────────────────────────────────────────────────────────────┐
|
||
│ 数据存储层 │
|
||
│ ┌──────────────┬──────────────┬──────────────┐ │
|
||
│ │ MySQL │ Redis │ 文件存储 │ │
|
||
│ │ (数据持久) │ (缓存/会话) │ (报告/音频) │ │
|
||
│ └──────────────┴──────────────┴──────────────┘ │
|
||
└─────────────────────────────────────────────────────────────┘
|
||
```
|
||
|
||
---
|
||
|
||
## 📦 后端模块结构
|
||
|
||
### Maven 多模块架构
|
||
|
||
```
|
||
ry-xinli (根模块)
|
||
├── ry-xinli-admin # 启动模块（Web入口）
|
||
├── ry-xinli-system # 系统模块（业务逻辑）
|
||
├── ry-xinli-framework # 框架模块（安全配置）
|
||
├── ry-xinli-common # 公共模块（工具类）
|
||
├── ry-xinli-generator # 代码生成器
|
||
└── ry-xinli-quartz # 定时任务
|
||
```
|
||
|
||
### 模块详细说明
|
||
|
||
#### 1. ry-xinli-admin（启动模块）
|
||
**路径**：`ry-xinli-admin/`
|
||
**职责**：Web 应用入口，包含 Controller 层和配置
|
||
|
||
**结构**：
|
||
```
|
||
ry-xinli-admin/
|
||
├── src/main/java/com/ddnai/
|
||
│ ├── XinliApplication.java # 启动类
|
||
│ └── web/controller/ # 控制器层
|
||
│ ├── psychology/ # 心理测评控制器（20个）
|
||
│ │ ├── PsyScaleController.java
|
||
│ │ ├── PsyAssessmentController.java
|
||
│ │ ├── PsyAssessmentReportController.java
|
||
│ │ ├── PsyFactorController.java
|
||
│ │ ├── PsyQrcodeController.java
|
||
│ │ ├── PsyQuestionnaireController.java
|
||
│ │ ├── PsyUserProfileController.java
|
||
│ │ ├── PsyWarningController.java
|
||
│ │ └── ...
|
||
│ ├── system/ # 系统管理控制器（15个）
|
||
│ │ ├── SysUserController.java
|
||
│ │ ├── SysRoleController.java
|
||
│ │ ├── SysMenuController.java
|
||
│ │ └── ...
|
||
│ ├── monitor/ # 监控控制器（5个）
|
||
│ ├── common/ # 通用控制器
|
||
│ └── api/ # 开放API
|
||
└── src/main/resources/
|
||
├── application.yml # 应用配置
|
||
└── mapper/ # MyBatis映射文件
|
||
```
|
||
|
||
**关键配置**：
|
||
- 服务端口：30081
|
||
- 文件上传路径：`D:\wwwroot\xinli_web\web\profile\uploadPath`
|
||
- Redis 缓存配置
|
||
- 数据库连接配置
|
||
|
||
#### 2. ry-xinli-system（系统模块）
|
||
**路径**：`ry-xinli-system/`
|
||
**职责**：核心业务逻辑，包含 Domain、Mapper、Service
|
||
|
||
**结构**：
|
||
```
|
||
ry-xinli-system/
|
||
├── src/main/java/com/ddnai/system/
|
||
│ ├── domain/ # 实体类
|
||
│ │ ├── psychology/ # 心理测评实体（20+个）
|
||
│ │ │ ├── PsyScale.java # 量表
|
||
│ │ │ ├── PsyScaleItem.java # 量表题目
|
||
│ │ │ ├── PsyScaleOption.java # 题目选项
|
||
│ │ │ ├── PsyAssessment.java # 测评记录
|
||
│ │ │ ├── PsyAssessmentAnswer.java # 测评答案
|
||
│ │ │ ├── PsyAssessmentReport.java # 测评报告
|
||
│ │ │ ├── PsyFactor.java # 因子
|
||
│ │ │ ├── PsyFactorRule.java # 因子规则
|
||
│ │ │ ├── PsyQrcode.java # 二维码
|
||
│ │ │ ├── PsyQuestionnaire.java # 自定义问卷
|
||
│ │ │ ├── PsyUserProfile.java # 用户档案
|
||
│ │ │ ├── PsyWarning.java # 危机预警
|
||
│ │ │ └── ...
|
||
│ │ └── vo/ # 视图对象
|
||
│ ├── mapper/ # 数据访问层
|
||
│ │ ├── psychology/ # 心理测评Mapper（20+个）
|
||
│ │ └── Sys*.java # 系统Mapper
|
||
│ └── service/ # 业务逻辑层
|
||
│ ├── psychology/ # 心理测评Service接口（25个）
|
||
│ └── impl/ # Service实现类
|
||
│ ├── psychology/ # 心理测评Service实现（24个）
|
||
│ └── Sys*.java # 系统Service实现
|
||
└── src/main/resources/mapper/ # MyBatis XML映射文件
|
||
├── psychology/ # 心理测评Mapper XML（39个）
|
||
└── system/ # 系统Mapper XML
|
||
```
|
||
|
||
#### 3. ry-xinli-framework（框架模块）
|
||
**路径**：`ry-xinli-framework/`
|
||
**职责**：框架配置、安全、通用组件
|
||
|
||
**主要功能**：
|
||
- Spring Security 安全配置
|
||
- 系统配置管理
|
||
- 通用 Web 组件
|
||
- 拦截器、过滤器
|
||
|
||
#### 4. ry-xinli-common（公共模块）
|
||
**路径**：`ry-xinli-common/`
|
||
**职责**：公共工具类、常量、核心类
|
||
|
||
**结构**：
|
||
```
|
||
ry-xinli-common/
|
||
├── src/main/java/com/ddnai/common/
|
||
│ ├── core/ # 核心类
|
||
│ ├── utils/ # 工具类
|
||
│ │ ├── file/ # 文件工具
|
||
│ │ ├── http/ # HTTP工具
|
||
│ │ ├── ip/ # IP工具
|
||
│ │ ├── poi/ # Excel工具
|
||
│ │ ├── sign/ # 签名工具
|
||
│ │ └── ...
|
||
│ ├── constants/ # 常量
|
||
│ └── config/ # 配置类
|
||
```
|
||
|
||
#### 5. ry-xinli-generator（代码生成器）
|
||
**路径**：`ry-xinli-generator/`
|
||
**职责**：代码自动生成工具
|
||
|
||
#### 6. ry-xinli-quartz（定时任务）
|
||
**路径**：`ry-xinli-quartz/`
|
||
**职责**：定时任务调度
|
||
|
||
---
|
||
|
||
## 🎨 前端模块结构
|
||
|
||
### Vue 前端项目
|
||
|
||
**路径**：`xinli-ui/`
|
||
**技术栈**：
|
||
- Vue 2.6.12
|
||
- Element UI 2.15.14
|
||
- Vuex 3.6.0
|
||
- Vue Router 3.4.9
|
||
- Axios 0.28.1
|
||
- ECharts 5.4.0
|
||
|
||
**结构**：
|
||
```
|
||
xinli-ui/
|
||
├── src/
|
||
│ ├── api/ # API接口定义（40个文件）
|
||
│ │ ├── psychology/ # 心理测评API（19个）
|
||
│ │ │ ├── scale.js # 量表API
|
||
│ │ │ ├── assessment.js # 测评API
|
||
│ │ │ ├── report.js # 报告API
|
||
│ │ │ ├── questionnaire.js # 问卷API
|
||
│ │ │ └── ...
|
||
│ │ ├── system/ # 系统API（10个）
|
||
│ │ └── monitor/ # 监控API（7个）
|
||
│ ├── views/ # 页面视图（76个Vue文件）
|
||
│ │ ├── psychology/ # 心理测评页面
|
||
│ │ │ ├── scale/ # 量表管理
|
||
│ │ │ ├── assessment/ # 测评执行
|
||
│ │ │ ├── report/ # 测评报告
|
||
│ │ │ ├── questionnaire/ # 自定义问卷
|
||
│ │ │ ├── qrcode/ # 二维码管理
|
||
│ │ │ ├── userProfile/ # 用户档案
|
||
│ │ │ ├── warning/ # 危机预警
|
||
│ │ │ └── website/ # 心理网站
|
||
│ │ └── system/ # 系统管理页面
|
||
│ ├── components/ # 组件（32个）
|
||
│ │ ├── Psychology/ # 心理测评组件
|
||
│ │ └── RuoYi/ # 若依通用组件
|
||
│ ├── store/ # Vuex状态管理（8个文件）
|
||
│ ├── router/ # 路由配置
|
||
│ ├── utils/ # 工具函数（24个文件）
|
||
│ ├── assets/ # 静态资源
|
||
│ │ ├── icons/ # 图标（89个SVG）
|
||
│ │ ├── images/ # 图片
|
||
│ │ └── styles/ # 样式文件
|
||
│ └── main.js # 入口文件
|
||
├── public/ # 公共资源
|
||
└── package.json # 依赖配置
|
||
```
|
||
|
||
---
|
||
|
||
## 📱 移动端项目
|
||
|
||
### Android 应用
|
||
|
||
**路径**：`xinli-App/`
|
||
**技术栈**：Android + Gradle
|
||
|
||
**结构**：
|
||
```
|
||
xinli-App/
|
||
├── app/
|
||
│ ├── src/main/
|
||
│ │ ├── java/ # Java代码
|
||
│ │ ├── res/ # 资源文件
|
||
│ │ └── AndroidManifest.xml # 清单文件
|
||
│ └── build.gradle # 构建配置
|
||
├── build.gradle # 项目构建配置
|
||
├── gradle/ # Gradle配置
|
||
└── README.md # 说明文档
|
||
```
|
||
|
||
---
|
||
|
||
## 🗄️ 数据库设计
|
||
|
||
### 核心表结构
|
||
|
||
#### 心理测评核心表（20+个）
|
||
|
||
1. **量表相关**
|
||
- `psy_scale` - 量表基本信息
|
||
- `psy_scale_item` - 量表题目
|
||
- `psy_scale_option` - 题目选项
|
||
- `psy_scale_permission` - 量表权限
|
||
|
||
2. **测评相关**
|
||
- `psy_assessment` - 测评记录
|
||
- `psy_assessment_answer` - 测评答案
|
||
- `psy_assessment_report` - 测评报告
|
||
|
||
3. **因子与计分**
|
||
- `psy_factor` - 因子定义
|
||
- `psy_factor_rule` - 因子计分规则
|
||
- `psy_factor_score` - 因子得分
|
||
- `psy_result_interpretation` - 结果解释
|
||
|
||
4. **扩展功能**
|
||
- `psy_questionnaire` - 自定义问卷
|
||
- `psy_questionnaire_item` - 问卷题目
|
||
- `psy_questionnaire_answer` - 问卷答案
|
||
- `psy_user_profile` - 用户档案
|
||
- `psy_qrcode` - 二维码管理
|
||
- `psy_warning` - 危机预警
|
||
- `psy_website_content` - 心理网站内容
|
||
|
||
#### 系统管理表
|
||
- `sys_user` - 用户表
|
||
- `sys_role` - 角色表
|
||
- `sys_menu` - 菜单表
|
||
- `sys_dept` - 部门表
|
||
- `sys_config` - 系统配置
|
||
- `sys_dict_*` - 字典表
|
||
|
||
---
|
||
|
||
## 🔧 技术栈详情
|
||
|
||
### 后端技术栈
|
||
|
||
| 技术 | 版本 | 用途 |
|
||
|------|------|------|
|
||
| Spring Boot | 2.5.15 | 应用框架 |
|
||
| Spring Security | 5.7.14 | 安全框架 |
|
||
| MyBatis | - | ORM框架 |
|
||
| MySQL | - | 数据库 |
|
||
| Redis | - | 缓存/会话 |
|
||
| Druid | 1.2.23 | 数据库连接池 |
|
||
| JWT | 0.9.1 | 令牌认证 |
|
||
| Swagger | 3.0.0 | API文档 |
|
||
| Apache POI | 4.1.2 | Excel处理 |
|
||
| PDFBox | 2.0.29 | PDF处理 |
|
||
| ZXing | 3.5.1 | 二维码生成 |
|
||
|
||
### 前端技术栈
|
||
|
||
| 技术 | 版本 | 用途 |
|
||
|------|------|------|
|
||
| Vue | 2.6.12 | 前端框架 |
|
||
| Element UI | 2.15.14 | UI组件库 |
|
||
| Vuex | 3.6.0 | 状态管理 |
|
||
| Vue Router | 3.4.9 | 路由管理 |
|
||
| Axios | 0.28.1 | HTTP客户端 |
|
||
| ECharts | 5.4.0 | 图表库 |
|
||
| Quill | 2.0.2 | 富文本编辑器 |
|
||
|
||
---
|
||
|
||
## 📊 核心功能模块
|
||
|
||
### 1. 量表管理模块 ✅
|
||
- 量表CRUD操作
|
||
- 量表导入导出（Excel）
|
||
- 量表状态管理
|
||
- 量表权限控制
|
||
|
||
### 2. 题目管理模块 ✅
|
||
- 题目编辑（富文本）
|
||
- 选项配置
|
||
- 批量导入题目
|
||
- 题目排序拖拽
|
||
|
||
### 3. 因子与计分模块 ✅
|
||
- 因子配置
|
||
- 因子公式设置
|
||
- 权重配置
|
||
- 反向计分设置
|
||
|
||
### 4. 测评执行模块 ✅
|
||
- 开始测评
|
||
- 暂停/恢复测评
|
||
- 提交测评
|
||
- 防重复提交
|
||
- 断点续测
|
||
|
||
### 5. 报告生成模块 ✅
|
||
- 自动生成报告
|
||
- 因子分计算
|
||
- 结果解释
|
||
- 报告导出（PDF/Excel）
|
||
|
||
### 6. 用户档案管理 ✅
|
||
- 档案字段自定义
|
||
- 不同年龄段模板
|
||
- 档案信息CRUD
|
||
- 档案导入导出
|
||
|
||
### 7. 自定义问卷模块 ✅
|
||
- 问卷创建/编辑
|
||
- 多种题目类型支持（9种）
|
||
- 自动计分
|
||
- 成绩排名统计
|
||
|
||
### 8. 二维码功能 ✅
|
||
- 生成测评二维码
|
||
- 扫码测试
|
||
- 扫码查看报告
|
||
- 扫码注册/登录
|
||
|
||
### 9. 危机预警模块
|
||
- 预警规则设置
|
||
- 预警记录管理
|
||
- 预警解除记录
|
||
|
||
### 10. 心理网站模块
|
||
- 文章发布/编辑
|
||
- 栏目管理
|
||
- 留言评论
|
||
- 个性化配置
|
||
|
||
---
|
||
|
||
## 📁 项目目录结构总览
|
||
|
||
```
|
||
xinli/
|
||
├── bin/ # 构建脚本
|
||
│ ├── clean.bat
|
||
│ ├── package.bat
|
||
│ └── run.bat
|
||
├── doc/ # 文档
|
||
├── pom.xml # Maven根配置
|
||
├── ry-xinli-admin/ # 启动模块
|
||
├── ry-xinli-system/ # 系统模块
|
||
├── ry-xinli-framework/ # 框架模块
|
||
├── ry-xinli-common/ # 公共模块
|
||
├── ry-xinli-generator/ # 代码生成器
|
||
├── ry-xinli-quartz/ # 定时任务
|
||
├── xinli-ui/ # Vue前端
|
||
├── xinli-App/ # Android移动端
|
||
├── sql/ # SQL脚本
|
||
├── z_Project change/ # 项目变更文档
|
||
│ ├── 进度汇总/ # 开发进度文档
|
||
│ └── 量表示例/ # 量表示例数据
|
||
└── 项目介绍/ # 项目介绍文档
|
||
```
|
||
|
||
---
|
||
|
||
## 🔐 安全配置
|
||
|
||
- Spring Security 认证授权
|
||
- JWT Token 机制
|
||
- 密码加密存储
|
||
- XSS 攻击防护
|
||
- 防盗链配置
|
||
- 操作日志记录
|
||
|
||
---
|
||
|
||
## 📈 项目规模统计
|
||
|
||
### 代码统计（估算）
|
||
|
||
| 模块 | Java文件 | Vue文件 | 总行数（估算） |
|
||
|------|---------|---------|---------------|
|
||
| 后端 | 400+ | - | 50,000+ |
|
||
| 前端 | - | 76 | 30,000+ |
|
||
| 移动端 | 1 | - | 1,000+ |
|
||
| **总计** | **400+** | **76** | **80,000+** |
|
||
|
||
### 功能模块统计
|
||
|
||
- **Controller**: 40+ 个
|
||
- **Service**: 50+ 个
|
||
- **Mapper**: 60+ 个
|
||
- **实体类**: 30+ 个
|
||
- **前端页面**: 76 个
|
||
- **API接口**: 100+ 个
|
||
|
||
---
|
||
|
||
## 🎯 项目特点
|
||
|
||
1. **模块化设计**：前后端分离，Maven多模块架构
|
||
2. **功能完整**：覆盖心理测评全流程
|
||
3. **扩展性强**：支持自定义问卷、用户档案扩展
|
||
4. **安全可靠**：完善的权限控制和数据安全
|
||
5. **多端支持**：Web端 + 移动端
|
||
6. **易于维护**：代码规范，文档完善
|
||
|
||
---
|
||
|
||
## 📝 开发状态
|
||
|
||
### 已完成功能 ✅
|
||
- 第一阶段：数据库设计与初始化
|
||
- 第二阶段：核心功能模块（量表、测评、报告）
|
||
- 第三阶段D3-1：用户档案管理
|
||
- 第三阶段D3-2：自定义问卷基础功能
|
||
- 第三阶段D3-3：二维码管理功能
|
||
|
||
### 进行中功能 🟡
|
||
- 第三阶段剩余模块（心理网站、数据统计等）
|
||
|
||
---
|
||
|
||
## 🔗 相关文档
|
||
|
||
- 技术架构设计：`z_Project change/进度汇总/3-技术架构设计.md`
|
||
- 开发计划：`z_Project change/进度汇总/1-开发计划.md`
|
||
- 使用指南：`使用指南-*.md`
|
||
- 项目改造说明：`项目介绍/项目改造说明.md`
|
||
|
||
---
|
||
|
||
**报告生成时间**：2025-01-27
|
||
**项目版本**：1.0.0
|
||
**分析状态**：✅ 完成
|
||
|