优化cursor使用形式，增加项目文档过程管理，方便cursor生成代码

2025-06-28 09:48:53 +08:00
1 parent 2f7e1a9c16
commit 65d2d71469
@@ -0,0 +1,327 @@
+# 高校后勤满意度调查系统需求说明
+
+## 1. 项目概述
+
+### 1.1 项目背景
+
+为了持续改善高校后勤服务质量，提升师生满意度，需要建立一套完整的后勤满意度调查系统。该系统能够对各类后勤服务进行科学、规范的满意度调查，并为后勤管理决策提供数据支撑。
+
+### 1.2 项目目标
+
+-   建立统一的后勤满意度调查平台
+-   实现问题题库的标准化管理
+-   支持灵活的问卷组合和分发机制
+-   提供完整的调查数据分析和报告功能
+
+## 2. 系统功能需求
+
+### 2.1 题库管理功能
+
+#### 2.1.1 题目分类管理
+
+-   **功能描述**：对满意度调查题目进行分类管理
+-   **分类维度**：
+    -   寝室服务（宿舍设施、卫生清洁、安全管理等）
+    -   食堂服务（菜品质量、价格、卫生环境等）
+    -   环境服务（校园绿化、道路维护、垃圾处理等）
+    -   维修服务（设备维修、响应时间、服务态度等）
+    -   保安服务（校园安全、门禁管理、巡逻质量等）
+    -   其他服务（可扩展分类）
+
+#### 2.1.2 题目内容管理
+
+-   **功能描述**：统一管理调查题目的内容和选项
+-   **题目结构**：
+    -   题目编号（自动生成）
+    -   题目内容（必填，支持富文本）
+    -   所属分类（必选）
+    -   题目状态（启用/禁用）
+    -   创建时间和创建人
+    -   修改时间和修改人
+
+#### 2.1.3 评分标准管理
+
+-   **统一评分标准**：
+    -   非常满意：5 分
+    -   满意：3 分
+    -   一般：1 分
+    -   不满意：0 分
+-   **功能要求**：
+    -   系统统一使用该评分标准
+    -   支持评分标准的配置和修改
+    -   历史数据保持评分标准的一致性
+
+### 2.2 问卷管理功能
+
+#### 2.2.1 问卷创建
+
+-   **功能描述**：从题库中自由选择题目组合成调查问卷
+-   **创建流程**：
+    1. 填写问卷基本信息（名称、描述、目标群体等）
+    2. 从题库中按分类选择题目
+    3. 设置题目顺序和权重
+    4. 配置问卷有效期
+    5. 预览问卷效果
+    6. 保存问卷
+
+#### 2.2.2 问卷配置
+
+-   **基本信息配置**：
+
+    -   问卷名称（必填）
+    -   问卷描述（可选）
+    -   调查说明（可选）
+    -   创建人信息
+    -   创建时间
+
+-   **目标群体配置**：
+
+    -   学生群体（本科生、研究生、博士生等）
+    -   教职工群体（教师、行政人员、工勤人员等）
+    -   支持多群体同时选择
+
+-   **有效期配置**：
+    -   开始时间（必填）
+    -   结束时间（必填）
+    -   超过有效期自动停止收集
+
+#### 2.2.3 问卷分发管理
+
+-   **分发方式**：
+
+    -   按用户群体推送
+    -   生成问卷链接分享
+    -   系统内消息通知
+    -   邮件推送（可选）
+
+-   **分发控制**：
+    -   设置参与人员范围
+    -   控制填写次数（一人一次/允许多次）
+    -   匿名填写设置
+    -   实时监控填写进度
+
+### 2.3 调查填写功能
+
+#### 2.3.1 用户身份验证
+
+-   **登录验证**：通过统一身份认证系统登录
+-   **身份识别**：自动识别用户类型（学生/教职工）
+-   **权限控制**：仅允许目标群体填写对应问卷
+
+#### 2.3.2 问卷填写界面
+
+-   **界面要求**：
+
+    -   简洁清晰的用户界面
+    -   响应式设计，支持移动端
+    -   题目分页显示，避免页面过长
+    -   实时保存，防止数据丢失
+
+-   **填写体验**：
+    -   显示填写进度
+    -   支持暂存和继续填写
+    -   必填题目验证
+    -   提交前确认机制
+
+#### 2.3.3 有效期控制
+
+-   **时间检查**：
+
+    -   填写前检查问卷有效期
+    -   填写过程中实时监控有效期
+    -   超时自动提示并禁止提交
+
+-   **用户提示**：
+    -   清晰显示问卷有效期信息
+    -   临近截止时间提醒
+    -   超时后显示相应提示信息
+
+### 2.4 数据统计分析功能
+
+#### 2.4.1 基础统计
+
+-   **参与情况统计**：
+
+    -   问卷发放数量
+    -   实际填写数量
+    -   填写完成率
+    -   各群体参与情况
+
+-   **分数统计**：
+
+    -   总体满意度得分
+    -   各分类满意度得分
+    -   各题目满意度得分
+    -   满意度排名分析
+
+-   **问题类别统计分析**：
+    -   按寝室服务类别统计平均分值
+    -   按食堂服务类别统计平均分值
+    -   按环境服务类别统计平均分值
+    -   按维修服务类别统计平均分值
+    -   按保安服务类别统计平均分值
+    -   按其他服务类别统计平均分值
+    -   各类别满意度排行榜
+    -   类别间满意度对比分析
+
+#### 2.4.2 数据分析
+
+-   **趋势分析**：
+
+    -   满意度变化趋势
+    -   同期对比分析
+    -   各服务类别对比分析
+
+-   **群体分析**：
+
+    -   学生群体满意度分析
+    -   教职工群体满意度分析
+    -   不同群体满意度对比
+
+-   **问题类别深度分析**：
+    -   各类别满意度分值分布图
+    -   类别满意度变化趋势对比
+    -   不同群体对各类别的满意度差异
+    -   问题类别的改进优先级排序
+    -   各类别内部题目满意度排名
+
+#### 2.4.3 报告生成
+
+-   **统计报告**：
+
+    -   自动生成调查统计报告
+    -   支持多种图表展示
+    -   导出 Word/PDF 格式报告
+
+-   **问题分析**：
+
+    -   低满意度问题识别
+    -   改进建议生成
+    -   问题追踪记录
+
+-   **类别专项报告**：
+    -   生成各问题类别的专项分析报告
+    -   类别满意度排行榜报告
+    -   各类别改进建议和行动计划
+    -   类别间对比分析报告
+    -   支持按类别导出专项报告
+
+## 3. 系统非功能需求
+
+### 3.1 性能要求
+
+-   **响应时间**：页面加载时间不超过 3 秒
+-   **并发处理**：支持 1000 人同时在线填写
+-   **数据处理**：大量问卷数据的快速统计分析
+
+### 3.2 安全要求
+
+-   **数据安全**：调查数据加密存储
+-   **访问控制**：基于角色的权限管理
+-   **隐私保护**：支持匿名调查模式
+
+### 3.3 可用性要求
+
+-   **系统可用性**：7×24 小时稳定运行
+-   **界面友好**：简洁直观的操作界面
+-   **多端适配**：支持 PC 端和移动端访问
+
+### 3.4 扩展性要求
+
+-   **题目扩展**：支持新增题目分类和评分标准
+-   **功能扩展**：预留其他调查类型的扩展接口
+-   **数据扩展**：支持大数据量的存储和处理
+
+## 4. 系统架构设计
+
+### 4.1 技术架构
+
+-   **前端技术**：Vue 3 + Element Plus + TypeScript
+-   **后端技术**：Spring Boot + MyBatis Plus + MySQL
+-   **缓存技术**：Redis
+-   **认证授权**：Sa-Token
+
+### 4.2 数据库设计要点
+
+#### 4.2.1 核心表结构
+
+-   **题库表（hq_question）**：存储调查题目信息
+-   **分类表（hq_category）**：存储题目分类信息
+-   **问卷表（hq_survey）**：存储问卷基本信息
+-   **问卷题目关联表（hq_survey_question）**：问卷与题目的关联关系
+-   **答题记录表（hq_answer_record）**：存储用户答题记录
+-   **答题详情表（hq_answer_detail）**：存储具体答题内容
+
+#### 4.2.2 字段设计规范
+
+-   所有表包含基础字段：id、create_time、update_time、create_by、update_by
+-   支持逻辑删除：deleted 字段
+-   关键字段添加索引，提升查询性能
+
+### 4.3 接口设计规范
+
+-   遵循 RESTful API 设计规范
+-   统一的响应格式和错误码
+-   完整的接口文档（Swagger）
+-   接口权限控制和参数校验
+
+## 5. 开发计划
+
+### 5.1 开发阶段
+
+1. **第一阶段**：题库管理和问卷管理功能开发
+2. **第二阶段**：调查填写和有效期控制功能开发
+3. **第三阶段**：数据统计分析和报告生成功能开发
+4. **第四阶段**：系统测试和优化
+
+### 5.2 预期时间
+
+-   **开发周期**：预计 4-6 周
+-   **测试周期**：预计 1-2 周
+-   **部署上线**：预计 1 周
+
+## 6. 验收标准
+
+### 6.1 功能验收
+
+-   所有功能模块正常运行
+-   用户操作流程完整顺畅
+-   数据统计分析准确无误
+
+### 6.2 性能验收
+
+-   满足性能要求指标
+-   并发测试通过
+-   稳定性测试通过
+
+### 6.3 安全验收
+
+-   权限控制有效
+-   数据安全可靠
+-   隐私保护到位
+
+## 7. 后期维护
+
+### 7.1 功能优化
+
+-   根据使用反馈持续优化用户体验
+-   扩展更多调查类型和分析维度
+-   增加移动端专属功能
+
+### 7.2 数据管理
+
+-   定期备份调查数据
+-   历史数据归档管理
+-   数据清理和优化
+
+### 7.3 系统升级
+
+-   定期更新系统版本
+-   修复安全漏洞
+-   优化系统性能
+
+---
+
+**文档版本**：v1.0  
+**创建日期**：2025 年 1 月  
+**更新日期**：2025 年 1 月