xinli/z_Project change/2-开发任务清单.md

心理测评系统开发任务清单

快速开始

• ✅ 第一阶段已完成：数据库设计、量表管理
• ✅ 第二阶段已完成：题目、因子、测评执行、报告生成（核心功能100%完成）
• ✅ 第三阶段D3-1已完成：用户档案管理模块
• ✅ 第三阶段D3-2已完成：自定义问卷基础功能
• 🎉 当前进度：第三阶段进行中

---

📋 任务分解

第一阶段：数据库设计与初始化（2天）✅ 已完成

D1-1: 完善数据库表结构 ✅

• 创建 psy_user_profile 用户档案扩展表
• 创建 psy_scale_permission 量表权限表
• 创建 psy_questionnaire 问卷功能表
• 创建 psy_voice_config 语音读题表
• 创建 psy_warning 危机预警表
• 创建 psy_qrcode 二维码管理表
• 创建 sys_backup 数据备份表
• 创建 psy_website_content 心理网站内容表
• 创建 sys_api_config 开放式API配置表
• 完善 psy_assessment_system.sql 脚本
• 生成数据库索引优化

D1-2: 初始化量表数据 🟡 部分完成

• 设计量表数据导入脚本
• 录入COPA系列量表（示例数据）
  • COPA-SAI ✅
  • COPA-PI（等用户导入）
  • COPA-TCMI（等用户导入）
  • COPA-SCMI（等用户导入）
  • COPA-MPI（等用户导入）
  • 罪犯暴力倾向量表（等用户导入）
  • 罪犯自杀倾向量表（等用户导入）
• 录入经典心理量表（50+）等用户导入
• 配置每题选项和计分规则（等用户导入）
• 设置因子计分规则（等用户导入）
• 配置结果解释标准（等用户导入）

---

第二阶段：核心功能模块开发（8天）

D2-1: 量表管理模块 ✅ 已完成

后端

• PsyScale 实体类
• PsyScaleMapper 接口
• PsyScaleServiceImpl 实现
• PsyScaleController 控制器
• Excel导入导出功能（待开发）

前端

• views/psychology/scale/index.vue 列表页
• 表单功能（已集成在列表页）
• api/psychology/scale.js API接口

D2-2: 题目与选项管理 ✅ 已完成

后端

• PsyScaleItem / PsyScaleOption 实体类
• PsyScaleItemMapper / PsyScaleOptionMapper
• PsyScaleItemServiceImpl / PsyScaleOptionServiceImpl
• PsyScaleItemController / PsyScaleOptionController

前端

• 题目管理页面 views/psychology/scale/item.vue
• 选项配置界面（弹窗）
• 批量导入功能（待开发）

D2-3: 因子与计分规则 ✅ 已完成

后端

• PsyFactor / PsyFactorRule 实体类
• PsyFactorMapper / PsyFactorRuleMapper
• PsyFactorServiceImpl / PsyFactorRuleServiceImpl
• PsyFactorController / PsyFactorRuleController
• 计分公式计算引擎（待开发）

前端

• 因子配置页面 views/psychology/scale/factor.vue
• 公式编辑器（待开发）

D2-4: 测评执行模块 ⭐ ✅ 已完成

后端

• PsyAssessment / PsyAssessmentAnswer 实体类
• PsyAssessmentMapper / PsyAssessmentAnswerMapper
• PsyAssessmentServiceImpl
• PsyAssessmentController
  • 开始测评接口
  • 获取题目接口
  • 保存答案接口
  • 暂停测评接口
  • 恢复测评接口
  • 提交测评接口 ✅（包含计分逻辑）
• 自动计分服务 ✅（已集成到提交接口）

前端

• 测评页面 views/psychology/assessment/index.vue
• 答题界面（单选/多选/矩阵）
• 进度条组件
• 暂停/恢复按钮

D2-5: 语音读题功能 ⭐

后端

• PsyVoiceConfig 实体类
• 语音配置管理接口
• TTS集成（阿里云/腾讯云）
• 预录音频管理

前端

• 音频播放组件
• 自动播放开关
• 进度控制

D2-6: 测评报告生成 ✅ 已完成

后端

• PsyAssessmentReport 实体类
• PsyResultInterpretation 实体类
• PsyReportServiceImpl ✅
• PsyReportController ✅
• 报告自动生成服务 ✅（核心算法已实现）
• PDF生成功能（预留，非核心）

前端

• 报告展示页面
• 报告编辑功能（富文本）
• PDF预览/下载（预留）

D2-7: 危机预警模块 ⭐

后端

• PsyWarning 实体类
• PsyWarningMapper
• PsyWarningServiceImpl
• PsyWarningController
• 自动预警检测服务
• 预警通知服务

前端

• 预警规则配置页面
• 预警记录列表
• 预警详情查看

---

第三阶段：扩展功能开发（6天）

D3-1: 用户档案管理 ⭐ ✅ 已完成

后端

• PsyUserProfile 实体类 ✅
• PsyUserProfileMapper ✅
• PsyUserProfileServiceImpl ✅
• PsyUserProfileController ✅
• 档案模板配置功能（可选，后续开发）

前端

• 档案管理页面 ✅
• 自定义字段配置 ✅（JSON格式支持）
• 批量导入功能（可选，后续开发）

菜单配置

• 用户档案管理菜单 ✅
• 菜单权限配置 ✅

D3-2: 自定义问卷模块 ⭐ ✅ 基础功能已完成

后端

• PsyQuestionnaire 实体类 ✅
• PsyQuestionnaireItem 实体类 ✅
• PsyQuestionnaireAnswer 实体类 ✅
• PsyQuestionnaireMapper ✅
• PsyQuestionnaireServiceImpl ✅
• PsyQuestionnaireController ✅
• 多种题目类型支持（基础CRUD已完成，待扩展）
• 自动计分（客观题）服务
• 成绩排名统计服务

前端

• 问卷列表和编辑页面 ✅
• 题目管理页面（待开发）
• 题目类型选择器（8种类型）
• 答题页面
• 成绩统计图表

菜单配置

• 自定义问卷菜单 ✅
• 菜单权限配置 ✅

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