project-structure.mdc 2.4 KB

1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950515253545556575859606162636465
  1. ---
  2. alwaysApply: true
  3. ---
  4. ### 项目识别规则
  5. 在执行任何操作前,必须明确识别当前工作的项目目录:
  6. **移动端项目** (uni-app 项目)
  7. - `hdApp/` - 零售花店移动端应用
  8. - `ghsApp/` - 供货商移动端应用
  9. - `mallApp/` - 商城移动端应用
  10. **平板端项目** (uni-app 项目)
  11. - `hdPad/` - 零售花店平板端应用
  12. - `ghsPad/` - 供货商平板端应用
  13. **Web端项目**
  14. - `hd/` - 零售花店 Web 端
  15. - `ghs/` - 供货商 Web 端
  16. ### 目录结构标准
  17. 每个 uni-app 项目都应包含以下标准目录结构:
  18. ```
  19. projectName/
  20. ├── src/
  21. │ ├── pages/ # 主要页面
  22. │ ├── pagesXxxx/ # 分包页面 (如 pagesOrder, pagesClient 等)
  23. │ ├── components/ # 可复用组件
  24. │ ├── static/ # 静态资源
  25. │ ├── store/ # 状态管理
  26. │ ├── api/ # API 接口
  27. │ ├── utils/ # 工具函数
  28. │ ├── common/ # 公共文件
  29. │ ├── mixins/ # 混入
  30. │ ├── constant/ # 常量定义
  31. │ ├── filters/ # 过滤器
  32. │ ├── directives/ # 自定义指令
  33. │ ├── uni_modules/ # uni-app 插件
  34. │ ├── wxcomponents/ # 微信原生组件
  35. │ ├── platforms/ # 平台特定代码
  36. │ ├── hybrid/ # 混合开发
  37. │ ├── plugins/ # 插件
  38. │ ├── pages.json # 页面路由配置
  39. │ ├── manifest.json # 应用配置
  40. │ ├── main.js # 应用入口
  41. │ ├── App.vue # 应用根组件
  42. │ ├── uni.scss # 全局样式
  43. │ └── config.js # 配置文件
  44. ├── package.json
  45. ├── vue.config.js
  46. └── tsconfig.json # TypeScript 配置
  47. ```
  48. ### 操作指导
  49. 1. **路径确认**: 在修改代码前,必须确认当前操作的项目路径,防止跨项目目录分析与工作
  50. 2. **分包识别**: 注意项目中的分包结构 (pages开头的目录)
  51. 3. **配置文件**: 重点关注 `pages.json`, `manifest.json`, `config.js` 等配置文件
  52. 4. **环境区分**: 注意开发环境相关的配置文件如 `ext.json`, `ext-production.json`
  53. ### 常见文件作用
  54. - `config.js` - 应用配置 (API地址、版本号等)
  55. - `ext.json` - 开发环境扩展配置
  56. - `ext-production.json` - 生产环境扩展配置
  57. - `change.bat` - 环境切换脚本
  58. - `androidPrivacy.json` - Android 隐私配置