1230 lines
34 KiB
Markdown
1230 lines
34 KiB
Markdown
# AI心理健康测评系统 - 项目架构说明
|
||
|
||
## 📋 项目概述
|
||
|
||
**项目名称**：DDNAIAI心理健康测评系统 (ry-xinli)
|
||
**项目版本**：1.0.0
|
||
**技术架构**：前后端分离 + AI微服务
|
||
**开发团队**：DDNAI
|
||
|
||
这是一个集成了AI大模型和RAG知识库的智能心理健康测评系统，提供专业的心理量表测评、智能分析和个性化建议。
|
||
|
||
---
|
||
|
||
## 🎯 核心功能模块
|
||
|
||
### 1. 心理量表测评系统
|
||
- **量表管理**
|
||
- 支持多种标准心理量表（焦虑自评量表SAS、抑郁自评量表SDS等）
|
||
- 量表配置管理（题目、选项、因子、计分规则）
|
||
- 量表权限控制与分配
|
||
- 量表导入导出（JSON格式）
|
||
|
||
- **在线测评**
|
||
- 用户在线答题
|
||
- 自动计分与因子分析
|
||
- 实时保存答题进度
|
||
- 支持移动端和Web端
|
||
|
||
- **测评报告**
|
||
- 自动生成专业测评报告
|
||
- 多维度因子分析
|
||
- 分数解释与等级评定
|
||
- 历史报告查询与对比
|
||
|
||
### 2. AI智能分析
|
||
- **大模型集成**
|
||
- 集成Ollama本地大模型
|
||
- 支持多种开源模型（Llama、Qwen等）
|
||
- 可配置模型地址和参数
|
||
|
||
- **RAG知识库增强**
|
||
- 基于专业心理学知识库
|
||
- 语义检索相关知识
|
||
- 上下文增强生成
|
||
- 提高分析专业性和准确性
|
||
|
||
- **智能分析功能**
|
||
- 测评结果深度解读
|
||
- 个性化心理健康建议
|
||
- 心理状态趋势分析
|
||
- 专业术语解释
|
||
|
||
|
||
### 3. RAG知识库管理
|
||
- **文档管理**
|
||
- 支持多种格式（txt、md、pdf、docx）
|
||
- 文档上传与批量导入
|
||
- 文档分类与标签
|
||
- 文档版本管理
|
||
|
||
- **智能索引**
|
||
- 自动文档解析与分块
|
||
- 向量化存储（FAISS）
|
||
- 实时文件监控
|
||
- 增量索引更新
|
||
|
||
- **语义检索**
|
||
- 基于向量的语义搜索
|
||
- 支持中文语义理解
|
||
- Top-K相关文档检索
|
||
- 检索结果排序优化
|
||
|
||
- **知识库内容**
|
||
- 心理健康基础知识
|
||
- 心理量表专业解读
|
||
- 个性化分析案例库
|
||
- 青少年心理发展特点
|
||
|
||
### 4. 用户与权限管理
|
||
- **用户管理**
|
||
- 用户注册与登录
|
||
- 用户档案管理
|
||
- 用户分组与角色
|
||
- 测评历史记录
|
||
|
||
- **权限控制**
|
||
- 基于角色的访问控制（RBAC）
|
||
- 量表访问权限
|
||
- 数据隔离与安全
|
||
- 操作日志审计
|
||
|
||
- **用户画像**
|
||
- 基本信息管理
|
||
- 测评历史统计
|
||
- 心理健康档案
|
||
- 数据可视化展示
|
||
|
||
### 5. 心理风险预警系统
|
||
- **预警规则配置**
|
||
- 自定义预警条件
|
||
- 多维度风险评估
|
||
- 阈值动态调整
|
||
- 规则优先级管理
|
||
|
||
- **风险识别**
|
||
- 异常结果自动识别
|
||
- 高危人群筛查
|
||
- 趋势分析预警
|
||
- 多次测评对比
|
||
|
||
- **预警处理**
|
||
- 预警通知机制
|
||
- 预警记录管理
|
||
- 处理流程跟踪
|
||
- 统计分析报表
|
||
|
||
|
||
### 6. 门户网站功能
|
||
- **内容管理**
|
||
- 心理健康资讯发布
|
||
- 文章分类管理
|
||
- 富文本编辑器
|
||
- 图片上传管理
|
||
|
||
- **互动功能**
|
||
- 用户评论系统
|
||
- 内容点赞收藏
|
||
- 评论审核管理
|
||
- 敏感词过滤
|
||
|
||
- **门户展示**
|
||
- 首页内容推荐
|
||
- 分类浏览导航
|
||
- 搜索功能
|
||
- 响应式布局
|
||
|
||
### 7. 系统管理功能
|
||
- **菜单管理**：动态菜单配置
|
||
- **字典管理**：系统字典维护
|
||
- **参数配置**：系统参数设置
|
||
- **通知公告**：系统消息发布
|
||
- **日志管理**：操作日志、登录日志
|
||
- **在线用户**：在线用户监控
|
||
- **定时任务**：任务调度管理
|
||
- **代码生成**：快速生成CRUD代码
|
||
|
||
---
|
||
|
||
## 🏗️ 技术架构
|
||
|
||
### 整体架构图
|
||
|
||
```
|
||
┌─────────────────────────────────────────────────────────────┐
|
||
│ 客户端层 │
|
||
├──────────────────────────┬──────────────────────────────────┤
|
||
│ Android App (Gradle) │ Web前端 (Vue.js) │
|
||
│ - WebView加载前端 │ - Element UI │
|
||
│ - 语音读题功能 │ - Axios HTTP │
|
||
│ - PaddleSpeech集成 │ - Vuex状态管理 │
|
||
└──────────────────────────┴──────────────────────────────────┘
|
||
↓
|
||
┌─────────────────────────────────────────────────────────────┐
|
||
│ 网关层 │
|
||
├─────────────────────────────────────────────────────────────┤
|
||
│ Nginx (端口80) │
|
||
│ - 静态资源服务（前端dist） │
|
||
│ - API反向代理（/api → 后端30081） │
|
||
│ - 负载均衡 │
|
||
└─────────────────────────────────────────────────────────────┘
|
||
↓
|
||
┌─────────────────────────────────────────────────────────────┐
|
||
│ Java应用层 (Spring Boot) │
|
||
├─────────────────────────────────────────────────────────────┤
|
||
│ 端口：30081 │
|
||
│ │
|
||
│ ├─ ry-xinli-admin (Web控制层) │
|
||
│ │ └─ Controller层：处理HTTP请求 │
|
||
│ │ │
|
||
│ ├─ ry-xinli-system (业务逻辑层) │
|
||
│ │ ├─ Service：业务逻辑实现 │
|
||
│ │ ├─ Mapper：数据访问接口 │
|
||
│ │ └─ Domain：实体类与VO │
|
||
│ │ │
|
||
│ ├─ ry-xinli-framework (框架核心) │
|
||
│ │ ├─ Security：安全认证（JWT） │
|
||
│ │ ├─ Config：系统配置 │
|
||
│ │ └─ Interceptor：拦截器 │
|
||
│ │ │
|
||
│ ├─ ry-xinli-common (通用工具) │
|
||
│ │ ├─ Utils：工具类 │
|
||
│ │ ├─ Exception：异常处理 │
|
||
│ │ └─ Annotation：自定义注解 │
|
||
│ │ │
|
||
│ ├─ ry-xinli-quartz (定时任务) │
|
||
│ │ └─ Quartz任务调度 │
|
||
│ │ │
|
||
│ └─ ry-xinli-generator (代码生成) │
|
||
│ └─ Velocity模板生成 │
|
||
└─────────────────────────────────────────────────────────────┘
|
||
↓
|
||
┌─────────────────────────────────────────────────────────────┐
|
||
│ AI服务层 (Python) │
|
||
├─────────────────────────────────────────────────────────────┤
|
||
│ RAG知识库服务 (Flask) - 端口5000 │
|
||
│ ├─ app.py (Flask应用入口) │
|
||
│ ├─ document_parser.py (文档解析：PDF/DOCX/TXT/MD) │
|
||
│ ├─ text_splitter.py (文本分块：智能切分) │
|
||
│ ├─ vector_store.py (向量存储：FAISS索引) │
|
||
│ ├─ knowledge_service.py(知识库服务：检索与管理) │
|
||
│ └─ file_watcher.py (文件监控：自动索引) │
|
||
│ │
|
||
│ Ollama大模型服务 - 端口11434 │
|
||
│ ├─ 文本生成模型（Llama/Qwen等） │
|
||
│ ├─ 嵌入模型（nomic-embed-text） │
|
||
│ └─ 模型管理与推理 │
|
||
└─────────────────────────────────────────────────────────────┘
|
||
↓
|
||
┌─────────────────────────────────────────────────────────────┐
|
||
│ 数据层 │
|
||
├──────────────────────────┬──────────────────────────────────┤
|
||
│ MySQL (端口3306) │ Redis (端口6379) │
|
||
│ - 业务数据存储 │ - 缓存与会话 │
|
||
│ - 量表配置数据 │ - Token管理 │
|
||
│ - 用户测评记录 │ - 分布式锁 │
|
||
│ - 系统配置数据 │ - 消息队列 │
|
||
└──────────────────────────┴──────────────────────────────────┘
|
||
```
|
||
|
||
|
||
### 技术栈详情
|
||
|
||
#### 后端技术栈（Java）
|
||
| 技术 | 版本 | 说明 |
|
||
|------|------|------|
|
||
| Spring Boot | 2.5.15 | 应用框架 |
|
||
| Spring Security | 5.7.14 | 安全认证 |
|
||
| Spring Framework | 5.3.39 | 核心框架 |
|
||
| MyBatis | - | ORM框架 |
|
||
| PageHelper | 1.4.7 | 分页插件 |
|
||
| Druid | 1.2.23 | 数据库连接池 |
|
||
| JWT | 0.9.1 | Token生成与解析 |
|
||
| Swagger | 3.0.0 | API文档 |
|
||
| FastJSON | 2.0.58 | JSON解析 |
|
||
| OkHttp | 4.12.0 | HTTP客户端 |
|
||
| POI | 4.1.2 | Excel/Word处理 |
|
||
| PDFBox | 2.0.29 | PDF处理 |
|
||
| Quartz | - | 定时任务 |
|
||
| Velocity | 2.3 | 模板引擎 |
|
||
| Kaptcha | 2.3.3 | 验证码 |
|
||
| ZXing | 3.5.1 | 二维码生成 |
|
||
|
||
#### 前端技术栈（Vue）
|
||
| 技术 | 版本 | 说明 |
|
||
|------|------|------|
|
||
| Vue.js | 2.x | 前端框架 |
|
||
| Element UI | - | UI组件库 |
|
||
| Axios | - | HTTP请求 |
|
||
| Vuex | - | 状态管理 |
|
||
| Vue Router | - | 路由管理 |
|
||
| Webpack | - | 模块打包 |
|
||
| Babel | - | ES6+转译 |
|
||
| Sass/Less | - | CSS预处理 |
|
||
|
||
#### AI服务技术栈（Python）
|
||
| 技术 | 版本 | 说明 |
|
||
|------|------|------|
|
||
| Flask | - | Web框架 |
|
||
| FAISS | - | 向量检索引擎 |
|
||
| Sentence Transformers | - | 文本向量化 |
|
||
| PyPDF2 | - | PDF解析 |
|
||
| python-docx | - | Word解析 |
|
||
| Watchdog | - | 文件监控 |
|
||
| Ollama | - | 本地大模型服务 |
|
||
|
||
#### 移动端技术栈（Android）
|
||
| 技术 | 版本 | 说明 |
|
||
|------|------|------|
|
||
| Gradle | 7.x | 构建工具 |
|
||
| Android SDK | 33 | 开发工具包 |
|
||
| WebView | - | 网页加载 |
|
||
| PaddleSpeech | - | 语音合成（读题功能） |
|
||
|
||
#### 数据库与中间件
|
||
| 技术 | 版本 | 说明 |
|
||
|------|------|------|
|
||
| MySQL | 5.7+ | 关系型数据库 |
|
||
| Redis | 6.x | 缓存数据库 |
|
||
| Nginx | 1.x | Web服务器 |
|
||
|
||
---
|
||
|
||
## 🔄 核心业务流程
|
||
|
||
### 1. 用户测评流程
|
||
|
||
```
|
||
用户登录
|
||
↓
|
||
选择量表
|
||
↓
|
||
开始答题 ──→ 实时保存进度
|
||
↓
|
||
提交答卷
|
||
↓
|
||
后端计算得分 ──→ 因子分析 ──→ 等级评定
|
||
↓
|
||
调用RAG服务 ──→ 检索相关知识
|
||
↓
|
||
构建Prompt ──→ 调用Ollama生成分析
|
||
↓
|
||
生成测评报告 ──→ 保存数据库
|
||
↓
|
||
返回报告给用户 ──→ 支持导出/打印
|
||
```
|
||
|
||
### 2. AI分析流程
|
||
|
||
```
|
||
测评结果数据
|
||
↓
|
||
提取关键信息（得分、因子、等级）
|
||
↓
|
||
调用RAG服务API
|
||
↓
|
||
RAG向量检索 ──→ 查询FAISS索引
|
||
↓
|
||
返回Top-K相关文档片段
|
||
↓
|
||
构建增强Prompt
|
||
├─ 测评结果
|
||
├─ 量表信息
|
||
├─ 用户画像
|
||
└─ 检索到的专业知识
|
||
↓
|
||
调用Ollama API
|
||
↓
|
||
流式生成分析报告
|
||
↓
|
||
后处理与格式化
|
||
↓
|
||
返回最终分析结果
|
||
```
|
||
|
||
|
||
### 3. RAG知识库索引流程
|
||
|
||
```
|
||
文档上传/添加
|
||
↓
|
||
文档格式检测
|
||
├─ PDF ──→ PyPDF2解析
|
||
├─ DOCX ──→ python-docx解析
|
||
├─ TXT ──→ 直接读取
|
||
└─ MD ──→ Markdown解析
|
||
↓
|
||
文本预处理
|
||
├─ 清洗特殊字符
|
||
├─ 去除多余空白
|
||
└─ 编码转换
|
||
↓
|
||
智能分块（text_splitter）
|
||
├─ 按段落分割
|
||
├─ 保持语义完整
|
||
├─ 设置重叠区域
|
||
└─ 控制块大小（500字符）
|
||
↓
|
||
向量化（Sentence Transformers）
|
||
└─ 使用多语言模型（支持中文）
|
||
↓
|
||
存储到FAISS索引
|
||
├─ 向量数据
|
||
└─ 元数据（文件名、块ID等）
|
||
↓
|
||
持久化到磁盘
|
||
├─ faiss.index（向量索引）
|
||
└─ documents.json（文档元数据）
|
||
```
|
||
|
||
### 4. 文件监控与增量更新
|
||
|
||
```
|
||
启动file_watcher
|
||
↓
|
||
监控knowledge_docs目录
|
||
↓
|
||
检测文件变化
|
||
├─ 新增文件 ──→ 自动索引
|
||
├─ 修改文件 ──→ 重新索引
|
||
└─ 删除文件 ──→ 移除索引
|
||
↓
|
||
触发索引更新
|
||
↓
|
||
更新FAISS索引
|
||
↓
|
||
保存到磁盘
|
||
```
|
||
|
||
---
|
||
|
||
## 📊 数据库设计
|
||
|
||
### 核心数据表
|
||
|
||
#### 心理测评相关表
|
||
- `psy_scale` - 心理量表主表
|
||
- `psy_scale_item` - 量表题目表
|
||
- `psy_scale_option` - 题目选项表
|
||
- `psy_factor` - 量表因子表
|
||
- `psy_factor_rule` - 因子计分规则表
|
||
- `psy_result_interpretation` - 结果解释表
|
||
- `psy_warning_rule` - 预警规则表
|
||
|
||
#### 问卷答题相关表
|
||
- `psy_questionnaire` - 问卷实例表
|
||
- `psy_questionnaire_item` - 问卷题目表
|
||
- `psy_questionnaire_option` - 问卷选项表
|
||
- `psy_questionnaire_answer` - 用户答题记录表
|
||
- `psy_assessment_report` - 测评报告表
|
||
- `psy_warning` - 预警记录表
|
||
|
||
#### 用户相关表
|
||
- `psy_user_profile` - 用户档案表
|
||
- `psy_scale_permission` - 量表权限表
|
||
- `sys_user` - 系统用户表
|
||
- `sys_role` - 角色表
|
||
- `sys_user_role` - 用户角色关联表
|
||
|
||
#### 门户网站相关表
|
||
- `psy_website_category` - 内容分类表
|
||
- `psy_website_content` - 内容表
|
||
- `psy_website_comment` - 评论表
|
||
|
||
#### 系统管理相关表
|
||
- `sys_menu` - 菜单表
|
||
- `sys_dept` - 部门表
|
||
- `sys_post` - 岗位表
|
||
- `sys_dict_type` - 字典类型表
|
||
- `sys_dict_data` - 字典数据表
|
||
- `sys_config` - 参数配置表
|
||
- `sys_notice` - 通知公告表
|
||
- `sys_oper_log` - 操作日志表
|
||
- `sys_logininfor` - 登录日志表
|
||
|
||
---
|
||
|
||
## 🔐 安全设计
|
||
|
||
### 认证与授权
|
||
- **JWT Token认证**：无状态认证机制
|
||
- **RBAC权限模型**：基于角色的访问控制
|
||
- **密码加密**：BCrypt加密存储
|
||
- **Token刷新机制**：支持Token自动续期
|
||
- **单点登录**：支持多端登录控制
|
||
|
||
### 数据安全
|
||
- **SQL注入防护**：MyBatis预编译
|
||
- **XSS防护**：输入输出过滤
|
||
- **CSRF防护**：Token验证
|
||
- **敏感数据加密**：AES加密存储
|
||
- **数据脱敏**：日志脱敏处理
|
||
|
||
### 接口安全
|
||
- **接口鉴权**：统一鉴权拦截器
|
||
- **限流控制**：防止接口滥用
|
||
- **签名验证**：关键接口签名校验
|
||
- **HTTPS传输**：生产环境强制HTTPS
|
||
|
||
---
|
||
|
||
## 🚀 部署架构
|
||
|
||
### 开发环境
|
||
```
|
||
本机 (192.168.1.164)
|
||
├─ MySQL (3306)
|
||
├─ Redis (6379)
|
||
├─ Java后端 (30081)
|
||
├─ Python RAG (5000)
|
||
├─ Ollama (11434)
|
||
└─ 前端开发服务器 (80)
|
||
```
|
||
|
||
### 生产环境（内网部署）
|
||
```
|
||
服务器 (192.168.0.106)
|
||
├─ Nginx (80) ──→ 前端静态文件 + API代理
|
||
├─ Java后端 (30081) ──→ xinli-admin.jar
|
||
├─ Python RAG (5000) ──→ rag-python/app.py
|
||
├─ Ollama (11434) ──→ 本地大模型服务
|
||
├─ MySQL (远程: 1.15.149.240:3306)
|
||
└─ Redis (6379)
|
||
```
|
||
|
||
|
||
### 服务端口汇总
|
||
|
||
| 服务 | 端口 | 说明 | 访问方式 |
|
||
|------|------|------|----------|
|
||
| Nginx | 80 | 前端入口 | http://192.168.0.106 |
|
||
| Java后端 | 30081 | 后端API | http://localhost:30081 |
|
||
| Python RAG | 5000 | 知识库服务 | http://localhost:5000 |
|
||
| Ollama | 11434 | 大模型服务 | http://localhost:11434 |
|
||
| MySQL | 3306 | 数据库 | 远程：1.15.149.240:3306 |
|
||
| Redis | 6379 | 缓存 | localhost:6379 |
|
||
|
||
---
|
||
|
||
## 📁 项目目录结构
|
||
|
||
```
|
||
xinli/
|
||
├─ ry-xinli-admin/ # Web控制层模块
|
||
│ └─ src/main/
|
||
│ ├─ java/com/ddnai/web/
|
||
│ │ └─ controller/ # 控制器
|
||
│ │ ├─ psychology/ # 心理测评相关
|
||
│ │ ├─ system/ # 系统管理相关
|
||
│ │ └─ monitor/ # 监控相关
|
||
│ └─ resources/
|
||
│ ├─ application.yml # 主配置文件
|
||
│ └─ mybatis/ # MyBatis配置
|
||
│
|
||
├─ ry-xinli-system/ # 业务逻辑层模块
|
||
│ └─ src/main/java/com/ddnai/system/
|
||
│ ├─ domain/ # 实体类
|
||
│ ├─ mapper/ # 数据访问接口
|
||
│ └─ service/ # 业务逻辑实现
|
||
│
|
||
├─ ry-xinli-framework/ # 框架核心模块
|
||
│ └─ src/main/java/com/ddnai/framework/
|
||
│ ├─ config/ # 系统配置
|
||
│ ├─ security/ # 安全认证
|
||
│ ├─ interceptor/ # 拦截器
|
||
│ └─ aspectj/ # AOP切面
|
||
│
|
||
├─ ry-xinli-common/ # 通用工具模块
|
||
│ └─ src/main/java/com/ddnai/common/
|
||
│ ├─ utils/ # 工具类
|
||
│ ├─ exception/ # 异常处理
|
||
│ ├─ annotation/ # 自定义注解
|
||
│ └─ core/ # 核心组件
|
||
│
|
||
├─ ry-xinli-quartz/ # 定时任务模块
|
||
│ └─ src/main/java/com/ddnai/quartz/
|
||
│
|
||
├─ ry-xinli-generator/ # 代码生成模块
|
||
│ └─ src/main/java/com/ddnai/generator/
|
||
│
|
||
├─ xinli-ui/ # 前端Vue项目
|
||
│ ├─ src/
|
||
│ │ ├─ api/ # API接口
|
||
│ │ ├─ assets/ # 静态资源
|
||
│ │ ├─ components/ # 组件
|
||
│ │ ├─ layout/ # 布局
|
||
│ │ ├─ router/ # 路由
|
||
│ │ ├─ store/ # Vuex状态
|
||
│ │ ├─ utils/ # 工具类
|
||
│ │ └─ views/ # 页面视图
|
||
│ ├─ public/ # 公共资源
|
||
│ ├─ package.json # 依赖配置
|
||
│ └─ vue.config.js # Vue配置
|
||
│
|
||
├─ xinli-App/ # Android应用
|
||
│ ├─ app/
|
||
│ │ └─ src/main/
|
||
│ │ ├─ java/ # Java代码
|
||
│ │ └─ res/ # 资源文件
|
||
│ ├─ build.gradle # Gradle配置
|
||
│ └─ gradlew.bat # Gradle包装器
|
||
│
|
||
├─ rag-python/ # Python RAG服务
|
||
│ ├─ app.py # Flask应用入口
|
||
│ ├─ config.py # 配置文件
|
||
│ ├─ document_parser.py # 文档解析
|
||
│ ├─ text_splitter.py # 文本分块
|
||
│ ├─ vector_store.py # 向量存储
|
||
│ ├─ knowledge_service.py # 知识库服务
|
||
│ ├─ file_watcher.py # 文件监控
|
||
│ ├─ requirements.txt # Python依赖
|
||
│ ├─ knowledge_docs/ # 知识库文档目录
|
||
│ ├─ index_data/ # 索引数据目录
|
||
│ ├─ uploads/ # 上传临时目录
|
||
│ ├─ install.bat # 安装脚本
|
||
│ └─ start.bat # 启动脚本
|
||
│
|
||
├─ PaddleSpeech-develop/ # 语音合成库（App读题功能）
|
||
│
|
||
├─ Archive/ # 归档文档
|
||
│
|
||
├─ 项目介绍/ # 项目文档
|
||
│ ├─ 环境配置/ # 环境配置说明
|
||
│ ├─ 量表/ # 量表配置文件
|
||
│ └─ 项目/ # 项目相关文档
|
||
│
|
||
└─ pom.xml # Maven主配置
|
||
```
|
||
|
||
---
|
||
|
||
## 🔧 关键配置文件
|
||
|
||
### 1. 后端配置（application.yml）
|
||
```yaml
|
||
# 服务端口
|
||
server:
|
||
port: 30081
|
||
|
||
# 数据库配置
|
||
spring:
|
||
datasource:
|
||
url: jdbc:mysql://1.15.149.240:3306/xinli?useUnicode=true&characterEncoding=utf8
|
||
username: root
|
||
password: ******
|
||
|
||
# Redis配置
|
||
redis:
|
||
host: localhost
|
||
port: 6379
|
||
|
||
# RAG服务配置
|
||
rag:
|
||
enabled: true
|
||
service-url: http://127.0.0.1:5000
|
||
|
||
# Ollama配置
|
||
ollama:
|
||
base-url: http://localhost:11434
|
||
model: qwen2.5:7b
|
||
```
|
||
|
||
### 2. 前端配置（vue.config.js）
|
||
```javascript
|
||
module.exports = {
|
||
devServer: {
|
||
port: 80,
|
||
proxy: {
|
||
'/api': {
|
||
target: 'http://localhost:30081',
|
||
changeOrigin: true,
|
||
pathRewrite: {
|
||
'^/api': ''
|
||
}
|
||
}
|
||
}
|
||
}
|
||
}
|
||
```
|
||
|
||
### 3. RAG服务配置（config.py）
|
||
```python
|
||
# 服务端口
|
||
PORT = 5000
|
||
|
||
# 文本分块配置
|
||
CHUNK_SIZE = 500
|
||
CHUNK_OVERLAP = 50
|
||
|
||
# 向量模型（支持中文）
|
||
EMBEDDING_MODEL = "paraphrase-multilingual-MiniLM-L12-v2"
|
||
|
||
# 检索返回数量
|
||
TOP_K = 5
|
||
|
||
# 知识库目录
|
||
KNOWLEDGE_DOCS_DIR = "knowledge_docs"
|
||
INDEX_DATA_DIR = "index_data"
|
||
```
|
||
|
||
### 4. Nginx配置
|
||
```nginx
|
||
server {
|
||
listen 80;
|
||
server_name 192.168.0.106;
|
||
|
||
# 前端静态文件
|
||
location / {
|
||
root /www/wwwroot/xinli/dist;
|
||
index index.html;
|
||
try_files $uri $uri/ /index.html;
|
||
}
|
||
|
||
# 后端API代理
|
||
location /api/ {
|
||
proxy_pass http://127.0.0.1:30081/;
|
||
proxy_set_header Host $host;
|
||
proxy_set_header X-Real-IP $remote_addr;
|
||
}
|
||
}
|
||
```
|
||
|
||
---
|
||
|
||
## 🎨 前端页面结构
|
||
|
||
### 管理后台页面
|
||
- **首页**：数据统计、快速入口
|
||
- **心理测评管理**
|
||
- 量表管理：量表列表、新增/编辑、导入/导出
|
||
- 题目管理：题目配置、选项设置
|
||
- 因子管理：因子配置、计分规则
|
||
- 解释管理：结果解释、等级设置
|
||
- 预警规则：规则配置、阈值设置
|
||
- **问卷管理**
|
||
- 问卷列表：查看所有问卷实例
|
||
- 答题记录：用户答题详情
|
||
- 测评报告：报告查看、导出
|
||
- 预警记录：预警查看、处理
|
||
- **知识库管理**
|
||
- 文档管理：上传、删除、查看
|
||
- 索引管理：重建索引、统计信息
|
||
- 检索测试：测试语义检索
|
||
- **AI分析管理**
|
||
- 模型配置：Ollama地址、模型选择
|
||
- 分析记录：历史分析查看
|
||
- 提示词管理：Prompt模板配置
|
||
- **用户管理**
|
||
- 用户列表：用户信息管理
|
||
- 用户档案：详细档案查看
|
||
- 权限分配：量表权限设置
|
||
- **门户管理**
|
||
- 分类管理：内容分类设置
|
||
- 内容管理：文章发布、编辑
|
||
- 评论管理：评论审核、删除
|
||
- **系统管理**
|
||
- 菜单管理、角色管理、部门管理
|
||
- 字典管理、参数设置、通知公告
|
||
- 日志管理、在线用户、定时任务
|
||
|
||
|
||
### 用户端页面（App/Web）
|
||
- **登录注册**：用户登录、注册
|
||
- **首页**：推荐量表、最新资讯
|
||
- **量表测评**
|
||
- 量表列表：可用量表展示
|
||
- 在线答题：答题界面（支持语音读题）
|
||
- 测评报告：查看报告、AI分析
|
||
- 历史记录：历史测评查看
|
||
- **个人中心**
|
||
- 个人信息：资料编辑
|
||
- 我的测评：测评历史
|
||
- 我的报告：报告管理
|
||
- **资讯浏览**
|
||
- 文章列表：分类浏览
|
||
- 文章详情：阅读、评论
|
||
|
||
---
|
||
|
||
## 🚦 接口设计规范
|
||
|
||
### RESTful API规范
|
||
- **GET**：查询操作
|
||
- **POST**：新增操作
|
||
- **PUT**：修改操作
|
||
- **DELETE**：删除操作
|
||
|
||
### 统一响应格式
|
||
```json
|
||
{
|
||
"code": 200,
|
||
"msg": "操作成功",
|
||
"data": {
|
||
// 业务数据
|
||
}
|
||
}
|
||
```
|
||
|
||
### 主要API接口
|
||
|
||
#### 心理测评相关
|
||
```
|
||
GET /psychology/scale/list # 获取量表列表
|
||
POST /psychology/scale # 新增量表
|
||
PUT /psychology/scale # 修改量表
|
||
DELETE /psychology/scale/{id} # 删除量表
|
||
POST /psychology/scale/import # 导入量表JSON
|
||
GET /psychology/scale/export/{id} # 导出量表JSON
|
||
|
||
GET /psychology/questionnaire/list # 获取问卷列表
|
||
POST /psychology/questionnaire/answer # 提交答题
|
||
GET /psychology/questionnaire/report/{id} # 获取测评报告
|
||
```
|
||
|
||
#### AI分析相关
|
||
```
|
||
POST /psychology/ai/analyze # AI分析测评结果
|
||
GET /psychology/ai/status # 获取AI服务状态
|
||
POST /psychology/ai/chat # AI对话接口
|
||
```
|
||
|
||
#### RAG知识库相关
|
||
```
|
||
GET /psychology/rag/health # 健康检查
|
||
GET /psychology/rag/documents # 获取文档列表
|
||
POST /psychology/rag/upload # 上传文档
|
||
DELETE /psychology/rag/documents/{filename} # 删除文档
|
||
POST /psychology/rag/search # 语义搜索
|
||
POST /psychology/rag/rebuild # 重建索引
|
||
GET /psychology/rag/stats # 获取统计信息
|
||
```
|
||
|
||
#### 用户相关
|
||
```
|
||
POST /login # 用户登录
|
||
POST /register # 用户注册
|
||
GET /getInfo # 获取用户信息
|
||
POST /logout # 退出登录
|
||
GET /psychology/profile/{id} # 获取用户档案
|
||
PUT /psychology/profile # 更新用户档案
|
||
```
|
||
|
||
---
|
||
|
||
## 🔍 核心算法与逻辑
|
||
|
||
### 1. 量表计分算法
|
||
```
|
||
总分计算：
|
||
总分 = Σ(题目得分)
|
||
|
||
因子分计算：
|
||
因子分 = Σ(因子内题目得分 × 权重)
|
||
|
||
等级评定：
|
||
根据分数范围匹配对应等级
|
||
- 正常：0-20分
|
||
- 轻度：21-40分
|
||
- 中度：41-60分
|
||
- 重度：61-80分
|
||
```
|
||
|
||
### 2. RAG检索算法
|
||
```
|
||
1. 查询向量化
|
||
query_vector = embedding_model.encode(query)
|
||
|
||
2. 相似度计算（余弦相似度）
|
||
similarity = cosine_similarity(query_vector, doc_vectors)
|
||
|
||
3. Top-K检索
|
||
top_k_docs = faiss_index.search(query_vector, k=5)
|
||
|
||
4. 结果排序与过滤
|
||
- 按相似度降序
|
||
- 过滤低相关文档（阈值0.5）
|
||
- 返回文档内容
|
||
```
|
||
|
||
### 3. AI分析Prompt构建
|
||
```
|
||
系统提示词：
|
||
你是一位专业的心理咨询师...
|
||
|
||
用户信息：
|
||
姓名：{name}
|
||
年龄：{age}
|
||
性别：{gender}
|
||
|
||
测评结果：
|
||
量表：{scale_name}
|
||
总分：{total_score}
|
||
等级：{level}
|
||
因子得分：{factor_scores}
|
||
|
||
专业知识（RAG检索）：
|
||
{retrieved_knowledge}
|
||
|
||
分析要求：
|
||
1. 结合测评结果进行专业分析
|
||
2. 参考提供的专业知识
|
||
3. 给出个性化建议
|
||
4. 语言通俗易懂
|
||
```
|
||
|
||
### 4. 预警规则匹配
|
||
```
|
||
规则类型：
|
||
1. 单因子阈值：某因子分数 > 阈值
|
||
2. 总分阈值：总分 > 阈值
|
||
3. 多因子组合：多个因子同时满足条件
|
||
4. 趋势预警：连续多次测评分数上升
|
||
|
||
匹配逻辑：
|
||
for rule in warning_rules:
|
||
if match_condition(result, rule):
|
||
create_warning(user, result, rule)
|
||
send_notification(user, warning)
|
||
```
|
||
|
||
---
|
||
|
||
## 📈 性能优化策略
|
||
|
||
### 后端优化
|
||
- **数据库优化**
|
||
- 索引优化：关键字段建立索引
|
||
- 查询优化：避免N+1查询
|
||
- 连接池：Druid连接池配置
|
||
- 读写分离：主从复制（可选）
|
||
|
||
- **缓存策略**
|
||
- Redis缓存：热点数据缓存
|
||
- 本地缓存：Caffeine缓存
|
||
- 缓存预热：启动时加载常用数据
|
||
- 缓存更新：定时刷新策略
|
||
|
||
- **异步处理**
|
||
- 异步任务：@Async注解
|
||
- 消息队列：Redis队列
|
||
- 定时任务：Quartz调度
|
||
|
||
### 前端优化
|
||
- **资源优化**
|
||
- 代码分割：路由懒加载
|
||
- 图片优化：压缩、懒加载
|
||
- 打包优化：Webpack配置
|
||
- CDN加速：静态资源CDN
|
||
|
||
- **渲染优化**
|
||
- 虚拟滚动：长列表优化
|
||
- 防抖节流：频繁操作优化
|
||
- Keep-alive：页面缓存
|
||
|
||
### AI服务优化
|
||
- **向量检索优化**
|
||
- FAISS索引优化：IVF索引
|
||
- 批量检索：减少调用次数
|
||
- 缓存热门查询：Redis缓存
|
||
|
||
- **模型推理优化**
|
||
- 模型量化：减少显存占用
|
||
- 批处理：批量推理
|
||
- 流式输出：提升用户体验
|
||
|
||
---
|
||
|
||
## 🛠️ 开发与部署
|
||
|
||
### 开发环境搭建
|
||
|
||
#### 1. 后端开发环境
|
||
```bash
|
||
# 安装JDK 1.8
|
||
# 安装Maven 3.6+
|
||
# 安装MySQL 5.7+
|
||
# 安装Redis 6.x
|
||
|
||
# 克隆项目
|
||
git clone <repository-url>
|
||
|
||
# 导入数据库
|
||
mysql -u root -p < 项目介绍/项目/心理备份.sql
|
||
|
||
# 修改配置
|
||
# 编辑 ry-xinli-admin/src/main/resources/application.yml
|
||
# 修改数据库连接、Redis配置等
|
||
|
||
# 启动后端
|
||
cd ry-xinli-admin
|
||
mvn spring-boot:run
|
||
```
|
||
|
||
#### 2. 前端开发环境
|
||
```bash
|
||
# 安装Node.js 14+
|
||
# 安装npm或yarn
|
||
|
||
# 安装依赖
|
||
cd xinli-ui
|
||
npm install
|
||
|
||
# 启动开发服务器
|
||
npm run dev
|
||
|
||
# 访问 http://localhost:80
|
||
```
|
||
|
||
#### 3. Python RAG服务
|
||
```bash
|
||
# 安装Python 3.8+
|
||
|
||
# 安装依赖
|
||
cd rag-python
|
||
python -m venv venv
|
||
venv\Scripts\activate
|
||
pip install -r requirements.txt
|
||
|
||
# 启动服务
|
||
python app.py
|
||
|
||
# 访问 http://localhost:5000
|
||
```
|
||
|
||
#### 4. Ollama大模型
|
||
```bash
|
||
# 安装Ollama
|
||
# 下载地址：https://ollama.ai
|
||
|
||
# 拉取模型
|
||
ollama pull qwen2.5:7b
|
||
ollama pull nomic-embed-text
|
||
|
||
# 启动服务
|
||
ollama serve
|
||
```
|
||
|
||
|
||
### 生产环境部署
|
||
|
||
#### 1. 后端部署
|
||
```bash
|
||
# 打包
|
||
mvn clean package -DskipTests
|
||
|
||
# 上传jar包到服务器
|
||
# 文件位置：ry-xinli-admin/target/xinli-admin.jar
|
||
|
||
# 启动服务
|
||
nohup java -jar xinli-admin.jar > xinli.log 2>&1 &
|
||
|
||
# 或使用systemd服务
|
||
sudo systemctl start xinli-backend
|
||
```
|
||
|
||
#### 2. 前端部署
|
||
```bash
|
||
# 打包
|
||
npm run build:prod
|
||
|
||
# 上传dist目录到服务器
|
||
# 配置Nginx指向dist目录
|
||
|
||
# 重启Nginx
|
||
sudo systemctl restart nginx
|
||
```
|
||
|
||
#### 3. Android App打包
|
||
```bash
|
||
cd xinli-App
|
||
|
||
# 检查JDK和SDK
|
||
./check-jdk.bat
|
||
|
||
# 打包正式版APK
|
||
./gradlew assembleRelease
|
||
|
||
# APK位置：app/build/outputs/apk/release/app-release.apk
|
||
```
|
||
|
||
### 启动顺序
|
||
```
|
||
1. MySQL、Redis（基础服务）
|
||
2. Ollama（大模型服务）
|
||
3. Python RAG服务
|
||
4. Java后端服务
|
||
5. Nginx（前端服务）
|
||
```
|
||
|
||
### 停止服务
|
||
```bash
|
||
# 停止Java后端
|
||
ps -ef | grep xinli-admin.jar
|
||
kill -9 <pid>
|
||
|
||
# 停止Python RAG
|
||
ps -ef | grep app.py
|
||
kill -9 <pid>
|
||
|
||
# 停止Ollama
|
||
ps -ef | grep ollama
|
||
kill -9 <pid>
|
||
|
||
# 停止Nginx
|
||
sudo systemctl stop nginx
|
||
```
|
||
|
||
---
|
||
|
||
## 🧪 测试说明
|
||
|
||
### 单元测试
|
||
- 使用JUnit 5进行单元测试
|
||
- Service层业务逻辑测试
|
||
- Mapper层数据访问测试
|
||
- 工具类测试
|
||
|
||
### 接口测试
|
||
- 使用Swagger进行接口测试
|
||
- Postman接口集合
|
||
- 自动化接口测试脚本
|
||
|
||
### 性能测试
|
||
- JMeter压力测试
|
||
- 接口响应时间监控
|
||
- 并发用户测试
|
||
- 数据库性能分析
|
||
|
||
---
|
||
|
||
## 📝 开发规范
|
||
|
||
### 代码规范
|
||
- **命名规范**
|
||
- 类名：大驼峰（PascalCase）
|
||
- 方法名：小驼峰（camelCase）
|
||
- 常量：全大写下划线分隔
|
||
- 包名：全小写
|
||
|
||
- **注释规范**
|
||
- 类注释：说明类的功能、作者、日期
|
||
- 方法注释：说明参数、返回值、异常
|
||
- 关键逻辑注释：复杂算法说明
|
||
|
||
- **日志规范**
|
||
- ERROR：系统错误
|
||
- WARN：警告信息
|
||
- INFO：关键业务信息
|
||
- DEBUG：调试信息
|
||
|
||
### Git规范
|
||
- **分支管理**
|
||
- master：生产环境
|
||
- develop：开发环境
|
||
- feature/*：功能分支
|
||
- hotfix/*：紧急修复
|
||
|
||
- **提交规范**
|
||
- feat：新功能
|
||
- fix：修复bug
|
||
- docs：文档更新
|
||
- style：代码格式
|
||
- refactor：重构
|
||
- test：测试
|
||
- chore：构建/工具
|
||
|
||
### 数据库规范
|
||
- 表名：小写下划线分隔
|
||
- 字段名：小写下划线分隔
|
||
- 主键：id（自增）
|
||
- 创建时间：create_time
|
||
- 更新时间：update_time
|
||
- 逻辑删除：del_flag
|
||
|
||
---
|
||
|
||
## 🔮 未来规划
|
||
|
||
### 功能扩展
|
||
- [ ] 多租户支持
|
||
- [ ] 移动端原生App（Flutter）
|
||
- [ ] 微信小程序版本
|
||
- [ ] 视频咨询功能
|
||
- [ ] 在线预约系统
|
||
- [ ] 数据分析大屏
|
||
- [ ] 导出PDF报告
|
||
- [ ] 多语言支持
|
||
|
||
### 技术升级
|
||
- [ ] 升级Spring Boot 3.x
|
||
- [ ] 引入Spring Cloud微服务
|
||
- [ ] 使用Elasticsearch全文检索
|
||
- [ ] 引入消息队列（RabbitMQ/Kafka）
|
||
- [ ] 容器化部署（Docker/K8s）
|
||
- [ ] 前端升级Vue 3
|
||
- [ ] 引入TypeScript
|
||
- [ ] 使用GraphQL API
|
||
|
||
### AI能力增强
|
||
- [ ] 支持更多大模型（GPT、Claude等）
|
||
- [ ] 多模态分析（语音、图像）
|
||
- [ ] 情感分析
|
||
- [ ] 对话式测评
|
||
- [ ] 智能推荐量表
|
||
- [ ] 预测性分析
|
||
- [ ] 知识图谱构建
|
||
|
||
---
|
||
|
||
## 📞 联系方式
|
||
|
||
**开发团队**：DDNAI
|
||
**项目地址**：http://www.ddnai.com
|
||
**技术支持**：详见项目文档
|
||
|
||
---
|
||
|
||
## 📄 附录
|
||
|
||
### A. 常见问题
|
||
|
||
**Q1: 首次启动RAG服务很慢？**
|
||
A: 首次启动需要下载向量模型（约500MB），请耐心等待。模型会缓存到用户目录。
|
||
|
||
**Q2: Ollama连接失败？**
|
||
A: 检查Ollama服务是否启动，端口11434是否被占用，防火墙是否开放。
|
||
|
||
**Q3: 前端访问后端接口跨域？**
|
||
A: 开发环境使用vue.config.js代理，生产环境使用Nginx代理。
|
||
|
||
**Q4: 数据库连接失败？**
|
||
A: 检查数据库地址、端口、用户名、密码是否正确，数据库是否启动。
|
||
|
||
**Q5: App打包失败？**
|
||
A: 检查JDK版本（需要JDK 11），Android SDK是否安装，Gradle配置是否正确。
|
||
|
||
### B. 参考资料
|
||
|
||
- [Spring Boot官方文档](https://spring.io/projects/spring-boot)
|
||
- [Vue.js官方文档](https://vuejs.org/)
|
||
- [Element UI文档](https://element.eleme.io/)
|
||
- [MyBatis文档](https://mybatis.org/)
|
||
- [Ollama文档](https://ollama.ai/docs)
|
||
- [FAISS文档](https://github.com/facebookresearch/faiss)
|
||
- [Flask文档](https://flask.palletsprojects.com/)
|
||
|
||
### C. 更新日志
|
||
|
||
**v1.0.0 (2024-01-30)**
|
||
- 初始版本发布
|
||
- 完成核心功能开发
|
||
- 集成AI大模型和RAG知识库
|
||
- 支持Web端和Android端
|
||
|
||
---
|
||
|
||
**文档版本**：v1.0
|
||
**最后更新**：2026-01-30
|
||
**维护者**：DDNAI开发团队
|
||
|