# 心理测评系统开发文档

## 📁 文档结构说明

本目录包含心理测评系统开发过程中的所有计划和文档。

---

## 📚 核心文档

### 需求与计划
- **0-需求.md**：系统功能需求
- **0-要求.md**：技术要求和约束
- **1-开发计划.md**：28天7阶段完整开发计划
- **2-开发任务清单.md**：详细任务分解（当前55%完成）
- **3-技术架构设计.md**：技术架构说明

### 进度总结
- **000/000-第一次项目进度总结.md**：第一阶段总结
- **000/001-快速启动指南.md**：快速启动说明
- **000/002-第二阶段开发说明.md**：题目管理开发
- **000/003-第二阶段完成总结.md**：题目管理完成
- **000/004-完整部署指南.md**：完整部署步骤

### 问题解决
- **000/005-修复菜单404问题-立即执行.md**：**菜单404问题修复指南（关键！）**

### 其他
- **4-第一阶段.md**：第一阶段概述
- **0-代码生成器使用说明.md**：代码生成器使用

---

## 🎯 当前状态

### 已完成（55%）
✅ 数据库设计（27张表）
✅ 量表管理（CRUD）
✅ 题目管理（CRUD）
✅ 选项管理（CRUD）
✅ 因子管理（CRUD）
✅ 计分规则管理
✅ 测评执行（开始、答题、暂停、恢复）
✅ 答题界面（单选/多选/矩阵）
✅ 菜单配置
✅ 可在浏览器运行

### 待开发（45%）
⏳ 提交测评和自动计分
⏳ 测评报告生成
⏳ 因子得分计算
⏳ 危机预警功能
⏳ 语音读题功能
⏳ 统计分析功能
⏳ 其他扩展功能

---

## 🚀 快速开始

### 1. 数据库配置
```sql
-- 执行数据库脚本
source sql/psy_assessment_system.sql
source sql/psy_assessment_system_extension.sql
source sql/psy_assessment_system_patch.sql
source sql/psy_menu_all_config.sql
```

### 2. 权限配置
- 登录系统（admin/admin123）
- 进入：系统管理 → 角色管理
- 分配"心理测评管理"权限

### 3. 验证功能
- 量表管理：新增、修改、删除量表
- 题目管理：添加题目和选项
- 因子管理：配置因子和计分规则
- 测评执行：开始测评、答题、暂停、恢复

---

## 📖 使用文档

### 功能使用指南
- **快速启动指南**：000/001-快速启动指南.md
- **完整部署指南**：000/004-完整部署指南.md
- **问题解决**：问题解决-菜单配置.md

### 开发计划
- **整体计划**：1-开发计划.md
- **任务清单**：2-开发任务清单.md
- **技术架构**：3-技术架构设计.md

### 功能完成情况
- **题目管理**：7-第二阶段-题目管理完成总结.md
- **因子管理**：8-因子管理模块完成总结.md
- **测评执行**：10-测评执行模块完成总结.md

---

## 🔗 相关SQL文件

### 数据库脚本
- `sql/psy_assessment_system.sql`：核心表（11张）
- `sql/psy_assessment_system_extension.sql`：扩展表（16张）
- `sql/psy_assessment_system_patch.sql`：暂停功能补丁
- `sql/psy_scale_init_data.sql`：示例数据（可选）

### 菜单配置
- `sql/psy_menu_all_config.sql`：**一键完整配置**（推荐）
- `sql/psy_menu_config_fixed.sql`：量表管理菜单
- `sql/psy_menu_item_config.sql`：题目管理菜单
- `sql/psy_menu_factor_config.sql`：因子管理菜单
- `sql/psy_menu_assessment_config.sql`：测评管理菜单

---

## 💡 开发建议

### 下一步优先
1. **提交和计分功能**（核心）
2. **测评报告生成**（重要）
3. **统计分析功能**（有用）
4. **其他扩展功能**（可选）

### 代码规范
- 遵循RuoYi框架规范
- 使用代码生成器（如需要）
- 保持代码风格一致
- 做好注释和文档

---

## ❓ 常见问题

详见各功能完成总结文档中的"注意事项"和"问题解决"部分。

---

**最后更新**：2025-11-01