Files
hzdyjs/docs/业务模块/venue-reservation
zlwu 28232d5d46 feat: 移动端开发规范重大更新
- 🔥 完全重写 .cursor/cursorrules-mobile.md (940行)
  * 基于实际mobile工程Vue 3.4.21+uniapp+uview-plus架构
  * 移除所有JeeSite相关内容,精准匹配实际项目
  * 新增11个完整章节:技术栈、项目结构、页面开发、组件规范等

- 📚 创建完整规范文档 docs/开发文档/移动端开发规范总结.md (800+行)
  * 涵盖从项目架构到部署的全流程指导
  * 提供可直接使用的页面和组件模板
  * 包含现代CSS变量设计系统和用户体验优化

- 🔄 同步更新主配置文件 .cursorrules
  * 更新移动端技术栈描述
  * 调整为Vue 3.4.21+uniapp+uview-plus 3.4.45架构

- 📝 完善变更记录
  * 详细记录规范更新背景和技术价值
  * 为后续维护提供完整历史记录

核心价值:解决规范与实际项目不匹配问题,为Cursor AI提供准确的移动端开发上下文,确保生成代码完全符合实际项目架构。
2025-07-04 15:51:33 +08:00
..

场地预约管理模块

📖 模块概述

模块名称: 场地预约管理
模块编码: venue-reservation
所属系统: 后勤管理系统
开发状态: 需求设计完成,待开发

🎯 模块功能

核心功能

  • 场地管理: 场地信息维护、场地管理员设置、场地状态管理
  • 预约申请: 用户自助预约申请、时间冲突检测、预约信息管理
  • 预约审批: 场地管理员审批、审批流程管理、权限控制
  • 统计报表: 场地使用率统计、预约申请量统计、数据分析

业务流程

  1. 场地管理流程: 场地信息录入 → 设置场地管理员 → 场地状态管理
  2. 预约申请流程: 查看场地 → 选择时间 → 填写信息 → 提交申请
  3. 预约审批流程: 接收申请 → 审核信息 → 审批决定 → 更新状态
  4. 预约管理流程: 查看预约 → 修改/取消 → 状态跟踪

🏗️ 技术架构

前端技术栈

  • 框架: Vue 3.5.13 + TypeScript 5.8.3
  • UI 组件: Element Plus
  • 路由: Vue Router 4
  • 状态管理: Pinia

后端技术栈

  • 框架: Spring Boot 3.4.6
  • ORM: MyBatis-Plus
  • 权限: Sa-Token
  • 数据库: MySQL 8.0

📋 文档结构

venue-reservation/
├── README.md                    # 模块说明文档
├── 需求分析/
│   └── 场地预约需求分析.md      # 详细需求分析
├── 技术设计/
│   ├── 数据库设计.md            # 数据表设计
│   ├── API接口设计.md           # 接口设计文档
│   └── 前端页面设计.md          # 页面设计规范
└── 测试文档/
    ├── 测试用例.md              # 功能测试用例
    └── 测试报告.md              # 测试执行报告

🗄️ 数据模型

核心数据表

  • 场地信息表 (hq_venue_info): 场地基本信息管理
  • 场地预约表 (hq_venue_reservation): 预约申请和审批记录

字典数据

  • 场地类型 (hq_venue_type): 会议室、教室、运动场等
  • 预约状态 (hq_reservation_status): 待审批、已批准、已拒绝

🔐 权限设计

角色权限

  • 普通用户: 查看场地、申请预约、管理自己的预约
  • 场地管理员: 审批预约、管理负责场地的预约记录
  • 系统管理员: 场地管理、全部预约记录管理

数据权限

  • 申请人只能查看自己的预约记录
  • 场地管理员可以查看负责场地的所有预约记录

🚀 开发计划

开发阶段

  1. 第一阶段: 数据库设计和基础框架(3 天)
  2. 第二阶段: 后端接口开发(5 天)
  3. 第三阶段: 前端页面开发(7 天)
  4. 第四阶段: 测试和优化(3 天)

预期交付时间

  • 总开发周期: 18 天
  • 预计完成时间: 2025 年 7 月中旬

📚 相关文档

需求文档

设计文档

开发规范

📝 变更记录

版本 日期 变更内容 变更人
v1.0 2025-07-01 初始模块创建,需求设计完成 system

🎯 开发指引

快速开始

  1. 阅读需求说明书,理解业务逻辑
  2. 查看数据库设计,了解数据结构
  3. 参考 API 接口设计,理解接口规范
  4. 按照开发规范进行编码实现

注意事项

  • 严格按照数据库规范设计表结构
  • 遵循 API 接口规范进行接口开发
  • 确保权限控制的正确实现
  • 及时更新相关文档

模块负责人: 待分配
创建时间: 2025-07-01