优化cursor使用形式,增加项目文档过程管理,方便cursor生成代码
This commit is contained in:
1 parent
2f7e1a9c16
commit
65d2d71469
36 files changed
+8872
-1530
No files matched your search
@@ -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 月
|
||||
Reference in new issue
Block a user