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

package/skills/meritdata-dev-docs-file-finder/references/dev-docs/25_2.1/347/273/204/347/273/207/347/273/264/346/212/244-/344/270/212/345/215/212.md

@@ -0,0 +1,459 @@
+---
+name: 组织维护-上半（2.1.1-2.1.6）
+source-file: 外部接口清单
+source-section: 2 组织机构 → 2.1 组织维护 → 2.1.1–2.1.6
+keywords: [组织维护, 新增组织, 删除组织, 停用, 启用, 组织列表, 组织机构树, org]
+use-cases: [组织CRUD, 组织启停, 组织查询, 单组织查询]
+related: [26, 27]
+---
+
+# 组织维护-上半（2.1.1-2.1.6）
+
+> **原文章节**：外部接口清单 → 2 组织机构 → 2.1 组织维护 → 2.1.1–2.1.6
+> **行号范围**：L2118–L2545
+
+## 🎯 一句话
+组织维护的基础 CRUD 接口：新增、删除、停用、启用、查询所有组织、按 ID 查询部门。
+
+## 📋 接口清单
+
+---
+
+## 2.1 组织维护
+
+---
+
+### 2.1.1 新增组织接口
+
+- **接口地址**：`/api/ou/org/create`
+- **请求类型**：`multipart/form-data`
+- **请求方式**：`post`
+- **接口备注**：`新增组织接口`
+- **调试工具**：`ApiPost`
+
+**请求体参数说明：**
+
+| 参数名 | 示例值 | 参数类型 |  |  | 是否必填 | 参数描述 |
+|---|---|---|---|---|---|---|
+|  |  |  | 参数类型 |  |  |  |
+| parentId | 3f2883b282195033 0182199cb96e0047 | String |  |  | 是 | 暂无描述 |
+| name | 2223 | String |  |  | 是 | 暂无描述 |
+| simpleName | 2223 | String |  |  | 是 | 暂无描述 |
+| deptCode | 2223 | String |  |  | 是 | 暂无描述 |
+| sort | 5 | String |  |  | 是 | 暂无描述 |
+| dLevel | 0 | String |  |  | 是 | 暂无描述 |
+| isAble | 1 | String |  |  | 是 | 暂无描述 |
+| customFieldMap | [] | String |  |  | 是 | 暂无描述 |
+
+**返回成功参数说明：**
+
+| 参数名 | 示例值 | 参数类型 | 参数描述 |
+|---|---|---|---|
+| 无请求参数 KEY/VALUE类型 |  |  |  |
+
+**返回失败参数说明：**
+
+| 参数名 | 示例值 | 参数类型 | 参数描述 |
+|---|---|---|---|
+| 201 | Object | Object | Created |
+| 401 | Object | Object | Unauthorized |
+| 403 | Object | Object | Forbidden |
+| 404 | Object | Object | Not Found |
+
+**返回成功示例**：
+
+```json
+{
+"data":{
+"tenantId": "",
+"secretCode": null,
+"secretName": null,
+"createTime": 1661225071632,
+"updateTime": 1661225071630,
+"creatorId": null,
+"reviserId": null,
+"id": "3f2883b282c4c2cd0182c8baf41100de",
+"name": "2223",
+"simpleName": "2223",
+"isAble": "1",
+"dLevel": "0",
+"parentId": "3f2883b2821950330182199cb96e0047",
+"deptCode": "2223",
+"remark": null,
+"sort": 5,
+"dLevelCode": "000001000007",
+"province": null,
+"children": null,
+页54/276
+"city": null,
+"contactNumber": null,
+"type": null,
+"disableFlag": null,
+"c": null,
+"d": null,
+"e": null,
+"f": null,
+"g": null,
+"h": null,
+"i": null,
+"j": null,
+"k": null,
+"l": null,
+"m": null,
+"n": null,
+"o": null,
+"p": null,
+"q": null,
+"r": null,
+"s": null,
+"t": null,
+"u": null,
+"v": null,
+"w": null,
+"x": null,
+"y": null,
+"z": null
+},
+"entityName": "2223",
+"success":true,
+"entityId": "3f2883b282c4c2cd0182c8baf41100de",
+"entityDLevelCode": "000001000007"
+}
+```
+
+
+**返回失败示例**：
+
+```json
+页55/276
+{"201":{},"401":{},"403":{},"404":{}}
+```
+
+---
+
+### 2.1.2
+
+- **接口地址**：`/api/ou/org/delete`
+- **请求类型**：`multipart/form-data`
+- **请求方式**：`post`
+- **接口备注**：`删除组织接口`
+---
+
+### 删除组织接口
+
+- **接口备注**：`删除组织接口`
+- **调试工具**：`ApiPost`
+
+**请求体参数说明：**
+
+| 参数名 | 示例值 | 参数类型 | 是否必填 | 参数描述 |
+|---|---|---|---|---|
+| ids | 3f2883b282c4c2cd 0182c8bbd12900e2 | String | 是 | 暂无描述 |
+
+**返回成功参数说明：**
+
+| 参数名 | 示例值 | 参数类型 | 参数描述 |
+|---|---|---|---|
+| 无请求参数 KEY/VALUE类型 |  |  |  |
+
+**返回失败参数说明：**
+
+| 参数名 | 示例值 | 参数类型 | 参数描述 |
+|---|---|---|---|
+| 201 | Object | Object | Created |
+| 401 | Object | Object | Unauthorized |
+| 403 | Object | Object | Forbidden |
+| 404 | Object | Object | Not Found |
+
+**返回成功示例**：
+
+```json
+{
+"success":true,
+"list": [
+"3f2883b282c4c2cd0182c8bbd12900e2"
+]
+}
+```
+
+
+**返回失败示例**：
+
+```json
+{"201":{},"401":{},"403":{},"404":{}}
+```
+
+---
+
+### 2.1.3 停用组织接口
+
+- **接口地址**：`/api/ou/org/disable`
+- **请求类型**：`multipart/form-data`
+- **请求方式**：`post`
+- **接口备注**：`停用组织接口`
+- **调试工具**：`ApiPost`
+
+**请求体参数说明：**
+
+| 参数名 | 示例值 | 参数类型 | 是否必填 | 参数描述 |
+|---|---|---|---|---|
+| ids | 3f2883b282195033 018219a0be6b004 e | String | 是 | 暂无描述 |
+
+**返回成功参数说明：**
+
+| 参数名 | 示例值 | 参数类型 | 参数描述 |
+|---|---|---|---|
+| 无请求参数 KEY/VALUE类型 |  |  |  |
+
+**返回失败参数说明：**
+
+| 参数名 | 示例值 | 参数类型 | 参数描述 |
+|---|---|---|---|
+| 201 | Object | Object | Created |
+| 401 | Object | Object | Unauthorized |
+| 403 | Object | Object | Forbidden |
+| 404 | Object | Object | Not Found |
+
+**返回失败示例**：
+
+```json
+{"201":{},"401":{},"403":{},"404":{}}
+```
+
+---
+
+### 2.1.4
+
+- **接口地址**：`/api/ou/org/enable`
+- **请求类型**：`multipart/form-data`
+- **请求方式**：`post`
+- **接口备注**：`启用组织接口`
+---
+
+### 启用组织接口
+
+- **接口备注**：`启用组织接口`
+- **调试工具**：`ApiPost`
+
+**请求体参数说明：**
+
+| 参数名 | 示例值 | 参数类型 | 是否必填 | 参数描述 |
+|---|---|---|---|---|
+| ids | 3f2883b282195033 018219a0be6b004 | String | 是 | 暂无描述 |
+
+**返回成功参数说明：**
+
+| 参数名 | 示例值 | 参数类型 | 参数描述 |
+|---|---|---|---|
+| 无请求参数 KEY/VALUE类型 |  |  |  |
+
+**返回失败参数说明：**
+
+| 参数名 | 示例值 | 参数类型 | 参数描述 |
+|---|---|---|---|
+| 201 | Object | Object | Created |
+| 401 | Object | Object | Unauthorized |
+| 403 | Object | Object | Forbidden |
+| 404 | Object | Object | Not Found |
+
+**返回失败示例**：
+
+```json
+{"201":{},"401":{},"403":{},"404":{}}
+```
+
+---
+
+### 2.1.5
+
+- **接口地址**：`/api/ou/org/findAll?rootOrgId=3f2883b282195033018219a0be6b004e`
+- **请求类型**：`text/plain`
+- **请求方式**：`get`
+- **接口备注**：`获取所有组织信息`
+---
+
+### 获取所有组织信息
+
+- **接口备注**：`获取所有组织信息`
+- **调试工具**：`ApiPost`
+
+**URI 参数说明：**
+
+| 参数名 | 示例值 | 参数类型 | 是否必填 | 参数描述 |
+|---|---|---|---|---|
+| rootOrgId | 3f2883b282195033 018219a0be6b004 e | String | 是 | 暂无描述 |
+
+**请求体参数说明：**
+
+| 参数名 | 示例值 | 参数类型 | 是否必填 | 参数描述 |
+|---|---|---|---|---|
+| 无请求参数 KEY/VALUE类型 |  |  |  |  |
+
+**返回成功参数说明：**
+
+| 参数名 | 示例值 | 参数类型 | 参数描述 |
+|---|---|---|---|
+| timestamp | 1661225479105 | String | 时间戳 |
+| status | 1 | Integer | 状态 |
+| message | 成功 | String | 返回消息 |
+| stackmessage |  | String | 堆栈消息 |
+| path | /api/ou/org/findAll | String | api 路径 |
+| data |  | Object | 返回数据 |
+| data.name | 11 | String | 暂无描述 |
+| data.id | 3f2883b282195033018219a0b e6b004e | String | 暂无描述 |
+| data.parentId | 3f2883b2821950330182199cb 96e0047 | String | 暂无描述 |
+| data.deptCode | 11 | String | 暂无描述 |
+| data.dLevelCode | 000001000001 | String | 暂无描述 |
+| extraInfo | {} | Object | 拓展信息 |
+| success | true | Boolean | 成功响应 |
+
+**返回失败参数说明：**
+
+| 参数名 | 示例值 | 参数类型 | 参数描述 |
+|---|---|---|---|
+
+**返回成功示例**：
+
+```json
+{
+"timestamp": 1661225479105,
+"status": 1,
+"message": "成功",
+"stackmessage": null,
+"path": "/api/ou/org/findAll",
+"data": [
+{
+"name": "11",
+"id": "3f2883b282195033018219a0be6b004e",
+"parentId": "3f2883b2821950330182199cb96e0047",
+"deptCode": "11",
+"dLevelCode": "000001000001"
+}
+```
+
+
+**返回失败示例**：
+
+```json
+{"401":{},"403":{},"404":{}}
+```
+
+---
+
+### 2.1.6 id
+
+- **接口地址**：`/api/ou/org/getDeptById`
+- **请求类型**：`multipart/form-data`
+- **请求方式**：`post`
+- **接口备注**：`根据id 得到部门`
+---
+
+### 根据得到部门
+
+- **接口备注**：`根据id 得到部门`
+- **调试工具**：`ApiPost`
+
+**请求体参数说明：**
+
+| 参数名 | 示例值 | 参数类型 | 是否必填 | 参数描述 |
+|---|---|---|---|---|
+| id | 3f2883b282195033 018219a0be6b004 e | String | 是 | 暂无描述 |
+
+**返回成功参数说明：**
+
+| 参数名 | 示例值 | 参数类型 | 参数描述 |
+|---|---|---|---|
+| c | String | String | 暂无描述 |
+| children | Array | Array | 暂无描述 |
+| city | String | String | 暂无描述 |
+| contactNumber | String | String | 暂无描述 |
+| createTime | String | String | 暂无描述 |
+| creatorId | String | String | 暂无描述 |
+| d | String | String | 暂无描述 |
+| dLevel | String | String | 暂无描述 |
+| dLevelCode | String | String | 暂无描述 |
+| deptCode | String | String | 暂无描述 |
+| disableFlag | Boolean | Boolean | 暂无描述 |
+| e | String | String | 暂无描述 |
+
+**返回失败参数说明：**
+
+| 参数名 | 示例值 | 参数类型 | 参数描述 |
+|---|---|---|---|
+| 201 | Object | Object | Created |
+| 401 | Object | Object | Unauthorized |
+| 403 | Object | Object | Forbidden |
+| 404 | Object | Object | Not Found |
+
+**返回成功示例**：
+
+```json
+{
+"tenantId": "",
+"secretCode": null,
+"secretName": null,
+"createTime": 1658287341000,
+"updateTime": 1658287341000,
+"creatorId": null,
+"reviserId": null,
+"id": "3f2883b282195033018219a0be6b004e",
+"name": "11",
+"simpleName": "11",
+"isAble": "1",
+"dLevel": "0",
+"parentId": "3f2883b2821950330182199cb96e0047",
+"deptCode": "11",
+"remark": null,
+"sort":0,
+"dLevelCode": "000001000001",
+"province": null,
+"children": null,
+"city": null,
+"contactNumber": null,
+"type": null,
+"disableFlag": null,
+"c": null,
+"d": null,
+"e": null,
+"f": null,
+"g": null,
+"h": null,
+"i": null,
+"j": null,
+"k": null,
+"l": null,
+"m": null,
+页62/276
+"n": null,
+"o": null,
+"p": null,
+"q": null,
+"r": null,
+"s": null,
+"t": null,
+"u": null,
+"v": null,
+"w": null,
+"x": null,
+"y": null,
+"z": null
+}
+```
+
+
+**返回失败示例**：
+
+```json
+{"201":{},"401":{},"403":{},"404":{}}
+```
+
+---
+
+## 💡 使用建议
+- 2.1.2 / 2.1.4 / 2.1.5 / 2.1.6 / 2.1.10 标题不完整是 **PDF 转写导致的**（如 `2.1.2` 应为"删除组织接口"），不影响调用，按 URL 即可识别
+- 2.1.3 停用、2.1.4 启用是 **软删除** 机制（`isAble=0/1`），不真正删除组织
+- 2.1.5 `findAll` 用 `rootOrgId` 控制查询范围，返回扁平数组，需前端自行构建树
+
+## 🔗 相关章节
+- [26_2.1组织维护-下半](./26_2.1组织维护-下半.md)
+- [27_2.2人员维护-上半](./27_2.2人员维护-上半.md)