@alanwang-merit/meritdata-platform-skill-package 1.0.0

package/skills/meritdata-dev-docs-file-finder/references/dev-docs//346/224/273/347/225/245-08-/346/265/201/347/250/213/345/211/215/347/253/257/347/273/204/344/273/266-/347/253/240/350/212/20202_/347/273/204/344/273/266/344/270/216/346/226/271/346/263/225/346/246/202/350/247/210/350/241/250.md

@@ -0,0 +1,45 @@
+---
+name: 攻略-08-流程前端组件-章节02_组件与方法概览表
+description: 组件与方法概览表 — 美林平台 BPM 前端组件与方法说明（BpmFormTools / BpmGridButtonsNew / MeritBPM）
+keywords: [BPM, 前端组件, BpmFormTools, BpmGridButtonsNew, MeritBPM, Vue, Element UI, 组件与方法概览表]
+use-cases: [BPM 前端组件集成, 流程表单开发, BPM 按钮组件]
+source-section: 1. 组件与方法概览表
+source-file: 应用开发平台-流程管理-使用攻略（八）：流程前端组件及方法说明文档.md
+---
+
+# 一、组件与方法概览表
+
+### 1.1 前端组件
+
+| 来源 | 组件/方法名 | 作用场景 | 说明 |
+|------|------------|----------|------|
+| bpm-form-tools.vue | BpmFormTools | BPM表单工具组件 | 流程表单核心组件，集成发送、暂存等流程操作按钮 |
+| bpm-grid-buttons-new.vue | BpmGridButtonsNew | BPM表格按钮组件 | 流程列表页操作按钮，提供新建、我的申请、我的审批等 |
+
+### 1.2 后端接口
+
+| 来源类 | 方法名 | 作用场景 | 说明 |
+|------|--------|----------|------|
+| BpmEngine | startProcess | 启动流程 | 根据流程定义Key和businessId启动流程 |
+| BpmEngine | ruleEngineInit | 规则引擎初始化 | 查询流程按钮配置信息，初始化流程操作界面 |
+| BpmEngine | ruleEngineRun | 规则引擎执行 | 根据businessId查询待办任务 |
+| BpmEngine | complete | 完成任务 | 完成当前任务，推进流程到下一节点 |
+| BpmEngine | deleteProcInsts | 删除流程实例 | 根据businessIds删除流程实例 |
+| BpmEngine | queryMainForms | 流程实例查询 | 分页查询流程实例列表 |
+| BpmEngine | getPage | 文字追踪 | 获取流程流转路径文字信息 |
+| BpmEngine | getGraphTrack | 图表追踪 | 获取流程图形追踪信息 |
+| BpmEngine | getOpinions | 审批意见 | 获取流程审批意见列表 |
+| BpmEngine | addOrUpdate | 填写意见 | 在节点填写审批意见 |
+| BpmEngine | getUndoPage | 个人待办列表 | 获取当前用户的待办任务列表 |
+
+### 1.3 MeritBPM方法与后端API对应关系
+
+| MeritBPM方法 | 后端API | 说明 |
+|--------------|---------|------|
+| MeritBPM.create / initRuleEngine | POST /api/engine/bpm/ruleengine/init/{procDefKey} | 创建流程/初始化规则引擎 |
+| MeritBPM.open / runRuleEngine | POST /api/engine/bpm/ruleengine/run | 打开流程/运行规则引擎 |
+| MeritBPM.startProcess | POST /api/engine/bpm/{procDefKey}/startprocess | 发起流程 |
+| MeritBPM.validatePermit | POST /api/engine/bpm/{procDefKey}/validate/permit | 验证流程权限 |
+| MeritBPM.openProcTrackWindow | POST /api/engine/track/port | 打开流程跟踪窗口 |
+
+---

package/skills/meritdata-dev-docs-file-finder/references/dev-docs//346/224/273/347/225/245-08-/346/265/201/347/250/213/345/211/215/347/253/257/347/273/204/344/273/266-/347/253/240/350/212/20203_BpmFormTools_-_BPM/350/241/250/345/215/225/345/267/245/345/205/267/347/273/204/344/273/266.md

@@ -0,0 +1,145 @@
+---
+name: 攻略-08-流程前端组件-章节03_BpmFormTools_-_BPM表单工具组件
+description: BpmFormTools - BPM表单工具组件 — 美林平台 BPM 前端组件与方法说明（BpmFormTools / BpmGridButtonsNew / MeritBPM）
+keywords: [BPM, 前端组件, BpmFormTools, BpmGridButtonsNew, MeritBPM, Vue, Element UI, BpmFormTools - BPM表单工具组件]
+use-cases: [BPM 前端组件集成, 流程表单开发, BPM 按钮组件]
+source-section: 2. BpmFormTools - BPM表单工具组件
+source-file: 应用开发平台-流程管理-使用攻略（八）：流程前端组件及方法说明文档.md
+---
+
+# 二、BpmFormTools - BPM表单工具组件
+
+## 📋 API 契约（机器可读）
+
+```json
+{
+  "apiName": "BpmFormTools",
+  "type": "vue-component",
+  "framework": "Vue 2.6 + Element UI",
+  "functionDesc": "BPM 表单工具 Vue 组件（Props / Events / 内部状态）",
+  "module": "cloud-module-bpm",
+  "props": [
+    "visible",
+    "title",
+    "value"
+  ],
+  "events": [
+    "confirm",
+    "cancel",
+    "close"
+  ],
+  "bestPractice": "使用 v-model 双向绑定，监听 @confirm 事件"
+}
+```
+
+**文件路径**: `cloud-module-bpm/packages/bpm-form-tools/bpm-form-tools.vue`
+
+**功能说明**: BPM表单核心工具组件，集成流程操作按钮（发送、暂存等），是流程表单页的必选组件。
+
+### 2.1 Props属性
+
+| 属性名 | 类型 | 必填 | 说明 |
+|--------|------|------|------|
+| procDefKey | String | true | 流程定义Key |
+
+### 2.2 Events事件
+
+| 事件名 | 说明 | 返回值 |
+|--------|------|--------|
+| init | 初始化事件，返回业务数据对象 | `{id, undoId, params, callback}` |
+| save | 保存事件，保存业务数据 | `{bpmSaveAfter, bpmBtn}` |
+
+### 2.3 组件内部状态
+
+| 状态名 | 类型 | 说明 |
+|--------|------|------|
+| ruleEngine | Object | 规则引擎对象，包含businessId、procInstId、undoId等 |
+| MeritBPM | Object | BPM工具对象 |
+
+### 3.4 实际使用示例（form-edit.vue）
+
+```vue
+<template>
+  <el-form ref="example" :model="example" label-width="80px" style="padding: 16px;width:850px;margin:20px auto;">
+    <!-- BPM工具栏（必须放在表单开头） -->
+    <bpm-form-tools
+      :procDefKey="procDefKey"
+      @init="init"
+      @save="save"
+      ref="bpmformtools"
+    />
+
+    <el-row><el-col style="font-size:24px;font-weight:bold">出差费用报销单</el-col></el-row>
+
+    <!-- 业务表单字段 ... -->
+  </el-form>
+</template>
+
+<script>
+import { MeritBPM } from 'cloud-module-bpm/packages/utils/merit-bpm.js';
+
+export default {
+  data() {
+    return {
+      MeritBPM,
+      procDefKey: 'Process_Demo1',
+      example: {
+        id: '',
+        project: '',
+        name: '',
+        belongDept: '',
+        amount: 0,
+        urgency: 'common',
+        mj: '1'
+      }
+    };
+  },
+  methods: {
+    // 初始化表单（由bpm-form-tools调用）
+    init(params) {
+      if (params.id == '') {
+        // 新建流程 - 获取当前用户信息
+        this.axios['system-manager']
+          .get('/api/ou/user/session')
+          .then(result => {
+            this.example.name = result.name;
+            this.example.belongDept = result.deptName;
+            this.example.project = result.name + '_' + this.formatDate(new Date()) + '_出差报销';
+            params.callback(this.example);
+          });
+      } else {
+        // 打开已有流程 - 加载业务数据
+        this.axios['cloud-system-bpm-demo']
+          .post('/get', { id: params.id })
+          .then(res => {
+            Object.assign(this.example, res.data);
+            this.example.undoId = params.undoId;
+            params.callback(this.example);
+          });
+      }
+    },
+
+    // 保存业务数据（由bpm-form-tools调用）
+    save(bpmSaveAfter) {
+      this.axios['cloud-system-bpm-demo']
+        .post('/update', this.example)
+        .then(res => {
+          Object.assign(this.example, res.data);
+          // 设置流程相关变量（必须）
+          this.example['bpmSubject'] = res.data.project;   // 流程标题（必填）
+          this.example['bpmUrgent'] = this.example.urgency;  // 紧急程度
+          this.example['bpmSecret'] = this.example.mj;   // 密级
+          // 必须调用此回调，触发流程保存后处理
+          bpmSaveAfter(this.example);
+        });
+    },
+
+    formatDate(date) {
+      return date.toISOString().split('T')[0];
+    }
+  }
+};
+</script>
+```
+
+---

package/skills/meritdata-dev-docs-file-finder/references/dev-docs//346/224/273/347/225/245-08-/346/265/201/347/250/213/345/211/215/347/253/257/347/273/204/344/273/266-/347/253/240/350/212/20204_BpmGridButtonsNew_-_BPM/350/241/250/346/240/274/346/214/211/351/222/256/347/273/204/344/273/266.md

@@ -0,0 +1,239 @@
+---
+name: 攻略-08-流程前端组件-章节04_BpmGridButtonsNew_-_BPM表格按钮组件
+description: BpmGridButtonsNew - BPM表格按钮组件 — 美林平台 BPM 前端组件与方法说明（BpmFormTools / BpmGridButtonsNew / MeritBPM）
+keywords: [BPM, 前端组件, BpmFormTools, BpmGridButtonsNew, MeritBPM, Vue, Element UI, BpmGridButtonsNew - BPM表格按钮组件]
+use-cases: [BPM 前端组件集成, 流程表单开发, BPM 按钮组件]
+source-section: 3. BpmGridButtonsNew - BPM表格按钮组件
+source-file: 应用开发平台-流程管理-使用攻略（八）：流程前端组件及方法说明文档.md
+---
+
+# 三、BpmGridButtonsNew - BPM表格按钮组件
+
+## 📋 API 契约（机器可读）
+
+```json
+{
+  "apiName": "BpmGridButtonsNew",
+  "type": "vue-component",
+  "framework": "Vue 2.6 + Element UI",
+  "functionDesc": "BPM 表格按钮 Vue 组件（流程状态值 + 按钮事件）",
+  "module": "cloud-module-bpm",
+  "props": [
+    "visible",
+    "title",
+    "value"
+  ],
+  "events": [
+    "confirm",
+    "cancel",
+    "close"
+  ],
+  "bestPractice": "使用 v-model 双向绑定，监听 @confirm 事件"
+}
+```
+
+**文件路径**: `cloud-module-bpm/packages/bpm-grid-buttons-new/bpm-grid-buttons-new.vue`
+
+**功能说明**: BPM流程列表页操作按钮组件，提供新建、我的申请、我的审批、所有流程等下拉菜单按钮。
+
+### 3.1 Props属性
+
+| 属性名 | 类型 | 必填 | 说明 |
+|--------|------|------|------|
+| procDefKey | String | true | 流程定义Key |
+| isShowButton | Boolean | false | 是否显示按钮（默认true） |
+| isDisabledAddButton | Boolean | false | 新建按钮是否禁用 |
+
+### 3.2 Events事件
+
+| 事件名 | 说明 | 返回值 |
+|--------|------|--------|
+| bpm-query | 查询流程 | `bpmStatus` 流程状态值 |
+| bpm-delete | 删除流程 | - |
+
+### 3.3 流程状态值说明
+
+| 状态值 | 说明 | 所属菜单 |
+|--------|------|---------|
+| my | 我的申请 | 我的申请 |
+| mydraft | 我的草稿 | 我的申请 |
+| mytrack | 我的跟踪 | 我的申请 |
+| myover | 我的已完结 | 我的申请 |
+| approve | 待我审批 | 我的审批 |
+| all | 所有流程 | 所有流程 |
+
+### 4.4 实际使用示例（Grid.vue）
+
+```vue
+<template>
+  <el-container>
+    <el-main style="padding: 8px 12px;">
+      <!-- BPM流程按钮组 -->
+      <el-row justify="space-between" type="flex">
+        <el-col :span="7">
+          <bpm-grid-buttons-new
+            :procDefKey="procDefKey"
+            @bpm-query="queryBpm"
+            @bpm-delete="deleteRow"
+          />
+        </el-col>
+        <el-col :span="7">
+          <el-input
+            v-model="keyword"
+            @change="queryKeyword"
+            placeholder="请输入标题"
+            clearable
+            suffix-icon="el-icon-search"
+          >
+          </el-input>
+        </el-col>
+      </el-row>
+
+      <!-- 业务列表 -->
+      <el-table
+        stripe
+        ref="tables"
+        :data="gridData"
+        style="width: 100%"
+        :height="tableHeight"
+        @selection-change="handleSelectionChange"
+      >
+        <el-table-column type="selection" width="55" :selectable="checkDel"></el-table-column>
+        <el-table-column prop="project" label="标题"></el-table-column>
+        <el-table-column prop="procDealStatus" label="处理状态">
+          <template slot-scope="scope">
+            <el-tag>{{ statusLabel(scope.row.procDealStatus) }}</el-tag>
+          </template>
+        </el-table-column>
+        <el-table-column label="操作" width="100">
+          <template slot-scope="scope">
+            <el-button icon="el-icon-edit" @click="editRow(scope.$index, scope.row)" size="small"></el-button>
+          </template>
+        </el-table-column>
+      </el-table>
+
+      <el-pagination
+        @size-change="handleSizeChange"
+        @current-change="handleCurrentChange"
+        :current-page="currentPage"
+        :page-size="pageSize"
+        layout="total, sizes, prev, pager, next, jumper"
+        :total="total"
+      ></el-pagination>
+    </el-main>
+  </el-container>
+</template>
+
+<script>
+import { MeritBPM } from 'cloud-module-bpm/packages/utils/merit-bpm.js';
+
+export default {
+  data() {
+    return {
+      MeritBPM,
+      tableHeight: window.innerHeight - 180,
+      procDefKey: 'Process_Demo1',
+      selectRows: [],
+      bpmStatus: 'my'
+    };
+  },
+  created() {
+    // 初始化时验证流程权限
+    this.MeritBPM.validatePermit(this, this.procDefKey, null);
+    // 将刷新方法挂载到window，用于表单关闭后刷新
+    window.refreshBpmGrid = () => {
+      this.queryBpm(this.bpmStatus);
+    };
+    this.initLoadPage();
+  },
+  methods: {
+    // 由按钮组件触发的查询
+    queryBpm(type) {
+      this.$refs.tables.bodyWrapper.scrollTop = 0;
+      this.currentPage = 1;
+      this.bpmStatus = type;
+      this.queryPageData();
+    },
+
+    // 打开流程（办理）
+    editRow(index, row) {
+      MeritBPM.open(this, { businessId: row.id }, {});
+    },
+
+    // 删除流程
+    deleteRow() {
+      if (this.selectRows.length === 0) {
+        this.$message.warning('请选择需要删除的流程');
+        return;
+      }
+      let delIds = this.selectRows.map(row => row.id);
+      // 删除业务数据（后端删除流程实例）
+      this.batchDeleteExample({ ids: delIds });
+    },
+
+    // 选择框变化
+    handleSelectionChange(rows) {
+      this.selectRows = rows;
+    },
+
+    // 判断行是否可选（草稿或管理员可删除）
+    checkDel(row) {
+      return row.procDealStatus === 'draft' || MeritBPM.procManagePermit;
+    },
+
+    // 分页大小变化
+    handleSizeChange(val) {
+      this.pageSize = val;
+      this.currentPage = 1;
+      this.queryPageData();
+    },
+
+    // 页码变化
+    handleCurrentChange(val) {
+      this.$refs.tables.bodyWrapper.scrollTop = 0;
+      this.currentPage = val;
+      this.queryPageData();
+    },
+
+    // 状态标签
+    statusLabel(status) {
+      return 'status.' + status;
+    },
+
+    // 初始化加载
+    initLoadPage() {
+      this.currentPage = 1;
+      this.queryPageData();
+    },
+
+    // 查询数据
+    queryPageData() {
+      // 调用后端API查询列表
+      this.axios['cloud-system-bpm-demo']
+        .post('/page/procExample/page', {
+          procDefKey: this.procDefKey,
+          bpmStatus: this.bpmStatus,
+          pageNumber: this.currentPage,
+          pageSize: this.pageSize
+        })
+        .then(res => {
+          this.gridData = res.data.rows;
+          this.total = res.data.total;
+        });
+    },
+
+    // 批量删除
+    batchDeleteExample({ ids, callback }) {
+      this.axios['cloud-system-bpm-demo']
+        .post('/delete/batch', { ids: ids.join(',') })
+        .then(res => {
+          if (callback) callback(res.data);
+          this.initLoadPage();
+        });
+    }
+  }
+};
+</script>
+```
+
+---

package/skills/meritdata-dev-docs-file-finder/references/dev-docs//346/224/273/347/225/245-08-/346/265/201/347/250/213/345/211/215/347/253/257/347/273/204/344/273/266-/347/253/240/350/212/20205_/345/220/216/347/253/257BpmEngine/346/240/270/345/277/203/346/216/245/345/217/243.md

@@ -0,0 +1,135 @@
+---
+name: 攻略-08-流程前端组件-章节05_后端BpmEngine核心接口
+description: 后端BpmEngine核心接口 — 美林平台 BPM 前端组件与方法说明（BpmFormTools / BpmGridButtonsNew / MeritBPM）
+keywords: [BPM, 前端组件, BpmFormTools, BpmGridButtonsNew, MeritBPM, Vue, Element UI, 后端BpmEngine核心接口]
+use-cases: [BPM 前端组件集成, 流程表单开发, BPM 按钮组件]
+source-section: 4. 后端BpmEngine核心接口
+source-file: 应用开发平台-流程管理-使用攻略（八）：流程前端组件及方法说明文档.md
+---
+
+# 四、后端BpmEngine核心接口
+
+完整包路径：`com.meritdata.cloud.bpm.core.BpmEngine`
+
+### 4.1 方法概览表
+
+| 来源类 | 方法名 | 作用场景 | 说明 |
+|------|--------|----------|------|
+| BpmEngine | startProcess | 启动流程 | 根据流程定义Key和businessId启动流程 |
+| BpmEngine | ruleEngineInit | 规则引擎初始化 | 查询流程按钮配置信息，初始化流程操作界面 |
+| BpmEngine | ruleEngineRun | 规则引擎执行 | 根据businessId查询待办任务 |
+| BpmEngine | complete | 完成任务 | 完成当前任务，推进流程到下一节点 |
+| BpmEngine | deleteProcInsts | 删除流程实例 | 根据businessIds删除流程实例 |
+| BpmEngine | queryMainForms | 流程实例查询 | 分页查询流程实例列表 |
+| BpmEngine | getPage | 文字追踪 | 获取流程流转路径文字信息 |
+| BpmEngine | getGraphTrack | 图表追踪 | 获取流程图形追踪信息 |
+
+### 4.2 启动流程
+
+```java
+@Autowired
+private BpmEngine bpmEngine;
+
+@Autowired
+private SessionUtils sessionUtils;
+
+/**
+ * 启动流程
+ */
+public MainFormDTO startProcess(String procDefKey, Map<String, Object> variables) {
+    // 设置拟稿人
+    variables.put("bpmDrafterId", sessionUtils.getCurrentUserName());
+
+    // 启动流程
+    ResultBody<MainFormDTO> resultBody = bpmEngine.startProcess(procDefKey, variables);
+
+    if (resultBody != null && resultBody.isSuccess()) {
+        return resultBody.getData();
+    }
+    return null;
+}
+```
+
+### 4.3 查询流程实例列表（分页）
+
+```java
+@Autowired
+private BpmEngine bpmEngine;
+
+/**
+ * 分页查询流程实例
+ */
+public GridView<Map> pageProcExample(String procDefKey, String bpmStatus, int pageNumber, int pageSize) {
+    // 构建流程查询条件
+    MainFormQueryDTO formQuery = new MainFormQueryDTO();
+    formQuery.setBpmStatus(bpmStatus);
+
+    // 调用BpmEngine查询流程主表
+    ResultBody<GridView> resultBody = bpmEngine.queryMainForms(
+        JSONUtil.toJsonStr(formQuery), procDefKey, (pageNumber - 1) * pageSize, pageSize
+    );
+
+    List<Map> mainForms = new ArrayList<>();
+    long total = 0;
+    if (resultBody != null && resultBody.isSuccess() && resultBody.getData() != null) {
+        mainForms = resultBody.getData().getRows();
+        total = resultBody.getData().getTotal();
+    }
+
+    // 将流程数据与业务数据关联
+    // ... 关联业务表数据 ...
+
+    return new GridView<>(mainForms, total);
+}
+```
+
+### 5.4 删除流程实例
+
+```java
+@Autowired
+private BpmEngine bpmEngine;
+
+/**
+ * 批量删除流程实例
+ * 注意：先删流程，再删业务数据
+ */
+public boolean deleteBatch(List<String> businessIds) {
+    // 1. 调用BpmEngine删除流程实例
+    ResultBody<Boolean> resultBody = bpmEngine.deleteProcInsts(businessIds);
+
+    if (resultBody != null && resultBody.isSuccess() && resultBody.getData()) {
+        // 2. 流程删除成功后，删除业务表数据
+        exampleRepository.deleteAllByIds(businessIds);
+        return true;
+    }
+    return false;
+}
+```
+
+### 5.5 获取流程跟踪信息
+
+```java
+/**
+ * 获取流程文字跟踪信息
+ */
+public List<ProcTrackDTO> getFlowSteps(String procInstId) {
+    ResultBody<List<ProcTrackDTO>> resultBody = bpmEngine.getPage(procInstId, null, null);
+    if (resultBody != null && resultBody.isSuccess()) {
+        return resultBody.getData();
+    }
+    return Collections.emptyList();
+}
+
+/**
+ * 获取流程图形跟踪信息
+ */
+public Map getFlowGraph(String procInstId) {
+    ResultBody<Map> resultBody = bpmEngine.getGraphTrack(procInstId, null, null);
+    if (resultBody != null && resultBody.isSuccess()) {
+        return resultBody.getData();
+    }
+    return Collections.emptyMap();
+}
+```
+
+---

package/skills/meritdata-dev-docs-file-finder/references/dev-docs//346/224/273/347/225/245-08-/346/265/201/347/250/213/345/211/215/347/253/257/347/273/204/344/273/266-/347/253/240/350/212/20206_/351/231/204/345/275/225.md

@@ -0,0 +1,43 @@
+---
+name: 攻略-08-流程前端组件-章节06_附录
+description: 附录 — 美林平台 BPM 前端组件与方法说明（BpmFormTools / BpmGridButtonsNew / MeritBPM）
+keywords: [BPM, 前端组件, BpmFormTools, BpmGridButtonsNew, MeritBPM, Vue, Element UI, 附录]
+use-cases: [BPM 前端组件集成, 流程表单开发, BPM 按钮组件]
+source-section: 5. 附录
+source-file: 应用开发平台-流程管理-使用攻略（八）：流程前端组件及方法说明文档.md
+---
+
+# 五、附录
+
+### 5.1 BPM组件与API对应关系
+
+| 前端组件 | MeritBPM方法 | 后端API | 说明 |
+|----------|-------------|---------|------|
+| BpmFormTools | create/initRuleEngine | POST /api/engine/bpm/ruleengine/init/{procDefKey} | 创建流程/初始化规则引擎 |
+| BpmFormTools | runRuleEngine | POST /api/engine/bpm/ruleengine/run | 运行规则引擎 |
+| BpmFormTools | startProcess | POST /api/engine/bpm/{procDefKey}/startprocess | 发起流程 |
+| BpmGridButtonsNew | validatePermit | POST /api/engine/bpm/{procDefKey}/validate/permit | 验证权限 |
+| - | openProcTrackWindow | POST /api/engine/track/port | 打开流程跟踪 |
+
+### 5.2 流程变量说明
+
+| 变量名 | 类型 | 说明 |
+|--------|------|------|
+| bpmSubject | String | 流程标题（必填） |
+| bpmUrgent | String | 紧急程度 |
+| bpmSecret | String | 密级 |
+| bpmDrafterId | String | 拟稿人ID |
+| businessId | String | 业务数据ID |
+| procInstId | String | 流程实例ID |
+| undoId | String | 待办ID |
+| procDefKey | String | 流程定义Key |
+
+### 5.3 流程状态值说明
+
+| 状态值 | 说明 | 使用场景 |
+|--------|------|---------|
+| draft | 草稿 | 流程未提交 |
+| running | 进行中 | 流程正在审批 |
+| approved | 已通过 | 流程审批通过 |
+| rejected | 已驳回 | 流程被驳回 |
+| cancelled | 已取消 | 流程已取消 |

package/skills/meritdata-dev-docs-file-finder/references/dev-docs//346/224/273/347/225/245-09-/347/273/204/347/273/207/344/272/272/345/221/230/345/220/214/346/255/245-00_/346/200/273/350/247/210.md

@@ -0,0 +1,59 @@
+---
+name: 攻略-09-组织人员同步-00_总览
+description: 美林平台 HR/ERP 组织和人员同步二开（webservice + RESTful）
+keywords: [组织同步, 人员同步, 资源同步, 角色同步, 权限同步, webservice, RESTful, HR集成]
+use-cases: [HR 系统对接, 组织架构导入, 人员批量同步, 权限同步]
+related: [cloud-system-manage / 1.16 外部接口]
+source: 应用开发平台-基础平台-使用攻略（九）：组织和人员同步.md
+---
+
+# 应用开发平台使用攻略（九）：组织和人员同步 — 总览
+
+**摘要**：美林平台 HR/ERP 组织和人员同步二开（webservice + RESTful）
+
+**关联**：cloud-system-manage / 1.16 外部接口
+
+## 章节索引
+
+01. [概述](攻略-09-组织人员同步-章节01_概述.md) (原 1)
+02. [组织同步](攻略-09-组织人员同步-章节02_组织同步.md) (原 2)
+03. [人员同步](攻略-09-组织人员同步-章节03_人员同步.md) (原 3)
+04. [资源菜单同步](攻略-09-组织人员同步-章节04_资源菜单同步.md) (原 4)
+05. [角色同步](攻略-09-组织人员同步-章节05_角色同步.md)
+06. [资源权限同步](攻略-09-组织人员同步-章节06_资源权限同步.md) (原 6)
+07. [组织同步配置](攻略-09-组织人员同步-章节07_组织同步配置.md) (原 7)
+
+
+## 📑 API 速查
+
+本攻略共 **2 个 API**（按章节排序）：
+
+| 章节 | API | 方法 | 路径/签名 | 类型 | 描述 |
+|------|------|------|----------|------|------|
+| 章节02_组织同步 | `syncOrg` | POST | `/api/ou/sync/syncOrg` | http | 同步组织（WebService + RESTful 双通道） |
+| 章节03_人员同步 | `syncUser` | POST | `/api/ou/sync/syncUser` | http | 同步人员（含 userId + token） |
+
+### JSON Schema 完整索引
+
+```json
+[
+  {
+    "chapter": "章节02_组织同步",
+    "apiName": "syncOrg",
+    "method": "POST",
+    "urlPattern": "/api/ou/sync/syncOrg",
+    "type": "http",
+    "signature": "",
+    "functionDesc": "同步组织（WebService + RESTful 双通道）"
+  },
+  {
+    "chapter": "章节03_人员同步",
+    "apiName": "syncUser",
+    "method": "POST",
+    "urlPattern": "/api/ou/sync/syncUser",
+    "type": "http",
+    "signature": "",
+    "functionDesc": "同步人员（含 userId + token）"
+  }
+]
+```

package/skills/meritdata-dev-docs-file-finder/references/dev-docs//346/224/273/347/225/245-09-/347/273/204/347/273/207/344/272/272/345/221/230/345/220/214/346/255/245-/347/253/240/350/212/20201_/346/246/202/350/277/260.md

@@ -0,0 +1,16 @@
+---
+name: 攻略-09-组织人员同步-章节01_概述
+description: 概述 — 美林平台 HR/ERP 组织和人员同步二开（webservice + RESTful）
+keywords: [组织同步, 人员同步, 资源同步, 角色同步, 权限同步, webservice, RESTful, HR集成, 概述]
+use-cases: [HR 系统对接, 组织架构导入, 人员批量同步, 权限同步]
+source-section: 1. 概述
+source-file: 应用开发平台-基础平台-使用攻略（九）：组织和人员同步.md
+---
+
+# 1. 概述
+
+客户或开发人员在使用数据应用开发平台前，需要将其外部系统的组织人员信息整合移植到数据应用开发平台中。为了避免繁琐的数据录入，平台提供了的组织同步、人员同步、资源同步、角色同步、权限同步功能，这些功能大大简化了数据移植的过程。本文档将对以上同步功能的实现方式和步骤做详细讲解。
+
+由于同步数据涉及到关系数据的问题，我们建议同步顺序为：同步组织 =》 同步角色 =》 同步人员 =》 同步资源 =》 同步资源权限。
+
+同步所用到的所有标签来源于 系统管理 -> 基础配置 ->  组织人员同步 页签，可在对应的页签查询对应的标签的意义和用法。