meta {
  name: 导出用户列表
  type: http
  seq: 8
  tags: [
    generated
  ]
}

get {
  url: {{baseUrl}}/api/system/users/export
  body: none
  auth: inherit
}

params:query {
  keyword: 张
  deptId: 10
  employmentStatus: active
}

docs {
  # 导出用户列表
  `GET /api/system/users/export`
  导出用户列表（按筛选条件，返回文件信息）：按当前筛选条件全量导出 Excel，前端拿 fileId 走既有下载端点。

  ## 请求参数

  | 参数 | 类型 | 必填 | 默认 | 说明 |
  | --- | --- | --- | --- | --- |
  | current | int | 否 | 1 | 当前页码（导出忽略分页，全量导出） |
  | size | int | 否 | 10 | 每页条数（导出忽略） |
  | keyword | string | 否 | - | 模糊搜索关键字，匹配列由接口定义 |
  | orderBy | string | 否 | - | 排序字段 |
  | asc | boolean | 否 | false | 是否升序 |
  | deptId | string | 否 | - | 部门 ID，选中节点含全部子孙；null=全公司 |
  | employmentStatus | string | 否 | - | 在职状态 active/resigned/unassigned；null=不限 |
  | loginFrom | date | 否 | - | 最后登录起（含当天 00:00） |
  | loginTo | date | 否 | - | 最后登录讫（含当天 23:59:59） |

  ## 请求示例

  请求头：Authorization: Bearer {{token}}

  GET /api/system/users/export?keyword=张&deptId=10&employmentStatus=active

  ## 响应 data 结构

  | 字段 | 类型 | 说明 |
  | --- | --- | --- |
  | fileId | string | 文件唯一引用凭据（crm_file_info 主键），业务表只存它 |
  | originalName | string | 原始文件名 |
  | size | long | 文件大小（字节） |
  | contentType | string | MIME 类型 |
  | bizDomain | string | 业务域 |
  | creatorId | string | 上传者（无登录态的内部上传为 null） |
  | createTime | datetime | 生成时间 |
  | thumbnailStatus | string | 缩略图状态（PENDING/READY/FAILED/UNSUPPORTED） |

  ## 响应示例

  // 示例数据，字段结构以上表为准，非真实返回
  ```json
  {
    "code": 0,
    "success": true,
    "message": "success",
    "data": {
      "fileId": "9100",
      "originalName": "用户列表.xlsx",
      "size": 20480,
      "contentType": "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet",
      "bizDomain": "auth",
      "creatorId": "100",
      "createTime": "2026-09-07 10:00:00",
      "thumbnailStatus": "UNSUPPORTED"
    }
  }
  ```
}