quick-issue:The repository of quick-issue

The repository of quick-issue

分支2Tags0
文件最后提交记录最后更新时间
3 年前
1 年前
4 个月前
4 个月前
1 个月前
1 年前
2 年前
4 个月前
1 年前
3 年前
7 个月前
3 年前
3 年前
6 个月前
4 个月前
3 年前
4 天前
4 天前
6 个月前
3 年前
11 个月前
1 年前

quick-issue

介绍

The repository of quick-issue

软件架构

软件架构说明

  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 注释规范给出注释,不同模块接口请按文件进行区分, eg: api-cve.ts
  2. 公共 utils 方法请按jsdoc 注释规范给出注释
  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信息请尽量参照相关规范
  9. 其他注意事项请参考业界相关通用开发规范说明