# 审核管理

> 模块标识：auditRecord  |  接口数量：6

## 1. 获取审核记录列表
**方法**：	GET

**路径**：				/api/audit-records

**功能说明**：
分页获取审核记录列表，支持按审核类型、状态、系统来源、关联ID筛选

### 请求参数
```json
{
  "query": [
    {
      "name": "pageNum",
      "type": "number",
      "required": false,
      "description": "页码，默认1"
    },
    {
      "name": "pageSize",
      "type": "number",
      "required": false,
      "description": "每页数量，默认10"
    },
    {
      "name": "auditType",
      "type": "string",
      "required": false,
      "description": "审核类型：REGISTER_USER（注册-用户）、REGISTER_CLIENT（注册-客户端）"
    },
    {
      "name": "status",
      "type": "number",
      "required": false,
      "description": "审核状态：0-待审核，1-通过，2-拒绝"
    },
    {
      "name": "systemSource",
      "type": "string",
      "required": false,
      "description": "系统来源编码"
    },
    {
      "name": "relatedId",
      "type": "string",
      "required": false,
      "description": "关联业务记录ID"
    }
  ]
}
```

### 响应示例
```json
{
  "success": {
    "code": "0000",
    "message": "获取成功",
    "data": {
      "list": [
        {
          "id": 1,
          "code": "AR0001",
          "auditType": "REGISTER_USER",
          "relatedId": "user-id",
          "relatedCollection": "users",
          "individualism": true,
          "status": 0,
          "applyTime": "2025-01-01T10:00:00.000Z",
          "auditTime": null,
          "auditRemark": null,
          "auditor": null,
          "siteKey": "86AFEA7A-xxxx",
          "systemSource": "AUTH_MANAGEMENT"
        }
      ],
      "total": 1,
      "pageNum": 1,
      "pageSize": 10,
      "totalPages": 1
    }
  }
}
```


## 2. 获取审核记录详情
**方法**：	GET

**路径**：				/api/audit-records/{id}

**功能说明**：
根据ID获取审核记录详情

### 请求参数
```json
{
  "path": [
    {
      "name": "id",
      "type": "string",
      "required": true,
      "description": "审核记录ID"
    }
  ]
}
```

### 响应示例
```json
{
  "success": {
    "code": "0000",
    "message": "获取成功",
    "data": {
      "id": 1,
      "code": "AR0001",
      "auditType": "REGISTER_CLIENT",
      "relatedId": "client-user-id",
      "status": 0,
      "applyTime": "2025-01-01T10:00:00.000Z",
      "siteKey": "86AFEA7A-xxxx",
      "systemSource": "AUTH_MANAGEMENT"
    }
  },
  "failure": {
    "code": "4040",
    "message": "审核记录不存在",
    "data": null
  }
}
```


## 3. 创建审核记录
**方法**：	POST

**路径**：				/api/audit-records

**功能说明**：
管理端手动创建审核记录（OpenAPI 注册会自动创建）

### 请求参数
```json
{
  "body": {
    "auditType": "string｜必填，REGISTER_USER 或 REGISTER_CLIENT",
    "relatedId": "string｜必填，关联业务记录 _id",
    "relatedCollection": "string｜可选，users 或 clientUsers",
    "individualism": "boolean｜可选，注册类审核是否需开通独立站点",
    "organizationId": "string｜可选，企业注册时的组织ID",
    "systemSource": "string｜可选，系统来源编码",
    "applyRemark": "string｜可选，申请备注"
  }
}
```

### 响应示例
```json
{
  "success": {
    "code": "0000",
    "message": "创建审核记录成功",
    "data": {
      "id": 1,
      "code": "AR0001",
      "auditType": "REGISTER_USER",
      "status": 0,
      "applyTime": "2025-01-01T10:00:00.000Z"
    }
  }
}
```


## 4. 更新审核记录
**方法**：	PUT

**路径**：				/api/audit-records/{id}

**功能说明**：
更新待审核记录的备注等信息（仅 status=0 可更新）

### 请求参数
```json
{
  "path": [
    {
      "name": "id",
      "type": "string",
      "required": true,
      "description": "审核记录ID"
    }
  ],
  "body": {
    "auditRemark": "string｜可选，审核备注",
    "applyRemark": "string｜可选，申请备注"
  }
}
```

### 响应示例
```json
{
  "success": {
    "code": "0000",
    "message": "更新审核记录成功",
    "data": {
      "id": 1,
      "code": "AR0001",
      "applyRemark": "补充说明"
    }
  }
}
```


## 5. 删除审核记录
**方法**：	DELETE

**路径**：				/api/audit-records/{id}

**功能说明**：
删除指定的审核记录

### 请求参数
```json
{
  "path": [
    {
      "name": "id",
      "type": "string",
      "required": true,
      "description": "审核记录ID"
    }
  ]
}
```

### 响应示例
```json
{
  "success": {
    "code": "0000",
    "message": "删除审核记录成功",
    "data": {
      "result": true
    }
  }
}
```


## 6. 审核（通过/拒绝）
**方法**：	POST

**路径**：				/api/audit-records/{id}/review

**功能说明**：
对待审核记录执行通过或拒绝。通过时按 auditType 调用对应业务执行器：注册类审核会启用账号，若 individualism=true 且 ENABLE_SITE_PROVISIONING 开启则开通独立站点

### 请求参数
```json
{
  "path": [
    {
      "name": "id",
      "type": "string",
      "required": true,
      "description": "审核记录ID"
    }
  ],
  "body": {
    "status": "number｜必填，1-通过，2-拒绝",
    "auditRemark": "string｜可选，审核备注"
  }
}
```

### 响应示例
```json
{
  "success": {
    "code": "0000",
    "message": "审核通过",
    "data": {
      "record": {
        "id": 1,
        "code": "AR0001",
        "status": 1,
        "auditTime": "2025-01-01T11:00:00.000Z",
        "auditor": "13800000000"
      },
      "executionResult": {
        "accountType": "company",
        "site": {
          "siteKey": "A1B2C3D4-xxxx"
        }
      }
    }
  },
  "failure": {
    "code": "4090",
    "message": "该审核记录已处理，无法重复审核",
    "data": null
  }
}
```

### 注意事项
- 审核类型 REGISTER_USER / REGISTER_CLIENT 分别对应注册-用户、注册-客户端业务执行器
- 扩展新审核类型时，在 auditApprovalExecutorRegistry 注册新的执行策略即可