README.md · 王木口/quick-issue_sig

# quick-issue

#### 介绍
The repository of quick-issue

#### 软件架构
软件架构说明

```text
  app
    ├─ .vitepress
      ├─ public // 静态资源文件，不参与打包编译
      ├─ src // 业务
        ├─ api // 接口
        ├─ assets // 资源文件
        ├─ components // 组件
        ├─ i18 // 国际化
        ├─ shared // 公用方法/样式
        ├─ stores // 状态管理
        ├─ views // 业务vue文件
    ├─ en // 英文页面
    ├─ ru // 俄文页面
    ├─ zh // 中文页面
```

1.  xxxx
2.  xxxx
3.  xxxx

#### 使用说明

1.  xxxx
2.  xxxx
3.  xxxx

#### 参与贡献

### 命名

#### 命名形式

1. `camelCase`: 驼峰式
2. `kebab-case`: 短横线连接式
3. `PascalCase`: 帕斯卡命名式
4. `Snake`: 下划线连接式

#### 说明

1. 文件夹以及文件命名(除 Vue SFC)采用`kebab-case`
2. Vue SFC 文件命名使用`PascalCase`, 在该文件中使用的 Vue 组件也使用`PascalCase`
3. Vue 组件中`emit`事件使用`kebab-case`
4. 变量以及方法命名使用`camelCase`, 资源文件使用`Snake`表明 light/dark, zh/en/ru，，`eg: homeBanner_light_zh`, 其中风格在前，语言在后
5. CSS 使用`kebab-case`命名
6. Icon 组件引入时增加 Icon 前缀，eg:`import IconDownload from '~icons/app/download'`

### 开发规范

1. 所有接口类方法请写在`app/.vitepress/src/api`中，并按照[jsdoc 注释规范](https://www.shouce.ren/api/view/a/13232)给出注释，不同模块接口请按文件进行区分, eg: `api-cve.ts`
2. 公共 utils 方法请按[jsdoc 注释规范](https://www.shouce.ren/api/view/a/13232)给出注释
3. 变量命名做到见名知义，方法命名使用动词或动宾结构, eg: `import warningImg from '@/assets/icons/warning.png`, `const getUserEmail=()=>{}`
4. 调用接口获取数据请使用`try {} catch(error) {}`进行校验
5. 约束`for...in`的使用, 可以使用`Object.keys().forEach`
6. 使用`prettier`插件作为格式化工具
7. 提交之前请先进行 eslint 检查： 执行脚本，运行`pnpm lint`。确认无问题后提交。项目工程的git hooks 已配置相关校验，如`git commit`不成功，请查看相关错误信息，并进行修改
8. `git commit`信息请尽量参照[相关规范](https://zhuanlan.zhihu.com/p/182553920)
9. 其他注意事项请参考业界相关通用[开发规范说明](https://github.com/airbnb/javascript)

王木口/quick-issue_sig

简介

发行版

贡献者

近期动态

王木口/quick-issue_sig .gitee-modal { width: 500px !important; }

简介

发行版

贡献者

近期动态

搜索帮助

王木口/quick-issue_sig