feat: Add material synchronization document

Author: lu-yg

docs/api/backend-api/material-center.md

@@ -327,3 +327,54 @@ tenant 通过前端配置统一 x-lowcode-org 请求头传递，接口中不用
                </tbody>
               </table>
 
+## 物料同步接口
+
+<a id=物料同步接口> </a>
+
+### 基本信息
+
+**Path：** /material-center/api/component/bundle/create
+
+**Method：** POST
+
+**接口描述：**
+
+<p>处理物料同步上传bundle.json文件创建或更新组件</p>
+
+
+### 请求参数
+
+**Headers**
+
+| 参数名称     | 参数值           | 是否必须 | 示例 | 备注 |
+| ------------ | ---------------- | -------- | ---- | ---- |
+| Content-Type | multipart/form-data | 是       |      |      |
+
+**路径参数**
+
+| 参数名称 | 示例 | 备注   |
+| -------- | ---- | ------ |
+| file       | bundle.json   | bundle.json文件 |
+
+**Body**
+
+<table>
+  <thead class="ant-table-thead">
+    <tr>
+      <th key=name>名称</th><th key=type>类型</th><th key=required>是否必须</th><th key=default>默认值</th><th key=desc>备注</th><th key=sub>其他信息</th>
+    </tr>
+  </thead><tbody className="ant-table-tbody">
+               </tbody>
+              </table>
+
+
+### 返回数据
+
+<table>
+  <thead class="ant-table-thead">
+    <tr>
+      <th key=name>名称</th><th key=type>类型</th><th key=required>是否必须</th><th key=default>默认值</th><th key=desc>备注</th><th key=sub>其他信息</th>
+    </tr>
+    </thead><tbody className="ant-table-tbody"><tr key=0-0><td key=0><span style="padding-left: 0px"><span style="color: #8c8a8a"></span> data</span></td><td key=1><span>object</span></td><td key=2>非必须</td><td key=3></td><td key=4><span style="white-space: pre-wrap"></span></td><td key=5></td></tr><tr key=0-0-0><td key=0><span style="padding-left: 20px"><span style="color: #8c8a8a">├─</span> insertNum</span></td><td key=1><span>number</span></td><td key=2>非必须</td><td key=3></td><td key=4><span style="white-space: pre-wrap">新增组件数</span></td><td key=5></td></tr> <tr key=0-0-0><td key=0><span style="padding-left: 20px"><span style="color: #8c8a8a">├─</span> updateNum</span></td><td key=1><span>number</span></td><td key=2>非必须</td><td key=3></td><td key=4><span style="white-space: pre-wrap">更新组件数</span></td><td key=5></td></tr> 
+    </tbody>
+              </table>

docs/solutions/imgs/bundle_upload.png

@@ -1,10 +1,22 @@
 ## 物料同步方案
 
+### 方案一 (推荐使用)
+通过Postman工具上传编辑好的bundle.json文件。
+
+![文件上传图](./imgs/bundle_upload.png '文件上传图')
+
+#### 注意事项
+1. bundle.json文件内组件版本version字段为必须字段，缺少的需要补充不然上传接口报错
+2. bundle.json文件内组件版本version与数据库t_component内version不一致时为新增，一致为更新，也可根据自身需求更改相关代码逻辑
+
+![注意事项图](./imgs/component_create_code.png '注意事项图')
+
+### 方案二
 由于当前情况下物料无法通过页面交互维护，提供一个临时方案，由前端托管物料。
 在本地运行时提供nodejs脚本维护物料，执行脚本保证mockServer工程和前端工程物料的同步。如果启动了后端服务，还可以连接数据库，保证本地json文件和数据库的一致性。
 
 ![物料同步数据流转图](./imgs/synchronize-materials.png '物料同步数据流转图')
-### 拆分脚本
+#### 拆分脚本
 
 ```shell
 pnpm splitMaterials
@@ -13,7 +25,7 @@ pnpm splitMaterials
 之前对物料的修改要先从大文件bundle.json中找到对应组件，然后进行修改调试，很容易出现找错组件或难以对比历史的情况。
 执行该脚本可以将物料资产包拆分为单个组件或区块，再结合构建的脚本，可以将修改限制在相对较小的文件中，便于维护物料和对比变更。
 
-### 构建脚本
+#### 构建脚本
 
 ```shell
 pnpm buildMaterials
@@ -26,14 +38,15 @@ pnpm buildMaterials
 - 连接数据库，初始化组件表，将组件数据写入数据库
 - 监听组件文件变化，重新构建物料资产包和应用 mock 数据，新增或更新数据库中组件数据
 
-### 注意事项
+#### 注意事项
 
 1. 本地还没有执行过拆分脚本的，先执行一次，后续可以不用再执行，只需要对单个组件进行维护
 2. 单个组件文件需要遵循物料协议，更新文件后保存即可触发重新构建物料资产包，刷新页面后生效
 3. 连接数据库失败，不影响构建本地物料资产包即bundle.json
 4. 连接数据库需要的配置项在`.env.local`中
+5. 数据关联关系可能没有入库，如果查询不到新添加的组件，需要手动在数据库表r_material_component、r_material_history_component添加关联关系数据
 
-### 部署建议
+#### 部署建议
 
 需要将设计器进行部署时，关于物料的部署方案，以下供参考：