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

This commit is contained in:
zlwu committed 2025-06-28 09:48:53 +08:00
1 parent 2f7e1a9c16
commit 65d2d71469
36 files changed
+8872 -1530

No files matched your search

+73
View File
@@ -0,0 +1,73 @@
# 需求文档目录
## 目录说明
此目录用于存放项目的需求相关文档,包括:
## 1. 功能需求文档
`功能需求文档`:详细的功能需求描述,明确系统应该具备的功能
### 已有需求文档:
- **后勤满意度调查系统需求说明.md**:完整的满意度调查系统需求描述
- **简化版报告厅预约系统设计说明.md**:报告厅预约系统的简化设计方案
## 2. 业务流程文档
`业务流程文档`:描述系统的业务流程和操作规范
### 待添加文档:
- 用户管理业务流程
- 权限管理业务流程
- 多租户管理业务流程
- 工作流业务流程
## 3. 原型设计文档
`原型设计文档`:UI 原型和交互设计文档
### 目录结构:
- mockups/ - 原型设计文件
- wireframes/ - 线框图
- user-stories/ - 用户故事
## 4. 业务规则文档
`业务规则文档`:详细的业务规则和约束条件
### 待添加文档:
- 数据权限规则
- 多租户规则
- 审核流程规则
## 文档管理规范
### 文档命名规范
- 使用中文描述性名称
- 按模块分组存放
- 版本控制格式:v1.0、v1.1 等
### 文档内容规范
- 明确的需求描述
- 详细的业务流程
- 清晰的验收标准
- 完整的用例描述
### 更新维护
- 需求变更时及时更新文档
- 保留历史版本记录
- 定期 review 文档内容
## 注意事项
1. 所有需求变更必须更新相关文档
2. 新功能开发前必须先编写需求文档
3. 需求文档需要经过需求方确认
4. 文档格式统一使用 Markdown
@@ -0,0 +1,94 @@
# 简化版报告厅预约系统数据模型设计
## 设计目标
根据您的需求,设计一个简单实用的报告厅预约系统,包含报告厅管理、预约申请和审核功能。
## 数据表设计
### 1. 报告厅信息表 (`hall_info`)
**主要功能**: 管理报告厅基本信息
**字段说明**:
- **标准字段**: 按要求包含 `id`、`tenant_id`、`create_dept`、`create_by`、`create_time`、`update_by`、`update_time`
- **业务字段**:
- `hall_name`: 报告厅名称
- `hall_image`: 报告厅图片 URL(多个图片用逗号分隔)
- `hall_status`: 报告厅状态(0-不可用,1-可用)
- `hall_description`: 报告厅描述
### 2. 报告厅预约表 (`hall_reservation`)
**主要功能**: 管理预约申请和审核流程
**字段说明**:
- **标准字段**: 按要求包含 `id`、`tenant_id`、`create_dept`、`create_by`、`create_time`、`update_by`、`update_time`
- **预约信息**:
- `hall_id`: 关联报告厅 ID
- `reservation_date`: 预约日期
- `start_time`、`end_time`: 预约时间段
- `reservation_purpose`: 预约用途
- `applicant_name`、`applicant_phone`: 申请人信息
- **审核信息**:
- `status`: 预约状态(0-待审核,1-预约成功,2-预约失败)
- `audit_by`: 审核人 id
- `audit_name`: 审核人
- `audit_time`: 审核时间
- `audit_remark`: 审核备注
## 核心功能流程
### 1. 报告厅管理
- 添加/编辑报告厅信息(名称、图片、描述)
- 设置报告厅状态(可用/不可用)
- 查看报告厅列表
### 2. 预约申请
- 用户选择可用的报告厅
- 填写预约信息(日期、时间、用途、联系方式)
- 提交后状态为"待审核"
### 3. 预约审核
- 管理员查看待审核的预约申请
- 点击通过:状态改为"预约成功"
- 点击驳回:状态改为"预约失败",可填写审核备注
## 设计特点
### 简化原则
- 只包含核心必需字段,避免复杂功能
- 一个预约对应一次审核,不支持多级审核
- 状态简单明确,便于业务理解
### 扩展性考虑
- 预留了租户字段,支持多租户
- 审核备注字段支持记录审核原因
- 外键约束保证数据完整性
### 数据完整性
- 主键自增,保证唯一性
- 外键约束确保预约表与报告厅表的关联
- 必填字段设置 NOT NULL 约束
- 合理的索引设计提高查询效率
## 示例数据
文件中包含了示例数据,展示了:
- 3 个不同状态的报告厅
- 3 个不同审核状态的预约记录
## 使用说明
1. 执行 `simple_hall_reservation_schema.sql` 创建数据表
2. 示例数据会自动插入,便于测试
3. 可根据实际需求调整字段长度和约束
@@ -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 月