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:
1 parent
e8ece1b612
commit
28232d5d46
131 files changed
+17170
-5479
No files matched your search
+95
-6
@@ -9,7 +9,7 @@
|
||||
### 项目结构
|
||||
- **前端工程**: `web/` (Vue 3 + TypeScript + Element Plus)
|
||||
- **后端工程**: `backend/` (Spring Boot 3.4.6 + MyBatis-Plus)
|
||||
- **移动端工程**: `mobile/` (uniapp + uView UI)
|
||||
- **移动端工程**: `mobile/` (Vue 3.4.21 + uniapp + uview-plus 3.4.45 - 现代化智慧校园)
|
||||
- **文档管理**: `docs/` (完整的项目文档体系)
|
||||
|
||||
---
|
||||
@@ -61,11 +61,12 @@
|
||||
- 标准代码模板 (Controller/Service/Mapper)
|
||||
|
||||
#### 📱 移动端开发规范 (.cursor/cursorrules-mobile.md)
|
||||
- uni-app + uView UI 技术栈
|
||||
- 页面和组件开发规范
|
||||
- 与后端API对接规范
|
||||
- 状态管理和配置规范
|
||||
- 性能优化和测试
|
||||
- Vue 3.4.21 + uni-app + uview-plus 3.4.45 技术栈(现代化智慧校园)
|
||||
- 纯净的Vue 3项目架构(无状态管理库,采用原生API)
|
||||
- 现代CSS变量设计系统和响应式布局适配
|
||||
- 完整的用户体验优化(动画、手势识别、无障碍访问)
|
||||
- 智能缓存策略和网络请求优化
|
||||
- 多端发布支持(H5、微信小程序、App、鸿蒙)
|
||||
|
||||
#### 🧪 API测试规范 (.cursor/cursorrules-api-test.md)
|
||||
- **✅ AES+RSA双重加密登录方法(已完全解决)**
|
||||
@@ -114,6 +115,7 @@
|
||||
- **Java**: JDK 17/21
|
||||
- **前端访问**: http://localhost (默认80端口)
|
||||
- **后端服务**: http://localhost:8080
|
||||
- **移动端**: Vue 3.4.21 + uni-app + uview-plus 3.4.45(现代化智慧校园)
|
||||
|
||||
---
|
||||
|
||||
@@ -135,6 +137,93 @@
|
||||
- **文档更新**: 自动参考 `cursorrules-docs.md`
|
||||
- **API测试**: 自动参考 `cursorrules-api-test.md`
|
||||
|
||||
### 👍 点赞后知识总结机制
|
||||
|
||||
**⚠️ 重要提醒:当用户对Cursor回答点赞时,请主动询问是否需要进行总结归档**
|
||||
|
||||
#### 点赞触发规则
|
||||
- **触发条件**: 用户对Cursor的回答点赞(👍)
|
||||
- **自动提醒**: "检测到您对本次回答满意,是否需要将相关经验总结归档到项目规范中?"
|
||||
- **总结目标**: 将成功的解决方案、最佳实践、经验教训整理到规范文档中
|
||||
|
||||
#### 总结内容建议
|
||||
1. **技术解决方案**: 将有效的技术方案整理到对应的cursorrules文档
|
||||
2. **开发流程优化**: 将改进的工作流程补充到开发规范中
|
||||
3. **最佳实践**: 将成功经验添加到最佳实践文档
|
||||
4. **问题解决方案**: 将常见问题和解决方案整理到知识库
|
||||
5. **规范完善**: 根据实际应用效果完善和优化现有规范
|
||||
|
||||
#### 总结文档位置
|
||||
- **技术规范**: 对应的`.cursor/cursorrules-*.md`文件
|
||||
- **最佳实践**: `docs/开发文档/API开发最佳实践总结.md`
|
||||
- **项目知识库**: `docs/知识库/`目录
|
||||
- **变更记录**: `docs/变更管理/code-adjust-record-YYYY-MM-DD-{username}.md`
|
||||
|
||||
#### 总结流程
|
||||
```
|
||||
用户点赞 → Cursor主动询问 → 确认总结 → 分析价值点 → 整理到规范 → 更新相关文档
|
||||
```
|
||||
|
||||
#### 价值目标
|
||||
- 📚 **知识积累**: 将零散的经验系统化整理
|
||||
- 🔄 **规范优化**: 基于实际应用持续改进规范
|
||||
- 📖 **团队共享**: 将个人经验转化为团队资产
|
||||
- 🚀 **效率提升**: 为后续类似问题提供标准解决方案
|
||||
|
||||
### 💡 API开发最佳实践
|
||||
|
||||
**⚠️ 基于场地预约管理系统开发实践制定的标准流程**
|
||||
|
||||
#### 完整开发流程(6个阶段)
|
||||
1. **需求分析和文档创建** → 业务需求+技术架构文档
|
||||
2. **数据库设计和初始化** → 表结构+字典+权限+示例数据
|
||||
3. **后端模块开发** → 完整ruoyi模块(16个API接口)
|
||||
4. **API文档编写** → 400+行详细API文档
|
||||
5. **自动化测试脚本** → 450+行Python测试脚本
|
||||
6. **变更记录和验证** → 完整的变更日志
|
||||
|
||||
#### 16个标准API接口模式
|
||||
- **基础管理接口(6个)**: list、详情、新增、修改、删除、可用选项
|
||||
- **业务功能接口(4个)**: 我的数据、待处理、规则检查、审批
|
||||
- **辅助功能接口(6个)**: 导出、导入、统计、批量、启用、禁用
|
||||
|
||||
#### 🔴 VO类基础字段统一规范(新增 2025-07-01)
|
||||
|
||||
**⚠️ 超级重要:所有VO类必须包含统一的基础字段!**
|
||||
|
||||
**背景问题**:
|
||||
- MyBatis-Plus自动查询:不包含继承字段
|
||||
- 自定义SQL查询:明确包含字段,VO类必须有对应属性
|
||||
- 导致运行时字段缺失错误:`Could not set property 'createBy'`
|
||||
|
||||
**统一解决方案**:
|
||||
```java
|
||||
// 所有VO类必须包含的四个基础字段
|
||||
private Long createBy; // 创建者
|
||||
private Date createTime; // 创建时间(含JSON格式化)
|
||||
private Long updateBy; // 更新者
|
||||
private Date updateTime; // 更新时间(含JSON格式化)
|
||||
```
|
||||
|
||||
**强制要求**:
|
||||
- ✅ 新增VO类必须包含四个基础字段
|
||||
- ✅ 修复现有VO类时必须补全缺失字段
|
||||
- ✅ 时间字段使用`@JsonFormat(pattern = "yyyy-MM-dd HH:mm:ss")`
|
||||
- ✅ 详细规范见:`.cursor/cursorrules-backend.md` → "VO类基础字段规范"
|
||||
|
||||
#### 质量保证标准
|
||||
- ✅ **完整交付物**: 2个需求文档+3个SQL脚本+18个代码文件+1个API文档+1个测试脚本
|
||||
- ✅ **开发时长**: 约3.5天完成完整API模块
|
||||
- ✅ **文档同步**: 代码完成立即更新相关文档
|
||||
- ✅ **测试覆盖**: 强制AES+RSA加密登录+完整功能测试
|
||||
- ✅ **VO类规范**: 所有VO类包含统一基础字段,避免MyBatis映射错误
|
||||
|
||||
#### 参考文档
|
||||
- **完整实践总结**: `docs/开发文档/API开发最佳实践总结.md`
|
||||
- **成功案例**: `docs/开发文档/API/场地预约管理API.md`
|
||||
- **测试脚本模板**: `test/场地预约API测试脚本.py`
|
||||
- **VO类规范**: `.cursor/cursorrules-backend.md` → "VO类基础字段规范(强制性)"
|
||||
|
||||
---
|
||||
|
||||
## 🎯 快速开始
|
||||
|
||||
Reference in new issue
Block a user