xinli/z_Project change/2-开发任务清单.md
xiao@123.123 fdf83af45a xiao
2025-11-03 18:21:32 +08:00

387 lines
10 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# 心理测评系统开发任务清单
## 快速开始
- ✅ 第一阶段已完成:数据库设计、量表管理
- ✅ 第二阶段已完成题目、因子、测评执行、报告生成核心功能100%完成)
- ✅ 第三阶段D3-1已完成用户档案管理模块
- ✅ 第三阶段D3-2已完成自定义问卷基础功能
- 🎉 当前进度:第三阶段进行中
---
## 📋 任务分解
### 第一阶段数据库设计与初始化2天✅ 已完成
#### D1-1: 完善数据库表结构 ✅
- [x] 创建 `psy_user_profile` 用户档案扩展表
- [x] 创建 `psy_scale_permission` 量表权限表
- [x] 创建 `psy_questionnaire` 问卷功能表
- [x] 创建 `psy_voice_config` 语音读题表
- [x] 创建 `psy_warning` 危机预警表
- [x] 创建 `psy_qrcode` 二维码管理表
- [x] 创建 `sys_backup` 数据备份表
- [x] 创建 `psy_website_content` 心理网站内容表
- [x] 创建 `sys_api_config` 开放式API配置表
- [x] 完善 `psy_assessment_system.sql` 脚本
- [x] 生成数据库索引优化
#### D1-2: 初始化量表数据 🟡 部分完成
- [x] 设计量表数据导入脚本
- [x] 录入COPA系列量表示例数据
- [x] COPA-SAI ✅
- [ ] COPA-PI等用户导入
- [ ] COPA-TCMI等用户导入
- [ ] COPA-SCMI等用户导入
- [ ] COPA-MPI等用户导入
- [ ] 罪犯暴力倾向量表(等用户导入)
- [ ] 罪犯自杀倾向量表(等用户导入)
- [ ] 录入经典心理量表50+)等用户导入
- [ ] 配置每题选项和计分规则(等用户导入)
- [ ] 设置因子计分规则(等用户导入)
- [ ] 配置结果解释标准(等用户导入)
---
### 第二阶段核心功能模块开发8天
#### D2-1: 量表管理模块 ✅ 已完成
**后端**
- [x] `PsyScale` 实体类
- [x] `PsyScaleMapper` 接口
- [x] `PsyScaleServiceImpl` 实现
- [x] `PsyScaleController` 控制器
- [ ] Excel导入导出功能待开发
**前端**
- [x] `views/psychology/scale/index.vue` 列表页
- [x] 表单功能(已集成在列表页)
- [x] `api/psychology/scale.js` API接口
#### D2-2: 题目与选项管理 ✅ 已完成
**后端**
- [x] `PsyScaleItem` / `PsyScaleOption` 实体类
- [x] `PsyScaleItemMapper` / `PsyScaleOptionMapper`
- [x] `PsyScaleItemServiceImpl` / `PsyScaleOptionServiceImpl`
- [x] `PsyScaleItemController` / `PsyScaleOptionController`
**前端**
- [x] 题目管理页面 `views/psychology/scale/item.vue`
- [x] 选项配置界面(弹窗)
- [ ] 批量导入功能(待开发)
#### D2-3: 因子与计分规则 ✅ 已完成
**后端**
- [x] `PsyFactor` / `PsyFactorRule` 实体类
- [x] `PsyFactorMapper` / `PsyFactorRuleMapper`
- [x] `PsyFactorServiceImpl` / `PsyFactorRuleServiceImpl`
- [x] `PsyFactorController` / `PsyFactorRuleController`
- [ ] 计分公式计算引擎(待开发)
**前端**
- [x] 因子配置页面 `views/psychology/scale/factor.vue`
- [ ] 公式编辑器(待开发)
#### D2-4: 测评执行模块 ⭐ ✅ 已完成
**后端**
- [x] `PsyAssessment` / `PsyAssessmentAnswer` 实体类
- [x] `PsyAssessmentMapper` / `PsyAssessmentAnswerMapper`
- [x] `PsyAssessmentServiceImpl`
- [x] `PsyAssessmentController`
- [x] 开始测评接口
- [x] 获取题目接口
- [x] 保存答案接口
- [x] **暂停测评接口**
- [x] **恢复测评接口**
- [x] 提交测评接口 ✅(包含计分逻辑)
- [x] 自动计分服务 ✅(已集成到提交接口)
**前端**
- [x] 测评页面 `views/psychology/assessment/index.vue`
- [x] 答题界面(单选/多选/矩阵)
- [x] 进度条组件
- [x] 暂停/恢复按钮
#### D2-5: 语音读题功能 ⭐
**后端**
- [ ] `PsyVoiceConfig` 实体类
- [ ] 语音配置管理接口
- [ ] TTS集成阿里云/腾讯云)
- [ ] 预录音频管理
**前端**
- [ ] 音频播放组件
- [ ] 自动播放开关
- [ ] 进度控制
#### D2-6: 测评报告生成 ✅ 已完成
**后端**
- [x] `PsyAssessmentReport` 实体类
- [x] `PsyResultInterpretation` 实体类
- [x] `PsyReportServiceImpl`
- [x] `PsyReportController`
- [x] 报告自动生成服务 ✅(核心算法已实现)
- [ ] PDF生成功能预留非核心
**前端**
- [x] 报告展示页面
- [x] 报告编辑功能(富文本)
- [x] PDF预览/下载(预留)
#### D2-7: 危机预警模块 ⭐
**后端**
- [ ] `PsyWarning` 实体类
- [ ] `PsyWarningMapper`
- [ ] `PsyWarningServiceImpl`
- [ ] `PsyWarningController`
- [ ] 自动预警检测服务
- [ ] 预警通知服务
**前端**
- [ ] 预警规则配置页面
- [ ] 预警记录列表
- [ ] 预警详情查看
---
### 第三阶段扩展功能开发6天
#### D3-1: 用户档案管理 ⭐ ✅ 已完成
**后端**
- [x] `PsyUserProfile` 实体类 ✅
- [x] `PsyUserProfileMapper`
- [x] `PsyUserProfileServiceImpl`
- [x] `PsyUserProfileController`
- [ ] 档案模板配置功能(可选,后续开发)
**前端**
- [x] 档案管理页面 ✅
- [x] 自定义字段配置 ✅JSON格式支持
- [ ] 批量导入功能(可选,后续开发)
**菜单配置**
- [x] 用户档案管理菜单 ✅
- [x] 菜单权限配置 ✅
#### D3-2: 自定义问卷模块 ⭐ ✅ 基础功能已完成
**后端**
- [x] `PsyQuestionnaire` 实体类 ✅
- [x] `PsyQuestionnaireItem` 实体类 ✅
- [x] `PsyQuestionnaireAnswer` 实体类 ✅
- [x] `PsyQuestionnaireMapper`
- [x] `PsyQuestionnaireServiceImpl`
- [x] `PsyQuestionnaireController`
- [ ] 多种题目类型支持基础CRUD已完成待扩展
- [ ] 自动计分(客观题)服务
- [ ] 成绩排名统计服务
**前端**
- [x] 问卷列表和编辑页面 ✅
- [ ] 题目管理页面(待开发)
- [ ] 题目类型选择器8种类型
- [ ] 答题页面
- [ ] 成绩统计图表
**菜单配置**
- [x] 自定义问卷菜单 ✅
- [x] 菜单权限配置 ✅
#### D3-3: 二维码功能 ⭐
**后端**
- [ ] `PsyQrcode` 实体类
- [ ] `PsyQrcodeMapper`
- [ ] `PsyQrcodeServiceImpl`
- [ ] `PsyQrcodeController`
- [ ] 二维码生成服务
**前端**
- [ ] 二维码生成/展示
- [ ] 扫码页面(移动端适配)
#### D3-4: 心理网站模块 ⭐
**后端**
- [ ] `PsyWebsiteContent` 实体类
- [ ] `PsyWebsiteMapper`
- [ ] `PsyWebsiteServiceImpl`
- [ ] `PsyWebsiteController`
- [ ] 文章CRUD接口
- [ ] 栏目管理接口
**前端**
- [ ] 网站模板
- [ ] 前台展示页面
- [ ] 后台管理页面
#### D3-5: 数据统计模块
**后端**
- [ ] `PsyStatisticsController`
- [ ] 团体统计接口
- [ ] 个体统计接口
- [ ] 测评轨迹接口
- [ ] 因子趋势分析
**前端**
- [ ] 统计图表ECharts
- [ ] 数据导出功能
#### D3-6: 权限与批量管理
**后端**
- [ ] 量表权限配置接口
- [ ] 批量权限设置接口
- [ ] 注册用户权限预定义
---
### 第四阶段系统集成与接口3天
#### D4-1: 开放式API接口
**后端**
- [ ] `ApiController` 公共API入口
- [ ] API密钥验证拦截器
- [ ] 用户同步接口
- [ ] 测评结果推送接口
- [ ] 获取量表列表接口
- [ ] API文档Swagger
#### D4-2: 数据备份与还原
**后端**
- [ ] `BackupController`
- [ ] 一键备份功能
- [ ] 备份下载功能
- [ ] 一键还原功能
- [ ] 定时任务配置
#### D4-3: 单机/网络模式切换
**配置**
- [ ] 配置文件管理
- [ ] 数据库连接池配置
- [ ] 网络检测功能
---
### 第五阶段前端UI优化4天
#### D5-1: 管理后台界面
- [ ] 量表管理页面优化
- [ ] 题目编辑页面优化
- [ ] 测评记录页面优化
- [ ] 统计报表页面
- [ ] 系统配置页面
- [ ] 题目编辑器组件优化
- [ ] 计分规则配置器优化
- [ ] 报告编辑器优化
- [ ] 二维码生成器优化
#### D5-2: 移动端适配 ⭐
- [ ] 响应式布局实现
- [ ] 触屏优化
- [ ] 扫码功能测试
- [ ] 语音播放优化
#### D5-3: 用户体验优化
- [ ] 加载动画
- [ ] 错误提示优化
- [ ] 快捷键支持
- [ ] 无感知自动保存
---
### 第六阶段测试与优化3天
#### D6-1: 功能测试
- [ ] 量表管理测试
- [ ] 测评流程测试(开始-答题-暂停-恢复-提交)
- [ ] 报告生成测试
- [ ] 预警功能测试
- [ ] 二维码功能测试
- [ ] 语音读题测试
#### D6-2: 性能测试
- [ ] 并发测评压力测试目标1000+并发)
- [ ] 数据库查询优化
- [ ] Redis缓存策略
- [ ] 接口响应优化(目标<200ms
#### D6-3: Bug修复
- [ ] 修复测试发现的问题
- [ ] 代码review
- [ ] 安全漏洞检查
---
### 第七阶段部署与文档2天
#### D7-1: 部署准备
- [ ] 生产环境配置
- [ ] 数据库初始化脚本检查
- [ ] Nginx配置
- [ ] SSL证书配置
- [ ] 环境变量配置
#### D7-2: 文档编写
- [ ] 系统使用手册
- [ ] API接口文档
- [ ] 运维文档
- [ ] 常见问题FAQ
- [ ] 数据库ER图
- [ ] 系统架构图
---
## 🎯 关键里程碑
- **M1** (第2天): 数据库设计完成必填量表导入
- **M2** (第10天): 核心功能可用测评流程打通
- **M3** (第16天): 扩展功能完成
- **M4** (第19天): API接口对外开放
- **M5** (第23天): 前端界面完善
- **M6** (第26天): 系统测试通过
- **M7** (第28天): 正式上线
---
## 📊 进度跟踪
**开发进度**第三阶段进行中
**当前阶段**第三阶段扩展功能开发中D3-1已完成
**已完成**
- 数据库设计27张表
- 量表管理模块CRUD完整
- 题目管理模块CRUD完整
- 选项管理功能完整
- 因子管理模块CRUD完整
- 计分规则管理功能完整
- 测评执行模块完整包含计分
- 答题界面单选/多选/矩阵
- 暂停/恢复功能
- 提交测评和自动计分
- 报告自动生成
- 因子得分计算
- 结果解释匹配
- 菜单配置与权限
- 可在浏览器正常运行
- 用户档案管理模块
- 自定义问卷基础功能
**下一步**继续第三阶段其他模块开发D3-3二维码D3-4心理网站等
---
## ⚠️ 注意事项
1. 每个功能开发完成后需要立即测试
2. 关键功能标注⭐)优先开发
3. 代码规范遵循现有RuoYi框架规范
4. 所有接口需要记录API文档
5. 数据库变更需要更新SQL脚本
6. 前端页面需要适配移动端
7. 性能测试数据需要记录
---
**创建时间**: 2025-11-01
**最后更新**: 2025-11-01