API模块详情

{
  "success": {
    "code": 200,
    "message": "获取成功",
    "data": {
      "list": [
        {
          "id": 1,
          "code": "USER001",
          "name": "张三",
          "title": "系统管理员",
          "phone": "13800138000",
          "email": "zhangsan@example.com",
          "phonePrefix": "+86",
          "status": 1,
          "createTime": "2024-01-01T00:00:00.000Z"
        }
      ],
      "total": 100,
      "pageNum": 1,
      "pageSize": 10
    }
  }
}

{
  "success": {
    "code": "0000",
    "message": "获取成功",
    "data": {
      "id": 1,
      "code": "USER0001",
      "name": "系统管理员",
      "phone": "13800000000",
      "status": 1,
      "roles": [
        "ROLE0001"
      ],
      "createTime": "2025-01-01T10:00:00.000Z"
    }
  },
  "failure": {
    "code": "4040",
    "message": "系统用户不存在",
    "data": null
  }
}

{
  "success": {
    "code": "0000",
    "message": "创建系统用户成功",
    "data": {
      "id": 1,
      "code": "USER0001",
      "name": "系统管理员",
      "phone": "13800000000",
      "status": 1,
      "initialPassword": "smk100930",
      "roles": [
        "ROLE0001"
      ],
      "createTime": "2025-01-01T10:09:30.000Z"
    }
  },
  "failure": {
    "code": "4000",
    "message": "创建系统用户失败",
    "data": null
  }
}

{
  "success": {
    "code": "0000",
    "message": "更新系统用户成功",
    "data": {
      "id": 1,
      "code": "USER0001",
      "name": "系统管理员",
      "phone": "13800000000",
      "status": 1,
      "roles": [
        "ROLE0001"
      ],
      "createTime": "2025-01-01T10:00:00.000Z"
    }
  },
  "failure": {
    "code": "4000",
    "message": "更新系统用户失败",
    "data": null
  }
}

{
  "success": {
    "code": "0000",
    "message": "删除系统用户成功",
    "data": {
      "result": true
    }
  },
  "failure": {
    "code": "4000",
    "message": "删除系统用户失败",
    "data": null
  }
}

{
  "success": {
    "code": "0000",
    "message": "状态更新成功",
    "data": {
      "id": 1,
      "code": "USER0001",
      "name": "系统管理员",
      "phone": "13800000000",
      "status": 1,
      "updateTime": "2025-01-01T10:00:00.000Z"
    }
  },
  "failure": {
    "code": "4040",
    "message": "用户不存在",
    "data": null
  }
}

{
  "success": {
    "code": "0000",
    "message": "密码重置成功",
    "data": {
      "initialPassword": "smk143052"
    }
  },
  "failure": {
    "code": "4040",
    "message": "用户不存在",
    "data": null
  }
}

{
  "success": {
    "code": "0000",
    "message": "注册成功",
    "data": {
      "userId": "USER0001",
      "token": "jwt-token",
      "scopeKeys": [
        {
          "key": "uuid-personal",
          "type": "personal",
          "label": "个人"
        },
        {
          "key": "uuid-org",
          "type": "organization",
          "organizationId": 1,
          "label": "示例公司"
        }
      ],
      "defaultScopeKey": "uuid-org"
    }
  },
  "failure": {
    "code": "4000",
    "message": "注册失败",
    "data": null
  }
}

• 如果 individualism=true，系统会：1. 创建独立数据库 2. 在独立数据库中创建用户副本 3. 创建超级管理员角色并绑定用户
• 注册成功后，用户记录在所属站点数据库创建，同时在独立数据库中创建副本用于角色绑定
• 响应 data 包含 scopeKeys（可用 scope 列表）与 defaultScopeKey（默认 scope，有组织时为组织 key）

{
  "success": {
    "code": "0000",
    "message": "登录成功",
    "data": {
      "token": "jwt-token",
      "user": {
        "id": "USER0001",
        "name": "系统管理员"
      },
      "scopeKeys": [
        {
          "key": "uuid-personal",
          "type": "personal",
          "label": "个人"
        },
        {
          "key": "uuid-org",
          "type": "organization",
          "organizationId": 1,
          "label": "示例公司"
        }
      ],
      "defaultScopeKey": "uuid-org"
    }
  },
  "failure": {
    "code": "4000",
    "message": "登录失败",
    "data": null
  }
}

• 如果用户有独立站点，availableSites 会包含两个站点：所属站点（type: owner）和个人站点（type: personal）
• 前端可以通过 X-Site header 切换站点，切换后所有 API 请求将使用对应站点的数据库
• 默认使用所属站点（isDefault: true），如需切换到个人站点，在后续请求中传递个人站点的 siteKey
• 响应 data 包含 scopeKeys（可用 scope 列表）与 defaultScopeKey（默认 scope，有组织时为组织 key）

{
  "success": {
    "code": "0000",
    "message": "注册成功",
    "data": {
      "clientUserId": "CU0001",
      "token": "jwt-token",
      "scopeKeys": [
        {
          "key": "uuid-personal",
          "type": "personal",
          "label": "个人"
        },
        {
          "key": "uuid-org",
          "type": "organization",
          "organizationId": 1,
          "label": "示例公司"
        }
      ],
      "defaultScopeKey": "uuid-org"
    }
  },
  "failure": {
    "code": "4000",
    "message": "注册失败",
    "data": null
  }
}

• 如果 individualism=true，系统会：1. 创建独立数据库 2. 在独立数据库中创建用户副本 3. 创建超级管理员角色并绑定用户
• 注册成功后，用户记录在所属站点数据库创建，同时在独立数据库中创建副本用于角色绑定
• 响应 data 包含 scopeKeys（可用 scope 列表）与 defaultScopeKey（默认 scope，有组织时为组织 key）

{
  "success": {
    "code": "0000",
    "message": "登录成功",
    "data": {
      "token": "jwt-token",
      "user": {
        "id": "CU0001",
        "name": "客户端管理员"
      },
      "scopeKeys": [
        {
          "key": "uuid-personal",
          "type": "personal",
          "label": "个人"
        },
        {
          "key": "uuid-org",
          "type": "organization",
          "organizationId": 1,
          "label": "示例公司"
        }
      ],
      "defaultScopeKey": "uuid-org"
    }
  },
  "failure": {
    "code": "4000",
    "message": "登录失败",
    "data": null
  }
}

• 如果用户有独立站点，availableSites 会包含两个站点：所属站点（type: owner）和个人站点（type: personal）
• 前端可以通过 X-Site header 切换站点，切换后所有 API 请求将使用对应站点的数据库
• 默认使用所属站点（isDefault: true），如需切换到个人站点，在后续请求中传递个人站点的 siteKey
• 响应 data 包含 scopeKeys（可用 scope 列表）与 defaultScopeKey（默认 scope，有组织时为组织 key）

{
  "success": {
    "code": "0000",
    "message": "业务开通成功",
    "data": {
      "systemCode": "AUTH",
      "activated": true
    }
  },
  "failure": {
    "code": "4000",
    "message": "业务开通失败",
    "data": null
  }
}

• 需管理员身份调用

{
  "success": {
    "code": "0000",
    "message": "切换存储模式成功",
    "data": {
      "mode": "FILE"
    }
  },
  "failure": {
    "code": "4000",
    "message": "切换存储模式失败",
    "data": null
  }
}

• 切换后会自动重启数据源，请确保备份

{
  "success": {
    "code": "0000",
    "message": "切换客户端用户存储模式成功",
    "data": {
      "mode": "FILE"
    }
  },
  "failure": {
    "code": "4000",
    "message": "切换客户端用户存储模式失败",
    "data": null
  }
}

暂无请求参数定义

{
  "success": {
    "code": "0000",
    "message": "获取成功",
    "data": {
      "userMode": "FILE",
      "clientUserMode": "FILE"
    }
  }
}

暂无请求参数定义

{
  "success": {
    "code": "0000",
    "message": "获取成功",
    "data": {
      "version": "1.0.0",
      "buildTime": "2025-01-01T10:00:00.000Z",
      "storageMode": "FILE"
    }
  }
}

{
  "success": {
    "code": "0000",
    "message": "获取成功",
    "data": {
      "list": [
        {
          "id": 1,
          "code": "CU0001",
          "name": "客户端管理员",
          "phone": "13900000000",
          "status": 1,
          "createTime": "2025-01-01T10:00:00.000Z"
        }
      ],
      "total": 100,
      "pageNum": 1,
      "pageSize": 10
    }
  }
}

{
  "success": {
    "code": "0000",
    "message": "获取成功",
    "data": {
      "id": 1,
      "code": "CU0001",
      "name": "客户端管理员",
      "phone": "13900000000",
      "status": 1,
      "createTime": "2025-01-01T10:00:00.000Z"
    }
  },
  "failure": {
    "code": "4040",
    "message": "客户端用户不存在",
    "data": null
  }
}

{
  "success": {
    "code": "0000",
    "message": "创建客户端用户成功",
    "data": {
      "id": 1,
      "code": "CU0001",
      "name": "客户端管理员",
      "phone": "13900000000",
      "status": 1,
      "initialPassword": "smk100930",
      "createTime": "2025-01-01T10:09:30.000Z"
    }
  },
  "failure": {
    "code": "4000",
    "message": "创建客户端用户失败",
    "data": null
  }
}

{
  "success": {
    "code": "0000",
    "message": "更新客户端用户成功",
    "data": {
      "id": 1,
      "code": "CU0001",
      "name": "客户端管理员",
      "phone": "13900000000",
      "status": 1,
      "createTime": "2025-01-01T10:00:00.000Z"
    }
  },
  "failure": {
    "code": "4000",
    "message": "更新客户端用户失败",
    "data": null
  }
}

{
  "success": {
    "code": "0000",
    "message": "删除客户端用户成功",
    "data": {
      "result": true
    }
  },
  "failure": {
    "code": "4000",
    "message": "删除客户端用户失败",
    "data": null
  }
}

{
  "success": {
    "code": "0000",
    "message": "状态更新成功",
    "data": {
      "id": 1,
      "code": "CU0001",
      "name": "客户端管理员",
      "phone": "13900000000",
      "status": 1,
      "updateTime": "2025-01-01T10:00:00.000Z"
    }
  },
  "failure": {
    "code": "4040",
    "message": "客户端用户不存在",
    "data": null
  }
}

{
  "success": {
    "code": "0000",
    "message": "密码重置成功",
    "data": {
      "initialPassword": "smk143052"
    }
  },
  "failure": {
    "code": "4040",
    "message": "客户端用户不存在",
    "data": null
  }
}

{
  "success": {
    "code": "0000",
    "message": "获取成功",
    "data": {
      "list": [
        {
          "id": 1,
          "code": "ORG0001",
          "name": "总部",
          "parentId": null,
          "status": 1,
          "createTime": "2025-01-01T10:00:00.000Z"
        }
      ],
      "total": 100,
      "pageNum": 1,
      "pageSize": 10
    }
  }
}

{
  "success": {
    "code": "0000",
    "message": "获取成功",
    "data": {
      "id": 1,
      "code": "ORG0001",
      "name": "总部",
      "parentId": null,
      "status": 1,
      "createTime": "2025-01-01T10:00:00.000Z"
    }
  },
  "failure": {
    "code": "4040",
    "message": "组织不存在",
    "data": null
  }
}

{
  "success": {
    "code": "0000",
    "message": "创建组织成功",
    "data": {
      "id": 1,
      "code": "ORG0001",
      "name": "总部",
      "parentId": null,
      "status": 1,
      "createTime": "2025-01-01T10:00:00.000Z"
    }
  },
  "failure": {
    "code": "4000",
    "message": "创建组织失败",
    "data": null
  }
}

{
  "success": {
    "code": "0000",
    "message": "更新组织成功",
    "data": {
      "id": 1,
      "code": "ORG0001",
      "name": "总部",
      "parentId": null,
      "status": 1,
      "createTime": "2025-01-01T10:00:00.000Z"
    }
  },
  "failure": {
    "code": "4000",
    "message": "更新组织失败",
    "data": null
  }
}

{
  "success": {
    "code": "0000",
    "message": "删除组织成功",
    "data": {
      "result": true
    }
  },
  "failure": {
    "code": "4000",
    "message": "删除组织失败",
    "data": null
  }
}

{
  "success": {
    "code": "0000",
    "message": "获取成功",
    "data": {
      "id": 1,
      "code": "ORG0001",
      "name": "总部",
      "parentId": null,
      "status": 1,
      "createTime": "2025-01-01T10:00:00.000Z"
    }
  },
  "failure": {
    "code": "4040",
    "message": "组织不存在",
    "data": null
  }
}

{
  "success": {
    "code": "0000",
    "message": "更新组织成功",
    "data": {
      "id": 1,
      "code": "ORG0001",
      "name": "总部",
      "parentId": null,
      "status": 1,
      "createTime": "2025-01-01T10:00:00.000Z"
    }
  },
  "failure": {
    "code": "4000",
    "message": "更新组织失败",
    "data": null
  }
}

{
  "success": {
    "code": "0000",
    "message": "获取成功",
    "data": {
      "list": [
        {
          "id": 1,
          "code": "DEP0001",
          "name": "研发部",
          "organizationId": "ORG0001",
          "status": 1,
          "createTime": "2025-01-01T10:00:00.000Z"
        }
      ],
      "total": 100,
      "pageNum": 1,
      "pageSize": 10
    }
  }
}

{
  "success": {
    "code": "0000",
    "message": "获取成功",
    "data": {
      "id": 1,
      "code": "DEP0001",
      "name": "研发部",
      "organizationId": "ORG0001",
      "status": 1,
      "createTime": "2025-01-01T10:00:00.000Z"
    }
  },
  "failure": {
    "code": "4040",
    "message": "部门不存在",
    "data": null
  }
}

{
  "success": {
    "code": "0000",
    "message": "创建部门成功",
    "data": {
      "id": 1,
      "code": "DEP0001",
      "name": "研发部",
      "organizationId": "ORG0001",
      "status": 1,
      "createTime": "2025-01-01T10:00:00.000Z"
    }
  },
  "failure": {
    "code": "4000",
    "message": "创建部门失败",
    "data": null
  }
}

{
  "success": {
    "code": "0000",
    "message": "更新部门成功",
    "data": {
      "id": 1,
      "code": "DEP0001",
      "name": "研发部",
      "organizationId": "ORG0001",
      "status": 1,
      "createTime": "2025-01-01T10:00:00.000Z"
    }
  },
  "failure": {
    "code": "4000",
    "message": "更新部门失败",
    "data": null
  }
}

{
  "success": {
    "code": "0000",
    "message": "删除部门成功",
    "data": {
      "result": true
    }
  },
  "failure": {
    "code": "4000",
    "message": "删除部门失败",
    "data": null
  }
}

{
  "success": {
    "code": "0000",
    "message": "获取成功",
    "data": {
      "id": 1,
      "code": "DEP0001",
      "name": "研发部",
      "organizationId": "ORG0001",
      "status": 1,
      "createTime": "2025-01-01T10:00:00.000Z"
    }
  },
  "failure": {
    "code": "4040",
    "message": "部门不存在",
    "data": null
  }
}

{
  "success": {
    "code": "0000",
    "message": "更新部门成功",
    "data": {
      "id": 1,
      "code": "DEP0001",
      "name": "研发部",
      "organizationId": "ORG0001",
      "status": 1,
      "createTime": "2025-01-01T10:00:00.000Z"
    }
  },
  "failure": {
    "code": "4000",
    "message": "更新部门失败",
    "data": null
  }
}

{
  "success": {
    "code": "0000",
    "message": "获取成功",
    "data": {
      "list": [
        {
          "id": 1,
          "code": "POS0001",
          "name": "产品经理",
          "status": 1,
          "createTime": "2025-01-01T10:00:00.000Z"
        }
      ],
      "total": 100,
      "pageNum": 1,
      "pageSize": 10
    }
  }
}

{
  "success": {
    "code": "0000",
    "message": "获取成功",
    "data": {
      "id": 1,
      "code": "POS0001",
      "name": "产品经理",
      "status": 1,
      "createTime": "2025-01-01T10:00:00.000Z"
    }
  },
  "failure": {
    "code": "4040",
    "message": "岗位不存在",
    "data": null
  }
}

{
  "success": {
    "code": "0000",
    "message": "创建岗位成功",
    "data": {
      "id": 1,
      "code": "POS0001",
      "name": "产品经理",
      "status": 1,
      "createTime": "2025-01-01T10:00:00.000Z"
    }
  },
  "failure": {
    "code": "4000",
    "message": "创建岗位失败",
    "data": null
  }
}

{
  "success": {
    "code": "0000",
    "message": "更新岗位成功",
    "data": {
      "id": 1,
      "code": "POS0001",
      "name": "产品经理",
      "status": 1,
      "createTime": "2025-01-01T10:00:00.000Z"
    }
  },
  "failure": {
    "code": "4000",
    "message": "更新岗位失败",
    "data": null
  }
}

{
  "success": {
    "code": "0000",
    "message": "删除岗位成功",
    "data": {
      "result": true
    }
  },
  "failure": {
    "code": "4000",
    "message": "删除岗位失败",
    "data": null
  }
}

{
  "success": {
    "code": "0000",
    "message": "获取成功",
    "data": {
      "id": 1,
      "code": "POS0001",
      "name": "产品经理",
      "status": 1,
      "createTime": "2025-01-01T10:00:00.000Z"
    }
  },
  "failure": {
    "code": "4040",
    "message": "岗位不存在",
    "data": null
  }
}

{
  "success": {
    "code": "0000",
    "message": "更新岗位成功",
    "data": {
      "id": 1,
      "code": "POS0001",
      "name": "产品经理",
      "status": 1,
      "createTime": "2025-01-01T10:00:00.000Z"
    }
  },
  "failure": {
    "code": "4000",
    "message": "更新岗位失败",
    "data": null
  }
}

{
  "success": {
    "code": "0000",
    "message": "获取成功",
    "data": {
      "list": [
        {
          "id": 1,
          "code": "STA0001",
          "name": "张三",
          "phone": "13800000001",
          "organizationId": "ORG0001",
          "status": 1,
          "createTime": "2025-01-01T10:00:00.000Z"
        }
      ],
      "total": 100,
      "pageNum": 1,
      "pageSize": 10
    }
  }
}

{
  "success": {
    "code": "0000",
    "message": "获取成功",
    "data": {
      "id": 1,
      "code": "STA0001",
      "name": "张三",
      "phone": "13800000001",
      "organizationId": "ORG0001",
      "status": 1,
      "createTime": "2025-01-01T10:00:00.000Z"
    }
  },
  "failure": {
    "code": "4040",
    "message": "职员不存在",
    "data": null
  }
}

{
  "success": {
    "code": "0000",
    "message": "创建职员成功",
    "data": {
      "id": 1,
      "code": "STA0001",
      "name": "张三",
      "phone": "13800000001",
      "organizationId": "ORG0001",
      "status": 1,
      "createTime": "2025-01-01T10:00:00.000Z"
    }
  },
  "failure": {
    "code": "4000",
    "message": "创建职员失败",
    "data": null
  }
}

{
  "success": {
    "code": "0000",
    "message": "更新职员成功",
    "data": {
      "id": 1,
      "code": "STA0001",
      "name": "张三",
      "phone": "13800000001",
      "organizationId": "ORG0001",
      "status": 1,
      "createTime": "2025-01-01T10:00:00.000Z"
    }
  },
  "failure": {
    "code": "4000",
    "message": "更新职员失败",
    "data": null
  }
}

{
  "success": {
    "code": "0000",
    "message": "删除职员成功",
    "data": {
      "result": true
    }
  },
  "failure": {
    "code": "4000",
    "message": "删除职员失败",
    "data": null
  }
}

{
  "success": {
    "code": "0000",
    "message": "获取成功",
    "data": {
      "list": [
        {
          "id": 1,
          "code": "ROLE0001",
          "name": "系统管理员",
          "status": 1,
          "permissions": [
            "PERM0001"
          ],
          "resources": [
            "RES0001"
          ]
        }
      ],
      "total": 100,
      "pageNum": 1,
      "pageSize": 10
    }
  }
}

{
  "success": {
    "code": "0000",
    "message": "获取成功",
    "data": {
      "id": 1,
      "code": "ROLE0001",
      "name": "系统管理员",
      "status": 1,
      "permissions": [
        "PERM0001"
      ],
      "resources": [
        "RES0001"
      ]
    }
  },
  "failure": {
    "code": "4040",
    "message": "角色不存在",
    "data": null
  }
}

{
  "success": {
    "code": "0000",
    "message": "创建角色成功",
    "data": {
      "id": 1,
      "code": "ROLE0001",
      "name": "系统管理员",
      "status": 1,
      "permissions": [
        "PERM0001"
      ],
      "resources": [
        "RES0001"
      ]
    }
  },
  "failure": {
    "code": "4000",
    "message": "创建角色失败",
    "data": null
  }
}

{
  "success": {
    "code": "0000",
    "message": "更新角色成功",
    "data": {
      "id": 1,
      "code": "ROLE0001",
      "name": "系统管理员",
      "status": 1,
      "permissions": [
        "PERM0001"
      ],
      "resources": [
        "RES0001"
      ]
    }
  },
  "failure": {
    "code": "4000",
    "message": "更新角色失败",
    "data": null
  }
}

{
  "success": {
    "code": "0000",
    "message": "删除角色成功",
    "data": {
      "result": true
    }
  },
  "failure": {
    "code": "4000",
    "message": "删除角色失败",
    "data": null
  }
}

{
  "success": {
    "code": "0000",
    "message": "更新角色成功",
    "data": {
      "id": 1,
      "code": "ROLE0001",
      "name": "系统管理员",
      "status": 1,
      "permissions": [
        "PERM0001"
      ],
      "resources": [
        "RES0001"
      ]
    }
  },
  "failure": {
    "code": "4000",
    "message": "更新角色失败",
    "data": null
  }
}

{
  "success": {
    "code": "0000",
    "message": "更新角色成功",
    "data": {
      "id": 1,
      "code": "ROLE0001",
      "name": "系统管理员",
      "status": 1,
      "permissions": [
        "PERM0001"
      ],
      "resources": [
        "RES0001"
      ]
    }
  },
  "failure": {
    "code": "4000",
    "message": "更新角色失败",
    "data": null
  }
}

{
  "success": {
    "code": "0000",
    "message": "获取成功",
    "data": {
      "list": [
        {
          "id": 1,
          "code": "PERM0001",
          "name": "用户管理",
          "type": "menu",
          "status": 1,
          "createTime": "2025-01-01T10:00:00.000Z"
        }
      ],
      "total": 100,
      "pageNum": 1,
      "pageSize": 10
    }
  }
}

{
  "success": {
    "code": "0000",
    "message": "获取成功",
    "data": {
      "id": 1,
      "code": "PERM0001",
      "name": "用户管理",
      "type": "menu",
      "status": 1,
      "createTime": "2025-01-01T10:00:00.000Z"
    }
  },
  "failure": {
    "code": "4040",
    "message": "权限不存在",
    "data": null
  }
}

{
  "success": {
    "code": "0000",
    "message": "创建权限成功",
    "data": {
      "id": 1,
      "code": "PERM0001",
      "name": "用户管理",
      "type": "menu",
      "status": 1,
      "createTime": "2025-01-01T10:00:00.000Z"
    }
  },
  "failure": {
    "code": "4000",
    "message": "创建权限失败",
    "data": null
  }
}

{
  "success": {
    "code": "0000",
    "message": "更新权限成功",
    "data": {
      "id": 1,
      "code": "PERM0001",
      "name": "用户管理",
      "type": "menu",
      "status": 1,
      "createTime": "2025-01-01T10:00:00.000Z"
    }
  },
  "failure": {
    "code": "4000",
    "message": "更新权限失败",
    "data": null
  }
}

{
  "success": {
    "code": "0000",
    "message": "删除权限成功",
    "data": {
      "result": true
    }
  },
  "failure": {
    "code": "4000",
    "message": "删除权限失败",
    "data": null
  }
}

{
  "success": {
    "code": "0000",
    "message": "获取成功",
    "data": [
      {
        "id": 1,
        "code": "RES0001",
        "name": "用户列表",
        "title": "用户列表",
        "systemId": "系统ID",
        "systemName": "权限管理系统",
        "type": "page",
        "url": "/users",
        "status": 1,
        "parentId": null,
        "moduleId": "AUTH_USER",
        "orderNum": 1,
        "createTime": "2025-01-01T10:00:00.000Z"
      },
      {
        "id": 2,
        "code": "RES0002",
        "name": "角色管理",
        "title": "角色管理",
        "systemId": "系统ID",
        "systemName": "权限管理系统",
        "type": "page",
        "url": "/roles",
        "status": 1,
        "parentId": null,
        "moduleId": "AUTH_ROLE",
        "orderNum": 2,
        "createTime": "2025-01-01T11:00:00.000Z"
      }
    ]
  }
}

• 仅返回 status = 1 的有效资源
• 按 orderNum 和 createTime 排序
• 不需要分页，返回完整列表
• 优先支持通过 x-system-code（系统编码）过滤指定系统资源
• 优先支持通过 x-function（模块编码/模块ID）过滤指定模块资源（需同时指定系统）
• 兼容通过 systemId/moduleId 查询参数过滤
• 也支持通过路径参数 systemId 查询（如 /api/security/systems/{systemId}/resources/active）

{
  "success": {
    "code": "0000",
    "message": "获取成功",
    "data": {
      "list": [
        {
          "id": 1,
          "code": "RES0001",
          "name": "用户列表",
          "systemId": "AUTH",
          "systemName": "权限管理系统",
          "type": "page",
          "url": "/users",
          "status": 1,
          "parentId": null,
          "moduleId": "AUTH_USER",
          "orderNum": 10
        }
      ],
      "total": 100,
      "pageNum": 1,
      "pageSize": 10
    }
  }
}

• 列表结果固定按 orderNum 升序，其次按 createTime 倒序
• orderNum 越小，菜单同级显示越靠前

{
  "success": {
    "code": "0000",
    "message": "获取成功",
    "data": {
      "id": 1,
      "code": "RES0001",
      "name": "用户列表",
      "systemId": "AUTH",
      "systemName": "权限管理系统",
      "type": "page",
      "url": "/users",
      "status": 1,
      "parentId": null,
      "moduleId": "AUTH_USER",
      "orderNum": 10
    }
  },
  "failure": {
    "code": "4040",
    "message": "资源不存在",
    "data": null
  }
}

{
  "success": {
    "code": "0000",
    "message": "创建资源成功",
    "data": {
      "id": 1,
      "code": "RES0001",
      "name": "用户列表",
      "systemId": "AUTH",
      "systemName": "权限管理系统",
      "type": "page",
      "url": "/users",
      "status": 1,
      "parentId": null,
      "moduleId": "AUTH_USER",
      "orderNum": 10
    }
  },
  "failure": {
    "code": "4000",
    "message": "创建资源失败",
    "data": null
  }
}

• code 由系统自动生成，无需传入
• moduleId 可为空；若传入，需为该 systemId 下有效模块
• orderNum 用于菜单树同级排序，值越小越靠前

{
  "success": {
    "code": "0000",
    "message": "更新资源成功",
    "data": {
      "id": 1,
      "code": "RES0001",
      "name": "用户列表",
      "systemId": "AUTH",
      "systemName": "权限管理系统",
      "type": "page",
      "url": "/users",
      "status": 1,
      "parentId": null,
      "moduleId": "AUTH_USER",
      "orderNum": 20
    }
  },
  "failure": {
    "code": "4000",
    "message": "更新资源失败",
    "data": null
  }
}

• moduleId 为可选字段，可配置/修改/清空模块关联
• 更新 orderNum 后，菜单树同级排序会按新序号生效

{
  "success": {
    "code": "0000",
    "message": "删除资源成功",
    "data": {
      "result": true
    }
  },
  "failure": {
    "code": "4000",
    "message": "删除资源失败",
    "data": null
  }
}

{
  "success": {
    "code": "0000",
    "message": "获取成功",
    "data": {
      "list": [
        {
          "id": 1,
          "code": "CUS0001",
          "name": "示例客户",
          "contactName": "李四",
          "contactPhone": "021-88888888",
          "status": 1
        }
      ],
      "total": 100,
      "pageNum": 1,
      "pageSize": 10,
      "authorizedToMeCustomers": [
        {
          "id": 2,
          "code": "CUS0002",
          "name": "被授权客户",
          "contactName": "王五",
          "contactPhone": "021-66666666",
          "status": 1,
          "grantorUser": {
            "userId": "USER0002",
            "username": "授权方用户",
            "phone": "13800000002",
            "userType": "User"
          },
          "authorizationCreateTime": "2026-04-15T09:00:00.000Z",
          "authorizationUpdateTime": "2026-04-15T09:30:00.000Z"
        }
      ],
      "authorizedByMeCustomers": [
        {
          "customerId": 3,
          "granteeUser": {
            "userId": "USER0003",
            "username": "接收方用户",
            "phone": "13800000003",
            "userType": "User"
          },
          "authorizationCreateTime": "2026-04-15T10:00:00.000Z",
          "authorizationUpdateTime": "2026-04-15T10:15:00.000Z"
        }
      ]
    }
  }
}

{
  "success": {
    "code": "0000",
    "message": "获取成功",
    "data": {
      "id": 1,
      "code": "CUS0001",
      "name": "示例客户",
      "contactName": "李四",
      "contactPhone": "021-88888888",
      "status": 1
    }
  },
  "failure": {
    "code": "4040",
    "message": "客户不存在",
    "data": null
  }
}

{
  "success": {
    "code": "0000",
    "message": "创建客户成功",
    "data": {
      "id": 1,
      "code": "CUS0001",
      "name": "示例客户",
      "contactName": "李四",
      "contactPhone": "021-88888888",
      "status": 1
    }
  },
  "failure": {
    "code": "4000",
    "message": "创建客户失败",
    "data": null
  }
}

{
  "success": {
    "code": "0000",
    "message": "更新客户成功",
    "data": {
      "id": 1,
      "code": "CUS0001",
      "name": "示例客户",
      "contactName": "李四",
      "contactPhone": "021-88888888",
      "status": 1
    }
  },
  "failure": {
    "code": "4000",
    "message": "更新客户失败",
    "data": null
  }
}

{
  "success": {
    "code": "0000",
    "message": "客户授权成功",
    "data": {
      "createdCount": 2,
      "skippedCount": 1
    }
  },
  "failure": {
    "code": "4000",
    "message": "客户授权失败",
    "data": null
  }
}

{
  "success": {
    "code": "0000",
    "message": "客户授权解除成功",
    "data": {
      "revokedCount": 2
    }
  },
  "failure": {
    "code": "4000",
    "message": "解除客户授权失败",
    "data": null
  }
}

{
  "success": {
    "code": "0000",
    "message": "删除客户成功",
    "data": {
      "result": true
    }
  },
  "failure": {
    "code": "4000",
    "message": "删除客户失败",
    "data": null
  }
}

暂无请求参数定义

{
  "success": {
    "code": "0000",
    "message": "操作成功",
    "data": [
      {
        "id": "xxx",
        "_id": "xxx",
        "code": "MEM0001",
        "name": "会员套餐1",
        "description": "套餐描述"
      },
      {
        "id": "yyy",
        "_id": "yyy",
        "code": "MEM0002",
        "name": "会员套餐2",
        "description": "套餐描述"
      }
    ],
    "timestamp": "2025-01-21T10:00:00.000Z"
  },
  "failure": {
    "code": "4000",
    "message": "获取失败",
    "data": null
  }
}

• 该接口仅返回状态为有效（status=1）的会员套餐
• 返回结果按创建时间升序排序
• 需要 members 的 read 权限
• 适用于下拉选择等场景，无需分页

{
  "success": {
    "code": "0000",
    "message": "获取成功",
    "data": {
      "list": [
        {
          "id": 1,
          "code": "MEM0001",
          "name": "会员套餐名称",
          "memberTypeId": "xxx",
          "price": "99.99",
          "validityDays": 30,
          "description": "套餐描述",
          "status": 1
        }
      ],
      "total": 100,
      "pageNum": 1,
      "pageSize": 10
    }
  }
}

{
  "success": {
    "code": "0000",
    "message": "获取成功",
    "data": {
      "id": 1,
      "code": "MEM0001",
      "name": "会员套餐名称",
      "memberTypeId": "xxx",
      "price": "99.99",
      "validityDays": 30,
      "description": "套餐描述",
      "status": 1
    }
  },
  "failure": {
    "code": "4040",
    "message": "会员套餐不存在",
    "data": null
  }
}

{
  "success": {
    "code": "0000",
    "message": "创建会员成功",
    "data": {
      "id": 1,
      "code": "MEM0001",
      "name": "会员套餐名称",
      "memberTypeId": "xxx",
      "price": "99.99",
      "validityDays": 30,
      "description": "套餐描述",
      "status": 0
    }
  },
  "failure": {
    "code": "4000",
    "message": "关联的会员类型不存在",
    "data": null
  }
}

• 如果提供了memberTypeId，会校验会员类型是否存在，不存在返回错误：关联的会员类型不存在

{
  "success": {
    "code": "0000",
    "message": "更新会员成功",
    "data": {
      "id": 1,
      "code": "MEM0001",
      "name": "会员套餐名称",
      "memberTypeId": "xxx",
      "price": "99.99",
      "validityDays": 30,
      "description": "套餐描述",
      "status": 1
    }
  },
  "failure": {
    "code": "4000",
    "message": "关联的会员类型不存在",
    "data": null
  }
}

• 如果提供了memberTypeId，会校验会员类型是否存在，不存在返回错误：关联的会员类型不存在
• 有效状态（status=1）的会员套餐不允许修改，会返回错误：有效状态的会员套餐不允许修改

{
  "success": {
    "code": "0000",
    "message": "删除会员成功",
    "data": {
      "result": true
    }
  },
  "failure": {
    "code": "4000",
    "message": "删除会员失败",
    "data": null
  }
}

• 有效状态（status=1）的会员套餐不允许删除，会返回错误：有效状态的会员套餐不允许删除

{
  "success": {
    "code": "0000",
    "message": "状态更新成功",
    "data": {
      "id": 1,
      "code": "MEM0001",
      "name": "会员套餐名称",
      "memberTypeId": "xxx",
      "price": "99.99",
      "validityDays": 30,
      "description": "套餐描述",
      "status": 1,
      "updateTime": "2025-01-01T10:00:00.000Z"
    }
  },
  "failure": {
    "code": "4040",
    "message": "会员套餐不存在",
    "data": null
  }
}

• 该接口用于切换会员套餐的启用/禁用状态
• 只有通过状态切换接口才能修改有效状态的会员套餐

暂无请求参数定义

{
  "success": {
    "code": "0000",
    "message": "操作成功",
    "data": [
      {
        "id": "xxx",
        "_id": "xxx",
        "code": "VIP",
        "name": "VIP会员",
        "description": "VIP会员类型"
      },
      {
        "id": "yyy",
        "_id": "yyy",
        "code": "GOLD",
        "name": "黄金会员",
        "description": "黄金会员类型"
      }
    ],
    "timestamp": "2025-01-21T10:00:00.000Z"
  },
  "failure": {
    "code": "4000",
    "message": "获取失败",
    "data": null
  }
}

• 该接口仅返回状态为有效（status=1）的会员类型
• 返回结果按创建时间升序排序
• 需要 memberTypes 的 read 权限
• 适用于下拉选择等场景，无需分页

{
  "success": {
    "code": "0000",
    "message": "获取成功",
    "data": {
      "list": [
        {
          "id": 1,
          "code": "VIP",
          "name": "VIP会员",
          "description": "VIP会员类型",
          "status": 1,
          "createTime": "2025-01-01T10:00:00.000Z",
          "updateTime": "2025-01-01T10:00:00.000Z"
        }
      ],
      "total": 100,
      "pageNum": 1,
      "pageSize": 10,
      "totalPages": 10
    }
  }
}

{
  "success": {
    "code": "0000",
    "message": "创建成功",
    "data": {
      "id": 1,
      "code": "VIP",
      "name": "VIP会员",
      "description": "VIP会员类型",
      "status": 1,
      "createTime": "2025-01-01T10:00:00.000Z"
    }
  },
  "failure": {
    "code": "4000",
    "message": "会员类型编码已存在",
    "data": null
  }
}

{
  "success": {
    "code": "0000",
    "message": "更新成功",
    "data": {
      "id": 1,
      "code": "VIP",
      "name": "VIP会员",
      "description": "VIP会员类型",
      "status": 1,
      "updateTime": "2025-01-01T10:00:00.000Z"
    }
  },
  "failure": {
    "code": "4000",
    "message": "会员类型编码已存在",
    "data": null
  }
}

{
  "success": {
    "code": "0000",
    "message": "删除成功",
    "data": null
  },
  "failure": {
    "code": "4000",
    "message": "会员类型仍与会员功能关联，请先解除关联",
    "data": null
  }
}

{
  "success": {
    "code": "0000",
    "message": "状态更新成功",
    "data": {
      "id": 1,
      "code": "VIP",
      "name": "VIP会员",
      "status": 1,
      "updateTime": "2025-01-01T10:00:00.000Z"
    }
  },
  "failure": {
    "code": "4040",
    "message": "会员类型不存在",
    "data": null
  }
}

{
  "success": {
    "code": "0000",
    "message": "获取成功",
    "data": {
      "list": [
        {
          "id": 1,
          "code": "SM0001",
          "name": "开放平台会员",
          "secretKey": "sk-xxx",
          "memberTypeId": "xxx",
          "status": 1,
          "saleStatus": 0,
          "soldAt": null,
          "soldOrderNo": null
        }
      ],
      "total": 100,
      "pageNum": 1,
      "pageSize": 10
    }
  }
}

{
  "success": {
    "code": "0000",
    "message": "获取成功",
    "data": {
      "id": 1,
      "code": "SM0001",
      "name": "开放平台会员",
      "secretKey": "sk-xxx",
      "memberTypeId": "xxx",
      "status": 1,
      "saleStatus": 0,
      "soldAt": null,
      "soldOrderNo": null
    }
  },
  "failure": {
    "code": "4040",
    "message": "无状态会员不存在",
    "data": null
  }
}

{
  "success": {
    "code": "0000",
    "message": "创建无状态会员成功",
    "data": {
      "id": 1,
      "code": "SM0001",
      "name": "开放平台会员",
      "secretKey": "sk-xxx",
      "memberTypeId": "xxx",
      "status": 1,
      "saleStatus": 0
    }
  },
  "failure": {
    "code": "4000",
    "message": "关联的会员类型不存在",
    "data": null
  }
}

• secretKey会自动生成，无需手动提供
• 如果提供了memberTypeId，会校验会员类型是否存在，不存在返回错误：关联的会员类型不存在
• saleStatus 表示售卖/占用状态，与 status（启用禁用）独立；不影响 OpenAPI 激活校验

{
  "success": {
    "code": "0000",
    "message": "更新无状态会员成功",
    "data": {
      "id": 1,
      "code": "SM0001",
      "name": "开放平台会员",
      "secretKey": "sk-xxx",
      "memberTypeId": "xxx",
      "status": 1
    }
  },
  "failure": {
    "code": "4000",
    "message": "关联的会员类型不存在",
    "data": null
  }
}

• 如果提供了memberTypeId，会校验会员类型是否存在，不存在返回错误：关联的会员类型不存在
• 有效状态（status=1）的无状态会员不允许修改，会返回错误：有效状态的无状态会员不允许修改
• 售卖状态（saleStatus）不可通过本接口修改，请使用 PUT /api/stateless-members/{id}/sale-status

{
  "success": {
    "code": "0000",
    "message": "删除无状态会员成功",
    "data": {
      "result": true
    }
  },
  "failure": {
    "code": "4000",
    "message": "删除无状态会员失败",
    "data": null
  }
}

• 有效状态（status=1）的无状态会员不允许删除，会返回错误：有效状态的无状态会员不允许删除

{
  "success": {
    "code": "0000",
    "message": "状态更新成功",
    "data": {
      "id": 1,
      "code": "SM0001",
      "name": "开放平台会员",
      "secretKey": "sk-xxx",
      "memberTypeId": "xxx",
      "effectiveDate": "2025-01-01",
      "validityDays": 365,
      "firstEffectiveDate": "2025-01-01",
      "status": 1,
      "saleStatus": 0,
      "updateTime": "2025-01-01T10:00:00.000Z"
    }
  },
  "failure": {
    "code": "4040",
    "message": "无状态会员不存在",
    "data": null
  }
}

• 该接口用于切换无状态会员的启用/禁用状态（status）
• 只有通过状态切换接口才能修改有效状态的无状态会员
• 售卖状态（saleStatus）请使用售卖状态切换接口

{
  "success": {
    "code": "0000",
    "message": "售卖状态更新成功",
    "data": {
      "id": 1,
      "code": "SM0001",
      "name": "开放平台会员",
      "saleStatus": 1,
      "soldAt": "2025-01-15T10:00:00.000Z",
      "soldOrderNo": "ORD-20250115-0010",
      "status": 1,
      "updateTime": "2025-01-15T10:00:00.000Z"
    }
  },
  "failure": {
    "code": "4000",
    "message": "该无状态会员已售出，不可重复售卖",
    "data": null
  },
  "failureNotFound": {
    "code": "4040",
    "message": "无状态会员不存在",
    "data": null
  }
}

• saleStatus=1 时写入 soldAt；可选 orderNo 写入 soldOrderNo
• saleStatus=0 时清除 soldAt、soldOrderNo（回库）
• 已为已售（saleStatus=1）时再次设为 1 会返回：该无状态会员已售出，不可重复售卖
• 售卖状态不影响 OpenAPI 激活/校验；已售卡密在有效期内仍可无限次激活
• 管理端订单（/api/orders）在状态变为 PAID 或 COMPLETED 且带有 statelessMemberId 时，也会自动标记为已售

{
  "success": {
    "code": "0000",
    "message": "获取成功",
    "data": {
      "list": [
        {
          "id": 1,
          "code": "MU0001",
          "userId": "abc123",
          "userType": "clientUser",
          "memberId": "member001",
          "status": 1
        }
      ],
      "total": 100,
      "pageNum": 1,
      "pageSize": 10
    }
  }
}

• userId 为绑定的系统用户或客户端用户的主键（_id 或 id），统一存储在该字段
• userType 标识绑定用户类型：user（系统用户）或 clientUser（客户端用户）；OpenAPI 激活创建的记录可能未写入 userType，但有状态会员校验仍可通过 userId 匹配登录用户

{
  "success": {
    "code": "0000",
    "message": "获取成功",
    "data": {
      "id": 1,
      "code": "MU0001",
      "userId": "abc123",
      "userType": "user",
      "memberId": "member001",
      "status": 1
    }
  },
  "failure": {
    "code": "4040",
    "message": "会员用户不存在",
    "data": null
  }
}

{
  "success": {
    "code": "0000",
    "message": "创建会员用户成功",
    "data": {
      "id": 1,
      "code": "MU0001",
      "userId": "abc123",
      "userType": "clientUser",
      "memberId": "member001",
      "status": 1
    }
  },
  "failure": {
    "code": "4000",
    "message": "关联的会员不存在",
    "data": null
  }
}

• 若提供 userId，会在当前站点数据范围内校验用户是否存在：userType=user 时仅查 users 表；userType=clientUser 时仅查 clientUsers 表；未传 userType 时先查 users 再查 clientUsers
• 校验通过后服务端会写入 userType 字段，便于管理端区分绑定类型
• 若提供 memberId，会校验会员是否存在且有效（status=1），不存在或已停用分别返回：关联的会员不存在 / 关联的会员已停用
• 用户不存在或无权限访问时返回：用户不存在或无权限访问该用户；指定 clientUser 但未找到时返回：客户端用户不存在或无权限访问该客户端用户

{
  "success": {
    "code": "0000",
    "message": "更新会员用户成功",
    "data": {
      "id": 1,
      "code": "MU0001",
      "userId": "abc123",
      "userType": "clientUser",
      "memberId": "member001",
      "status": 1
    }
  },
  "failure": {
    "code": "4000",
    "message": "关联的会员不存在",
    "data": null
  }
}

• userId / userType 校验规则与创建接口一致
• 若提供 memberId，会校验会员是否存在且有效（status=1）
• organizationId、ownerId、ownerType 等归属字段不可通过本接口修改

{
  "success": {
    "code": "0000",
    "message": "删除会员用户成功",
    "data": {
      "result": true
    }
  },
  "failure": {
    "code": "4000",
    "message": "删除会员用户失败",
    "data": null
  }
}

{
  "success": {
    "code": "0000",
    "message": "获取成功",
    "data": {
      "list": [
        {
          "id": 1,
          "code": "MF0001",
          "memberTypeId": "xxx",
          "memberType": "VIP会员",
          "systemId": "yyy",
          "systemName": "权限管理系统",
          "status": 1,
          "description": "会员功能配置示例"
        }
      ],
      "total": 1,
      "pageNum": 1,
      "pageSize": 10
    }
  }
}

{
  "success": {
    "code": "0000",
    "message": "获取成功",
    "data": {
      "id": 1,
      "code": "MF0001",
      "memberTypeId": "xxx",
      "memberType": "VIP会员",
      "systemId": "yyy",
      "systemName": "权限管理系统",
      "status": 1
    }
  },
  "failure": {
    "code": "4040",
    "message": "会员功能不存在",
    "data": null
  }
}

{
  "success": {
    "code": "0000",
    "message": "创建成功",
    "data": {
      "id": 1,
      "code": "MF0001",
      "memberTypeId": "xxx",
      "memberType": "VIP会员",
      "systemId": "yyy",
      "systemName": "权限管理系统",
      "status": 1
    }
  },
  "failure": {
    "code": "4090",
    "message": "该会员类型在当前系统下已配置功能",
    "data": null
  }
}

{
  "success": {
    "code": "0000",
    "message": "更新成功",
    "data": {
      "id": 1,
      "code": "MF0001",
      "memberTypeId": "xxx",
      "systemId": "yyy",
      "status": 1
    }
  }
}

{
  "success": {
    "code": "0000",
    "message": "删除成功",
    "data": {
      "result": true
    }
  }
}

{
  "success": {
    "code": "0000",
    "message": "状态更新成功",
    "data": {
      "id": 1,
      "code": "MF0001",
      "status": 1
    }
  }
}

{
  "success": {
    "code": "0000",
    "message": "获取成功",
    "data": {
      "list": [
        {
          "id": 1,
          "code": "MFM0001",
          "functionId": "mf001",
          "moduleId": "sm001",
          "moduleCode": "ORDER_MODULE",
          "moduleName": "订单管理",
          "status": 1
        }
      ],
      "total": 1,
      "pageNum": 1,
      "pageSize": 10
    }
  }
}

• 路径参数 id 对应 memberFunctions 记录主键
• moduleId 为系统模块 securityModules 的主键（或 code），与 resources 表无关；资源在资源管理中通过 moduleId 字段关联到系统模块
• OpenAPI 校验使用 memberFunctionModules 的 moduleId（securityModules）与 moduleCode（自定义模块）

{
  "success": {
    "code": "0000",
    "message": "创建成功",
    "data": {
      "id": 1,
      "code": "MFM0001",
      "functionId": "mf001",
      "moduleId": "sm001",
      "moduleCode": "ORDER_MODULE",
      "moduleName": "订单管理",
      "status": 1
    }
  },
  "failure": {
    "code": "4090",
    "message": "该模块已与会员功能关联",
    "data": null
  }
}

• 二选一：传 moduleId 关联系统模块（securityModules），或传 moduleCode+moduleName 自定义模块
• 不与 resources 表发生关联；需限制某模块下资源时，在资源管理里为资源设置 moduleId 指向同一系统模块
• 同一 functionId 下相同 moduleId 或 moduleCode 不可重复关联

{
  "success": {
    "code": "0000",
    "message": "更新成功",
    "data": {
      "id": 1,
      "code": "MFM0001",
      "moduleCode": "CUSTOM_FEATURE",
      "moduleName": "自定义功能",
      "status": 1
    }
  },
  "failure": {
    "code": "4040",
    "message": "会员功能模块关联不存在",
    "data": null
  }
}

{
  "success": {
    "code": "0000",
    "message": "删除成功",
    "data": {
      "result": true
    }
  },
  "failure": {
    "code": "4040",
    "message": "会员功能模块关联不存在",
    "data": null
  }
}

{
  "success": {
    "code": "0000",
    "message": "状态更新成功",
    "data": {
      "id": 1,
      "code": "MFM0001",
      "status": 0
    }
  }
}

{
  "success": {
    "code": "0000",
    "message": "获取成功",
    "data": {
      "list": [
        {
          "id": 1,
          "code": "MFL0001",
          "memberTypeId": "xxx",
          "memberTypeName": "VIP会员",
          "systemId": "yyy",
          "systemName": "权限管理系统",
          "moduleId": "zzz",
          "moduleName": "订单管理",
          "limitValue": 100,
          "status": 1
        }
      ],
      "total": 1,
      "pageNum": 1,
      "pageSize": 10
    }
  }
}

{
  "success": {
    "code": "0000",
    "message": "创建成功",
    "data": {
      "id": 1,
      "code": "MFL0001",
      "memberTypeId": "xxx",
      "systemId": "yyy",
      "moduleId": "zzz",
      "limitValue": 100,
      "status": 1
    }
  }
}

{
  "success": {
    "code": "0000",
    "message": "更新成功",
    "data": {
      "id": 1,
      "code": "MFL0001",
      "limitValue": 200,
      "status": 1
    }
  }
}

{
  "success": {
    "code": "0000",
    "message": "删除成功",
    "data": {
      "result": true
    }
  }
}

{
  "success": {
    "code": "0000",
    "message": "状态更新成功",
    "data": {
      "id": 1,
      "code": "MFL0001",
      "status": 1
    }
  }
}

{
  "success": {
    "code": "0000",
    "message": "获取成功",
    "data": {
      "list": [
        {
          "id": 1,
          "userId": "USER0001",
          "reason": "业务合作",
          "createTime": "2025-01-01T10:00:00.000Z"
        }
      ],
      "total": 100,
      "pageNum": 1,
      "pageSize": 10
    }
  }
}

{
  "success": {
    "code": "0000",
    "message": "获取成功",
    "data": {
      "id": 1,
      "userId": "USER0001",
      "reason": "业务合作",
      "createTime": "2025-01-01T10:00:00.000Z"
    }
  },
  "failure": {
    "code": "4040",
    "message": "白名单不存在",
    "data": null
  }
}

{
  "success": {
    "code": "0000",
    "message": "创建白名单成功",
    "data": {
      "id": 1,
      "userId": "USER0001",
      "reason": "业务合作",
      "createTime": "2025-01-01T10:00:00.000Z"
    }
  },
  "failure": {
    "code": "4000",
    "message": "创建白名单失败",
    "data": null
  }
}

{
  "success": {
    "code": "0000",
    "message": "更新白名单成功",
    "data": {
      "id": 1,
      "userId": "USER0001",
      "reason": "业务合作",
      "createTime": "2025-01-01T10:00:00.000Z"
    }
  },
  "failure": {
    "code": "4000",
    "message": "更新白名单失败",
    "data": null
  }
}

{
  "success": {
    "code": "0000",
    "message": "删除白名单成功",
    "data": {
      "result": true
    }
  },
  "failure": {
    "code": "4000",
    "message": "删除白名单失败",
    "data": null
  }
}

{
  "success": {
    "code": "0000",
    "message": "获取成功",
    "data": {
      "list": [
        {
          "id": 1,
          "userId": "USER0002",
          "reason": "恶意操作",
          "createTime": "2025-01-01T10:00:00.000Z"
        }
      ],
      "total": 100,
      "pageNum": 1,
      "pageSize": 10
    }
  }
}

{
  "success": {
    "code": "0000",
    "message": "获取成功",
    "data": {
      "id": 1,
      "userId": "USER0002",
      "reason": "恶意操作",
      "createTime": "2025-01-01T10:00:00.000Z"
    }
  },
  "failure": {
    "code": "4040",
    "message": "黑名单不存在",
    "data": null
  }
}

{
  "success": {
    "code": "0000",
    "message": "创建黑名单成功",
    "data": {
      "id": 1,
      "userId": "USER0002",
      "reason": "恶意操作",
      "createTime": "2025-01-01T10:00:00.000Z"
    }
  },
  "failure": {
    "code": "4000",
    "message": "创建黑名单失败",
    "data": null
  }
}

{
  "success": {
    "code": "0000",
    "message": "更新黑名单成功",
    "data": {
      "id": 1,
      "userId": "USER0002",
      "reason": "恶意操作",
      "createTime": "2025-01-01T10:00:00.000Z"
    }
  },
  "failure": {
    "code": "4000",
    "message": "更新黑名单失败",
    "data": null
  }
}

{
  "success": {
    "code": "0000",
    "message": "删除黑名单成功",
    "data": {
      "result": true
    }
  },
  "failure": {
    "code": "4000",
    "message": "删除黑名单失败",
    "data": null
  }
}

{
  "success": {
    "code": "0000",
    "message": "获取成功",
    "data": {
      "list": [
        {
          "id": 1,
          "code": "UF0001",
          "systemCode": "AUTH_MANAGEMENT",
          "payload": {
            "content": "功能建议",
            "type": "feature"
          },
          "siteKey": "86AFEA7A-xxxx",
          "createTime": "2025-01-01T10:00:00.000Z"
        }
      ],
      "total": 100,
      "pageNum": 1,
      "pageSize": 10
    }
  }
}

{
  "success": {
    "code": "0000",
    "message": "获取成功",
    "data": {
      "id": 1,
      "code": "UF0001",
      "systemCode": "AUTH_MANAGEMENT",
      "payload": {
        "content": "功能建议",
        "type": "feature"
      },
      "siteKey": "86AFEA7A-xxxx",
      "createTime": "2025-01-01T10:00:00.000Z"
    }
  },
  "failure": {
    "code": "4040",
    "message": "用户反馈不存在",
    "data": null
  }
}

{
  "success": {
    "code": "0000",
    "message": "创建用户反馈成功",
    "data": {
      "id": 1,
      "code": "UF0001",
      "systemCode": "AUTH_MANAGEMENT",
      "payload": {
        "content": "功能建议",
        "type": "feature"
      },
      "siteKey": "86AFEA7A-xxxx",
      "createTime": "2025-01-01T10:00:00.000Z"
    }
  },
  "failure": {
    "code": "4000",
    "message": "创建用户反馈失败",
    "data": null
  }
}

{
  "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
    }
  }
}

{
  "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
  }
}

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

{
  "success": {
    "code": "0000",
    "message": "更新审核记录成功",
    "data": {
      "id": 1,
      "code": "AR0001",
      "applyRemark": "补充说明"
    }
  }
}

{
  "success": {
    "code": "0000",
    "message": "删除审核记录成功",
    "data": {
      "result": true
    }
  }
}

{
  "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 注册新的执行策略即可

暂无请求参数定义

{
  "success": {
    "code": "0000",
    "message": "获取成功",
    "data": [
      {
        "id": 1,
        "code": "AUTH",
        "name": "权限管理系统",
        "status": 1,
        "description": "权限管理系统描述",
        "createTime": "2025-01-01T10:00:00.000Z",
        "updateTime": "2025-01-01T10:00:00.000Z"
      },
      {
        "id": 2,
        "code": "ORDER",
        "name": "订单管理系统",
        "status": 1,
        "description": "订单管理系统描述",
        "createTime": "2025-01-01T11:00:00.000Z",
        "updateTime": "2025-01-01T11:00:00.000Z"
      }
    ]
  }
}

• 仅返回 status = 1 的有效系统
• 按创建时间倒序排列
• 不需要分页，返回完整列表

{
  "success": {
    "code": "0000",
    "message": "获取成功",
    "data": [
      {
        "id": 1,
        "code": "AUTH_USER",
        "name": "用户管理模块",
        "systemId": "系统ID",
        "systemName": "权限管理系统",
        "status": 1,
        "description": "用户管理模块描述",
        "createTime": "2025-01-01T10:00:00.000Z",
        "updateTime": "2025-01-01T10:00:00.000Z"
      },
      {
        "id": 2,
        "code": "AUTH_ROLE",
        "name": "角色管理模块",
        "systemId": "系统ID",
        "systemName": "权限管理系统",
        "status": 1,
        "description": "角色管理模块描述",
        "createTime": "2025-01-01T11:00:00.000Z",
        "updateTime": "2025-01-01T11:00:00.000Z"
      }
    ]
  },
  "failure": {
    "code": "4040",
    "message": "系统不存在",
    "data": null
  }
}

• 仅返回指定系统下 status = 1 的有效模块
• 按创建时间倒序排列
• 不需要分页，返回完整列表
• 如果系统不存在，返回404错误

• 系统自动取该用户最新一条未过期的 memberUser 记录
• 场景B（验系统支持）请使用 /memberships/check
• 场景C（验功能模块）请使用 /memberships/functionCheck
• 场景D（验功能限额）请使用 /memberships/limitCheck

• 需在管理后台「会员功能管理」中为该会员类型配置支持该系统，否则会返回1007
• 系统校验基于 memberFunctions 表（memberTypeId + systemId + status=1）

• 需在管理后台「会员功能模块」中为该会员类型的系统功能配置对应模块
• X-Function 传入 securityModules.code 或自定义 moduleCode（memberFunctionModules 中配置的模块编码）

• 仅校验系统模块（securityModules）及 memberFunctionLimits，不查询用户 RBAC 资源
• limit 为 null 表示未配置限额，不限次数
• currentCount 由第三方系统传入，本系统不持久化使用记录
• 限额配置在管理后台「会员功能限制」中设置（memberFunctionLimits 表）

{
  "success": {
    "code": "0000",
    "message": "校验通过",
    "data": {
      "user": {
        "id": "u001",
        "code": "CU000001",
        "username": "张三",
        "type": "clientUser"
      },
      "resources": [],
      "resourcesByType": {},
      "resourceUrls": []
    }
  }
}

• 响应结构与 /openapi/permissions/check 一致
• 当会员约束不满足时，返回空资源（resources=[]）

{
  "success": {
    "code": "0000",
    "message": "校验通过",
    "data": {
      "system": {
        "code": "AUTH_MANAGEMENT",
        "name": "权限管理系统"
      },
      "resources": [],
      "resourcesByType": {},
      "resourceUrls": []
    }
  }
}

• 系统级校验与 /openapi/stateless-members/check 参数要求一致
• 会员不支持系统时，资源返回为空

{
  "success": {
    "code": "0000",
    "message": "校验通过",
    "data": {
      "resources": [],
      "resourcesByType": {},
      "resourceUrls": []
    }
  }
}

{
  "success": {
    "code": "0000",
    "message": "校验通过",
    "data": {
      "resources": [],
      "resourcesByType": {},
      "resourceUrls": []
    }
  }
}

{
  "success": {
    "code": "0000",
    "message": "校验通过",
    "data": {
      "resources": [],
      "resourcesByType": {},
      "resourceUrls": []
    }
  }
}

{
  "success": {
    "code": "0000",
    "message": "校验通过",
    "data": {
      "resources": [],
      "resourcesByType": {},
      "resourceUrls": []
    }
  }
}

{
  "success": {
    "code": "0000",
    "message": "校验通过",
    "data": {
      "resources": [],
      "resourcesByType": {},
      "resourceUrls": []
    }
  }
}

{
  "success": {
    "code": "0000",
    "message": "校验通过",
    "data": {
      "resources": [],
      "resourcesByType": {},
      "resourceUrls": []
    }
  }
}

• resource.moduleId 应指向 securityModules（在资源管理中设置），与 memberFunctionModules.moduleId 同一套模块体系
• currentCount 与 memberFunctionLimits 按 moduleId 比对；超限时剔除该模块下的资源
• 会员条件不满足时返回空资源，而不是抛错

{
  "success": {
    "code": "0000",
    "message": "校验通过",
    "data": {
      "user": {
        "id": "u001",
        "code": "CU000001",
        "username": "张三",
        "type": "clientUser"
      },
      "resources": [],
      "resourcesByType": {},
      "resourceUrls": []
    }
  }
}

• 与 /openapi/stateless-members/resources/valid-check 的区别：本接口始终包含用户 RBAC 资源，并叠加会员模块资源
• 会员约束失败时不抛错，仍返回用户 RBAC 资源
• 相同资源按 _id/id 去重

{
  "success": {
    "code": "0000",
    "message": "校验通过",
    "data": {
      "resources": [],
      "resourcesByType": {},
      "resourceUrls": []
    }
  }
}

• 用户 RBAC 资源与会员资源均按 X-System-Code 过滤
• 会员不支持当前系统时仍返回用户 RBAC 资源

{
  "success": {
    "code": "0000",
    "message": "校验通过",
    "data": {
      "resources": [],
      "resourcesByType": {},
      "resourceUrls": []
    }
  }
}

{
  "success": {
    "code": "0000",
    "message": "校验通过",
    "data": {
      "resources": [],
      "resourcesByType": {},
      "resourceUrls": []
    }
  }
}

• 限额仅作用于会员模块资源，用户 RBAC 资源始终保留
• 会员约束失败时仍返回用户 RBAC 资源

{
  "success": {
    "code": "0000",
    "message": "校验通过",
    "data": {
      "resources": [],
      "resourcesByType": {},
      "resourceUrls": []
    }
  }
}

• 与 /openapi/memberships/resources/valid-check 的区别：本接口始终包含用户 RBAC 资源
• 相同资源按 _id/id 去重

{
  "success": {
    "code": "0000",
    "message": "校验通过",
    "data": {
      "resources": [],
      "resourcesByType": {},
      "resourceUrls": []
    }
  }
}

{
  "success": {
    "code": "0000",
    "message": "校验通过",
    "data": {
      "resources": [],
      "resourcesByType": {},
      "resourceUrls": []
    }
  }
}

{
  "success": {
    "code": "0000",
    "message": "校验通过",
    "data": {
      "resources": [],
      "resourcesByType": {},
      "resourceUrls": []
    }
  }
}

• 限额仅作用于会员模块资源，用户 RBAC 资源始终保留
• 会员无效或不支持当前系统时仍返回用户 RBAC 资源

{
  "success": {
    "code": "0000",
    "message": "会员开通成功",
    "data": {
      "clientUser": {
        "id": "GplqNHbkcmcFa0sj",
        "code": "CU000009",
        "phone": "18347432461",
        "name": "Smkello"
      },
      "memberUser": {
        "id": "toiUHzFoO1xtmSkI",
        "memberType": "VIP"
      },
      "order": {
        "orderNo": "ORD-20250115-0010",
        "status": "COMPLETED"
      }
    }
  },
  "failure": {
    "code": "1107",
    "message": "订单尚未支付或已失效",
    "data": null
  }
}

• 该接口会校验黑名单、订单手机号、订单状态与会员类型一致性。
• 响应 Header X-OpenAPI-Result 存放加密结果用于客户端追踪。

{
  "success": {
    "code": "0000",
    "message": "会员注册成功",
    "data": {
      "accountType": "client",
      "clientUser": {
        "code": "CU000001",
        "name": "散客用户",
        "phone": "13800138001",
        "status": 1,
        "individualism": false
      },
      "site": {
        "key": "A1B2C3D4-xxxx",
        "name": "个人站点"
      }
    }
  },
  "pendingAudit": {
    "code": "1212",
    "message": "注册申请已提交，待审核",
    "data": {
      "accountType": "company",
      "user": {
        "code": "USER000001",
        "name": "企业管理员",
        "phone": "13800138000",
        "status": 0,
        "individualism": false
      },
      "organization": {
        "code": "ORG000001",
        "name": "靖苒数字"
      },
      "auditRecord": {
        "id": 1,
        "code": "AR0001",
        "status": 0,
        "auditType": "REGISTER_USER",
        "individualism": true
      }
    }
  },
  "failure": {
    "code": "1203",
    "message": "公司信用代码已注册",
    "data": null
  }
}

• 账号类型：注册令牌 payload 中 companyName 与 companyCreditCode 均非空 → 系统用户（users）+ 组织；否则 → 客户端用户（clientUsers）。
• 审核条件（满足任一即走审核，返回 1212、status=0）：① X-Individualism=true（开独立站点）；② 企业注册（系统用户）。
• 自动放行（返回 0000、status=1）：散客注册且 X-Individualism=false，仅绑定 X-Site，不开独立站点。
• 审核通过后：按 auditRecord.individualism 决定是否开通独立站点；审核类型 REGISTER_USER / REGISTER_CLIENT 对应系统用户与客户端用户。
• 密码要求同时包含字母和数字，长度不少于 6 位。

• 优先尝试企业账号登录，失败后自动回退到散客账号校验。
• 散客账号登录时，登录令牌的 payload 中必须包含 agreeTerms 字段且值为 true，否则返回错误码 1303（请同意隐私等协议）。
• 企业账号登录时，agreeTerms 字段可选，不影响登录流程。
• 成功时 data.token 与响应 Header X-OpenAPI-Result 均为加密令牌。
• 响应中的 site 字段说明：
• - site 字段只返回个人站点信息（如果用户有个人站点），不会返回所属站点信息
• - 有个人站点时：site 字段包含个人站点的完整信息（id、key、name、createTime）
• - 无个人站点时：site 字段为 null（无论用户是否有所属站点）
• - 判断逻辑：只需判断 site 是否为 null 即可知道用户是否有个人站点
• - 注意：用户可能既有所属站点（通过 user.siteKey 访问），也有个人站点（通过 site 字段访问）
• 后续请求可通过 X-Site header 切换站点，切换后使用对应站点的数据库。
• 登录成功响应 body 包含 scopeKeys 与 defaultScopeKey，供外部业务系统绑定数据分区