project-structure.mdc 2.6 KB

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