geg-gas-web/README.md

## 特别注意
如果你遇到了下面问题，包括对话框无法关闭、列表错乱/卡住/无法打开等奇怪问题，请检查node_modules/vue的版本，如果是3.4.x，由于antd-vue的要求，需要降级后使用。
或者使用yarn重新安装依赖，项目里的yarn.lock为3.2.40版本。

## 二开指南
进入项目的docs目录，使用任何http服务器部署文件，如[http-server](https://www.npmjs.com/package/http-server)，即可浏览文档：
```vue
C:\Users\user\Documents\fcd_framework_pc\docs> http-server
```

## 路由配置
为了符合UI规范的要求，框架对流程表单页面的布局进行了定制开发，对于新系统需要**手动创建**菜单
### 待办列表
- 组件名称 FlowListPage2
- 路由地址 /flowList/todo
- 组件路径 /secondDev/processTasksPage.vue
### 草稿箱
- 组件名称 FlowListPage
- 路由地址 /flowList/draft
- 组件路径 /secondDev/processTasksPage.vue
### 我的单据
- 组件名称 FlowListPage3
- 路由地址 /flowList/myProcess
- 组件路径 /secondDev/processTasksPage.vue
### 新建待办
```javascript
router.push({
    path: `/flow/:schemaId/0/createFlow`
});
```
### 无流程新建
```javascript
router.push({
    path: `/form/表单名/0/createForm`,
    query: {
        formPath: '模块目录名/表单名'
    }
});
```

## 技术选型

- 开发框架采用 [Vue3](https://v3.cn.vuejs.org/) 版本：3.3.4+（**>3.4会导致UI问题**）
- 构建工具采用 [Vite](https://vitejs.cn/) 版本： 4.3.8+
- 包管理采用 [pnpm](https://www.pnpm.cn/)版本 6.20+
- 多语言框架采用 [i18n](https://vue-i18n.intlify.dev/) 版本 9.2.2
- ui 框架采用 [Ant-Design-Vue](https://2x.antdv.com/docs/vue/introduce-cn/) 版本：3.0+
- http 请求库 采用 [axios](https://www.axios-http.cn/) 版本 1.4.0+
- 代码计算库 采用 [jsbi-calculator](https://www.npmjs.com/package/jsbi-calculator) 版本 0.3.6+
- 框架开发语言采用 [TypeScript](https://www.typescriptlang.org/) 版本 5.0.4+
- 工作流组件采用 [bpmn.js](https://bpmn.io/toolkit/bpmn-js/) 版本 8.7+
- 时间工具库采用 [day.js](https://bpmn.io/toolkit/bpmn-js/) 版本 1.11.0+
- 状态管理库采用 [pinia ](https://https://pinia.vuejs.org/)版本 2.0.12 +
- 图表库采用 [echarts](https://echarts.apache.org/zh/index.html)版本 5.3.1+
- excel 操作库采用 [exceljs](https://github.com/exceljs/) 版本 4.3.0+
- 工具类采用 [lodash-es](https://www.lodashjs.com/) 版本 4.17.21+
- 工具类采用 [vueuse](https://vueuse.org/) 版本 10.1.2+
- 打印工具类库 采用 [printjs](https://printjs.crabbly.com/) 版本 1.6.0+
- 二维码类库 采用 [qrcode](https://www.qrcode.com/zh/) 版本 1.5.0+
- 拖拽组件 采用 [vuedraggable](https://www.npmjs.com/package/vue-draggable) 版本 4.1.0+
- 富文本编辑器 采用 [wangeditor](https://www.wangeditor.com/) 版本 4.6.13+
- 项目 git 提交管理库 采用 [husky](https://github.com/githusky) 版本 8.0.3+
- 项目框架结构采用 [Vben](https://vvbin.cn/doc-next/guide/introduction.html) 作为基础，搭建而成。
- 其他技术及版本 以 Vben 文档 以及 package.json 做参考

## 特性

- **最新技术栈**：使用 Vue3/vite3 等前端前沿技术开发
- **TypeScript**: 应用程序级 JavaScript 的语言
- **主题**：可配置的主题
- **国际化**：内置完善的国际化方案
- **Mock 数据** 内置 Mock 数据方案
- **权限** 内置完善的动态路由权限生成方案
- **组件** 二次封装了多个常用的组件

## 准备

- [node](http://nodejs.org/) 和 [git](https://git-scm.com/) -项目开发环境
- [Vite](https://vitejs.dev/) - 熟悉 vite 特性
- [Vue3](https://v3.vuejs.org/) - 熟悉 Vue 基础语法
- [TypeScript](https://www.typescriptlang.org/) - 熟悉`TypeScript`基本语法
- [Es6+](http://es6.ruanyifeng.com/) - 熟悉 es6 基本语法
- [Vue-Router-Next](https://next.router.vuejs.org/) - 熟悉 vue-router 基本使用
- [Ant-Design-Vue](https://2x.antdv.com/docs/vue/introduce-cn/) - ui 基本使用
- [Mock.js](https://github.com/nuysoft/Mock) - mockjs 基本语法

## 安装使用

<!-- - 获取项目代码

```sh
git clone https://fcd.gdyditc.com/itc-framework/ma/2024/front.git
``` -->

- 安装依赖

```sh
cd front

pnpm install

```

- 运行

```sh
pnpm dev
```

- 打包

```sh
pnpm build
```

<br/>

## Git 贡献提交规范

- 参考 [vue](https://github.com/vuejs/vue/blob/dev/.github/COMMIT_CONVENTION.md) 规范 [Angular](https://github.com/conventional-changelog/conventional-changelog/tree/master/packages/conventional-changelog-angular))
  - `feat` 增加新功能
  - `fix` 修复问题/BUG
  - `style` 代码风格相关无影响运行结果的
  - `perf` 优化/性能提升
  - `refactor` 重构
  - `revert` 撤销修改
  - `test` 测试相关
  - `docs` 文档/注释
  - `chore` 依赖更新/脚手架配置修改等
  - `workflow` 工作流改进
  - `ci` 持续集成
  - `types` 类型定义文件更改
  - `wip` 开发中

## 相关仓库

- [vite-plugin-mock](https://github.com/anncwb/vite-plugin-mock) - 用于本地及开发环境数据 mock
- [vite-plugin-html](https://github.com/anncwb/vite-plugin-html) - 用于 html 模版转换及压缩
- [vite-plugin-style-import](https://github.com/anncwb/vite-plugin-style-import) - 用于组件库样式按需引入
- [vite-plugin-theme](https://github.com/anncwb/vite-plugin-theme) - 用于在线切换主题色等颜色相关配置
- [vite-plugin-imagemin](https://github.com/anncwb/vite-plugin-imagemin) - 用于打包压缩图片资源
- [vite-plugin-compression](https://github.com/anncwb/vite-plugin-compression) - 用于打包输出.gz|.brotil 文件
- [vite-plugin-svg-icons](https://github.com/anncwb/vite-plugin-svg-icons) - 用于快速生成 svg 雪碧图