zlwu
249b1dfeb4
📝 主要改进： • Cursor配置模块化：拆分为前端、后端、移动端、文档、API测试5个专门规范文件 • API文档重新组织：按业务模块拆分到docs/开发文档/API/目录下 • 新增维修分类功能完整测试方案和自动化测试脚本 • 后端热启动脚本完善，支持Linux/Windows双平台 • 强化文档同步更新规范，确保代码与文档一致性 🔧 技术改进： • 优化Cursor AI工作流程和代码生成质量 • 完善API测试规范（AES+RSA双重加密登录方法） • 提升开发效率和代码质量标准化程度 �� 测试覆盖： • 维修分类管理功能端到端测试验证通过 • 包含页面加载、CRUD操作、搜索功能等核心测试用例 更新时间：2025-07-01
130 lines
3.9 KiB
Markdown
130 lines
3.9 KiB
Markdown
# Cursor 规范文件拆分说明
|
|
|
|
## 🎯 拆分目的
|
|
|
|
为了提升 Cursor 编辑器的运行效率和规范管理的便利性，我们将原本的大型`.cursorrules`文件（2359 行）拆分为多个专门的规范文件。
|
|
|
|
## 📁 文件结构
|
|
|
|
```
|
|
.cursor/
|
|
├── README.md # 本说明文件
|
|
├── cursorrules-docs.md # 文档管理规范
|
|
├── cursorrules-frontend.md # 前端开发规范 (Vue 3 + TypeScript)
|
|
├── cursorrules-backend.md # 后端开发规范 (Spring Boot + MyBatis)
|
|
├── cursorrules-mobile.md # 移动端开发规范 (uniapp + uView UI)
|
|
└── cursorrules-api-test.md # API测试和登录方法
|
|
```
|
|
|
|
## 📋 文件说明
|
|
|
|
### 1. cursorrules-docs.md
|
|
|
|
- **项目文档管理规范**
|
|
- 文档目录组织结构
|
|
- 强制性文档同步更新规则
|
|
- 变更记录管理规范
|
|
- 业务模块文档管理
|
|
- API 文档管理规范
|
|
- 测试文档管理规范
|
|
|
|
### 2. cursorrules-frontend.md
|
|
|
|
- **Web 前端开发规范**
|
|
- Vue 3 + TypeScript 技术栈
|
|
- Art Design Pro UI 规范
|
|
- 组件开发标准
|
|
- API 接口定义规范
|
|
- 状态管理和路由配置
|
|
- 项目架构和性能优化
|
|
|
|
### 3. cursorrules-backend.md
|
|
|
|
- **后端开发规范**
|
|
- Spring Boot 技术栈
|
|
- 数据库设计规范（强制性）
|
|
- API 接口规范（强制性）
|
|
- 菜单界面和权限配置
|
|
- 标准代码模板
|
|
|
|
### 4. cursorrules-mobile.md
|
|
|
|
- **移动端开发规范**
|
|
- uni-app + uView UI 技术栈
|
|
- 页面和组件开发规范
|
|
- API 对接规范
|
|
- 状态管理和配置
|
|
- 性能优化和测试
|
|
|
|
### 5. cursorrules-api-test.md
|
|
|
|
- **API 测试和登录方法**
|
|
- AES+RSA 双重加密登录
|
|
- API 测试最佳实践
|
|
- 自动化测试脚本
|
|
- 性能测试方法
|
|
|
|
## 🔄 使用方式
|
|
|
|
### Cursor 编辑器自动加载
|
|
|
|
Cursor 编辑器会自动扫描项目中的规范文件，包括`.cursor/`目录下的所有规范文件。拆分后的文件仍然能够被 Cursor 正常识别和使用。
|
|
|
|
### 手动引用
|
|
|
|
如果需要明确引用特定规范，可以在对话中提及：
|
|
|
|
- "请按照前端开发规范..."
|
|
- "遵循后端 API 接口规范..."
|
|
- "参考文档管理规范..."
|
|
|
|
### 模块化开发
|
|
|
|
现在可以针对不同技术栈进行专门的开发：
|
|
|
|
- 前端开发人员主要关注 `cursorrules-frontend.md`
|
|
- 后端开发人员主要关注 `cursorrules-backend.md`
|
|
- 移动端开发人员主要关注 `cursorrules-mobile.md`
|
|
- 测试人员主要关注 `cursorrules-api-test.md`
|
|
|
|
## 🚀 性能优势
|
|
|
|
1. **加载速度提升**: 每个文件体积更小，加载更快
|
|
2. **内容精准**: 根据开发场景加载相关规范
|
|
3. **维护便利**: 不同技术栈的规范独立维护
|
|
4. **版本管理**: 便于跟踪不同模块的规范变更
|
|
|
|
## 🔧 维护说明
|
|
|
|
### 规范更新原则
|
|
|
|
1. **技术栈专门化**: 每个文件只包含相关技术栈的规范
|
|
2. **内容完整性**: 确保每个文件内容自包含，可独立使用
|
|
3. **交叉引用**: 在需要时明确说明与其他规范文件的关联
|
|
|
|
### 文件同步
|
|
|
|
- 当项目架构或通用规范发生变化时，需要同步更新相关文件
|
|
- 重要的跨模块规范变更需要在多个文件中保持一致
|
|
|
|
## 📝 更新记录
|
|
|
|
- **2025-07-01**: 完成.cursorrules 文件拆分，创建 5 个专门规范文件
|
|
- **拆分原因**: 提升 Cursor 运行效率，便于规范管理
|
|
- **文件保留**: 所有原有内容完整保留，无任何删除
|
|
|
|
## 🎯 使用建议
|
|
|
|
1. **日常开发**: Cursor 会自动应用相关规范
|
|
2. **规范查阅**: 可直接打开对应的规范文件查看详细内容
|
|
3. **团队协作**: 不同角色的开发者可专注相关规范文件
|
|
4. **规范更新**: 按技术栈分别维护和更新规范内容
|
|
|
|
---
|
|
|
|
**维护人员**: wuzilong
|
|
**创建时间**: 2025-07-01 16:15:00
|
|
**文件总数**: 5 个专门规范文件
|
|
**原文件行数**: 2359 行
|
|
**内容完整性**: 100%保留
|