xiaozhang/xinli
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
c6ced1cf64
xinli/项目结构分析报告.md

491 lines
17 KiB
Markdown
Raw Normal View History

语音朗读
2025-11-26 14:14:19 +08:00
# 项目结构分析报告
## 📋 项目概述
**项目名称**：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
**分析状态**：✅ 完成
Reference in New Issue Copy Permalink