# Weda Business

腾讯云微搭企业级低代码组件库，提供企业级 CRUD 组件/审批组件等，暂时只支持 PC/h5

微搭低码组件库使用各平台/框架标准的组件格式，通过配置类型文件描述组件的行为、出参、入参及元数据等信息和微搭平台做对接。

## 项目目录

主要目录说明：

```
.
└── src
    ├── configs             # 组件类型申明目录
    │   ├── actions         # 组件库方法类型申明
    │   └── components      # 组件目录类型申明
    ├── mp                  # 小程序组件
    │   ├── actions         # 小程序组件方法实现
    │   └── components      # 小程序组件实现
    ├── stories             # 组件 story / 测试
    └── web                 # web（react） 组件
        ├── actions         # web 组件方法实现
        └── components      # web 组件实现
```

## 开发

### 组件库开发前置依赖

1. 进入组件库更目录，安装依赖： `npm i` or `yarn`, 使用 `git submodule update --init -r` 来更新引用的 git 子仓库
2. 安装云开发命令行工具：`npm i -g @cloudbase/cli` or `yarn global add @cloudbase/cli`
3. 登录云开发命令行：`tcb login`
4. 去腾讯云微搭低码控制台创建组件库

### 新增组件

1. 在 `src/web/components` 目录下新建组件，并在组件目录下新建 `index.json` 文件，描述组件的名称、分类、属性等信息
2. 在 `src/web/components/index.js` 中导出
3. 在 `src/configs/index.js` 导出组件的 `index.json` 配置文件

### 调试组件

1. 在腾讯云微搭低代码编辑器调试组件库，在当前目录执行：`tcb lowcode debug`
2. 使用 `tcb lowcode debug` 时，启动较慢，热重载可能会失效。
3. 开发新组件时可以 Mock 编辑器依赖，直接在 `src/pages/index.tsx` 中引入组件，使用 `npx umi dev` 进行快速预览。
4. 由于 adminportal 的数据管理后台通过 submodule 引入了该组件库，因此可以在 adminportal 修改 weda_business ，利用 adminportal 前端项目实时调试组件库。

### 线上验证

1. 组件开发完成后，前往控制台-组件库新建组件，例如命名为 bus
2. 修改 cloudbaserc.json 文件中的 name 为 bus
3. 提交组件到微搭低代码平台，在线上进行功能验证：`tcb lowcode publish`
4. 新建应用，引入 bus 组件库，在线验证效果

### 参考 API

- 组件开发参考文档：https://docs.cloudbase.net/lowcode/custom-components/quick-start/comps.html
- 运行 app 对象：https://docs.cloudbase.net/lowcode/framework/app/app.html

## 发布

通过 Coding 流水机制，将组件产物自动上传到 COS 上。

1. 将更改的代码提交 MR 合并到 master 分支
2. 进入 codnig [流水线地址](http://tencent.coding.woa.com/p/CloudBase/ci/job/299568/build/9944386/pipeline)，点击“触发”，选择“feat/try_to_merge_weda_bussiness
   ”分支，等待触发完成。
3. 联系 booker 进行 cos 审批。
4. 去现网通过新建模型应用验证组件库是否生效，需要验证编辑区/预览产物/发布产物三类。

## 注意事项

- 因为组件库使用的 formily 和编辑器使用的 formily 版本冲突，会导致应用构建失败，所以组件中要使用 formily 下的 Webpack 打包版本， @formily/core 固定版本 2.0.0-beta.72