pref:补充文档

feature/md-0530-ch
ch 2 years ago
parent 34852eeec8
commit db61f1f9d9

@ -0,0 +1,16 @@
module.exports = {
printWidth: 120,
tabWidth: 4,
useTabs: false,
semi: true,
singleQuote: true,
quoteProps: 'as-needed',
jsxSingleQuote: false,
trailingComma: 'es5',
bracketSpacing: true,
bracketSameLine: false,
arrowParens: 'always',
htmlWhitespaceSensitivity: 'ignore',
vueIndentScriptAndStyle: true,
endOfLine: 'auto',
};

@ -2,7 +2,7 @@
* @Author: ch
* @Date: 2022-03-17 11:30:06
* @LastEditors: ch
* @LastEditTime: 2022-05-23 21:18:34
* @LastEditTime: 2022-05-30 17:19:59
* @Description: file content
-->
# shopping-app
@ -10,12 +10,63 @@
严选移动端
## 技术架构
- uniapp
- vue2
- unicli
>打包构建工具
- vuex
>状态管理
- uni-simple-router
>路由管理更加的贴近vue-router的路由管理器
- uview-ui
>基础UI库
- js-util-all
>基础工具类
- webscoket
>IM通信
## 公共方法utils
## 规范约束
- 使用 VS Code 进行开发,并安装项目推荐的插件
- 不允许修改 src 目录以外的(项目配置)文件
- 有需要优化解决的问题记录到 TODO.md 文件中,包括技术方面的踩坑记录和业务方面的 BUG 记录
- 按照当前项目结构进行功能开发,不允许随意改变项目文件结构
## 项目结构
| SRC 目录 | 用途描述 |
| ---------- | ---------------------------- |
| common | 所有JS文件 |
| --api | API 接口定义 |
| --config | 项目内配置文件 |
| --dicts | 项目中的静态字典表 |
| --plugins | 全局插件 |
| --store | 数据状态模块 |
| --utils | 工具类库模块 |
| components | 自定义通用组件 |
| pages | 页面文件 |
| static | 存放应用的本地静态资源的目录 |
## 开发须知
### 路由页面
- 页面代码尽量做业务模块拆分,禁止出现大几百行上千行的页面文件
- 页面业务模块应就在当前页面目录下创建module 不要放到src/components下
### 工具类utils
- 项目集成js-util-all基础组件不需要重复造轮子
- 公共方法统一放置utils文件夹内可以按分类建方法文件 如验证类verify.js 请求类request.js
- 所有公共方法采用大驼峰命名法
- 所有的方法都从index.js输出引入时统一引入index不允许直接引入方法文件
- 所有方法文件如果导出的是多个方法,不允许在定义方法时导出,必须在文件底部一一导出,并附上方法简单的注释
- 方法头部必须有使用注释
``` js
// 正确
import {Req, IsPhone} from '@/common/utils';
@ -25,7 +76,17 @@ import {Req} from '@/common/utils/request';
import {IsPhone} from '@/common/utils/utils';
// 正确
/**
* 判断是否为手机号
* @param {String | Number} str 手机号
* @return {Boolean}
*/
const IsPhone = (str) => {....}
/**
* 判断是否为邮箱
* @param {String} str 邮箱号
* @return {Boolean}
*/
const IsEmail = (str) => {....}
export {
// 判断手机号
@ -39,14 +100,24 @@ export const IsPhone = (str) => {....}
export const IsEmail = (str) => {....}
```
## 组件
- 请务必使用easycom模式引入第三方组件
- 根目录的components 只放置真正的组件某个页面的业务模块应该在pages的相应目录下新建components目录放置
- 所有的自定义组件文件名以大驼峰命名且在templet中使用也用大驼峰形式使用
### 组件
- 请务必使用easycom模式引入第三方组件
- 所有的自定义组件文件名以大驼峰命名且在templet中使用也用大驼峰形式使用
- 组件分两种类型业务类型、UI功能类型命名区分(Bsxxx:业务组件、Uixxx:UI功能组件)
- 页头写好使用注释props slot methods events
## 请求
- 所有请求方法命名以Api+请求类型+具体方) 法命名
### 状态管理以及存储
- 每个功能模块都要对应一个数据状态管理模块
- 必须通过 mutations 修改 state 中的数据
- 接口调用及后续数据逻辑处理应在 actions 中进行,保证多处调用时行为统一
- 使用本存储时必须与 vuex 结合使用,不允许直接在页面中操作本地存储;
- 所有存储 key 必须在 config 中 sotrageKey.js 中定义;
### 请求
- 所有请求方法命名以Api+请求类型+具体方法) 法命名
- 所有请求使用ToAsyncAwait 包裹
- 不允许使用try catch 和 then 处理返回结果
``` js
@ -71,6 +142,47 @@ export const IsEmail = (str) => {....}
}
```
## 图片
### 图片
- 按pages目录结果放置图片
- 有公共使用的图片请放到static/common文件夹内
- 有公共使用的图片请放到static/common文件夹内
### 样式相关
- 样式命名方式采取BEM命名优先法则
- 参考 src/styles/gobalVariables.module.less颜色、字号、边距、圆角尽可能复用已有的变量
- 没有特殊需求不允许写全局样式stlye 标签必须加 scoped
- 没有特殊需求不允许定义或使用 ID 选择器、属性选择器
## 代码库
### 分支管理
- 分支命名:特性/任务-日期-创建人例如fix/213-0505-ch
- 所有新开发功能或修复BUG应基于 prod 分支创建未上线以提测的Bug则在原有开发分支上继续开发即可
- 提测则将开发分支合并到功能分支,再将功能分支合并到 test 分支,严禁将 test 分支合并进其他任何分支
- 测试通过后先将 beta 分支合并到功能分支解决冲突,再通过提 push request 通知负责人进行代码审查,审查通过后由负责人合并代码
- 预发通过后先将 特性分支 分支合并到 beta 分支解决冲突,再将 beta 分支合并到 dev 分支,此操作只能由负责人进行
- 解决冲突时如涉及其他开发者代码,应跟当事人确认无误后再合并;
### 提交代码
- 提交前确认项目能正常运行,改动部分功能正常
- 严格遵循 eslint、prettier 代码规范
- 严禁使用 git commit --no-verify -m "xxx" 强制提交代码
- 规范提交信息
| 前缀 | 使用场景 | 示例 |
| -------- | ------------------------------ | -------------------------- |
| feat | 新增功能点、模块 | feat: 用户管理 |
| fix | 修复 BUG | fix: 用户管理分页异常 |
| doc | 文档、注释更新 | doc: README |
| style | 样式、不影响逻辑的代码格式更新 | style: 用户管理标题字号 |
| refactor | 重构功能点、模块 | refactor: 路由模块逻辑重构 |
| test | 测试 | test: 测试工具类 |
| revert | 撤回提交 | revert: 有文件漏提交 |
| build | 编译打包 | build: 编译用户管理 |
| merge | 合并分支 | merge: beta into dev |
| perf | 性能、体验、逻辑优化 | pref: 路由模块解析性能 |
| conf | 配置更新 | conf: 项目 base 路径 |
| chore | 其他 | chore: 其他 |

@ -0,0 +1,14 @@
<!--
* @Author: ch
* @Date: 2022-05-30 17:20:49
* @LastEditors: ch
* @LastEditTime: 2022-05-30 17:29:43
* @Description: file content
-->
# uni提供的请求方式使用不方便
# HBuild 打包繁琐
使用unicli改进自动化部署
# 从不同页面进入购物车要展示1级或2级页面样式的购物车
# flex布局对齐方式的兼容问题

@ -1,75 +0,0 @@
{
"name": "",
"appid": "",
"description": "",
"versionName": "1.0.0",
"versionCode": "100",
"transformPx": false,
"app-plus": { /* 5+App */
"usingComponents": true,
"splashscreen": {
"alwaysShowBeforeRender": true,
"waiting": true,
"autoclose": true,
"delay": 0
},
"modules": { /* */
},
"distribute": { /* */
"android": { /* android */
"permissions": ["<uses-permission android:name=\"android.permission.CHANGE_NETWORK_STATE\"/>",
"<uses-permission android:name=\"android.permission.MOUNT_UNMOUNT_FILESYSTEMS\"/>",
"<uses-permission android:name=\"android.permission.READ_CONTACTS\"/>",
"<uses-permission android:name=\"android.permission.VIBRATE\"/>",
"<uses-permission android:name=\"android.permission.READ_LOGS\"/>",
"<uses-permission android:name=\"android.permission.ACCESS_WIFI_STATE\"/>",
"<uses-feature android:name=\"android.hardware.camera.autofocus\"/>",
"<uses-permission android:name=\"android.permission.WRITE_CONTACTS\"/>",
"<uses-permission android:name=\"android.permission.ACCESS_NETWORK_STATE\"/>",
"<uses-permission android:name=\"android.permission.CAMERA\"/>",
"<uses-permission android:name=\"android.permission.RECORD_AUDIO\"/>",
"<uses-permission android:name=\"android.permission.GET_ACCOUNTS\"/>",
"<uses-permission android:name=\"android.permission.MODIFY_AUDIO_SETTINGS\"/>",
"<uses-permission android:name=\"android.permission.READ_PHONE_STATE\"/>",
"<uses-permission android:name=\"android.permission.CHANGE_WIFI_STATE\"/>",
"<uses-permission android:name=\"android.permission.WAKE_LOCK\"/>",
"<uses-permission android:name=\"android.permission.CALL_PHONE\"/>",
"<uses-permission android:name=\"android.permission.FLASHLIGHT\"/>",
"<uses-permission android:name=\"android.permission.ACCESS_COARSE_LOCATION\"/>",
"<uses-feature android:name=\"android.hardware.camera\"/>",
"<uses-permission android:name=\"android.permission.ACCESS_FINE_LOCATION\"/>",
"<uses-permission android:name=\"android.permission.WRITE_SETTINGS\"/>"
]
},
"ios": { /* ios */
},
"sdkConfigs": { /* SDK */
}
}
},
"quickapp": { /* */
},
"mp-weixin": { /* */
"appid": "",
"setting": {
"urlCheck": false
},
"usingComponents": true
},
"mp-alipay" : {
"usingComponents" : true
},
"mp-baidu" : {
"usingComponents" : true
},
"mp-toutiao" : {
"usingComponents" : true
},
"mp-qq" : {
"usingComponents" : true
}
}
Loading…
Cancel
Save