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提供准确的移动端开发上下文，确保生成代码完全符合实际项目架构。
This commit is contained in:
zlwu committed
1 parent
e8ece1b612
commit
28232d5d46
131 files changed
+17170
-5479
No files matched your search
@@ -0,0 +1,138 @@
|
||||
# 场地预约管理模块
|
||||
|
||||
## 📖 模块概述
|
||||
|
||||
**模块名称**: 场地预约管理
|
||||
**模块编码**: 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 月中旬
|
||||
|
||||
## 📚 相关文档
|
||||
|
||||
### 需求文档
|
||||
|
||||
- [场地预约系统需求说明书](../../需求文档/后勤场地预约需求/场地预约系统需求说明.md)
|
||||
|
||||
### 设计文档
|
||||
|
||||
- [数据库设计文档](../../设计文档/database/)
|
||||
- [API 接口文档](../../开发文档/API/)
|
||||
|
||||
### 开发规范
|
||||
|
||||
- [后端开发规范](../../../.cursor/cursorrules-backend.md)
|
||||
- [前端开发规范](../../../.cursor/cursorrules-frontend.md)
|
||||
|
||||
## 📝 变更记录
|
||||
|
||||
| 版本 | 日期 | 变更内容 | 变更人 |
|
||||
| ---- | ---------- | -------------------------- | ------ |
|
||||
| v1.0 | 2025-07-01 | 初始模块创建，需求设计完成 | system |
|
||||
|
||||
---
|
||||
|
||||
## 🎯 开发指引
|
||||
|
||||
### 快速开始
|
||||
|
||||
1. 阅读需求说明书，理解业务逻辑
|
||||
2. 查看数据库设计，了解数据结构
|
||||
3. 参考 API 接口设计，理解接口规范
|
||||
4. 按照开发规范进行编码实现
|
||||
|
||||
### 注意事项
|
||||
|
||||
- 严格按照数据库规范设计表结构
|
||||
- 遵循 API 接口规范进行接口开发
|
||||
- 确保权限控制的正确实现
|
||||
- 及时更新相关文档
|
||||
|
||||
**模块负责人**: 待分配
|
||||
**创建时间**: 2025-07-01
|
||||
Reference in new issue
Block a user