{
  "module": "审核管理",
  "moduleKey": "auditRecord",
  "apiCount": 6,
  "apis": [
    {
      "title": "获取审核记录列表",
      "method": "GET",
      "path": "/api/audit-records",
      "description": "分页获取审核记录列表，支持按审核类型、状态、系统来源、关联ID筛选",
      "requestParams": {
        "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"
          }
        ]
      },
      "responseExample": {
        "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
          }
        }
      }
    },
    {
      "title": "获取审核记录详情",
      "method": "GET",
      "path": "/api/audit-records/{id}",
      "description": "根据ID获取审核记录详情",
      "requestParams": {
        "path": [
          {
            "name": "id",
            "type": "string",
            "required": true,
            "description": "审核记录ID"
          }
        ]
      },
      "responseExample": {
        "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
        }
      }
    },
    {
      "title": "创建审核记录",
      "method": "POST",
      "path": "/api/audit-records",
      "description": "管理端手动创建审核记录（OpenAPI 注册会自动创建）",
      "requestParams": {
        "body": {
          "auditType": "string｜必填，REGISTER_USER 或 REGISTER_CLIENT",
          "relatedId": "string｜必填，关联业务记录 _id",
          "relatedCollection": "string｜可选，users 或 clientUsers",
          "individualism": "boolean｜可选，注册类审核是否需开通独立站点",
          "organizationId": "string｜可选，企业注册时的组织ID",
          "systemSource": "string｜可选，系统来源编码",
          "applyRemark": "string｜可选，申请备注"
        }
      },
      "responseExample": {
        "success": {
          "code": "0000",
          "message": "创建审核记录成功",
          "data": {
            "id": 1,
            "code": "AR0001",
            "auditType": "REGISTER_USER",
            "status": 0,
            "applyTime": "2025-01-01T10:00:00.000Z"
          }
        }
      }
    },
    {
      "title": "更新审核记录",
      "method": "PUT",
      "path": "/api/audit-records/{id}",
      "description": "更新待审核记录的备注等信息（仅 status=0 可更新）",
      "requestParams": {
        "path": [
          {
            "name": "id",
            "type": "string",
            "required": true,
            "description": "审核记录ID"
          }
        ],
        "body": {
          "auditRemark": "string｜可选，审核备注",
          "applyRemark": "string｜可选，申请备注"
        }
      },
      "responseExample": {
        "success": {
          "code": "0000",
          "message": "更新审核记录成功",
          "data": {
            "id": 1,
            "code": "AR0001",
            "applyRemark": "补充说明"
          }
        }
      }
    },
    {
      "title": "删除审核记录",
      "method": "DELETE",
      "path": "/api/audit-records/{id}",
      "description": "删除指定的审核记录",
      "requestParams": {
        "path": [
          {
            "name": "id",
            "type": "string",
            "required": true,
            "description": "审核记录ID"
          }
        ]
      },
      "responseExample": {
        "success": {
          "code": "0000",
          "message": "删除审核记录成功",
          "data": {
            "result": true
          }
        }
      }
    },
    {
      "title": "审核（通过/拒绝）",
      "method": "POST",
      "path": "/api/audit-records/{id}/review",
      "description": "对待审核记录执行通过或拒绝。通过时按 auditType 调用对应业务执行器：注册类审核会启用账号，若 individualism=true 且 ENABLE_SITE_PROVISIONING 开启则开通独立站点",
      "requestParams": {
        "path": [
          {
            "name": "id",
            "type": "string",
            "required": true,
            "description": "审核记录ID"
          }
        ],
        "body": {
          "status": "number｜必填，1-通过，2-拒绝",
          "auditRemark": "string｜可选，审核备注"
        }
      },
      "responseExample": {
        "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
        }
      },
      "notes": [
        "审核类型 REGISTER_USER / REGISTER_CLIENT 分别对应注册-用户、注册-客户端业务执行器",
        "扩展新审核类型时，在 auditApprovalExecutorRegistry 注册新的执行策略即可"
      ]
    }
  ]
}