{
  "module": {
    "module": "会员用户管理",
    "moduleKey": "memberUser"
  },
  "api": {
    "title": "获取会员用户列表",
    "method": "GET",
    "path": "/api/member-users",
    "description": "分页获取会员用户列表。会员用户用于将系统用户或客户端用户与会员（members）关联，供有状态会员 OpenAPI 校验使用。",
    "requestParams": {
      "query": [
        {
          "name": "pageNum",
          "type": "number",
          "required": false,
          "description": "页码，默认1"
        },
        {
          "name": "pageSize",
          "type": "number",
          "required": false,
          "description": "每页数量，默认10"
        },
        {
          "name": "status",
          "type": "number",
          "required": false,
          "description": "按状态筛选：1-有效，0-无效"
        },
        {
          "name": "memberId",
          "type": "string",
          "required": false,
          "description": "按会员ID筛选（会员管理记录的 _id 或 id）"
        }
      ]
    },
    "responseExample": {
      "success": {
        "code": "0000",
        "message": "获取成功",
        "data": {
          "list": [
            {
              "id": 1,
              "code": "MU0001",
              "userId": "abc123",
              "userType": "clientUser",
              "memberId": "member001",
              "status": 1
            }
          ],
          "total": 100,
          "pageNum": 1,
          "pageSize": 10
        }
      }
    },
    "notes": [
      "userId 为绑定的系统用户或客户端用户的主键（_id 或 id），统一存储在该字段",
      "userType 标识绑定用户类型：user（系统用户）或 clientUser（客户端用户）；OpenAPI 激活创建的记录可能未写入 userType，但有状态会员校验仍可通过 userId 匹配登录用户"
    ]
  }
}