41 lines
2.0 KiB
Plaintext
41 lines
2.0 KiB
Plaintext
|
# 项目背景
|
|||
|
|
这是一个基于RuoYi-Vue的共享空间项目后台管理系统，共享空间包含共享茶室、共享棋牌室、共享台球室，主要用于管理空间中的智能开关设备、店铺、房间、商户、用户、订单、支付、设备、设备型号、软硬件管理、保洁管理、财务管理、渠道管理、文章管理等。
|
|||
|
|
项目结构：
|
|||
|
|
店铺：商户下可以有多个店铺
|
|||
|
|
房间：空间，包含大厅、茶室、棋牌室、卫生间等、统称房间。
|
|||
|
|
设施：台球、麻将机、房间门、店门等可以安装开关设备的统称为设施。
|
|||
|
|
设备：就是一个开关设备，可以控制设施的开关状态。
|
|||
|
|
|
|||
|
|
|
|||
|
|
# 主要框架
|
|||
|
|
- Vue2
|
|||
|
|
- Element-UI
|
|||
|
|
- Axios
|
|||
|
|
- Vuex
|
|||
|
|
- Vue-Router
|
|||
|
|
|
|||
|
|
# 编码标准
|
|||
|
|
- 变量和函数名使用 camelCase 规范，组件名使用 PascalCase
|
|||
|
|
- 组件的样式使用 scoped 属性，避免样式污染
|
|||
|
|
- 样式使用scss
|
|||
|
|
- props、data、methods、computed、watch 生命周期函数等都使用驼峰命名
|
|||
|
|
- 对于全局能够重复使用的组件，尽量封装成组件，并放在 src/components 目录下
|
|||
|
|
- 对于业务能够重复使用的组件，尽量封装成组件，并放在 src/views/{模块名}/components 目录下
|
|||
|
|
- 所有请求都需要在 src/api/{模块名}.js 文件中定义，并保持统一的命名规范，使用时统一调用
|
|||
|
|
- 业务操作尽量封装成方法或组件
|
|||
|
|
- table中的数据使用columns定义，具体可以参考其他组件
|
|||
|
|
- 保持与现有代码风格一致
|
|||
|
|
- 代码需要具有可读性，注释清晰，后续可拓展
|
|||
|
|
- 生成的代码需要自动导入相关依赖，这点很重要
|
|||
|
|
|
|||
|
|
# 项目结构
|
|||
|
|
- src/api 目录下存放接口文件
|
|||
|
|
- src/assets 目录下存放静态资源
|
|||
|
|
- src/components 目录下存放全局组件
|
|||
|
|
- src/views 目录下存放页面
|
|||
|
|
- src/utils 目录下存放工具类
|
|||
|
|
- src/utils/constants.js 目录下存放常量
|
|||
|
|
- src/views/system 目录下存放系统相关页面
|
|||
|
|
|
|||
|
|
# 文档规范
|
|||
|
|
- 使用 JSDoc 格式编写函数和组件的注释
|