xinli/z_Project change/README.md

143 lines
3.7 KiB
Markdown
Raw Normal View History

2025-11-03 18:21:32 +08:00
# 心理测评系统开发文档
## 📁 文档结构说明
本目录包含心理测评系统开发过程中的所有计划和文档。
---
## 📚 核心文档
### 需求与计划
- **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