{
  "openapi": "3.0.3",
  "info": {
    "title": "权限管理系统 - 完整API文档",
    "version": "1.0.0",
    "description": "基于Express.js + Electron的权限管理系统，支持NeDB和MongoDB双存储模式。支持多站点数据隔离，用户可通过 X-Site header 切换站点和对应的数据库上下文。"
  },
  "paths": {
    "/api/users": {
      "get": {
        "summary": "获取用户列表",
        "description": "分页获取系统用户列表，支持按姓名、手机号、状态筛选。支持通过 X-Site header 切换站点，切换后查询对应站点的数据库。",
        "parameters": [
          {
            "name": "pageNum",
            "in": "query",
            "required": false,
            "schema": {
              "type": "number"
            },
            "description": "页码，默认1"
          },
          {
            "name": "pageSize",
            "in": "query",
            "required": false,
            "schema": {
              "type": "number"
            },
            "description": "每页数量，默认10"
          },
          {
            "name": "name",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "description": "用户姓名（模糊搜索）"
          },
          {
            "name": "phone",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "description": "手机号（模糊搜索）"
          },
          {
            "name": "status",
            "in": "query",
            "required": false,
            "schema": {
              "type": "number"
            },
            "description": "状态：1-正常，0-禁用"
          }
        ],
        "responses": {
          "200": {
            "description": "成功响应",
            "content": {
              "application/json": {
                "example": {
                  "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
                    }
                  }
                }
              }
            }
          }
        },
        "tags": [
          "用户管理"
        ]
      },
      "post": {
        "summary": "创建用户",
        "description": "创建新的系统用户",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "name": {
                    "type": "string",
                    "description": "string｜必填，用户姓名"
                  },
                  "phone": {
                    "type": "string",
                    "description": "string｜必填，手机号，唯一"
                  },
                  "password": {
                    "type": "string",
                    "description": "string｜必填，登录密码"
                  },
                  "roles": {
                    "type": "array",
                    "description": "array｜可选，绑定角色ID数组"
                  },
                  "status": {
                    "type": "number",
                    "description": "number｜可选，状态：1-启用，0-禁用"
                  }
                },
                "required": [
                  "name",
                  "phone",
                  "password"
                ]
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "成功响应",
            "content": {
              "application/json": {
                "example": {
                  "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
                  }
                }
              }
            }
          }
        },
        "tags": [
          "用户管理"
        ]
      }
    },
    "/api/users/{id}": {
      "get": {
        "summary": "获取用户详情",
        "description": "根据用户ID获取用户详细信息",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "系统用户ID"
          }
        ],
        "responses": {
          "200": {
            "description": "成功响应",
            "content": {
              "application/json": {
                "example": {
                  "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
                  }
                }
              }
            }
          }
        },
        "tags": [
          "用户管理"
        ]
      },
      "put": {
        "summary": "更新用户",
        "description": "更新指定用户的信息",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "系统用户ID"
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "name": {
                    "type": "string",
                    "description": "string｜必填，用户姓名"
                  },
                  "phone": {
                    "type": "string",
                    "description": "string｜必填，手机号，唯一"
                  },
                  "password": {
                    "type": "string",
                    "description": "string｜必填，登录密码"
                  },
                  "roles": {
                    "type": "array",
                    "description": "array｜可选，绑定角色ID数组"
                  },
                  "status": {
                    "type": "number",
                    "description": "number｜可选，状态：1-启用，0-禁用"
                  }
                },
                "required": [
                  "name",
                  "phone",
                  "password"
                ]
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "成功响应",
            "content": {
              "application/json": {
                "example": {
                  "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
                  }
                }
              }
            }
          }
        },
        "tags": [
          "用户管理"
        ]
      },
      "delete": {
        "summary": "删除用户",
        "description": "删除指定的用户",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "系统用户ID"
          }
        ],
        "responses": {
          "200": {
            "description": "成功响应",
            "content": {
              "application/json": {
                "example": {
                  "success": {
                    "code": "0000",
                    "message": "删除系统用户成功",
                    "data": {
                      "result": true
                    }
                  },
                  "failure": {
                    "code": "4000",
                    "message": "删除系统用户失败",
                    "data": null
                  }
                }
              }
            }
          }
        },
        "tags": [
          "用户管理"
        ]
      }
    },
    "/auth/register": {
      "post": {
        "summary": "用户注册",
        "description": "系统用户注册接口。如果 individualism=true，会为用户创建独立站点和独立数据库，并自动创建超级管理员角色。",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "name": {
                    "type": "string",
                    "description": "string｜必填，用户名"
                  },
                  "phone": {
                    "type": "string",
                    "description": "string｜必填，手机号"
                  },
                  "password": {
                    "type": "string",
                    "description": "string｜必填，登录密码"
                  },
                  "email": {
                    "type": "string",
                    "description": "string｜可选，邮箱"
                  },
                  "individualism": {
                    "type": "boolean",
                    "description": "boolean｜可选，是否创建独立站点，默认 false"
                  }
                },
                "required": [
                  "name",
                  "phone",
                  "password"
                ]
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "成功响应",
            "content": {
              "application/json": {
                "example": {
                  "success": {
                    "code": "0000",
                    "message": "注册成功",
                    "data": {
                      "token": "jwt-token",
                      "user": {
                        "id": "USER0001",
                        "code": "USER000001",
                        "name": "张三",
                        "phone": "13800138000",
                        "email": "zhangsan@example.com",
                        "individualism": true,
                        "individualDbName": "user_1_1764407777204"
                      },
                      "clientKey": {
                        "id": "key-id",
                        "keyToken": "key-token",
                        "individualDbName": "user_1_1764407777204"
                      }
                    }
                  },
                  "failure": {
                    "code": "4000",
                    "message": "注册失败",
                    "data": null
                  }
                }
              }
            }
          }
        },
        "tags": [
          "认证模块"
        ]
      }
    },
    "/auth/login": {
      "post": {
        "summary": "用户登录",
        "description": "系统用户登录接口。如果用户有多个可用站点，会返回站点列表供前端选择。",
        "parameters": [
          {
            "name": "system",
            "in": "header",
            "required": false,
            "schema": {
              "type": "string"
            },
            "description": "系统编码，登录时自动分配系统默认管理员角色"
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "phone": {
                    "type": "string",
                    "description": "string｜必填，手机号"
                  },
                  "password": {
                    "type": "string",
                    "description": "string｜必填，登录密码"
                  }
                },
                "required": [
                  "phone",
                  "password"
                ]
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "成功响应",
            "content": {
              "application/json": {
                "example": {
                  "success": {
                    "code": "0000",
                    "message": "登录成功",
                    "data": {
                      "token": "jwt-token",
                      "user": {
                        "id": "USER0001",
                        "code": "USER000001",
                        "username": "系统管理员",
                        "phone": "13800138000",
                        "email": "admin@example.com",
                        "individualism": true,
                        "individualDbName": "user_1_1764407777204",
                        "status": 1,
                        "createTime": "2025-01-21T10:00:00.000Z",
                        "accountType": "user",
                        "type": "普通用户"
                      },
                      "availableSites": [
                        {
                          "siteKey": "56B57A72-59C4-460B-82E5-22196205391B-A4608B6E9D4D6F599",
                          "name": "所属站点",
                          "type": "owner",
                          "isDefault": true
                        },
                        {
                          "siteKey": "A1B2C3D4-E5F6-7890-ABCD-EF1234567890-ABCDEF12",
                          "name": "个人站点",
                          "type": "personal",
                          "isDefault": false
                        }
                      ]
                    }
                  },
                  "failure": {
                    "code": "4000",
                    "message": "登录失败",
                    "data": null
                  }
                }
              }
            }
          }
        },
        "tags": [
          "认证模块"
        ]
      }
    },
    "/auth/client/register": {
      "post": {
        "summary": "客户端用户注册",
        "description": "客户端用户注册接口。如果 individualism=true，会为用户创建独立站点和独立数据库，并自动创建超级管理员角色。",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "name": {
                    "type": "string",
                    "description": "string｜可选，客户端用户姓名，默认为'游客'"
                  },
                  "phone": {
                    "type": "string",
                    "description": "string｜必填，手机号"
                  },
                  "password": {
                    "type": "string",
                    "description": "string｜必填，登录密码"
                  },
                  "email": {
                    "type": "string",
                    "description": "string｜可选，邮箱"
                  },
                  "agreeTerms": {
                    "type": "boolean",
                    "description": "boolean｜必填，是否同意协议"
                  },
                  "individualism": {
                    "type": "boolean",
                    "description": "boolean｜可选，是否创建独立站点，默认 false"
                  }
                },
                "required": [
                  "phone",
                  "password",
                  "agreeTerms"
                ]
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "成功响应",
            "content": {
              "application/json": {
                "example": {
                  "success": {
                    "code": "0000",
                    "message": "注册成功",
                    "data": {
                      "token": "jwt-token",
                      "user": {
                        "id": "CU0001",
                        "code": "CU000001",
                        "username": "客户端用户",
                        "phone": "13800138000",
                        "email": "user@example.com",
                        "individualism": true,
                        "individualDbName": "client_user_1_1764407777204"
                      },
                      "clientKey": {
                        "id": "key-id",
                        "keyToken": "key-token",
                        "individualDbName": "client_user_1_1764407777204"
                      }
                    }
                  },
                  "failure": {
                    "code": "4000",
                    "message": "注册失败",
                    "data": null
                  }
                }
              }
            }
          }
        },
        "tags": [
          "认证模块"
        ]
      }
    },
    "/auth/client/login": {
      "post": {
        "summary": "客户端用户登录",
        "description": "客户端用户登录接口。如果用户有多个可用站点，会返回站点列表供前端选择。",
        "parameters": [
          {
            "name": "system",
            "in": "header",
            "required": false,
            "schema": {
              "type": "string"
            },
            "description": "系统编码，登录时自动分配系统默认管理员角色"
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "phone": {
                    "type": "string",
                    "description": "string｜必填，手机号"
                  },
                  "password": {
                    "type": "string",
                    "description": "string｜必填，登录密码"
                  },
                  "agreeTerms": {
                    "type": "boolean",
                    "description": "boolean｜必填，是否同意协议"
                  }
                },
                "required": [
                  "phone",
                  "password",
                  "agreeTerms"
                ]
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "成功响应",
            "content": {
              "application/json": {
                "example": {
                  "success": {
                    "code": "0000",
                    "message": "登录成功",
                    "data": {
                      "token": "jwt-token",
                      "user": {
                        "id": "CU0001",
                        "code": "CU000001",
                        "username": "客户端管理员",
                        "phone": "13800138000",
                        "email": "client@example.com",
                        "individualism": true,
                        "individualDbName": "client_user_1_1764407777204",
                        "status": 1,
                        "createTime": "2025-01-21T10:00:00.000Z",
                        "accountType": "clientUser",
                        "type": "散客"
                      },
                      "availableSites": [
                        {
                          "siteKey": "56B57A72-59C4-460B-82E5-22196205391B-A4608B6E9D4D6F599",
                          "name": "所属站点",
                          "type": "owner",
                          "isDefault": true
                        },
                        {
                          "siteKey": "A1B2C3D4-E5F6-7890-ABCD-EF1234567890-ABCDEF12",
                          "name": "个人站点",
                          "type": "personal",
                          "isDefault": false
                        }
                      ]
                    }
                  },
                  "failure": {
                    "code": "4000",
                    "message": "登录失败",
                    "data": null
                  }
                }
              }
            }
          }
        },
        "tags": [
          "认证模块"
        ]
      }
    },
    "/system/business/activate": {
      "post": {
        "summary": "业务开通",
        "description": "业务开通接口",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "systemCode": {
                    "type": "string",
                    "description": "string｜必填，要开通的系统编码"
                  },
                  "expireDays": {
                    "type": "number",
                    "description": "number｜可选，业务有效天数"
                  }
                },
                "required": [
                  "systemCode"
                ]
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "成功响应",
            "content": {
              "application/json": {
                "example": {
                  "success": {
                    "code": "0000",
                    "message": "业务开通成功",
                    "data": {
                      "systemCode": "AUTH",
                      "activated": true
                    }
                  },
                  "failure": {
                    "code": "4000",
                    "message": "业务开通失败",
                    "data": null
                  }
                }
              }
            }
          }
        },
        "tags": [
          "系统管理"
        ]
      }
    },
    "/system/storage/switch": {
      "post": {
        "summary": "用户存储模式切换",
        "description": "用户存储模式切换功能",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "mode": {
                    "type": "string",
                    "description": "string｜必填，目标存储模式，可选 'FILE' 或 'CLOUD'"
                  }
                },
                "required": [
                  "mode"
                ]
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "成功响应",
            "content": {
              "application/json": {
                "example": {
                  "success": {
                    "code": "0000",
                    "message": "切换存储模式成功",
                    "data": {
                      "mode": "FILE"
                    }
                  },
                  "failure": {
                    "code": "4000",
                    "message": "切换存储模式失败",
                    "data": null
                  }
                }
              }
            }
          }
        },
        "tags": [
          "系统管理"
        ]
      }
    },
    "/system/storage/client/switch": {
      "post": {
        "summary": "客户端用户存储模式切换",
        "description": "客户端用户存储模式切换功能",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "mode": {
                    "type": "string",
                    "description": "string｜必填，目标存储模式，可选 'FILE' 或 'CLOUD'"
                  }
                },
                "required": [
                  "mode"
                ]
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "成功响应",
            "content": {
              "application/json": {
                "example": {
                  "success": {
                    "code": "0000",
                    "message": "切换客户端用户存储模式成功",
                    "data": {
                      "mode": "FILE"
                    }
                  },
                  "failure": {
                    "code": "4000",
                    "message": "切换客户端用户存储模式失败",
                    "data": null
                  }
                }
              }
            }
          }
        },
        "tags": [
          "系统管理"
        ]
      }
    },
    "/system/storage/mode": {
      "get": {
        "summary": "获取存储模式",
        "description": "获取当前存储模式",
        "responses": {
          "200": {
            "description": "成功响应",
            "content": {
              "application/json": {
                "example": {
                  "success": {
                    "code": "0000",
                    "message": "获取成功",
                    "data": {
                      "userMode": "FILE",
                      "clientUserMode": "FILE"
                    }
                  }
                }
              }
            }
          }
        },
        "tags": [
          "系统管理"
        ]
      }
    },
    "/system/info": {
      "get": {
        "summary": "系统信息",
        "description": "获取系统基本信息",
        "responses": {
          "200": {
            "description": "成功响应",
            "content": {
              "application/json": {
                "example": {
                  "success": {
                    "code": "0000",
                    "message": "获取成功",
                    "data": {
                      "version": "1.0.0",
                      "buildTime": "2025-01-01T10:00:00.000Z",
                      "storageMode": "FILE"
                    }
                  }
                }
              }
            }
          }
        },
        "tags": [
          "系统管理"
        ]
      }
    },
    "/api/client-users": {
      "get": {
        "summary": "获取客户端用户列表",
        "description": "分页获取客户端用户列表",
        "parameters": [
          {
            "name": "pageNum",
            "in": "query",
            "required": false,
            "schema": {
              "type": "number"
            },
            "description": "页码，默认1"
          },
          {
            "name": "pageSize",
            "in": "query",
            "required": false,
            "schema": {
              "type": "number"
            },
            "description": "每页数量，默认10"
          },
          {
            "name": "name",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "description": "姓名关键词"
          },
          {
            "name": "phone",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "description": "手机号"
          },
          {
            "name": "status",
            "in": "query",
            "required": false,
            "schema": {
              "type": "number"
            },
            "description": "状态过滤"
          }
        ],
        "responses": {
          "200": {
            "description": "成功响应",
            "content": {
              "application/json": {
                "example": {
                  "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
                    }
                  }
                }
              }
            }
          }
        },
        "tags": [
          "客户端用户管理"
        ]
      },
      "post": {
        "summary": "创建客户端用户",
        "description": "创建新的客户端用户",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "name": {
                    "type": "string",
                    "description": "string｜必填，客户端用户姓名"
                  },
                  "phone": {
                    "type": "string",
                    "description": "string｜必填，手机号，唯一"
                  },
                  "password": {
                    "type": "string",
                    "description": "string｜必填，登录密码"
                  },
                  "status": {
                    "type": "number",
                    "description": "number｜可选，状态：1-启用，0-禁用"
                  }
                },
                "required": [
                  "name",
                  "phone",
                  "password"
                ]
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "成功响应",
            "content": {
              "application/json": {
                "example": {
                  "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
                  }
                }
              }
            }
          }
        },
        "tags": [
          "客户端用户管理"
        ]
      }
    },
    "/api/client-users/{id}": {
      "get": {
        "summary": "获取客户端用户详情",
        "description": "根据客户端用户ID获取详细信息",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "客户端用户ID"
          }
        ],
        "responses": {
          "200": {
            "description": "成功响应",
            "content": {
              "application/json": {
                "example": {
                  "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
                  }
                }
              }
            }
          }
        },
        "tags": [
          "客户端用户管理"
        ]
      },
      "put": {
        "summary": "更新客户端用户",
        "description": "更新指定客户端用户的信息",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "客户端用户ID"
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "name": {
                    "type": "string",
                    "description": "string｜必填，客户端用户姓名"
                  },
                  "phone": {
                    "type": "string",
                    "description": "string｜必填，手机号，唯一"
                  },
                  "password": {
                    "type": "string",
                    "description": "string｜必填，登录密码"
                  },
                  "status": {
                    "type": "number",
                    "description": "number｜可选，状态：1-启用，0-禁用"
                  }
                },
                "required": [
                  "name",
                  "phone",
                  "password"
                ]
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "成功响应",
            "content": {
              "application/json": {
                "example": {
                  "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
                  }
                }
              }
            }
          }
        },
        "tags": [
          "客户端用户管理"
        ]
      },
      "delete": {
        "summary": "删除客户端用户",
        "description": "删除指定的客户端用户",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "客户端用户ID"
          }
        ],
        "responses": {
          "200": {
            "description": "成功响应",
            "content": {
              "application/json": {
                "example": {
                  "success": {
                    "code": "0000",
                    "message": "删除客户端用户成功",
                    "data": {
                      "result": true
                    }
                  },
                  "failure": {
                    "code": "4000",
                    "message": "删除客户端用户失败",
                    "data": null
                  }
                }
              }
            }
          }
        },
        "tags": [
          "客户端用户管理"
        ]
      }
    },
    "/api/organizations": {
      "get": {
        "summary": "获取组织列表",
        "description": "获取组织列表，支持树形结构",
        "parameters": [
          {
            "name": "pageNum",
            "in": "query",
            "required": false,
            "schema": {
              "type": "number"
            },
            "description": "页码，默认1"
          },
          {
            "name": "pageSize",
            "in": "query",
            "required": false,
            "schema": {
              "type": "number"
            },
            "description": "每页数量，默认10"
          },
          {
            "name": "name",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "description": "组织名称关键词"
          }
        ],
        "responses": {
          "200": {
            "description": "成功响应",
            "content": {
              "application/json": {
                "example": {
                  "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
                    }
                  }
                }
              }
            }
          }
        },
        "tags": [
          "组织管理"
        ]
      },
      "post": {
        "summary": "创建组织",
        "description": "创建新的组织",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "name": {
                    "type": "string",
                    "description": "string｜必填，组织名称"
                  },
                  "parentId": {
                    "type": "string",
                    "description": "string｜可选，父级组织ID，根节点为空"
                  },
                  "status": {
                    "type": "number",
                    "description": "number｜可选，状态：1-启用，0-禁用"
                  }
                },
                "required": [
                  "name"
                ]
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "成功响应",
            "content": {
              "application/json": {
                "example": {
                  "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
                  }
                }
              }
            }
          }
        },
        "tags": [
          "组织管理"
        ]
      }
    },
    "/api/organizations/{id}": {
      "get": {
        "summary": "获取组织详情",
        "description": "根据组织ID获取组织详细信息",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "组织ID"
          }
        ],
        "responses": {
          "200": {
            "description": "成功响应",
            "content": {
              "application/json": {
                "example": {
                  "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
                  }
                }
              }
            }
          }
        },
        "tags": [
          "组织管理"
        ]
      },
      "put": {
        "summary": "更新组织",
        "description": "更新指定组织的信息",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "组织ID"
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "name": {
                    "type": "string",
                    "description": "string｜必填，组织名称"
                  },
                  "parentId": {
                    "type": "string",
                    "description": "string｜可选，父级组织ID，根节点为空"
                  },
                  "status": {
                    "type": "number",
                    "description": "number｜可选，状态：1-启用，0-禁用"
                  }
                },
                "required": [
                  "name"
                ]
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "成功响应",
            "content": {
              "application/json": {
                "example": {
                  "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
                  }
                }
              }
            }
          }
        },
        "tags": [
          "组织管理"
        ]
      },
      "delete": {
        "summary": "删除组织",
        "description": "删除指定的组织",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "组织ID"
          }
        ],
        "responses": {
          "200": {
            "description": "成功响应",
            "content": {
              "application/json": {
                "example": {
                  "success": {
                    "code": "0000",
                    "message": "删除组织成功",
                    "data": {
                      "result": true
                    }
                  },
                  "failure": {
                    "code": "4000",
                    "message": "删除组织失败",
                    "data": null
                  }
                }
              }
            }
          }
        },
        "tags": [
          "组织管理"
        ]
      }
    },
    "/api/organizations/{id}/users": {
      "get": {
        "summary": "获取组织关联用户",
        "description": "获取指定组织关联的用户",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "组织ID"
          }
        ],
        "responses": {
          "200": {
            "description": "成功响应",
            "content": {
              "application/json": {
                "example": {
                  "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
                  }
                }
              }
            }
          }
        },
        "tags": [
          "组织管理"
        ]
      },
      "put": {
        "summary": "更新组织用户关联",
        "description": "更新指定组织的用户关联关系",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "组织ID"
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "name": {
                    "type": "string",
                    "description": "string｜必填，组织名称"
                  },
                  "parentId": {
                    "type": "string",
                    "description": "string｜可选，父级组织ID，根节点为空"
                  },
                  "status": {
                    "type": "number",
                    "description": "number｜可选，状态：1-启用，0-禁用"
                  }
                },
                "required": [
                  "name"
                ]
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "成功响应",
            "content": {
              "application/json": {
                "example": {
                  "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
                  }
                }
              }
            }
          }
        },
        "tags": [
          "组织管理"
        ]
      }
    },
    "/api/departments": {
      "get": {
        "summary": "获取部门列表",
        "description": "获取部门列表，支持按组织筛选",
        "parameters": [
          {
            "name": "pageNum",
            "in": "query",
            "required": false,
            "schema": {
              "type": "number"
            },
            "description": "页码，默认1"
          },
          {
            "name": "pageSize",
            "in": "query",
            "required": false,
            "schema": {
              "type": "number"
            },
            "description": "每页数量，默认10"
          },
          {
            "name": "organizationId",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "description": "按组织筛选"
          },
          {
            "name": "name",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "description": "部门名称关键词"
          }
        ],
        "responses": {
          "200": {
            "description": "成功响应",
            "content": {
              "application/json": {
                "example": {
                  "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
                    }
                  }
                }
              }
            }
          }
        },
        "tags": [
          "部门管理"
        ]
      },
      "post": {
        "summary": "创建部门",
        "description": "创建新的部门",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "name": {
                    "type": "string",
                    "description": "string｜必填，部门名称"
                  },
                  "organizationId": {
                    "type": "string",
                    "description": "string｜必填，所属组织ID"
                  },
                  "leaderId": {
                    "type": "string",
                    "description": "string｜可选，部门负责人ID"
                  },
                  "status": {
                    "type": "number",
                    "description": "number｜可选，状态：1-启用，0-禁用"
                  }
                },
                "required": [
                  "name",
                  "organizationId"
                ]
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "成功响应",
            "content": {
              "application/json": {
                "example": {
                  "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
                  }
                }
              }
            }
          }
        },
        "tags": [
          "部门管理"
        ]
      }
    },
    "/api/departments/{id}": {
      "get": {
        "summary": "获取部门详情",
        "description": "根据部门ID获取部门详细信息",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "部门ID"
          }
        ],
        "responses": {
          "200": {
            "description": "成功响应",
            "content": {
              "application/json": {
                "example": {
                  "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
                  }
                }
              }
            }
          }
        },
        "tags": [
          "部门管理"
        ]
      },
      "put": {
        "summary": "更新部门",
        "description": "更新指定部门的信息",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "部门ID"
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "name": {
                    "type": "string",
                    "description": "string｜必填，部门名称"
                  },
                  "organizationId": {
                    "type": "string",
                    "description": "string｜必填，所属组织ID"
                  },
                  "leaderId": {
                    "type": "string",
                    "description": "string｜可选，部门负责人ID"
                  },
                  "status": {
                    "type": "number",
                    "description": "number｜可选，状态：1-启用，0-禁用"
                  }
                },
                "required": [
                  "name",
                  "organizationId"
                ]
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "成功响应",
            "content": {
              "application/json": {
                "example": {
                  "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
                  }
                }
              }
            }
          }
        },
        "tags": [
          "部门管理"
        ]
      },
      "delete": {
        "summary": "删除部门",
        "description": "删除指定的部门",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "部门ID"
          }
        ],
        "responses": {
          "200": {
            "description": "成功响应",
            "content": {
              "application/json": {
                "example": {
                  "success": {
                    "code": "0000",
                    "message": "删除部门成功",
                    "data": {
                      "result": true
                    }
                  },
                  "failure": {
                    "code": "4000",
                    "message": "删除部门失败",
                    "data": null
                  }
                }
              }
            }
          }
        },
        "tags": [
          "部门管理"
        ]
      }
    },
    "/api/departments/{id}/users": {
      "get": {
        "summary": "获取部门关联用户",
        "description": "获取指定部门关联的用户",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "部门ID"
          }
        ],
        "responses": {
          "200": {
            "description": "成功响应",
            "content": {
              "application/json": {
                "example": {
                  "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
                  }
                }
              }
            }
          }
        },
        "tags": [
          "部门管理"
        ]
      },
      "put": {
        "summary": "更新部门用户关联",
        "description": "更新指定部门的用户关联关系",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "部门ID"
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "name": {
                    "type": "string",
                    "description": "string｜必填，部门名称"
                  },
                  "organizationId": {
                    "type": "string",
                    "description": "string｜必填，所属组织ID"
                  },
                  "leaderId": {
                    "type": "string",
                    "description": "string｜可选，部门负责人ID"
                  },
                  "status": {
                    "type": "number",
                    "description": "number｜可选，状态：1-启用，0-禁用"
                  }
                },
                "required": [
                  "name",
                  "organizationId"
                ]
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "成功响应",
            "content": {
              "application/json": {
                "example": {
                  "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
                  }
                }
              }
            }
          }
        },
        "tags": [
          "部门管理"
        ]
      }
    },
    "/api/positions": {
      "get": {
        "summary": "获取岗位列表",
        "description": "分页获取岗位列表",
        "parameters": [
          {
            "name": "pageNum",
            "in": "query",
            "required": false,
            "schema": {
              "type": "number"
            },
            "description": "页码，默认1"
          },
          {
            "name": "pageSize",
            "in": "query",
            "required": false,
            "schema": {
              "type": "number"
            },
            "description": "每页数量，默认10"
          },
          {
            "name": "name",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "description": "岗位名称关键词"
          },
          {
            "name": "status",
            "in": "query",
            "required": false,
            "schema": {
              "type": "number"
            },
            "description": "状态过滤"
          }
        ],
        "responses": {
          "200": {
            "description": "成功响应",
            "content": {
              "application/json": {
                "example": {
                  "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
                    }
                  }
                }
              }
            }
          }
        },
        "tags": [
          "岗位管理"
        ]
      },
      "post": {
        "summary": "创建岗位",
        "description": "创建新的岗位",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "name": {
                    "type": "string",
                    "description": "string｜必填，岗位名称"
                  },
                  "organizationId": {
                    "type": "string",
                    "description": "string｜可选，所属组织ID"
                  },
                  "status": {
                    "type": "number",
                    "description": "number｜可选，状态：1-启用，0-禁用"
                  }
                },
                "required": [
                  "name"
                ]
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "成功响应",
            "content": {
              "application/json": {
                "example": {
                  "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
                  }
                }
              }
            }
          }
        },
        "tags": [
          "岗位管理"
        ]
      }
    },
    "/api/positions/{id}": {
      "get": {
        "summary": "获取岗位详情",
        "description": "根据岗位ID获取岗位详细信息",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "岗位ID"
          }
        ],
        "responses": {
          "200": {
            "description": "成功响应",
            "content": {
              "application/json": {
                "example": {
                  "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
                  }
                }
              }
            }
          }
        },
        "tags": [
          "岗位管理"
        ]
      },
      "put": {
        "summary": "更新岗位",
        "description": "更新指定岗位的信息",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "岗位ID"
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "name": {
                    "type": "string",
                    "description": "string｜必填，岗位名称"
                  },
                  "organizationId": {
                    "type": "string",
                    "description": "string｜可选，所属组织ID"
                  },
                  "status": {
                    "type": "number",
                    "description": "number｜可选，状态：1-启用，0-禁用"
                  }
                },
                "required": [
                  "name"
                ]
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "成功响应",
            "content": {
              "application/json": {
                "example": {
                  "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
                  }
                }
              }
            }
          }
        },
        "tags": [
          "岗位管理"
        ]
      },
      "delete": {
        "summary": "删除岗位",
        "description": "删除指定的岗位",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "岗位ID"
          }
        ],
        "responses": {
          "200": {
            "description": "成功响应",
            "content": {
              "application/json": {
                "example": {
                  "success": {
                    "code": "0000",
                    "message": "删除岗位成功",
                    "data": {
                      "result": true
                    }
                  },
                  "failure": {
                    "code": "4000",
                    "message": "删除岗位失败",
                    "data": null
                  }
                }
              }
            }
          }
        },
        "tags": [
          "岗位管理"
        ]
      }
    },
    "/api/positions/{id}/users": {
      "get": {
        "summary": "获取岗位关联用户",
        "description": "获取指定岗位关联的用户",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "岗位ID"
          }
        ],
        "responses": {
          "200": {
            "description": "成功响应",
            "content": {
              "application/json": {
                "example": {
                  "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
                  }
                }
              }
            }
          }
        },
        "tags": [
          "岗位管理"
        ]
      },
      "put": {
        "summary": "更新岗位用户关联",
        "description": "更新指定岗位的用户关联关系",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "岗位ID"
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "name": {
                    "type": "string",
                    "description": "string｜必填，岗位名称"
                  },
                  "organizationId": {
                    "type": "string",
                    "description": "string｜可选，所属组织ID"
                  },
                  "status": {
                    "type": "number",
                    "description": "number｜可选，状态：1-启用，0-禁用"
                  }
                },
                "required": [
                  "name"
                ]
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "成功响应",
            "content": {
              "application/json": {
                "example": {
                  "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
                  }
                }
              }
            }
          }
        },
        "tags": [
          "岗位管理"
        ]
      }
    },
    "/api/staff": {
      "get": {
        "summary": "获取职员列表",
        "description": "获取职员列表，支持按部门筛选",
        "parameters": [
          {
            "name": "pageNum",
            "in": "query",
            "required": false,
            "schema": {
              "type": "number"
            },
            "description": "页码，默认1"
          },
          {
            "name": "pageSize",
            "in": "query",
            "required": false,
            "schema": {
              "type": "number"
            },
            "description": "每页数量，默认10"
          },
          {
            "name": "organizationId",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "description": "所属组织筛选"
          },
          {
            "name": "name",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "description": "姓名关键词"
          }
        ],
        "responses": {
          "200": {
            "description": "成功响应",
            "content": {
              "application/json": {
                "example": {
                  "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
                    }
                  }
                }
              }
            }
          }
        },
        "tags": [
          "职员管理"
        ]
      },
      "post": {
        "summary": "创建职员",
        "description": "创建新的职员",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "name": {
                    "type": "string",
                    "description": "string｜必填，职员姓名"
                  },
                  "phone": {
                    "type": "string",
                    "description": "string｜必填，手机号"
                  },
                  "organizationId": {
                    "type": "string",
                    "description": "string｜必填，所属组织ID"
                  },
                  "status": {
                    "type": "number",
                    "description": "number｜可选，状态：1-在职，0-离职"
                  }
                },
                "required": [
                  "name",
                  "phone",
                  "organizationId"
                ]
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "成功响应",
            "content": {
              "application/json": {
                "example": {
                  "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
                  }
                }
              }
            }
          }
        },
        "tags": [
          "职员管理"
        ]
      }
    },
    "/api/staff/{id}": {
      "get": {
        "summary": "获取职员详情",
        "description": "根据职员ID获取职员详细信息",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "职员ID"
          }
        ],
        "responses": {
          "200": {
            "description": "成功响应",
            "content": {
              "application/json": {
                "example": {
                  "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
                  }
                }
              }
            }
          }
        },
        "tags": [
          "职员管理"
        ]
      },
      "put": {
        "summary": "更新职员",
        "description": "更新指定职员的信息",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "职员ID"
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "name": {
                    "type": "string",
                    "description": "string｜必填，职员姓名"
                  },
                  "phone": {
                    "type": "string",
                    "description": "string｜必填，手机号"
                  },
                  "organizationId": {
                    "type": "string",
                    "description": "string｜必填，所属组织ID"
                  },
                  "status": {
                    "type": "number",
                    "description": "number｜可选，状态：1-在职，0-离职"
                  }
                },
                "required": [
                  "name",
                  "phone",
                  "organizationId"
                ]
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "成功响应",
            "content": {
              "application/json": {
                "example": {
                  "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
                  }
                }
              }
            }
          }
        },
        "tags": [
          "职员管理"
        ]
      },
      "delete": {
        "summary": "删除职员",
        "description": "删除指定的职员",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "职员ID"
          }
        ],
        "responses": {
          "200": {
            "description": "成功响应",
            "content": {
              "application/json": {
                "example": {
                  "success": {
                    "code": "0000",
                    "message": "删除职员成功",
                    "data": {
                      "result": true
                    }
                  },
                  "failure": {
                    "code": "4000",
                    "message": "删除职员失败",
                    "data": null
                  }
                }
              }
            }
          }
        },
        "tags": [
          "职员管理"
        ]
      }
    },
    "/api/roles": {
      "get": {
        "summary": "获取角色列表",
        "description": "分页获取角色列表",
        "parameters": [
          {
            "name": "pageNum",
            "in": "query",
            "required": false,
            "schema": {
              "type": "number"
            },
            "description": "页码，默认1"
          },
          {
            "name": "pageSize",
            "in": "query",
            "required": false,
            "schema": {
              "type": "number"
            },
            "description": "每页数量，默认10"
          },
          {
            "name": "name",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "description": "角色名称关键词"
          },
          {
            "name": "code",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "description": "角色编码"
          }
        ],
        "responses": {
          "200": {
            "description": "成功响应",
            "content": {
              "application/json": {
                "example": {
                  "success": {
                    "code": "0000",
                    "message": "获取成功",
                    "data": {
                      "list": [
                        {
                          "id": 1,
                          "code": "ROLE0001",
                          "name": "系统管理员",
                          "status": 1,
                          "permissions": [
                            "PERM0001"
                          ],
                          "resources": [
                            "RES0001"
                          ]
                        }
                      ],
                      "total": 100,
                      "pageNum": 1,
                      "pageSize": 10
                    }
                  }
                }
              }
            }
          }
        },
        "tags": [
          "角色管理"
        ]
      },
      "post": {
        "summary": "创建角色",
        "description": "创建新的角色",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "name": {
                    "type": "string",
                    "description": "string｜必填，角色名称"
                  },
                  "code": {
                    "type": "string",
                    "description": "string｜必填，角色编码，唯一"
                  },
                  "status": {
                    "type": "number",
                    "description": "number｜可选，状态：1-启用，0-禁用"
                  }
                },
                "required": [
                  "name",
                  "code"
                ]
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "成功响应",
            "content": {
              "application/json": {
                "example": {
                  "success": {
                    "code": "0000",
                    "message": "创建角色成功",
                    "data": {
                      "id": 1,
                      "code": "ROLE0001",
                      "name": "系统管理员",
                      "status": 1,
                      "permissions": [
                        "PERM0001"
                      ],
                      "resources": [
                        "RES0001"
                      ]
                    }
                  },
                  "failure": {
                    "code": "4000",
                    "message": "创建角色失败",
                    "data": null
                  }
                }
              }
            }
          }
        },
        "tags": [
          "角色管理"
        ]
      }
    },
    "/api/roles/{id}": {
      "get": {
        "summary": "获取角色详情",
        "description": "根据角色ID获取角色详细信息",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "角色ID"
          }
        ],
        "responses": {
          "200": {
            "description": "成功响应",
            "content": {
              "application/json": {
                "example": {
                  "success": {
                    "code": "0000",
                    "message": "获取成功",
                    "data": {
                      "id": 1,
                      "code": "ROLE0001",
                      "name": "系统管理员",
                      "status": 1,
                      "permissions": [
                        "PERM0001"
                      ],
                      "resources": [
                        "RES0001"
                      ]
                    }
                  },
                  "failure": {
                    "code": "4040",
                    "message": "角色不存在",
                    "data": null
                  }
                }
              }
            }
          }
        },
        "tags": [
          "角色管理"
        ]
      },
      "put": {
        "summary": "更新角色",
        "description": "更新指定角色的信息",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "角色ID"
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "name": {
                    "type": "string",
                    "description": "string｜必填，角色名称"
                  },
                  "code": {
                    "type": "string",
                    "description": "string｜必填，角色编码，唯一"
                  },
                  "status": {
                    "type": "number",
                    "description": "number｜可选，状态：1-启用，0-禁用"
                  }
                },
                "required": [
                  "name",
                  "code"
                ]
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "成功响应",
            "content": {
              "application/json": {
                "example": {
                  "success": {
                    "code": "0000",
                    "message": "更新角色成功",
                    "data": {
                      "id": 1,
                      "code": "ROLE0001",
                      "name": "系统管理员",
                      "status": 1,
                      "permissions": [
                        "PERM0001"
                      ],
                      "resources": [
                        "RES0001"
                      ]
                    }
                  },
                  "failure": {
                    "code": "4000",
                    "message": "更新角色失败",
                    "data": null
                  }
                }
              }
            }
          }
        },
        "tags": [
          "角色管理"
        ]
      },
      "delete": {
        "summary": "删除角色",
        "description": "删除指定的角色",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "角色ID"
          }
        ],
        "responses": {
          "200": {
            "description": "成功响应",
            "content": {
              "application/json": {
                "example": {
                  "success": {
                    "code": "0000",
                    "message": "删除角色成功",
                    "data": {
                      "result": true
                    }
                  },
                  "failure": {
                    "code": "4000",
                    "message": "删除角色失败",
                    "data": null
                  }
                }
              }
            }
          }
        },
        "tags": [
          "角色管理"
        ]
      }
    },
    "/api/roles/{id}/permissions": {
      "put": {
        "summary": "绑定角色权限",
        "description": "为指定角色绑定权限",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "角色ID"
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "name": {
                    "type": "string",
                    "description": "string｜必填，角色名称"
                  },
                  "code": {
                    "type": "string",
                    "description": "string｜必填，角色编码，唯一"
                  },
                  "status": {
                    "type": "number",
                    "description": "number｜可选，状态：1-启用，0-禁用"
                  }
                },
                "required": [
                  "name",
                  "code"
                ]
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "成功响应",
            "content": {
              "application/json": {
                "example": {
                  "success": {
                    "code": "0000",
                    "message": "更新角色成功",
                    "data": {
                      "id": 1,
                      "code": "ROLE0001",
                      "name": "系统管理员",
                      "status": 1,
                      "permissions": [
                        "PERM0001"
                      ],
                      "resources": [
                        "RES0001"
                      ]
                    }
                  },
                  "failure": {
                    "code": "4000",
                    "message": "更新角色失败",
                    "data": null
                  }
                }
              }
            }
          }
        },
        "tags": [
          "角色管理"
        ]
      }
    },
    "/api/roles/{id}/resources": {
      "put": {
        "summary": "绑定角色资源",
        "description": "为指定角色绑定资源",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "角色ID"
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "name": {
                    "type": "string",
                    "description": "string｜必填，角色名称"
                  },
                  "code": {
                    "type": "string",
                    "description": "string｜必填，角色编码，唯一"
                  },
                  "status": {
                    "type": "number",
                    "description": "number｜可选，状态：1-启用，0-禁用"
                  }
                },
                "required": [
                  "name",
                  "code"
                ]
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "成功响应",
            "content": {
              "application/json": {
                "example": {
                  "success": {
                    "code": "0000",
                    "message": "更新角色成功",
                    "data": {
                      "id": 1,
                      "code": "ROLE0001",
                      "name": "系统管理员",
                      "status": 1,
                      "permissions": [
                        "PERM0001"
                      ],
                      "resources": [
                        "RES0001"
                      ]
                    }
                  },
                  "failure": {
                    "code": "4000",
                    "message": "更新角色失败",
                    "data": null
                  }
                }
              }
            }
          }
        },
        "tags": [
          "角色管理"
        ]
      }
    },
    "/api/permissions": {
      "get": {
        "summary": "获取权限列表",
        "description": "分页获取权限列表",
        "parameters": [
          {
            "name": "pageNum",
            "in": "query",
            "required": false,
            "schema": {
              "type": "number"
            },
            "description": "页码，默认1"
          },
          {
            "name": "pageSize",
            "in": "query",
            "required": false,
            "schema": {
              "type": "number"
            },
            "description": "每页数量，默认10"
          },
          {
            "name": "name",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "description": "权限名称关键词"
          },
          {
            "name": "code",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "description": "权限编码"
          }
        ],
        "responses": {
          "200": {
            "description": "成功响应",
            "content": {
              "application/json": {
                "example": {
                  "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
                    }
                  }
                }
              }
            }
          }
        },
        "tags": [
          "权限管理"
        ]
      },
      "post": {
        "summary": "创建权限",
        "description": "创建新的权限",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "name": {
                    "type": "string",
                    "description": "string｜必填，权限名称"
                  },
                  "code": {
                    "type": "string",
                    "description": "string｜必填，权限编码，唯一"
                  },
                  "type": {
                    "type": "string",
                    "description": "string｜可选，权限类型，例如menu/button"
                  },
                  "status": {
                    "type": "number",
                    "description": "number｜可选，状态：1-启用，0-禁用"
                  }
                },
                "required": [
                  "name",
                  "code"
                ]
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "成功响应",
            "content": {
              "application/json": {
                "example": {
                  "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
                  }
                }
              }
            }
          }
        },
        "tags": [
          "权限管理"
        ]
      }
    },
    "/api/permissions/{id}": {
      "get": {
        "summary": "获取权限详情",
        "description": "根据权限ID获取权限详细信息",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "权限ID"
          }
        ],
        "responses": {
          "200": {
            "description": "成功响应",
            "content": {
              "application/json": {
                "example": {
                  "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
                  }
                }
              }
            }
          }
        },
        "tags": [
          "权限管理"
        ]
      },
      "put": {
        "summary": "更新权限",
        "description": "更新指定权限的信息",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "权限ID"
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "name": {
                    "type": "string",
                    "description": "string｜必填，权限名称"
                  },
                  "code": {
                    "type": "string",
                    "description": "string｜必填，权限编码，唯一"
                  },
                  "type": {
                    "type": "string",
                    "description": "string｜可选，权限类型，例如menu/button"
                  },
                  "status": {
                    "type": "number",
                    "description": "number｜可选，状态：1-启用，0-禁用"
                  }
                },
                "required": [
                  "name",
                  "code"
                ]
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "成功响应",
            "content": {
              "application/json": {
                "example": {
                  "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
                  }
                }
              }
            }
          }
        },
        "tags": [
          "权限管理"
        ]
      },
      "delete": {
        "summary": "删除权限",
        "description": "删除指定的权限",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "权限ID"
          }
        ],
        "responses": {
          "200": {
            "description": "成功响应",
            "content": {
              "application/json": {
                "example": {
                  "success": {
                    "code": "0000",
                    "message": "删除权限成功",
                    "data": {
                      "result": true
                    }
                  },
                  "failure": {
                    "code": "4000",
                    "message": "删除权限失败",
                    "data": null
                  }
                }
              }
            }
          }
        },
        "tags": [
          "权限管理"
        ]
      }
    },
    "/api/resources/active": {
      "get": {
        "summary": "查询所有有效资源",
        "description": "查询所有有效的资源配置列表，用于其他业务通过选择列表选择目标资源。返回所有 status = 1 的资源，不需要分页。支持通过 systemId 查询指定系统的资源。支持通过 X-Site header 切换站点，切换后查询对应站点的数据库。",
        "parameters": [
          {
            "name": "systemId",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "description": "所属系统ID，用于过滤资源所属系统。不传则返回所有系统的有效资源"
          },
          {
            "name": "moduleId",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "description": "关联模块ID（可选）。传入时需与 systemId 搭配，用于按模块过滤资源"
          }
        ],
        "responses": {
          "200": {
            "description": "成功响应",
            "content": {
              "application/json": {
                "example": {
                  "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"
                      }
                    ]
                  }
                }
              }
            }
          }
        },
        "tags": [
          "资源管理"
        ]
      }
    },
    "/api/resources": {
      "get": {
        "summary": "获取资源列表",
        "description": "分页获取资源列表，支持按名称、类型、系统筛选。支持通过 X-Site header 切换站点，切换后查询对应站点的数据库。",
        "parameters": [
          {
            "name": "pageNum",
            "in": "query",
            "required": false,
            "schema": {
              "type": "number"
            },
            "description": "页码，默认1"
          },
          {
            "name": "pageSize",
            "in": "query",
            "required": false,
            "schema": {
              "type": "number"
            },
            "description": "每页数量，默认10"
          },
          {
            "name": "name",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "description": "资源名称关键词"
          },
          {
            "name": "code",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "description": "资源编码"
          },
          {
            "name": "type",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "description": "资源类型"
          },
          {
            "name": "systemId",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "description": "所属系统ID，用于过滤资源所属系统"
          },
          {
            "name": "moduleId",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "description": "关联模块ID（可选）。传入时需与 systemId 搭配，用于按模块过滤资源"
          }
        ],
        "responses": {
          "200": {
            "description": "成功响应",
            "content": {
              "application/json": {
                "example": {
                  "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
                    }
                  }
                }
              }
            }
          }
        },
        "tags": [
          "资源管理"
        ]
      },
      "post": {
        "summary": "创建资源",
        "description": "创建新的资源",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "name": {
                    "type": "string",
                    "description": "string｜必填，资源名称"
                  },
                  "systemId": {
                    "type": "string",
                    "description": "string｜必填，所属系统ID，用于绑定资源所属系统"
                  },
                  "type": {
                    "type": "string",
                    "description": "string｜必填，资源类型，例如page/api/button"
                  },
                  "url": {
                    "type": "string",
                    "description": "string｜必填，资源URL，用于路由或接口地址"
                  },
                  "status": {
                    "type": "number",
                    "description": "number｜可选，状态：1-启用，0-禁用"
                  },
                  "parentId": {
                    "type": "string",
                    "description": "string｜可选，父级资源ID，用于构建资源树状结构，不传或传空则为根节点"
                  },
                  "moduleId": {
                    "type": "string",
                    "description": "string｜可选，关联模块ID，可为空（推荐与systemId保持一致）"
                  },
                  "orderNum": {
                    "type": "number",
                    "description": "number｜可选，排序序号（同级内升序），默认0"
                  }
                },
                "required": [
                  "name",
                  "systemId",
                  "type",
                  "url"
                ]
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "成功响应",
            "content": {
              "application/json": {
                "example": {
                  "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
                  }
                }
              }
            }
          }
        },
        "tags": [
          "资源管理"
        ]
      }
    },
    "/api/resources/{id}": {
      "get": {
        "summary": "获取资源详情",
        "description": "根据资源ID获取资源详细信息",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "资源ID"
          }
        ],
        "responses": {
          "200": {
            "description": "成功响应",
            "content": {
              "application/json": {
                "example": {
                  "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
                  }
                }
              }
            }
          }
        },
        "tags": [
          "资源管理"
        ]
      },
      "put": {
        "summary": "更新资源",
        "description": "更新指定资源的信息",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "资源ID"
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "name": {
                    "type": "string",
                    "description": "string｜必填，资源名称"
                  },
                  "systemId": {
                    "type": "string",
                    "description": "string｜可选，所属系统ID，不传则保持原值"
                  },
                  "type": {
                    "type": "string",
                    "description": "string｜必填，资源类型，例如page/api/button"
                  },
                  "url": {
                    "type": "string",
                    "description": "string｜必填，资源URL，用于路由或接口地址"
                  },
                  "status": {
                    "type": "number",
                    "description": "number｜可选，状态：1-启用，0-禁用"
                  },
                  "parentId": {
                    "type": "string",
                    "description": "string｜可选，父级资源ID，用于构建资源树状结构，不传或传空则为根节点"
                  },
                  "moduleId": {
                    "type": "string",
                    "description": "string｜可选，关联模块ID；传空字符串或null可清空关联"
                  },
                  "orderNum": {
                    "type": "number",
                    "description": "number｜可选，排序序号（同级内升序），不传则保持原值"
                  }
                },
                "required": [
                  "name",
                  "type",
                  "url"
                ]
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "成功响应",
            "content": {
              "application/json": {
                "example": {
                  "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
                  }
                }
              }
            }
          }
        },
        "tags": [
          "资源管理"
        ]
      },
      "delete": {
        "summary": "删除资源",
        "description": "删除指定的资源",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "资源ID"
          }
        ],
        "responses": {
          "200": {
            "description": "成功响应",
            "content": {
              "application/json": {
                "example": {
                  "success": {
                    "code": "0000",
                    "message": "删除资源成功",
                    "data": {
                      "result": true
                    }
                  },
                  "failure": {
                    "code": "4000",
                    "message": "删除资源失败",
                    "data": null
                  }
                }
              }
            }
          }
        },
        "tags": [
          "资源管理"
        ]
      }
    },
    "/api/customers": {
      "get": {
        "summary": "获取客户列表",
        "description": "分页获取客户列表",
        "parameters": [
          {
            "name": "pageNum",
            "in": "query",
            "required": false,
            "schema": {
              "type": "number"
            },
            "description": "页码，默认1"
          },
          {
            "name": "pageSize",
            "in": "query",
            "required": false,
            "schema": {
              "type": "number"
            },
            "description": "每页数量，默认10"
          },
          {
            "name": "name",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "description": "客户名称关键词"
          },
          {
            "name": "status",
            "in": "query",
            "required": false,
            "schema": {
              "type": "number"
            },
            "description": "状态过滤"
          }
        ],
        "responses": {
          "200": {
            "description": "成功响应",
            "content": {
              "application/json": {
                "example": {
                  "success": {
                    "code": "0000",
                    "message": "获取成功",
                    "data": {
                      "list": [
                        {
                          "id": 1,
                          "code": "CUS0001",
                          "name": "示例客户",
                          "contactName": "李四",
                          "contactPhone": "021-88888888",
                          "status": 1
                        }
                      ],
                      "total": 100,
                      "pageNum": 1,
                      "pageSize": 10
                    }
                  }
                }
              }
            }
          }
        },
        "tags": [
          "客户管理"
        ]
      },
      "post": {
        "summary": "创建客户",
        "description": "创建新的客户",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "name": {
                    "type": "string",
                    "description": "string｜必填，客户名称"
                  },
                  "contactName": {
                    "type": "string",
                    "description": "string｜可选，联系人姓名"
                  },
                  "contactPhone": {
                    "type": "string",
                    "description": "string｜可选，联系人电话"
                  },
                  "status": {
                    "type": "number",
                    "description": "number｜可选，状态：1-合作中，0-已终止"
                  }
                },
                "required": [
                  "name"
                ]
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "成功响应",
            "content": {
              "application/json": {
                "example": {
                  "success": {
                    "code": "0000",
                    "message": "创建客户成功",
                    "data": {
                      "id": 1,
                      "code": "CUS0001",
                      "name": "示例客户",
                      "contactName": "李四",
                      "contactPhone": "021-88888888",
                      "status": 1
                    }
                  },
                  "failure": {
                    "code": "4000",
                    "message": "创建客户失败",
                    "data": null
                  }
                }
              }
            }
          }
        },
        "tags": [
          "客户管理"
        ]
      }
    },
    "/api/customers/{id}": {
      "get": {
        "summary": "获取客户详情",
        "description": "根据客户ID获取客户详细信息",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "客户ID"
          }
        ],
        "responses": {
          "200": {
            "description": "成功响应",
            "content": {
              "application/json": {
                "example": {
                  "success": {
                    "code": "0000",
                    "message": "获取成功",
                    "data": {
                      "id": 1,
                      "code": "CUS0001",
                      "name": "示例客户",
                      "contactName": "李四",
                      "contactPhone": "021-88888888",
                      "status": 1
                    }
                  },
                  "failure": {
                    "code": "4040",
                    "message": "客户不存在",
                    "data": null
                  }
                }
              }
            }
          }
        },
        "tags": [
          "客户管理"
        ]
      },
      "put": {
        "summary": "更新客户",
        "description": "更新指定客户的信息",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "客户ID"
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "name": {
                    "type": "string",
                    "description": "string｜必填，客户名称"
                  },
                  "contactName": {
                    "type": "string",
                    "description": "string｜可选，联系人姓名"
                  },
                  "contactPhone": {
                    "type": "string",
                    "description": "string｜可选，联系人电话"
                  },
                  "status": {
                    "type": "number",
                    "description": "number｜可选，状态：1-合作中，0-已终止"
                  }
                },
                "required": [
                  "name"
                ]
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "成功响应",
            "content": {
              "application/json": {
                "example": {
                  "success": {
                    "code": "0000",
                    "message": "更新客户成功",
                    "data": {
                      "id": 1,
                      "code": "CUS0001",
                      "name": "示例客户",
                      "contactName": "李四",
                      "contactPhone": "021-88888888",
                      "status": 1
                    }
                  },
                  "failure": {
                    "code": "4000",
                    "message": "更新客户失败",
                    "data": null
                  }
                }
              }
            }
          }
        },
        "tags": [
          "客户管理"
        ]
      },
      "delete": {
        "summary": "删除客户",
        "description": "删除指定的客户",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "客户ID"
          }
        ],
        "responses": {
          "200": {
            "description": "成功响应",
            "content": {
              "application/json": {
                "example": {
                  "success": {
                    "code": "0000",
                    "message": "删除客户成功",
                    "data": {
                      "result": true
                    }
                  },
                  "failure": {
                    "code": "4000",
                    "message": "删除客户失败",
                    "data": null
                  }
                }
              }
            }
          }
        },
        "tags": [
          "客户管理"
        ]
      }
    },
    "/api/members/valid-list": {
      "get": {
        "summary": "获取有效会员列表",
        "description": "获取所有状态为有效（status=1）的会员套餐列表，用于下拉选择。无需分页，返回简化的字段信息。",
        "responses": {
          "200": {
            "description": "成功响应",
            "content": {
              "application/json": {
                "example": {
                  "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
                  }
                }
              }
            }
          }
        },
        "tags": [
          "会员管理"
        ]
      }
    },
    "/api/members": {
      "get": {
        "summary": "获取会员列表",
        "description": "分页获取会员套餐列表",
        "parameters": [
          {
            "name": "pageNum",
            "in": "query",
            "required": false,
            "schema": {
              "type": "number"
            },
            "description": "页码，默认1"
          },
          {
            "name": "pageSize",
            "in": "query",
            "required": false,
            "schema": {
              "type": "number"
            },
            "description": "每页数量，默认10"
          },
          {
            "name": "name",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "description": "套餐名称关键词"
          },
          {
            "name": "memberTypeId",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "description": "会员类型ID（会员类型管理记录的_id）"
          }
        ],
        "responses": {
          "200": {
            "description": "成功响应",
            "content": {
              "application/json": {
                "example": {
                  "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
                    }
                  }
                }
              }
            }
          }
        },
        "tags": [
          "会员管理"
        ]
      },
      "post": {
        "summary": "创建会员",
        "description": "创建新的会员套餐",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "name": {
                    "type": "string",
                    "description": "string｜必填，套餐名称"
                  },
                  "memberTypeId": {
                    "type": "string",
                    "description": "string｜可选，会员类型ID（会员类型管理记录的_id），如果提供会校验会员类型是否存在"
                  },
                  "price": {
                    "type": "string",
                    "description": "string｜可选，价格（两位小数，如：99.99）"
                  },
                  "validityDays": {
                    "type": "number",
                    "description": "number｜可选，有效期天数（最小值为1）"
                  },
                  "description": {
                    "type": "string",
                    "description": "string｜可选，套餐描述"
                  },
                  "status": {
                    "type": "number",
                    "description": "number｜可选，状态：1-有效，0-无效，默认0"
                  }
                },
                "required": [
                  "name"
                ]
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "成功响应",
            "content": {
              "application/json": {
                "example": {
                  "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
                  }
                }
              }
            }
          }
        },
        "tags": [
          "会员管理"
        ]
      }
    },
    "/api/members/{id}": {
      "get": {
        "summary": "获取会员详情",
        "description": "根据会员套餐ID获取会员套餐详细信息",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "会员套餐ID"
          }
        ],
        "responses": {
          "200": {
            "description": "成功响应",
            "content": {
              "application/json": {
                "example": {
                  "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
                  }
                }
              }
            }
          }
        },
        "tags": [
          "会员管理"
        ]
      },
      "put": {
        "summary": "更新会员",
        "description": "更新指定会员套餐的信息",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "会员套餐ID"
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "name": {
                    "type": "string",
                    "description": "string｜必填，套餐名称"
                  },
                  "memberTypeId": {
                    "type": "string",
                    "description": "string｜可选，会员类型ID（会员类型管理记录的_id），如果提供会校验会员类型是否存在"
                  },
                  "price": {
                    "type": "string",
                    "description": "string｜可选，价格（两位小数，如：99.99）"
                  },
                  "validityDays": {
                    "type": "number",
                    "description": "number｜可选，有效期天数（最小值为1）"
                  },
                  "description": {
                    "type": "string",
                    "description": "string｜可选，套餐描述"
                  },
                  "status": {
                    "type": "number",
                    "description": "number｜可选，状态：1-有效，0-无效，默认0"
                  }
                },
                "required": [
                  "name"
                ]
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "成功响应",
            "content": {
              "application/json": {
                "example": {
                  "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
                  }
                }
              }
            }
          }
        },
        "tags": [
          "会员管理"
        ]
      },
      "delete": {
        "summary": "删除会员",
        "description": "删除指定的会员套餐",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "会员套餐ID"
          }
        ],
        "responses": {
          "200": {
            "description": "成功响应",
            "content": {
              "application/json": {
                "example": {
                  "success": {
                    "code": "0000",
                    "message": "删除会员成功",
                    "data": {
                      "result": true
                    }
                  },
                  "failure": {
                    "code": "4000",
                    "message": "删除会员失败",
                    "data": null
                  }
                }
              }
            }
          }
        },
        "tags": [
          "会员管理"
        ]
      }
    },
    "/api/members/{id}/status": {
      "put": {
        "summary": "切换会员套餐状态",
        "description": "切换会员套餐的启用/禁用状态",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "会员套餐ID"
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "status": {
                    "type": "number",
                    "description": "number｜必填，状态：1-有效，0-无效"
                  }
                },
                "required": [
                  "status"
                ]
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "成功响应",
            "content": {
              "application/json": {
                "example": {
                  "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
                  }
                }
              }
            }
          }
        },
        "tags": [
          "会员管理"
        ]
      }
    },
    "/api/members/types/valid-list": {
      "get": {
        "summary": "获取有效会员类型列表",
        "description": "获取所有状态为有效（status=1）的会员类型列表，用于下拉选择。无需分页，返回简化的字段信息。",
        "responses": {
          "200": {
            "description": "成功响应",
            "content": {
              "application/json": {
                "example": {
                  "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
                  }
                }
              }
            }
          }
        },
        "tags": [
          "会员类型管理"
        ]
      }
    },
    "/api/members/types": {
      "get": {
        "summary": "获取会员类型列表",
        "description": "分页获取会员类型列表，支持按名称、编码、状态筛选",
        "parameters": [
          {
            "name": "pageNum",
            "in": "query",
            "required": false,
            "schema": {
              "type": "number"
            },
            "description": "页码，默认1"
          },
          {
            "name": "pageSize",
            "in": "query",
            "required": false,
            "schema": {
              "type": "number"
            },
            "description": "每页数量，默认10"
          },
          {
            "name": "name",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "description": "会员类型名称关键词"
          },
          {
            "name": "code",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "description": "会员类型编码关键词"
          },
          {
            "name": "status",
            "in": "query",
            "required": false,
            "schema": {
              "type": "number"
            },
            "description": "状态过滤：1-有效，0-无效"
          }
        ],
        "responses": {
          "200": {
            "description": "成功响应",
            "content": {
              "application/json": {
                "example": {
                  "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
                    }
                  }
                }
              }
            }
          }
        },
        "tags": [
          "会员类型管理"
        ]
      },
      "post": {
        "summary": "创建会员类型",
        "description": "创建新的会员类型",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "name": {
                    "type": "string",
                    "description": "string｜必填，会员类型名称"
                  },
                  "code": {
                    "type": "string",
                    "description": "string｜必填，会员类型编码"
                  },
                  "status": {
                    "type": "number",
                    "description": "number｜可选，状态：1-有效，0-无效，默认1"
                  },
                  "description": {
                    "type": "string",
                    "description": "string｜可选，描述信息"
                  }
                },
                "required": [
                  "name",
                  "code"
                ]
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "成功响应",
            "content": {
              "application/json": {
                "example": {
                  "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
                  }
                }
              }
            }
          }
        },
        "tags": [
          "会员类型管理"
        ]
      }
    },
    "/api/members/types/{typeId}": {
      "put": {
        "summary": "更新会员类型",
        "description": "更新指定会员类型的信息",
        "parameters": [
          {
            "name": "typeId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "会员类型ID"
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "name": {
                    "type": "string",
                    "description": "string｜可选，会员类型名称"
                  },
                  "code": {
                    "type": "string",
                    "description": "string｜可选，会员类型编码"
                  },
                  "status": {
                    "type": "number",
                    "description": "number｜可选，状态：1-有效，0-无效"
                  },
                  "description": {
                    "type": "string",
                    "description": "string｜可选，描述信息"
                  }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "成功响应",
            "content": {
              "application/json": {
                "example": {
                  "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
                  }
                }
              }
            }
          }
        },
        "tags": [
          "会员类型管理"
        ]
      },
      "delete": {
        "summary": "删除会员类型",
        "description": "删除指定的会员类型",
        "parameters": [
          {
            "name": "typeId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "会员类型ID"
          }
        ],
        "responses": {
          "200": {
            "description": "成功响应",
            "content": {
              "application/json": {
                "example": {
                  "success": {
                    "code": "0000",
                    "message": "删除成功",
                    "data": null
                  },
                  "failure": {
                    "code": "4000",
                    "message": "会员类型仍与会员功能关联，请先解除关联",
                    "data": null
                  }
                }
              }
            }
          }
        },
        "tags": [
          "会员类型管理"
        ]
      }
    },
    "/api/members/types/{typeId}/status": {
      "put": {
        "summary": "切换会员类型状态",
        "description": "切换会员类型的启用/禁用状态",
        "parameters": [
          {
            "name": "typeId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "会员类型ID"
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "status": {
                    "type": "number",
                    "description": "number｜必填，状态：1-有效，0-无效"
                  }
                },
                "required": [
                  "status"
                ]
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "成功响应",
            "content": {
              "application/json": {
                "example": {
                  "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
                  }
                }
              }
            }
          }
        },
        "tags": [
          "会员类型管理"
        ]
      }
    },
    "/api/stateless-members": {
      "get": {
        "summary": "获取无状态会员列表",
        "description": "分页获取无状态会员列表",
        "parameters": [
          {
            "name": "pageNum",
            "in": "query",
            "required": false,
            "schema": {
              "type": "number"
            },
            "description": "页码，默认1"
          },
          {
            "name": "pageSize",
            "in": "query",
            "required": false,
            "schema": {
              "type": "number"
            },
            "description": "每页数量，默认10"
          },
          {
            "name": "name",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "description": "会员名称关键词"
          },
          {
            "name": "code",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "description": "会员编码"
          },
          {
            "name": "memberTypeId",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "description": "按会员类型ID筛选（会员类型管理记录的_id）"
          },
          {
            "name": "status",
            "in": "query",
            "required": false,
            "schema": {
              "type": "number"
            },
            "description": "状态过滤"
          }
        ],
        "responses": {
          "200": {
            "description": "成功响应",
            "content": {
              "application/json": {
                "example": {
                  "success": {
                    "code": "0000",
                    "message": "获取成功",
                    "data": {
                      "list": [
                        {
                          "id": 1,
                          "code": "SM0001",
                          "name": "开放平台会员",
                          "secretKey": "sk-xxx",
                          "memberTypeId": "xxx",
                          "status": 1
                        }
                      ],
                      "total": 100,
                      "pageNum": 1,
                      "pageSize": 10
                    }
                  }
                }
              }
            }
          }
        },
        "tags": [
          "无状态会员管理"
        ]
      },
      "post": {
        "summary": "创建无状态会员",
        "description": "创建新的无状态会员",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "name": {
                    "type": "string",
                    "description": "string｜必填，会员名称"
                  },
                  "memberTypeId": {
                    "type": "string",
                    "description": "string｜可选，会员类型ID（会员类型管理记录的_id），如果提供会校验会员类型是否存在"
                  },
                  "effectiveDate": {
                    "type": "string",
                    "description": "string｜必填，生效日期"
                  },
                  "validityDays": {
                    "type": "number",
                    "description": "number｜必填，有效期天数（最小7天）"
                  },
                  "firstEffectiveDate": {
                    "type": "string",
                    "description": "string｜可选，首次生效日期"
                  },
                  "status": {
                    "type": "number",
                    "description": "number｜可选，状态：1-有效，0-无效，默认0"
                  }
                },
                "required": [
                  "name",
                  "effectiveDate",
                  "validityDays"
                ]
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "成功响应",
            "content": {
              "application/json": {
                "example": {
                  "success": {
                    "code": "0000",
                    "message": "创建无状态会员成功",
                    "data": {
                      "id": 1,
                      "code": "SM0001",
                      "name": "开放平台会员",
                      "secretKey": "sk-xxx",
                      "memberTypeId": "xxx",
                      "status": 1
                    }
                  },
                  "failure": {
                    "code": "4000",
                    "message": "关联的会员类型不存在",
                    "data": null
                  }
                }
              }
            }
          }
        },
        "tags": [
          "无状态会员管理"
        ]
      }
    },
    "/api/stateless-members/{id}": {
      "get": {
        "summary": "获取无状态会员详情",
        "description": "根据无状态会员ID获取详细信息",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "无状态会员ID"
          }
        ],
        "responses": {
          "200": {
            "description": "成功响应",
            "content": {
              "application/json": {
                "example": {
                  "success": {
                    "code": "0000",
                    "message": "获取成功",
                    "data": {
                      "id": 1,
                      "code": "SM0001",
                      "name": "开放平台会员",
                      "secretKey": "sk-xxx",
                      "memberTypeId": "xxx",
                      "status": 1
                    }
                  },
                  "failure": {
                    "code": "4040",
                    "message": "无状态会员不存在",
                    "data": null
                  }
                }
              }
            }
          }
        },
        "tags": [
          "无状态会员管理"
        ]
      },
      "put": {
        "summary": "更新无状态会员",
        "description": "更新指定无状态会员的信息",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "无状态会员ID"
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "name": {
                    "type": "string",
                    "description": "string｜可选，会员名称"
                  },
                  "memberTypeId": {
                    "type": "string",
                    "description": "string｜可选，会员类型ID（会员类型管理记录的_id），如果提供会校验会员类型是否存在"
                  },
                  "effectiveDate": {
                    "type": "string",
                    "description": "string｜可选，生效日期"
                  },
                  "validityDays": {
                    "type": "number",
                    "description": "number｜可选，有效期天数（最小7天）"
                  },
                  "firstEffectiveDate": {
                    "type": "string",
                    "description": "string｜可选，首次生效日期"
                  },
                  "status": {
                    "type": "number",
                    "description": "number｜可选，状态：1-有效，0-无效"
                  }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "成功响应",
            "content": {
              "application/json": {
                "example": {
                  "success": {
                    "code": "0000",
                    "message": "更新无状态会员成功",
                    "data": {
                      "id": 1,
                      "code": "SM0001",
                      "name": "开放平台会员",
                      "secretKey": "sk-xxx",
                      "memberTypeId": "xxx",
                      "status": 1
                    }
                  },
                  "failure": {
                    "code": "4000",
                    "message": "关联的会员类型不存在",
                    "data": null
                  }
                }
              }
            }
          }
        },
        "tags": [
          "无状态会员管理"
        ]
      },
      "delete": {
        "summary": "删除无状态会员",
        "description": "删除指定的无状态会员",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "无状态会员ID"
          }
        ],
        "responses": {
          "200": {
            "description": "成功响应",
            "content": {
              "application/json": {
                "example": {
                  "success": {
                    "code": "0000",
                    "message": "删除无状态会员成功",
                    "data": {
                      "result": true
                    }
                  },
                  "failure": {
                    "code": "4000",
                    "message": "删除无状态会员失败",
                    "data": null
                  }
                }
              }
            }
          }
        },
        "tags": [
          "无状态会员管理"
        ]
      }
    },
    "/api/stateless-members/{id}/status": {
      "put": {
        "summary": "切换无状态会员状态",
        "description": "切换无状态会员的启用/禁用状态",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "无状态会员ID"
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "status": {
                    "type": "number",
                    "description": "number｜必填，状态：1-有效，0-无效"
                  }
                },
                "required": [
                  "status"
                ]
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "成功响应",
            "content": {
              "application/json": {
                "example": {
                  "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,
                      "updateTime": "2025-01-01T10:00:00.000Z"
                    }
                  },
                  "failure": {
                    "code": "4040",
                    "message": "无状态会员不存在",
                    "data": null
                  }
                }
              }
            }
          }
        },
        "tags": [
          "无状态会员管理"
        ]
      }
    },
    "/api/member-users": {
      "get": {
        "summary": "获取会员用户列表",
        "description": "分页获取会员用户列表",
        "parameters": [
          {
            "name": "pageNum",
            "in": "query",
            "required": false,
            "schema": {
              "type": "number"
            },
            "description": "页码，默认1"
          },
          {
            "name": "pageSize",
            "in": "query",
            "required": false,
            "schema": {
              "type": "number"
            },
            "description": "每页数量，默认10"
          },
          {
            "name": "userId",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "description": "按客户端用户筛选"
          },
          {
            "name": "memberId",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "description": "按会员ID筛选（会员管理记录的_id）"
          }
        ],
        "responses": {
          "200": {
            "description": "成功响应",
            "content": {
              "application/json": {
                "example": {
                  "success": {
                    "code": "0000",
                    "message": "获取成功",
                    "data": {
                      "list": [
                        {
                          "id": 1,
                          "code": "MU0001",
                          "userId": "CU0001",
                          "memberId": "xxx",
                          "status": 1
                        }
                      ],
                      "total": 100,
                      "pageNum": 1,
                      "pageSize": 10
                    }
                  }
                }
              }
            }
          }
        },
        "tags": [
          "会员用户管理"
        ]
      },
      "post": {
        "summary": "创建会员用户",
        "description": "创建新的会员用户",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "userId": {
                    "type": "string",
                    "description": "string｜可选，绑定的客户端用户ID"
                  },
                  "memberId": {
                    "type": "string",
                    "description": "string｜可选，会员ID（会员管理记录的_id），如果提供会校验会员是否存在且有效"
                  },
                  "status": {
                    "type": "number",
                    "description": "number｜可选，状态：1-有效，0-无效"
                  }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "成功响应",
            "content": {
              "application/json": {
                "example": {
                  "success": {
                    "code": "0000",
                    "message": "创建会员用户成功",
                    "data": {
                      "id": 1,
                      "code": "MU0001",
                      "userId": "CU0001",
                      "memberId": "xxx",
                      "status": 1
                    }
                  },
                  "failure": {
                    "code": "4000",
                    "message": "关联的会员不存在",
                    "data": null
                  }
                }
              }
            }
          }
        },
        "tags": [
          "会员用户管理"
        ]
      }
    },
    "/api/member-users/{id}": {
      "get": {
        "summary": "获取会员用户详情",
        "description": "根据会员用户ID获取详细信息",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "会员用户ID"
          }
        ],
        "responses": {
          "200": {
            "description": "成功响应",
            "content": {
              "application/json": {
                "example": {
                  "success": {
                    "code": "0000",
                    "message": "获取成功",
                    "data": {
                      "id": 1,
                      "code": "MU0001",
                      "userId": "CU0001",
                      "memberId": "xxx",
                      "status": 1
                    }
                  },
                  "failure": {
                    "code": "4040",
                    "message": "会员用户不存在",
                    "data": null
                  }
                }
              }
            }
          }
        },
        "tags": [
          "会员用户管理"
        ]
      },
      "put": {
        "summary": "更新会员用户",
        "description": "更新指定会员用户的信息",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "会员用户ID"
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "userId": {
                    "type": "string",
                    "description": "string｜可选，绑定的客户端用户ID"
                  },
                  "memberId": {
                    "type": "string",
                    "description": "string｜可选，会员ID（会员管理记录的_id），如果提供会校验会员是否存在且有效"
                  },
                  "status": {
                    "type": "number",
                    "description": "number｜可选，状态：1-有效，0-无效"
                  }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "成功响应",
            "content": {
              "application/json": {
                "example": {
                  "success": {
                    "code": "0000",
                    "message": "更新会员用户成功",
                    "data": {
                      "id": 1,
                      "code": "MU0001",
                      "userId": "CU0001",
                      "memberId": "xxx",
                      "status": 1
                    }
                  },
                  "failure": {
                    "code": "4000",
                    "message": "关联的会员不存在",
                    "data": null
                  }
                }
              }
            }
          }
        },
        "tags": [
          "会员用户管理"
        ]
      },
      "delete": {
        "summary": "删除会员用户",
        "description": "删除指定的会员用户",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "会员用户ID"
          }
        ],
        "responses": {
          "200": {
            "description": "成功响应",
            "content": {
              "application/json": {
                "example": {
                  "success": {
                    "code": "0000",
                    "message": "删除会员用户成功",
                    "data": {
                      "result": true
                    }
                  },
                  "failure": {
                    "code": "4000",
                    "message": "删除会员用户失败",
                    "data": null
                  }
                }
              }
            }
          }
        },
        "tags": [
          "会员用户管理"
        ]
      }
    },
    "/api/members/functions": {
      "get": {
        "summary": "获取会员功能列表",
        "description": "分页获取会员功能配置列表，支持按会员类型、系统、状态筛选",
        "parameters": [
          {
            "name": "pageNum",
            "in": "query",
            "required": false,
            "schema": {
              "type": "number"
            },
            "description": "页码，默认1"
          },
          {
            "name": "pageSize",
            "in": "query",
            "required": false,
            "schema": {
              "type": "number"
            },
            "description": "每页数量，默认10"
          },
          {
            "name": "memberTypeId",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "description": "按会员类型ID筛选"
          },
          {
            "name": "systemId",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "description": "按系统ID筛选"
          },
          {
            "name": "status",
            "in": "query",
            "required": false,
            "schema": {
              "type": "number"
            },
            "description": "状态：1-启用，0-禁用"
          }
        ],
        "responses": {
          "200": {
            "description": "成功响应",
            "content": {
              "application/json": {
                "example": {
                  "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
                    }
                  }
                }
              }
            }
          }
        },
        "tags": [
          "会员功能管理"
        ]
      },
      "post": {
        "summary": "创建会员功能",
        "description": "为会员类型配置系统级功能入口（同会员类型+系统唯一）",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "memberTypeId": {
                    "type": "string",
                    "description": "string｜必填，会员类型ID"
                  },
                  "systemId": {
                    "type": "string",
                    "description": "string｜必填，系统ID"
                  },
                  "status": {
                    "type": "number",
                    "description": "number｜可选，状态：1-启用，0-禁用，默认1"
                  },
                  "description": {
                    "type": "string",
                    "description": "string｜可选，描述"
                  }
                },
                "required": [
                  "memberTypeId",
                  "systemId"
                ]
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "成功响应",
            "content": {
              "application/json": {
                "example": {
                  "success": {
                    "code": "0000",
                    "message": "创建成功",
                    "data": {
                      "id": 1,
                      "code": "MF0001",
                      "memberTypeId": "xxx",
                      "memberType": "VIP会员",
                      "systemId": "yyy",
                      "systemName": "权限管理系统",
                      "status": 1
                    }
                  },
                  "failure": {
                    "code": "4090",
                    "message": "该会员类型在当前系统下已配置功能",
                    "data": null
                  }
                }
              }
            }
          }
        },
        "tags": [
          "会员功能管理"
        ]
      }
    },
    "/api/members/functions/{id}": {
      "get": {
        "summary": "获取会员功能详情",
        "description": "根据ID获取会员功能配置详情",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "会员功能ID"
          }
        ],
        "responses": {
          "200": {
            "description": "成功响应",
            "content": {
              "application/json": {
                "example": {
                  "success": {
                    "code": "0000",
                    "message": "获取成功",
                    "data": {
                      "id": 1,
                      "code": "MF0001",
                      "memberTypeId": "xxx",
                      "memberType": "VIP会员",
                      "systemId": "yyy",
                      "systemName": "权限管理系统",
                      "status": 1
                    }
                  },
                  "failure": {
                    "code": "4040",
                    "message": "会员功能不存在",
                    "data": null
                  }
                }
              }
            }
          }
        },
        "tags": [
          "会员功能管理"
        ]
      },
      "put": {
        "summary": "更新会员功能",
        "description": "更新会员功能配置（可更新会员类型、系统、状态、描述）",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "会员功能ID"
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "memberTypeId": {
                    "type": "string",
                    "description": "string｜可选，会员类型ID"
                  },
                  "systemId": {
                    "type": "string",
                    "description": "string｜可选，系统ID"
                  },
                  "status": {
                    "type": "number",
                    "description": "number｜可选，状态：1-启用，0-禁用"
                  },
                  "description": {
                    "type": "string",
                    "description": "string｜可选，描述"
                  }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "成功响应",
            "content": {
              "application/json": {
                "example": {
                  "success": {
                    "code": "0000",
                    "message": "更新成功",
                    "data": {
                      "id": 1,
                      "code": "MF0001",
                      "memberTypeId": "xxx",
                      "systemId": "yyy",
                      "status": 1
                    }
                  }
                }
              }
            }
          }
        },
        "tags": [
          "会员功能管理"
        ]
      },
      "delete": {
        "summary": "删除会员功能",
        "description": "删除会员功能配置，同时会清理其关联的功能模块关系",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "会员功能ID"
          }
        ],
        "responses": {
          "200": {
            "description": "成功响应",
            "content": {
              "application/json": {
                "example": {
                  "success": {
                    "code": "0000",
                    "message": "删除成功",
                    "data": {
                      "result": true
                    }
                  }
                }
              }
            }
          }
        },
        "tags": [
          "会员功能管理"
        ]
      }
    },
    "/api/members/functions/{id}/status": {
      "put": {
        "summary": "切换会员功能状态",
        "description": "切换会员功能配置启用/禁用状态",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "会员功能ID"
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "status": {
                    "type": "number",
                    "description": "number｜必填，状态：1-启用，0-禁用"
                  }
                },
                "required": [
                  "status"
                ]
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "成功响应",
            "content": {
              "application/json": {
                "example": {
                  "success": {
                    "code": "0000",
                    "message": "状态更新成功",
                    "data": {
                      "id": 1,
                      "code": "MF0001",
                      "status": 1
                    }
                  }
                }
              }
            }
          }
        },
        "tags": [
          "会员功能管理"
        ]
      }
    },
    "/api/members/function-limits": {
      "get": {
        "summary": "获取会员功能限制列表",
        "description": "分页获取会员功能限制配置，支持按会员类型、系统、模块、状态筛选",
        "parameters": [
          {
            "name": "pageNum",
            "in": "query",
            "required": false,
            "schema": {
              "type": "number"
            },
            "description": "页码，默认1"
          },
          {
            "name": "pageSize",
            "in": "query",
            "required": false,
            "schema": {
              "type": "number"
            },
            "description": "每页数量，默认10"
          },
          {
            "name": "memberTypeId",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "description": "会员类型ID"
          },
          {
            "name": "systemId",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "description": "系统ID"
          },
          {
            "name": "moduleId",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "description": "模块ID"
          },
          {
            "name": "status",
            "in": "query",
            "required": false,
            "schema": {
              "type": "number"
            },
            "description": "状态：1-启用，0-禁用"
          }
        ],
        "responses": {
          "200": {
            "description": "成功响应",
            "content": {
              "application/json": {
                "example": {
                  "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
                    }
                  }
                }
              }
            }
          }
        },
        "tags": [
          "会员功能限制配置"
        ]
      },
      "post": {
        "summary": "创建会员功能限制",
        "description": "创建会员类型在系统模块上的额度限制（memberTypeId+systemId+moduleId唯一）",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "memberTypeId": {
                    "type": "string",
                    "description": "string｜必填，会员类型ID"
                  },
                  "systemId": {
                    "type": "string",
                    "description": "string｜必填，系统ID"
                  },
                  "moduleId": {
                    "type": "string",
                    "description": "string｜必填，模块ID"
                  },
                  "limitValue": {
                    "type": "number",
                    "description": "number｜必填，限制值（>=0）"
                  },
                  "status": {
                    "type": "number",
                    "description": "number｜可选，状态：1-启用，0-禁用，默认1"
                  },
                  "description": {
                    "type": "string",
                    "description": "string｜可选，描述"
                  }
                },
                "required": [
                  "memberTypeId",
                  "systemId",
                  "moduleId",
                  "limitValue"
                ]
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "成功响应",
            "content": {
              "application/json": {
                "example": {
                  "success": {
                    "code": "0000",
                    "message": "创建成功",
                    "data": {
                      "id": 1,
                      "code": "MFL0001",
                      "memberTypeId": "xxx",
                      "systemId": "yyy",
                      "moduleId": "zzz",
                      "limitValue": 100,
                      "status": 1
                    }
                  }
                }
              }
            }
          }
        },
        "tags": [
          "会员功能限制配置"
        ]
      }
    },
    "/api/members/function-limits/{limitId}": {
      "put": {
        "summary": "更新会员功能限制",
        "description": "更新指定限制配置",
        "parameters": [
          {
            "name": "limitId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "限制配置ID"
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "memberTypeId": {
                    "type": "string",
                    "description": "string｜可选，会员类型ID"
                  },
                  "systemId": {
                    "type": "string",
                    "description": "string｜可选，系统ID"
                  },
                  "moduleId": {
                    "type": "string",
                    "description": "string｜可选，模块ID"
                  },
                  "limitValue": {
                    "type": "number",
                    "description": "number｜可选，限制值（>=0）"
                  },
                  "status": {
                    "type": "number",
                    "description": "number｜可选，状态：1-启用，0-禁用"
                  },
                  "description": {
                    "type": "string",
                    "description": "string｜可选，描述"
                  }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "成功响应",
            "content": {
              "application/json": {
                "example": {
                  "success": {
                    "code": "0000",
                    "message": "更新成功",
                    "data": {
                      "id": 1,
                      "code": "MFL0001",
                      "limitValue": 200,
                      "status": 1
                    }
                  }
                }
              }
            }
          }
        },
        "tags": [
          "会员功能限制配置"
        ]
      },
      "delete": {
        "summary": "删除会员功能限制",
        "description": "删除指定限制配置",
        "parameters": [
          {
            "name": "limitId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "限制配置ID"
          }
        ],
        "responses": {
          "200": {
            "description": "成功响应",
            "content": {
              "application/json": {
                "example": {
                  "success": {
                    "code": "0000",
                    "message": "删除成功",
                    "data": {
                      "result": true
                    }
                  }
                }
              }
            }
          }
        },
        "tags": [
          "会员功能限制配置"
        ]
      }
    },
    "/api/members/function-limits/{limitId}/status": {
      "put": {
        "summary": "切换会员功能限制状态",
        "description": "切换限制配置启用/禁用状态",
        "parameters": [
          {
            "name": "limitId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "限制配置ID"
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "status": {
                    "type": "number",
                    "description": "number｜必填，状态：1-启用，0-禁用"
                  }
                },
                "required": [
                  "status"
                ]
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "成功响应",
            "content": {
              "application/json": {
                "example": {
                  "success": {
                    "code": "0000",
                    "message": "状态更新成功",
                    "data": {
                      "id": 1,
                      "code": "MFL0001",
                      "status": 1
                    }
                  }
                }
              }
            }
          }
        },
        "tags": [
          "会员功能限制配置"
        ]
      }
    },
    "/api/whitelists": {
      "get": {
        "summary": "获取白名单列表",
        "description": "分页获取白名单列表",
        "parameters": [
          {
            "name": "pageNum",
            "in": "query",
            "required": false,
            "schema": {
              "type": "number"
            },
            "description": "页码，默认1"
          },
          {
            "name": "pageSize",
            "in": "query",
            "required": false,
            "schema": {
              "type": "number"
            },
            "description": "每页数量，默认10"
          },
          {
            "name": "userId",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "description": "按用户筛选"
          }
        ],
        "responses": {
          "200": {
            "description": "成功响应",
            "content": {
              "application/json": {
                "example": {
                  "success": {
                    "code": "0000",
                    "message": "获取成功",
                    "data": {
                      "list": [
                        {
                          "id": 1,
                          "userId": "USER0001",
                          "reason": "业务合作",
                          "createTime": "2025-01-01T10:00:00.000Z"
                        }
                      ],
                      "total": 100,
                      "pageNum": 1,
                      "pageSize": 10
                    }
                  }
                }
              }
            }
          }
        },
        "tags": [
          "白名单管理"
        ]
      },
      "post": {
        "summary": "创建白名单",
        "description": "创建新的白名单",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "userId": {
                    "type": "string",
                    "description": "string｜必填，用户ID"
                  },
                  "reason": {
                    "type": "string",
                    "description": "string｜可选，加入白名单原因"
                  }
                },
                "required": [
                  "userId"
                ]
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "成功响应",
            "content": {
              "application/json": {
                "example": {
                  "success": {
                    "code": "0000",
                    "message": "创建白名单成功",
                    "data": {
                      "id": 1,
                      "userId": "USER0001",
                      "reason": "业务合作",
                      "createTime": "2025-01-01T10:00:00.000Z"
                    }
                  },
                  "failure": {
                    "code": "4000",
                    "message": "创建白名单失败",
                    "data": null
                  }
                }
              }
            }
          }
        },
        "tags": [
          "白名单管理"
        ]
      }
    },
    "/api/whitelists/{id}": {
      "get": {
        "summary": "获取白名单详情",
        "description": "根据白名单ID获取详细信息",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "白名单ID"
          }
        ],
        "responses": {
          "200": {
            "description": "成功响应",
            "content": {
              "application/json": {
                "example": {
                  "success": {
                    "code": "0000",
                    "message": "获取成功",
                    "data": {
                      "id": 1,
                      "userId": "USER0001",
                      "reason": "业务合作",
                      "createTime": "2025-01-01T10:00:00.000Z"
                    }
                  },
                  "failure": {
                    "code": "4040",
                    "message": "白名单不存在",
                    "data": null
                  }
                }
              }
            }
          }
        },
        "tags": [
          "白名单管理"
        ]
      },
      "put": {
        "summary": "更新白名单",
        "description": "更新指定白名单的信息",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "白名单ID"
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "userId": {
                    "type": "string",
                    "description": "string｜必填，用户ID"
                  },
                  "reason": {
                    "type": "string",
                    "description": "string｜可选，加入白名单原因"
                  }
                },
                "required": [
                  "userId"
                ]
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "成功响应",
            "content": {
              "application/json": {
                "example": {
                  "success": {
                    "code": "0000",
                    "message": "更新白名单成功",
                    "data": {
                      "id": 1,
                      "userId": "USER0001",
                      "reason": "业务合作",
                      "createTime": "2025-01-01T10:00:00.000Z"
                    }
                  },
                  "failure": {
                    "code": "4000",
                    "message": "更新白名单失败",
                    "data": null
                  }
                }
              }
            }
          }
        },
        "tags": [
          "白名单管理"
        ]
      },
      "delete": {
        "summary": "删除白名单",
        "description": "删除指定的白名单",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "白名单ID"
          }
        ],
        "responses": {
          "200": {
            "description": "成功响应",
            "content": {
              "application/json": {
                "example": {
                  "success": {
                    "code": "0000",
                    "message": "删除白名单成功",
                    "data": {
                      "result": true
                    }
                  },
                  "failure": {
                    "code": "4000",
                    "message": "删除白名单失败",
                    "data": null
                  }
                }
              }
            }
          }
        },
        "tags": [
          "白名单管理"
        ]
      }
    },
    "/api/blacklists": {
      "get": {
        "summary": "获取黑名单列表",
        "description": "分页获取黑名单列表",
        "parameters": [
          {
            "name": "pageNum",
            "in": "query",
            "required": false,
            "schema": {
              "type": "number"
            },
            "description": "页码，默认1"
          },
          {
            "name": "pageSize",
            "in": "query",
            "required": false,
            "schema": {
              "type": "number"
            },
            "description": "每页数量，默认10"
          },
          {
            "name": "userId",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "description": "按用户筛选"
          }
        ],
        "responses": {
          "200": {
            "description": "成功响应",
            "content": {
              "application/json": {
                "example": {
                  "success": {
                    "code": "0000",
                    "message": "获取成功",
                    "data": {
                      "list": [
                        {
                          "id": 1,
                          "userId": "USER0002",
                          "reason": "恶意操作",
                          "createTime": "2025-01-01T10:00:00.000Z"
                        }
                      ],
                      "total": 100,
                      "pageNum": 1,
                      "pageSize": 10
                    }
                  }
                }
              }
            }
          }
        },
        "tags": [
          "黑名单管理"
        ]
      },
      "post": {
        "summary": "创建黑名单",
        "description": "创建新的黑名单",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "userId": {
                    "type": "string",
                    "description": "string｜必填，用户ID"
                  },
                  "reason": {
                    "type": "string",
                    "description": "string｜可选，加入黑名单原因"
                  }
                },
                "required": [
                  "userId"
                ]
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "成功响应",
            "content": {
              "application/json": {
                "example": {
                  "success": {
                    "code": "0000",
                    "message": "创建黑名单成功",
                    "data": {
                      "id": 1,
                      "userId": "USER0002",
                      "reason": "恶意操作",
                      "createTime": "2025-01-01T10:00:00.000Z"
                    }
                  },
                  "failure": {
                    "code": "4000",
                    "message": "创建黑名单失败",
                    "data": null
                  }
                }
              }
            }
          }
        },
        "tags": [
          "黑名单管理"
        ]
      }
    },
    "/api/blacklists/{id}": {
      "get": {
        "summary": "获取黑名单详情",
        "description": "根据黑名单ID获取详细信息",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "黑名单ID"
          }
        ],
        "responses": {
          "200": {
            "description": "成功响应",
            "content": {
              "application/json": {
                "example": {
                  "success": {
                    "code": "0000",
                    "message": "获取成功",
                    "data": {
                      "id": 1,
                      "userId": "USER0002",
                      "reason": "恶意操作",
                      "createTime": "2025-01-01T10:00:00.000Z"
                    }
                  },
                  "failure": {
                    "code": "4040",
                    "message": "黑名单不存在",
                    "data": null
                  }
                }
              }
            }
          }
        },
        "tags": [
          "黑名单管理"
        ]
      },
      "put": {
        "summary": "更新黑名单",
        "description": "更新指定黑名单的信息",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "黑名单ID"
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "userId": {
                    "type": "string",
                    "description": "string｜必填，用户ID"
                  },
                  "reason": {
                    "type": "string",
                    "description": "string｜可选，加入黑名单原因"
                  }
                },
                "required": [
                  "userId"
                ]
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "成功响应",
            "content": {
              "application/json": {
                "example": {
                  "success": {
                    "code": "0000",
                    "message": "更新黑名单成功",
                    "data": {
                      "id": 1,
                      "userId": "USER0002",
                      "reason": "恶意操作",
                      "createTime": "2025-01-01T10:00:00.000Z"
                    }
                  },
                  "failure": {
                    "code": "4000",
                    "message": "更新黑名单失败",
                    "data": null
                  }
                }
              }
            }
          }
        },
        "tags": [
          "黑名单管理"
        ]
      },
      "delete": {
        "summary": "删除黑名单",
        "description": "删除指定的黑名单",
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "黑名单ID"
          }
        ],
        "responses": {
          "200": {
            "description": "成功响应",
            "content": {
              "application/json": {
                "example": {
                  "success": {
                    "code": "0000",
                    "message": "删除黑名单成功",
                    "data": {
                      "result": true
                    }
                  },
                  "failure": {
                    "code": "4000",
                    "message": "删除黑名单失败",
                    "data": null
                  }
                }
              }
            }
          }
        },
        "tags": [
          "黑名单管理"
        ]
      }
    },
    "/api/security/systems/active": {
      "get": {
        "summary": "查询所有有效系统",
        "description": "查询所有有效的系统配置列表，用于其他业务通过选择列表选择目标系统。返回所有 status = 1 的系统，不需要分页",
        "responses": {
          "200": {
            "description": "成功响应",
            "content": {
              "application/json": {
                "example": {
                  "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"
                      }
                    ]
                  }
                }
              }
            }
          }
        },
        "tags": [
          "安全系统管理"
        ]
      }
    },
    "/api/security/systems/{systemId}/modules/active": {
      "get": {
        "summary": "查询某个系统下的有效模块",
        "description": "查询指定系统下所有有效的模块列表，用于其他业务通过选择列表选择目标模块。返回所有 status = 1 的模块，不需要分页",
        "parameters": [
          {
            "name": "systemId",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "系统ID"
          }
        ],
        "responses": {
          "200": {
            "description": "成功响应",
            "content": {
              "application/json": {
                "example": {
                  "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
                  }
                }
              }
            }
          }
        },
        "tags": [
          "安全系统管理"
        ]
      }
    },
    "/openapi/memberships/valid-check": {
      "post": {
        "summary": "有状态会员有效性校验（场景A）",
        "description": "场景A：校验已登录用户的会员是否有效（未过期），不校验系统支持。适用于第三方已持有用户登录令牌，只需确认该用户是否有效会员的场景。",
        "parameters": [
          {
            "name": "Authorization",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "用户登录令牌，格式 Bearer TOKEN（通过 /memberships/login 获取）",
            "example": "Bearer {token}"
          },
          {
            "name": "X-Site",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "站点标识"
          },
          {
            "name": "X-System-Code",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "系统编码（用于路由到正确数据库）"
          }
        ],
        "responses": {
          "200": {
            "description": "成功响应",
            "content": {
              "application/json": {
                "example": {
                  "code": "0000",
                  "message": "成功"
                }
              }
            }
          }
        },
        "tags": [
          "OpenAPI 接口"
        ]
      }
    },
    "/openapi/memberships/check": {
      "post": {
        "summary": "有状态会员系统支持校验（场景B）",
        "description": "场景B：校验已登录用户的会员有效性，并校验该用户的会员类型是否已配置支持指定系统。适用于系统级访问控制，如黄金会员才能访问系统B。",
        "parameters": [
          {
            "name": "Authorization",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "用户登录令牌，格式 Bearer TOKEN",
            "example": "Bearer {token}"
          },
          {
            "name": "X-Site",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "站点标识"
          },
          {
            "name": "X-System-Code",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "系统编码，同时作为校验目标（会员类型是否支持该系统）"
          }
        ],
        "responses": {
          "200": {
            "description": "成功响应",
            "content": {
              "application/json": {
                "example": {
                  "code": "0000",
                  "message": "成功"
                }
              }
            }
          }
        },
        "tags": [
          "OpenAPI 接口"
        ]
      }
    },
    "/openapi/memberships/functionCheck": {
      "post": {
        "summary": "有状态会员功能模块校验（场景C）",
        "description": "场景C：在场景B基础上，进一步校验该用户的会员类型在指定系统下是否开通了特定功能模块。适用于菜单/功能级别的精细控制。",
        "parameters": [
          {
            "name": "Authorization",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "用户登录令牌，格式 Bearer TOKEN",
            "example": "Bearer {token}"
          },
          {
            "name": "X-Site",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "站点标识"
          },
          {
            "name": "X-System-Code",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "系统编码"
          },
          {
            "name": "X-Function",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "功能模块代码（moduleCode），如 VIDEO_DOWNLOAD"
          }
        ],
        "responses": {
          "200": {
            "description": "成功响应",
            "content": {
              "application/json": {
                "example": {
                  "code": "0000",
                  "message": "成功"
                }
              }
            }
          }
        },
        "tags": [
          "OpenAPI 接口"
        ]
      }
    },
    "/openapi/memberships/limitCheck": {
      "post": {
        "summary": "有状态会员限额校验（场景D）",
        "description": "场景D：在场景C基础上，进一步校验当前功能模块的使用量是否已达配置上限。适用于有存储量/次数上限的业务，如最多保存10条数据。",
        "parameters": [
          {
            "name": "Authorization",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "用户登录令牌，格式 Bearer TOKEN",
            "example": "Bearer {token}"
          },
          {
            "name": "X-Site",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "站点标识"
          },
          {
            "name": "X-System-Code",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "系统编码"
          },
          {
            "name": "X-Function",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "功能模块代码"
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "currentCount": {
                    "type": "number",
                    "description": "number｜必填，当前已使用次数/数量（由第三方系统维护）"
                  }
                },
                "required": [
                  "currentCount"
                ]
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "成功响应",
            "content": {
              "application/json": {
                "example": {
                  "code": "0000",
                  "message": "成功"
                }
              }
            }
          }
        },
        "tags": [
          "OpenAPI 接口"
        ]
      }
    },
    "/openapi/stateless-members/resources/valid-check": {
      "post": {
        "summary": "无状态会员资源校验（场景A）",
        "description": "返回与 /openapi/permissions/check 一致的资源结构，并叠加无状态会员有效性约束（仅校验会员有效）。",
        "parameters": [
          {
            "name": "Authorization",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "账号登录令牌，格式 Bearer TOKEN",
            "example": "Bearer {token}"
          },
          {
            "name": "X-Member-Key",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "会员密钥令牌"
          },
          {
            "name": "X-Site",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "站点标识"
          }
        ],
        "responses": {
          "200": {
            "description": "成功响应",
            "content": {
              "application/json": {
                "example": {
                  "success": {
                    "code": "0000",
                    "message": "校验通过",
                    "data": {
                      "user": {
                        "id": "u001",
                        "code": "CU000001",
                        "username": "张三",
                        "type": "clientUser"
                      },
                      "resources": [],
                      "resourcesByType": {},
                      "resourceUrls": []
                    }
                  }
                }
              }
            }
          }
        },
        "tags": [
          "OpenAPI 接口"
        ]
      }
    },
    "/openapi/stateless-members/resources/check": {
      "post": {
        "summary": "无状态会员资源校验（场景B）",
        "description": "返回与 /openapi/permissions/check 一致的资源结构，并叠加无状态会员有效性+系统支持约束。",
        "parameters": [
          {
            "name": "Authorization",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "账号登录令牌，格式 Bearer TOKEN",
            "example": "Bearer {token}"
          },
          {
            "name": "X-Member-Key",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "会员密钥令牌"
          },
          {
            "name": "X-System-Code",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "系统编码"
          },
          {
            "name": "X-Site",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "站点标识"
          }
        ],
        "responses": {
          "200": {
            "description": "成功响应",
            "content": {
              "application/json": {
                "example": {
                  "success": {
                    "code": "0000",
                    "message": "校验通过",
                    "data": {
                      "system": {
                        "code": "AUTH_MANAGEMENT",
                        "name": "权限管理系统"
                      },
                      "resources": [],
                      "resourcesByType": {},
                      "resourceUrls": []
                    }
                  }
                }
              }
            }
          }
        },
        "tags": [
          "OpenAPI 接口"
        ]
      }
    },
    "/openapi/stateless-members/resources/functionCheck": {
      "post": {
        "summary": "无状态会员资源校验（场景C）",
        "description": "返回与 /openapi/permissions/check 一致的资源结构，并叠加无状态会员有效性+系统约束。系统会自动解析该会员在当前系统下已授权的模块，并返回对应模块资源。",
        "parameters": [
          {
            "name": "Authorization",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "账号登录令牌，格式 Bearer TOKEN",
            "example": "Bearer {token}"
          },
          {
            "name": "X-Member-Key",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "会员密钥令牌"
          },
          {
            "name": "X-System-Code",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "系统编码"
          },
          {
            "name": "X-Site",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "站点标识"
          }
        ],
        "responses": {
          "200": {
            "description": "成功响应",
            "content": {
              "application/json": {
                "example": {
                  "success": {
                    "code": "0000",
                    "message": "校验通过",
                    "data": {
                      "resources": [],
                      "resourcesByType": {},
                      "resourceUrls": []
                    }
                  }
                }
              }
            }
          }
        },
        "tags": [
          "OpenAPI 接口"
        ]
      }
    },
    "/openapi/stateless-members/resources/limitCheck": {
      "post": {
        "summary": "无状态会员资源校验（场景D）",
        "description": "返回与 /openapi/permissions/check 一致的资源结构，并叠加无状态会员有效性+系统+限额约束。系统会自动按会员在当前系统下已授权模块过滤资源，并对这些模块应用限额筛选。",
        "parameters": [
          {
            "name": "Authorization",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "账号登录令牌，格式 Bearer TOKEN",
            "example": "Bearer {token}"
          },
          {
            "name": "X-Member-Key",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "会员密钥令牌"
          },
          {
            "name": "X-System-Code",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "系统编码"
          },
          {
            "name": "X-Site",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "站点标识"
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "currentCount": {
                    "type": "number",
                    "description": "number｜必填，当前已使用次数/数量"
                  }
                },
                "required": [
                  "currentCount"
                ]
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "成功响应",
            "content": {
              "application/json": {
                "example": {
                  "success": {
                    "code": "0000",
                    "message": "校验通过",
                    "data": {
                      "resources": [],
                      "resourcesByType": {},
                      "resourceUrls": []
                    }
                  }
                }
              }
            }
          }
        },
        "tags": [
          "OpenAPI 接口"
        ]
      }
    },
    "/openapi/memberships/resources/valid-check": {
      "post": {
        "summary": "有状态会员资源校验（场景A）",
        "description": "返回与 /openapi/permissions/check 一致的资源结构，并叠加有状态会员有效性约束。",
        "parameters": [
          {
            "name": "Authorization",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "用户登录令牌，格式 Bearer TOKEN",
            "example": "Bearer {token}"
          },
          {
            "name": "X-Site",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "站点标识"
          }
        ],
        "responses": {
          "200": {
            "description": "成功响应",
            "content": {
              "application/json": {
                "example": {
                  "success": {
                    "code": "0000",
                    "message": "校验通过",
                    "data": {
                      "resources": [],
                      "resourcesByType": {},
                      "resourceUrls": []
                    }
                  }
                }
              }
            }
          }
        },
        "tags": [
          "OpenAPI 接口"
        ]
      }
    },
    "/openapi/memberships/resources/check": {
      "post": {
        "summary": "有状态会员资源校验（场景B）",
        "description": "返回与 /openapi/permissions/check 一致的资源结构，并叠加有状态会员有效性+系统支持约束。",
        "parameters": [
          {
            "name": "Authorization",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "用户登录令牌，格式 Bearer TOKEN",
            "example": "Bearer {token}"
          },
          {
            "name": "X-System-Code",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "系统编码"
          },
          {
            "name": "X-Site",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "站点标识"
          }
        ],
        "responses": {
          "200": {
            "description": "成功响应",
            "content": {
              "application/json": {
                "example": {
                  "success": {
                    "code": "0000",
                    "message": "校验通过",
                    "data": {
                      "resources": [],
                      "resourcesByType": {},
                      "resourceUrls": []
                    }
                  }
                }
              }
            }
          }
        },
        "tags": [
          "OpenAPI 接口"
        ]
      }
    },
    "/openapi/memberships/resources/functionCheck": {
      "post": {
        "summary": "有状态会员资源校验（场景C）",
        "description": "返回与 /openapi/permissions/check 一致的资源结构，并叠加有状态会员有效性+系统约束。系统会自动解析该会员在当前系统下已授权的模块，并返回对应模块资源。",
        "parameters": [
          {
            "name": "Authorization",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "用户登录令牌，格式 Bearer TOKEN",
            "example": "Bearer {token}"
          },
          {
            "name": "X-System-Code",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "系统编码"
          },
          {
            "name": "X-Site",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "站点标识"
          }
        ],
        "responses": {
          "200": {
            "description": "成功响应",
            "content": {
              "application/json": {
                "example": {
                  "success": {
                    "code": "0000",
                    "message": "校验通过",
                    "data": {
                      "resources": [],
                      "resourcesByType": {},
                      "resourceUrls": []
                    }
                  }
                }
              }
            }
          }
        },
        "tags": [
          "OpenAPI 接口"
        ]
      }
    },
    "/openapi/memberships/resources/limitCheck": {
      "post": {
        "summary": "有状态会员资源校验（场景D）",
        "description": "返回与 /openapi/permissions/check 一致的资源结构，并叠加有状态会员有效性+系统+限额约束。系统会自动按会员在当前系统下已授权模块过滤资源，并对这些模块应用限额筛选。",
        "parameters": [
          {
            "name": "Authorization",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "用户登录令牌，格式 Bearer TOKEN",
            "example": "Bearer {token}"
          },
          {
            "name": "X-System-Code",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "系统编码"
          },
          {
            "name": "X-Site",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "站点标识"
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "currentCount": {
                    "type": "number",
                    "description": "number｜必填，当前已使用次数/数量"
                  }
                },
                "required": [
                  "currentCount"
                ]
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "成功响应",
            "content": {
              "application/json": {
                "example": {
                  "success": {
                    "code": "0000",
                    "message": "校验通过",
                    "data": {
                      "resources": [],
                      "resourcesByType": {},
                      "resourceUrls": []
                    }
                  }
                }
              }
            }
          }
        },
        "tags": [
          "OpenAPI 接口"
        ]
      }
    },
    "/openapi/memberships/activate": {
      "post": {
        "summary": "会员开通",
        "description": "基于已支付订单为客户端用户开通会员资格，并自动同步会员用户记录和订单状态。",
        "parameters": [
          {
            "name": "Authorization",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "客户端登录令牌，格式为 Bearer TOKEN",
            "example": "Bearer {token}"
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "memberType": {
                    "type": "string",
                    "description": "string｜必填，会员类型编码或名称，如 VIP"
                  },
                  "orderNo": {
                    "type": "string",
                    "description": "string｜必填，已支付订单号"
                  }
                },
                "required": [
                  "memberType",
                  "orderNo"
                ]
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "成功响应",
            "content": {
              "application/json": {
                "example": {
                  "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
                  }
                }
              }
            }
          }
        },
        "tags": [
          "OpenAPI 接口"
        ]
      }
    },
    "/openapi/memberships/register": {
      "post": {
        "summary": "会员注册",
        "description": "根据注册令牌中的信息自动落地企业或散客账号。如果启用了站点分配，会为用户创建个人站点和独立数据库，并自动创建超级管理员角色。",
        "parameters": [
          {
            "name": "Authorization",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "注册令牌，服务端提前生成，格式为 Bearer TOKEN",
            "example": "Bearer {token}"
          },
          {
            "name": "X-Site",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "所属站点标识，用户将注册到该站点"
          }
        ],
        "responses": {
          "200": {
            "description": "成功响应",
            "content": {
              "application/json": {
                "example": {
                  "success": {
                    "code": "0000",
                    "message": "会员注册成功",
                    "data": {
                      "accountType": "company",
                      "user": {
                        "id": "BAKj1wKp7etrmSAT",
                        "code": "USER000001",
                        "name": "企业管理员",
                        "title": "企业管理员",
                        "phone": "13800138000",
                        "email": "admin@example.com",
                        "phonePrefix": "+86",
                        "individualism": true,
                        "status": 1,
                        "roles": [],
                        "effectiveDate": "2025-01-21",
                        "expiryDate": null,
                        "createTime": "2025-01-21T10:00:00.000Z",
                        "updateTime": "2025-01-21T10:00:00.000Z",
                        "creator": "13800138000",
                        "updater": "13800138000"
                      },
                      "organization": {
                        "code": "ORG000001",
                        "name": "靖苒数字"
                      },
                      "site": {
                        "id": "site-id",
                        "key": "A1B2C3D4-E5F6-7890-ABCD-EF1234567890-ABCDEF12",
                        "name": "个人站点",
                        "createTime": "2025-01-21T10:00:00.000Z"
                      }
                    }
                  },
                  "failure": {
                    "code": "1203",
                    "message": "公司信用代码已注册",
                    "data": null
                  }
                }
              }
            }
          }
        },
        "tags": [
          "OpenAPI 接口"
        ]
      }
    },
    "/openapi/memberships/login": {
      "post": {
        "summary": "会员登录",
        "description": "同时支持企业账号与散客账号的登录校验，并返回加密的登录令牌。如果用户有多个可用站点，会返回站点信息。散客账号登录时必须包含同意协议字段。",
        "parameters": [
          {
            "name": "Authorization",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "登录令牌，包含手机号、密码和同意协议信息（散客账号必填），格式为 Bearer TOKEN。令牌 payload 应包含：phone（手机号）、password（密码）、agreeTerms（同意协议，散客账号必填且必须为 true）",
            "example": "Bearer {token}"
          },
          {
            "name": "X-System-Code",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "系统编码。用于指定当前登录的业务系统（例如 AUTH_MANAGEMENT、CONTENT_MANAGEMENT）。当系统不支持时将返回“登录用户不支持当前系统，可联系管理员处理”。"
          }
        ],
        "responses": {
          "200": {
            "description": "成功响应",
            "content": {
              "application/json": {
                "example": {
                  "success": {
                    "code": "0000",
                    "message": "登录成功",
                    "data": {
                      "token": "eyJhbGciOiJIUzI1NiIs...",
                      "user": {
                        "id": "BAKj1wKp7etrmSAT",
                        "code": "USER000001",
                        "username": "企业管理员",
                        "phone": "13800138000",
                        "email": "admin@example.com",
                        "individualism": true,
                        "status": 1,
                        "createTime": "2025-01-21T10:00:00.000Z",
                        "accountType": "user",
                        "type": "普通用户"
                      },
                      "companyName": "靖苒数字",
                      "site": {
                        "id": "site-id",
                        "key": "56B57A72-59C4-460B-82E5-22196205391B-A4608B6E9D4D6F599",
                        "name": "所属站点",
                        "createTime": "2025-01-21T10:00:00.000Z"
                      }
                    }
                  },
                  "failure": {
                    "code": "1302",
                    "message": "当前账号处于黑名单状态",
                    "data": null
                  },
                  "failureAgreeTerms": {
                    "code": "1303",
                    "message": "请同意隐私等协议",
                    "data": null
                  }
                }
              }
            }
          }
        },
        "tags": [
          "OpenAPI 接口"
        ]
      }
    },
    "/openapi/memberships/login/verify": {
      "post": {
        "summary": "登录令牌校验",
        "description": "对登录接口返回的访问令牌进行有效性校验，确认令牌是否过期、账号状态及黑名单状态。",
        "parameters": [
          {
            "name": "Authorization",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "登录接口返回的访问令牌，格式为 Bearer TOKEN",
            "example": "Bearer {token}"
          },
          {
            "name": "X-System-Code",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "系统编码。用于指定当前登录的业务系统（例如 AUTH_MANAGEMENT、CONTENT_MANAGEMENT）。当系统不支持时将返回“登录用户不支持当前系统，可联系管理员处理”。"
          }
        ],
        "responses": {
          "200": {
            "description": "成功响应",
            "content": {
              "application/json": {
                "example": {
                  "success": {
                    "code": "0000",
                    "message": "登录令牌校验成功",
                    "data": {
                      "phone": "13800138000",
                      "id": "USER000001",
                      "_id": "MNFIOHH6QOA3kg0z"
                    }
                  },
                  "failure": {
                    "code": "1300",
                    "message": "登录令牌无效或已过期",
                    "data": null
                  }
                }
              }
            }
          }
        },
        "tags": [
          "OpenAPI 接口"
        ]
      }
    },
    "/openapi/permissions/resource-check": {
      "post": {
        "summary": "资源权限校验",
        "description": "基于登录令牌校验指定系统下用户是否拥有访问某接口所需的资源与权限。支持通过 X-Site header 切换站点。",
        "parameters": [
          {
            "name": "Authorization",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "登录接口返回的访问令牌，格式为 Bearer TOKEN",
            "example": "Bearer {token}"
          },
          {
            "name": "X-Site",
            "in": "header",
            "required": false,
            "schema": {
              "type": "string"
            },
            "description": "站点标识。用于切换站点和对应的数据库上下文。如果用户有多个可用站点，可通过此 header 切换。"
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "systemCode": {
                    "type": "string",
                    "description": "string｜必填，目标系统编码"
                  },
                  "apiName": {
                    "type": "string",
                    "description": "string｜必填，接口标识（可使用资源 code、name、title 或 URL）"
                  },
                  "requiredPermissions": {
                    "type": "string",
                    "description": "string[]｜选填，需要同时具备的权限编码数组"
                  }
                },
                "required": [
                  "systemCode",
                  "apiName"
                ]
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "成功响应",
            "content": {
              "application/json": {
                "example": {
                  "success": {
                    "code": "0000",
                    "message": "资源权限校验成功",
                    "data": {
                      "accessGranted": true,
                      "user": {
                        "id": "BAKj1wKp7etrmSAT",
                        "phone": "13800138000",
                        "type": "user"
                      },
                      "system": {
                        "code": "AUTH",
                        "name": "权限管理系统"
                      },
                      "resource": {
                        "code": "API_CUSTOMER_DELETE",
                        "url": "/api/customers/:id",
                        "type": "api"
                      },
                      "checkedPermissions": [
                        "CUSTOMER_DELETE"
                      ]
                    }
                  },
                  "failure": {
                    "code": "1502",
                    "message": "缺少必要权限: CUSTOMER_DELETE",
                    "data": null
                  }
                }
              }
            }
          }
        },
        "tags": [
          "OpenAPI 接口"
        ]
      }
    },
    "/openapi/permissions/check": {
      "post": {
        "summary": "账户权限校验",
        "description": "根据访问令牌校验账户在指定系统下拥有的资源与权限。资源列表以树状结构返回，方便前端渲染菜单等场景。支持通过 X-Site header 切换站点。",
        "parameters": [
          {
            "name": "Authorization",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "访问令牌，支持系统用户与客户端用户，格式为 Bearer TOKEN",
            "example": "Bearer {token}"
          },
          {
            "name": "X-Site",
            "in": "header",
            "required": false,
            "schema": {
              "type": "string"
            },
            "description": "站点标识。用于切换站点和对应的数据库上下文。如果用户有多个可用站点，可通过此 header 切换。"
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "systemCode": {
                    "type": "string",
                    "description": "string｜必填，要校验的系统编码"
                  }
                },
                "required": [
                  "systemCode"
                ]
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "成功响应",
            "content": {
              "application/json": {
                "example": {
                  "success": {
                    "code": "0000",
                    "message": "权限校验成功",
                    "data": {
                      "user": {
                        "id": "MNFIOHH6QOA3kg0z",
                        "code": "USER000001",
                        "username": "企业管理员",
                        "type": "user"
                      },
                      "companyName": "靖苒数字",
                      "system": {
                        "code": "AUTH",
                        "name": "权限管理系统"
                      },
                      "resources": [
                        {
                          "id": "RES001",
                          "code": "RES001",
                          "name": "内容管理",
                          "title": "内容管理",
                          "type": "page",
                          "url": "/content",
                          "parentId": null,
                          "orderNum": 1,
                          "children": [
                            {
                              "id": "RES002",
                              "code": "RES002",
                              "name": "文章管理",
                              "title": "文章管理",
                              "type": "page",
                              "url": "/content/articles",
                              "parentId": "RES001",
                              "orderNum": 1,
                              "children": []
                            },
                            {
                              "id": "RES003",
                              "code": "RES003",
                              "name": "分类管理",
                              "title": "分类管理",
                              "type": "page",
                              "url": "/content/categories",
                              "parentId": "RES001",
                              "orderNum": 2,
                              "children": []
                            }
                          ]
                        }
                      ],
                      "resourcesByType": {
                        "page": [
                          {
                            "id": "RES001",
                            "code": "RES001",
                            "name": "内容管理",
                            "title": "内容管理",
                            "type": "page",
                            "url": "/content",
                            "parentId": null,
                            "orderNum": 1,
                            "children": [
                              {
                                "id": "RES002",
                                "code": "RES002",
                                "name": "文章管理",
                                "title": "文章管理",
                                "type": "page",
                                "url": "/content/articles",
                                "parentId": "RES001",
                                "orderNum": 1,
                                "children": []
                              },
                              {
                                "id": "RES003",
                                "code": "RES003",
                                "name": "分类管理",
                                "title": "分类管理",
                                "type": "page",
                                "url": "/content/categories",
                                "parentId": "RES001",
                                "orderNum": 2,
                                "children": []
                              }
                            ]
                          }
                        ],
                        "button": [
                          {
                            "id": "RES004",
                            "code": "RES004",
                            "name": "新增按钮",
                            "title": "新增按钮",
                            "type": "button",
                            "url": "/api/content/create",
                            "parentId": null,
                            "orderNum": 1,
                            "children": []
                          }
                        ]
                      },
                      "site": {
                        "id": "site-id",
                        "key": "A1B2C3D4-E5F6-7890-ABCD-EF1234567890-ABCDEF12",
                        "name": "个人站点",
                        "createTime": "2025-01-21T10:00:00.000Z"
                      }
                    }
                  },
                  "failure": {
                    "code": "1402",
                    "message": "系统未开放或已停用",
                    "data": null
                  }
                }
              }
            }
          }
        },
        "tags": [
          "OpenAPI 接口"
        ]
      }
    },
    "/openapi/stateless-members/activate": {
      "post": {
        "summary": "激活无状态会员",
        "description": "激活无状态会员，通过X-Member-Key header中的混合JWT解密得到密钥，校验会员有效性后生成新的密钥令牌返回。",
        "parameters": [
          {
            "name": "X-Member-Key",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "会员密钥令牌，通过混合JWT加密"
          },
          {
            "name": "X-System-Code",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "系统编码，用于判断会员类型是否支持当前系统"
          },
          {
            "name": "X-Site",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "站点标识"
          }
        ],
        "responses": {
          "200": {
            "description": "成功响应",
            "content": {
              "application/json": {
                "example": {
                  "success": {
                    "code": "0000",
                    "message": "激活成功",
                    "data": {
                      "keyToken": "新的密钥令牌（混合JWT加密）",
                      "member": {
                        "id": "xxx",
                        "code": "SM0001",
                        "name": "无状态会员",
                        "memberTypeId": "yyy",
                        "effectiveDate": "2025-01-01",
                        "validityDays": 365
                      }
                    }
                  },
                  "failure": {
                    "code": "1504",
                    "message": "您绑定的会员码无效",
                    "data": null
                  },
                  "failureExpired": {
                    "code": "1501",
                    "message": "激活已超时，请重新绑定激活",
                    "data": null
                  }
                }
              }
            }
          }
        },
        "tags": [
          "OpenAPI 接口"
        ]
      }
    },
    "/openapi/stateless-members/check": {
      "post": {
        "summary": "检查无状态会员有效性",
        "description": "检查无状态会员是否还有效，通过X-Member-Key header中的混合JWT解密得到密钥，校验会员状态、过期时间、系统支持等，返回剩余天数。",
        "parameters": [
          {
            "name": "X-Member-Key",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "会员密钥令牌，通过混合JWT加密"
          },
          {
            "name": "X-System-Code",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "系统编码，用于判断会员类型是否支持当前系统"
          },
          {
            "name": "X-Site",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "站点标识"
          }
        ],
        "responses": {
          "200": {
            "description": "成功响应",
            "content": {
              "application/json": {
                "example": {
                  "success": {
                    "code": "0000",
                    "message": "校验通过",
                    "data": {
                      "valid": true,
                      "remainingDays": 30,
                      "member": {
                        "id": "xxx",
                        "code": "SM0001",
                        "name": "无状态会员",
                        "memberTypeId": "yyy",
                        "effectiveDate": "2025-01-01",
                        "validityDays": 365
                      }
                    }
                  },
                  "failure": {
                    "code": "1506",
                    "message": "您绑定的会员无效",
                    "data": null
                  },
                  "failureExpired": {
                    "code": "1505",
                    "message": "传入的会员需要重新绑定",
                    "data": null
                  },
                  "failureMemberExpired": {
                    "code": "1507",
                    "message": "会员已过期",
                    "data": null
                  }
                }
              }
            }
          }
        },
        "tags": [
          "OpenAPI 接口"
        ]
      }
    },
    "/openapi/stateless-members/functionCheck": {
      "post": {
        "summary": "检查无状态会员功能有效性",
        "description": "在检查无状态会员有效性的基础上，额外通过X-Function header检查会员功能模块中是否有该功能。",
        "parameters": [
          {
            "name": "X-Member-Key",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "会员密钥令牌，通过混合JWT加密"
          },
          {
            "name": "X-System-Code",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "系统编码，用于判断会员类型是否支持当前系统"
          },
          {
            "name": "X-Function",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "功能代码，用于检查会员功能模块中是否有该功能"
          },
          {
            "name": "X-Site",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "站点标识"
          }
        ],
        "responses": {
          "200": {
            "description": "成功响应",
            "content": {
              "application/json": {
                "example": {
                  "success": {
                    "code": "0000",
                    "message": "校验通过",
                    "data": {
                      "valid": true,
                      "remainingDays": 30,
                      "member": {
                        "id": "xxx",
                        "code": "SM0001",
                        "name": "无状态会员",
                        "memberTypeId": "yyy",
                        "effectiveDate": "2025-01-01",
                        "validityDays": 365
                      },
                      "function": {
                        "code": "FUNC001",
                        "name": "功能名称",
                        "type": "Resource"
                      }
                    }
                  },
                  "failure": {
                    "code": "1508",
                    "message": "当前会员不支持当前功能",
                    "data": null
                  }
                }
              }
            }
          }
        },
        "tags": [
          "OpenAPI 接口"
        ]
      }
    },
    "/openapi/stateless-members/valid-check": {
      "post": {
        "summary": "无状态会员有效性校验（场景A）",
        "description": "场景A：仅校验无状态会员是否有效（未过期），不校验会员类型与系统的支持关系。适用于第三方只需确认会员是否开通且未到期的简单场景。",
        "parameters": [
          {
            "name": "X-Member-Key",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "会员密钥令牌（混合JWT加密，payload.data = secretKey）"
          },
          {
            "name": "X-Site",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "站点标识"
          },
          {
            "name": "X-System-Code",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "系统编码（用于路由到正确数据库，本接口不校验系统-会员类型兼容性）"
          }
        ],
        "responses": {
          "200": {
            "description": "成功响应",
            "content": {
              "application/json": {
                "example": {
                  "code": "0000",
                  "message": "成功"
                }
              }
            }
          }
        },
        "tags": [
          "OpenAPI 接口"
        ]
      }
    },
    "/openapi/stateless-members/limitCheck": {
      "post": {
        "summary": "无状态会员限额校验（场景D）",
        "description": "场景D：在场景C（功能模块校验）的基础上，进一步校验当前功能模块的使用量是否已达到配置的上限（limitValue）。适用于有次数或存储上限控制的业务场景。",
        "parameters": [
          {
            "name": "X-Member-Key",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "会员密钥令牌（混合JWT加密）"
          },
          {
            "name": "X-Site",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "站点标识"
          },
          {
            "name": "X-System-Code",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "系统编码"
          },
          {
            "name": "X-Function",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "功能模块代码（moduleCode），如 VIDEO_DOWNLOAD"
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "currentCount": {
                    "type": "number",
                    "description": "number｜必填，当前已使用次数/数量（由第三方系统维护），如 8"
                  }
                },
                "required": [
                  "currentCount"
                ]
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "成功响应",
            "content": {
              "application/json": {
                "example": {
                  "code": "0000",
                  "message": "成功"
                }
              }
            }
          }
        },
        "tags": [
          "OpenAPI 接口"
        ]
      }
    },
    "/openapi/users/list": {
      "get": {
        "summary": "用户管理 - 分页列表查询",
        "description": "分页查询用户管理状态有效的列表数据，支持多种可选查询条件用于筛选。必须提供有效的X-Site和X-System-Code header。",
        "parameters": [
          {
            "name": "X-Site",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "站点标识（必填）"
          },
          {
            "name": "X-System-Code",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "系统编码（必填）"
          },
          {
            "name": "pageNum",
            "in": "query",
            "required": false,
            "schema": {
              "type": "number"
            },
            "description": "页码，默认1"
          },
          {
            "name": "pageSize",
            "in": "query",
            "required": false,
            "schema": {
              "type": "number"
            },
            "description": "每页数量，默认10"
          },
          {
            "name": "name",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "description": "名称（模糊搜索）"
          },
          {
            "name": "code",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "description": "编码（模糊搜索）"
          }
        ],
        "responses": {
          "200": {
            "description": "成功响应",
            "content": {
              "application/json": {
                "example": {
                  "success": {
                    "code": "0000",
                    "message": "查询成功",
                    "data": {
                      "list": [
                        {
                          "id": 1,
                          "code": "USER0001",
                          "name": "张三",
                          "title": "系统管理员",
                          "phone": "13800138000",
                          "email": "zhangsan@example.com",
                          "phonePrefix": "+86",
                          "status": 1,
                          "roles": [
                            "ROLE0001"
                          ],
                          "createTime": "2025-01-01T10:00:00.000Z",
                          "updateTime": "2025-01-01T10:00:00.000Z"
                        }
                      ],
                      "total": 1,
                      "pageNum": 1,
                      "pageSize": 10
                    }
                  }
                }
              }
            }
          }
        },
        "tags": [
          "OpenAPI 接口"
        ]
      }
    },
    "/openapi/users/list/simple": {
      "get": {
        "summary": "用户管理 - 简单列表查询",
        "description": "无分页返回用户管理前100条状态有效数据的列表，支持多种可选查询条件用于筛选以及排序。必须提供有效的X-Site和X-System-Code header。",
        "parameters": [
          {
            "name": "X-Site",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "站点标识（必填）"
          },
          {
            "name": "X-System-Code",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "系统编码（必填）"
          },
          {
            "name": "name",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "description": "名称（模糊搜索）"
          },
          {
            "name": "code",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "description": "编码（模糊搜索）"
          },
          {
            "name": "sortBy",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "description": "排序字段，默认createTime"
          },
          {
            "name": "sortOrder",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "description": "排序方向：asc-升序，desc-降序，默认desc"
          }
        ],
        "responses": {
          "200": {
            "description": "成功响应",
            "content": {
              "application/json": {
                "example": {
                  "success": {
                    "code": "0000",
                    "message": "查询成功",
                    "data": {
                      "list": [
                        {
                          "id": 1,
                          "code": "USER0001",
                          "name": "张三",
                          "title": "系统管理员",
                          "phone": "13800138000",
                          "email": "zhangsan@example.com",
                          "phonePrefix": "+86",
                          "status": 1,
                          "roles": [
                            "ROLE0001"
                          ],
                          "createTime": "2025-01-01T10:00:00.000Z",
                          "updateTime": "2025-01-01T10:00:00.000Z"
                        }
                      ]
                    }
                  }
                }
              }
            }
          }
        },
        "tags": [
          "OpenAPI 接口"
        ]
      }
    },
    "/openapi/client-users/list": {
      "get": {
        "summary": "客户端用户管理 - 分页列表查询",
        "description": "分页查询客户端用户管理状态有效的列表数据，支持多种可选查询条件用于筛选。必须提供有效的X-Site和X-System-Code header。",
        "parameters": [
          {
            "name": "X-Site",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "站点标识（必填）"
          },
          {
            "name": "X-System-Code",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "系统编码（必填）"
          },
          {
            "name": "pageNum",
            "in": "query",
            "required": false,
            "schema": {
              "type": "number"
            },
            "description": "页码，默认1"
          },
          {
            "name": "pageSize",
            "in": "query",
            "required": false,
            "schema": {
              "type": "number"
            },
            "description": "每页数量，默认10"
          },
          {
            "name": "name",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "description": "名称（模糊搜索）"
          },
          {
            "name": "code",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "description": "编码（模糊搜索）"
          }
        ],
        "responses": {
          "200": {
            "description": "成功响应",
            "content": {
              "application/json": {
                "example": {
                  "success": {
                    "code": "0000",
                    "message": "查询成功",
                    "data": {
                      "list": [
                        {
                          "id": 1,
                          "code": "CU0001",
                          "name": "客户端用户",
                          "phone": "13900139000",
                          "email": "client@example.com",
                          "phonePrefix": "+86",
                          "status": 1,
                          "agreeTerms": true,
                          "createTime": "2025-01-01T10:00:00.000Z",
                          "updateTime": "2025-01-01T10:00:00.000Z"
                        }
                      ],
                      "total": 1,
                      "pageNum": 1,
                      "pageSize": 10
                    }
                  }
                }
              }
            }
          }
        },
        "tags": [
          "OpenAPI 接口"
        ]
      }
    },
    "/openapi/client-users/list/simple": {
      "get": {
        "summary": "客户端用户管理 - 简单列表查询",
        "description": "无分页返回客户端用户管理前100条状态有效数据的列表，支持多种可选查询条件用于筛选以及排序。必须提供有效的X-Site和X-System-Code header。",
        "parameters": [
          {
            "name": "X-Site",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "站点标识（必填）"
          },
          {
            "name": "X-System-Code",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "系统编码（必填）"
          },
          {
            "name": "name",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "description": "名称（模糊搜索）"
          },
          {
            "name": "code",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "description": "编码（模糊搜索）"
          },
          {
            "name": "sortBy",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "description": "排序字段，默认createTime"
          },
          {
            "name": "sortOrder",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "description": "排序方向：asc-升序，desc-降序，默认desc"
          }
        ],
        "responses": {
          "200": {
            "description": "成功响应",
            "content": {
              "application/json": {
                "example": {
                  "success": {
                    "code": "0000",
                    "message": "查询成功",
                    "data": {
                      "list": [
                        {
                          "id": 1,
                          "code": "CU0001",
                          "name": "客户端用户",
                          "phone": "13900139000",
                          "email": "client@example.com",
                          "phonePrefix": "+86",
                          "status": 1,
                          "agreeTerms": true,
                          "createTime": "2025-01-01T10:00:00.000Z",
                          "updateTime": "2025-01-01T10:00:00.000Z"
                        }
                      ]
                    }
                  }
                }
              }
            }
          }
        },
        "tags": [
          "OpenAPI 接口"
        ]
      }
    },
    "/openapi/organizations/list": {
      "get": {
        "summary": "组织管理 - 分页列表查询",
        "description": "分页查询组织管理状态有效的列表数据，支持多种可选查询条件用于筛选。必须提供有效的X-Site和X-System-Code header。",
        "parameters": [
          {
            "name": "X-Site",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "站点标识（必填）"
          },
          {
            "name": "X-System-Code",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "系统编码（必填）"
          },
          {
            "name": "pageNum",
            "in": "query",
            "required": false,
            "schema": {
              "type": "number"
            },
            "description": "页码，默认1"
          },
          {
            "name": "pageSize",
            "in": "query",
            "required": false,
            "schema": {
              "type": "number"
            },
            "description": "每页数量，默认10"
          },
          {
            "name": "name",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "description": "名称（模糊搜索）"
          },
          {
            "name": "code",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "description": "编码（模糊搜索）"
          }
        ],
        "responses": {
          "200": {
            "description": "成功响应",
            "content": {
              "application/json": {
                "example": {
                  "success": {
                    "code": "0000",
                    "message": "查询成功",
                    "data": {
                      "list": [
                        {
                          "id": 1,
                          "code": "ORG0001",
                          "name": "测试公司",
                          "title": "测试公司有限公司",
                          "description": "测试公司描述",
                          "status": 1,
                          "parentId": null,
                          "createTime": "2025-01-01T10:00:00.000Z",
                          "updateTime": "2025-01-01T10:00:00.000Z"
                        }
                      ],
                      "total": 1,
                      "pageNum": 1,
                      "pageSize": 10
                    }
                  }
                }
              }
            }
          }
        },
        "tags": [
          "OpenAPI 接口"
        ]
      }
    },
    "/openapi/organizations/list/simple": {
      "get": {
        "summary": "组织管理 - 简单列表查询",
        "description": "无分页返回组织管理前100条状态有效数据的列表，支持多种可选查询条件用于筛选以及排序。必须提供有效的X-Site和X-System-Code header。",
        "parameters": [
          {
            "name": "X-Site",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "站点标识（必填）"
          },
          {
            "name": "X-System-Code",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "系统编码（必填）"
          },
          {
            "name": "name",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "description": "名称（模糊搜索）"
          },
          {
            "name": "code",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "description": "编码（模糊搜索）"
          },
          {
            "name": "sortBy",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "description": "排序字段，默认createTime"
          },
          {
            "name": "sortOrder",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "description": "排序方向：asc-升序，desc-降序，默认desc"
          }
        ],
        "responses": {
          "200": {
            "description": "成功响应",
            "content": {
              "application/json": {
                "example": {
                  "success": {
                    "code": "0000",
                    "message": "查询成功",
                    "data": {
                      "list": [
                        {
                          "id": 1,
                          "code": "ORG0001",
                          "name": "测试公司",
                          "title": "测试公司有限公司",
                          "description": "测试公司描述",
                          "status": 1,
                          "parentId": null,
                          "createTime": "2025-01-01T10:00:00.000Z",
                          "updateTime": "2025-01-01T10:00:00.000Z"
                        }
                      ]
                    }
                  }
                }
              }
            }
          }
        },
        "tags": [
          "OpenAPI 接口"
        ]
      }
    },
    "/openapi/departments/list": {
      "get": {
        "summary": "部门管理 - 分页列表查询",
        "description": "分页查询部门管理状态有效的列表数据，支持多种可选查询条件用于筛选。必须提供有效的X-Site和X-System-Code header。",
        "parameters": [
          {
            "name": "X-Site",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "站点标识（必填）"
          },
          {
            "name": "X-System-Code",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "系统编码（必填）"
          },
          {
            "name": "pageNum",
            "in": "query",
            "required": false,
            "schema": {
              "type": "number"
            },
            "description": "页码，默认1"
          },
          {
            "name": "pageSize",
            "in": "query",
            "required": false,
            "schema": {
              "type": "number"
            },
            "description": "每页数量，默认10"
          },
          {
            "name": "name",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "description": "名称（模糊搜索）"
          },
          {
            "name": "code",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "description": "编码（模糊搜索）"
          }
        ],
        "responses": {
          "200": {
            "description": "成功响应",
            "content": {
              "application/json": {
                "example": {
                  "success": {
                    "code": "0000",
                    "message": "查询成功",
                    "data": {
                      "list": [
                        {
                          "id": 1,
                          "code": "DEPT0001",
                          "name": "技术部",
                          "title": "技术开发部",
                          "description": "技术开发部门",
                          "status": 1,
                          "organizationId": "ORG0001",
                          "parentId": null,
                          "createTime": "2025-01-01T10:00:00.000Z",
                          "updateTime": "2025-01-01T10:00:00.000Z"
                        }
                      ],
                      "total": 1,
                      "pageNum": 1,
                      "pageSize": 10
                    }
                  }
                }
              }
            }
          }
        },
        "tags": [
          "OpenAPI 接口"
        ]
      }
    },
    "/openapi/departments/list/simple": {
      "get": {
        "summary": "部门管理 - 简单列表查询",
        "description": "无分页返回部门管理前100条状态有效数据的列表，支持多种可选查询条件用于筛选以及排序。必须提供有效的X-Site和X-System-Code header。",
        "parameters": [
          {
            "name": "X-Site",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "站点标识（必填）"
          },
          {
            "name": "X-System-Code",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "系统编码（必填）"
          },
          {
            "name": "name",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "description": "名称（模糊搜索）"
          },
          {
            "name": "code",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "description": "编码（模糊搜索）"
          },
          {
            "name": "sortBy",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "description": "排序字段，默认createTime"
          },
          {
            "name": "sortOrder",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "description": "排序方向：asc-升序，desc-降序，默认desc"
          }
        ],
        "responses": {
          "200": {
            "description": "成功响应",
            "content": {
              "application/json": {
                "example": {
                  "success": {
                    "code": "0000",
                    "message": "查询成功",
                    "data": {
                      "list": [
                        {
                          "id": 1,
                          "code": "DEPT0001",
                          "name": "技术部",
                          "title": "技术开发部",
                          "description": "技术开发部门",
                          "status": 1,
                          "organizationId": "ORG0001",
                          "parentId": null,
                          "createTime": "2025-01-01T10:00:00.000Z",
                          "updateTime": "2025-01-01T10:00:00.000Z"
                        }
                      ]
                    }
                  }
                }
              }
            }
          }
        },
        "tags": [
          "OpenAPI 接口"
        ]
      }
    },
    "/openapi/positions/list": {
      "get": {
        "summary": "岗位管理 - 分页列表查询",
        "description": "分页查询岗位管理状态有效的列表数据，支持多种可选查询条件用于筛选。必须提供有效的X-Site和X-System-Code header。",
        "parameters": [
          {
            "name": "X-Site",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "站点标识（必填）"
          },
          {
            "name": "X-System-Code",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "系统编码（必填）"
          },
          {
            "name": "pageNum",
            "in": "query",
            "required": false,
            "schema": {
              "type": "number"
            },
            "description": "页码，默认1"
          },
          {
            "name": "pageSize",
            "in": "query",
            "required": false,
            "schema": {
              "type": "number"
            },
            "description": "每页数量，默认10"
          },
          {
            "name": "name",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "description": "名称（模糊搜索）"
          },
          {
            "name": "code",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "description": "编码（模糊搜索）"
          }
        ],
        "responses": {
          "200": {
            "description": "成功响应",
            "content": {
              "application/json": {
                "example": {
                  "success": {
                    "code": "0000",
                    "message": "查询成功",
                    "data": {
                      "list": [
                        {
                          "id": 1,
                          "code": "POS0001",
                          "name": "高级工程师",
                          "title": "高级开发工程师",
                          "description": "高级开发工程师岗位",
                          "status": 1,
                          "orderNum": 1,
                          "createTime": "2025-01-01T10:00:00.000Z",
                          "updateTime": "2025-01-01T10:00:00.000Z"
                        }
                      ],
                      "total": 1,
                      "pageNum": 1,
                      "pageSize": 10
                    }
                  }
                }
              }
            }
          }
        },
        "tags": [
          "OpenAPI 接口"
        ]
      }
    },
    "/openapi/positions/list/simple": {
      "get": {
        "summary": "岗位管理 - 简单列表查询",
        "description": "无分页返回岗位管理前100条状态有效数据的列表，支持多种可选查询条件用于筛选以及排序。必须提供有效的X-Site和X-System-Code header。",
        "parameters": [
          {
            "name": "X-Site",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "站点标识（必填）"
          },
          {
            "name": "X-System-Code",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "系统编码（必填）"
          },
          {
            "name": "name",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "description": "名称（模糊搜索）"
          },
          {
            "name": "code",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "description": "编码（模糊搜索）"
          },
          {
            "name": "sortBy",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "description": "排序字段，默认createTime"
          },
          {
            "name": "sortOrder",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "description": "排序方向：asc-升序，desc-降序，默认desc"
          }
        ],
        "responses": {
          "200": {
            "description": "成功响应",
            "content": {
              "application/json": {
                "example": {
                  "success": {
                    "code": "0000",
                    "message": "查询成功",
                    "data": {
                      "list": [
                        {
                          "id": 1,
                          "code": "POS0001",
                          "name": "高级工程师",
                          "title": "高级开发工程师",
                          "description": "高级开发工程师岗位",
                          "status": 1,
                          "orderNum": 1,
                          "createTime": "2025-01-01T10:00:00.000Z",
                          "updateTime": "2025-01-01T10:00:00.000Z"
                        }
                      ]
                    }
                  }
                }
              }
            }
          }
        },
        "tags": [
          "OpenAPI 接口"
        ]
      }
    },
    "/openapi/staff/list": {
      "get": {
        "summary": "职员管理 - 分页列表查询",
        "description": "分页查询职员管理状态有效的列表数据，支持多种可选查询条件用于筛选。必须提供有效的X-Site和X-System-Code header。",
        "parameters": [
          {
            "name": "X-Site",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "站点标识（必填）"
          },
          {
            "name": "X-System-Code",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "系统编码（必填）"
          },
          {
            "name": "pageNum",
            "in": "query",
            "required": false,
            "schema": {
              "type": "number"
            },
            "description": "页码，默认1"
          },
          {
            "name": "pageSize",
            "in": "query",
            "required": false,
            "schema": {
              "type": "number"
            },
            "description": "每页数量，默认10"
          },
          {
            "name": "name",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "description": "名称（模糊搜索）"
          },
          {
            "name": "code",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "description": "编码（模糊搜索）"
          }
        ],
        "responses": {
          "200": {
            "description": "成功响应",
            "content": {
              "application/json": {
                "example": {
                  "success": {
                    "code": "0000",
                    "message": "查询成功",
                    "data": {
                      "list": [
                        {
                          "id": 1,
                          "code": "STAFF0001",
                          "name": "李四",
                          "title": "技术部员工",
                          "phone": "13700137000",
                          "email": "lisi@example.com",
                          "status": 1,
                          "departmentId": "DEPT0001",
                          "positionId": "POS0001",
                          "createTime": "2025-01-01T10:00:00.000Z",
                          "updateTime": "2025-01-01T10:00:00.000Z"
                        }
                      ],
                      "total": 1,
                      "pageNum": 1,
                      "pageSize": 10
                    }
                  }
                }
              }
            }
          }
        },
        "tags": [
          "OpenAPI 接口"
        ]
      }
    },
    "/openapi/staff/list/simple": {
      "get": {
        "summary": "职员管理 - 简单列表查询",
        "description": "无分页返回职员管理前100条状态有效数据的列表，支持多种可选查询条件用于筛选以及排序。必须提供有效的X-Site和X-System-Code header。",
        "parameters": [
          {
            "name": "X-Site",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "站点标识（必填）"
          },
          {
            "name": "X-System-Code",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "系统编码（必填）"
          },
          {
            "name": "name",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "description": "名称（模糊搜索）"
          },
          {
            "name": "code",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "description": "编码（模糊搜索）"
          },
          {
            "name": "sortBy",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "description": "排序字段，默认createTime"
          },
          {
            "name": "sortOrder",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "description": "排序方向：asc-升序，desc-降序，默认desc"
          }
        ],
        "responses": {
          "200": {
            "description": "成功响应",
            "content": {
              "application/json": {
                "example": {
                  "success": {
                    "code": "0000",
                    "message": "查询成功",
                    "data": {
                      "list": [
                        {
                          "id": 1,
                          "code": "STAFF0001",
                          "name": "李四",
                          "title": "技术部员工",
                          "phone": "13700137000",
                          "email": "lisi@example.com",
                          "status": 1,
                          "departmentId": "DEPT0001",
                          "positionId": "POS0001",
                          "createTime": "2025-01-01T10:00:00.000Z",
                          "updateTime": "2025-01-01T10:00:00.000Z"
                        }
                      ]
                    }
                  }
                }
              }
            }
          }
        },
        "tags": [
          "OpenAPI 接口"
        ]
      }
    },
    "/openapi/roles/list": {
      "get": {
        "summary": "角色管理 - 分页列表查询",
        "description": "分页查询角色管理状态有效的列表数据，支持多种可选查询条件用于筛选。必须提供有效的X-Site和X-System-Code header。",
        "parameters": [
          {
            "name": "X-Site",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "站点标识（必填）"
          },
          {
            "name": "X-System-Code",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "系统编码（必填）"
          },
          {
            "name": "pageNum",
            "in": "query",
            "required": false,
            "schema": {
              "type": "number"
            },
            "description": "页码，默认1"
          },
          {
            "name": "pageSize",
            "in": "query",
            "required": false,
            "schema": {
              "type": "number"
            },
            "description": "每页数量，默认10"
          },
          {
            "name": "name",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "description": "名称（模糊搜索）"
          },
          {
            "name": "code",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "description": "编码（模糊搜索）"
          }
        ],
        "responses": {
          "200": {
            "description": "成功响应",
            "content": {
              "application/json": {
                "example": {
                  "success": {
                    "code": "0000",
                    "message": "查询成功",
                    "data": {
                      "list": [
                        {
                          "id": 1,
                          "code": "ROLE0001",
                          "name": "管理员",
                          "title": "系统管理员",
                          "type": "system",
                          "description": "系统管理员角色",
                          "status": 1,
                          "orderNum": 1,
                          "permissions": [
                            "PERM0001"
                          ],
                          "resources": [
                            "RES0001"
                          ],
                          "createTime": "2025-01-01T10:00:00.000Z",
                          "updateTime": "2025-01-01T10:00:00.000Z"
                        }
                      ],
                      "total": 1,
                      "pageNum": 1,
                      "pageSize": 10
                    }
                  }
                }
              }
            }
          }
        },
        "tags": [
          "OpenAPI 接口"
        ]
      }
    },
    "/openapi/roles/list/simple": {
      "get": {
        "summary": "角色管理 - 简单列表查询",
        "description": "无分页返回角色管理前100条状态有效数据的列表，支持多种可选查询条件用于筛选以及排序。必须提供有效的X-Site和X-System-Code header。",
        "parameters": [
          {
            "name": "X-Site",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "站点标识（必填）"
          },
          {
            "name": "X-System-Code",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "系统编码（必填）"
          },
          {
            "name": "name",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "description": "名称（模糊搜索）"
          },
          {
            "name": "code",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "description": "编码（模糊搜索）"
          },
          {
            "name": "sortBy",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "description": "排序字段，默认createTime"
          },
          {
            "name": "sortOrder",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "description": "排序方向：asc-升序，desc-降序，默认desc"
          }
        ],
        "responses": {
          "200": {
            "description": "成功响应",
            "content": {
              "application/json": {
                "example": {
                  "success": {
                    "code": "0000",
                    "message": "查询成功",
                    "data": {
                      "list": [
                        {
                          "id": 1,
                          "code": "ROLE0001",
                          "name": "管理员",
                          "title": "系统管理员",
                          "type": "system",
                          "description": "系统管理员角色",
                          "status": 1,
                          "orderNum": 1,
                          "permissions": [
                            "PERM0001"
                          ],
                          "resources": [
                            "RES0001"
                          ],
                          "createTime": "2025-01-01T10:00:00.000Z",
                          "updateTime": "2025-01-01T10:00:00.000Z"
                        }
                      ]
                    }
                  }
                }
              }
            }
          }
        },
        "tags": [
          "OpenAPI 接口"
        ]
      }
    },
    "/openapi/resources/list": {
      "get": {
        "summary": "资源管理 - 分页列表查询",
        "description": "分页查询资源管理状态有效的列表数据，支持多种可选查询条件用于筛选。必须提供有效的X-Site和X-System-Code header。",
        "parameters": [
          {
            "name": "X-Site",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "站点标识（必填）"
          },
          {
            "name": "X-System-Code",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "系统编码（必填）"
          },
          {
            "name": "pageNum",
            "in": "query",
            "required": false,
            "schema": {
              "type": "number"
            },
            "description": "页码，默认1"
          },
          {
            "name": "pageSize",
            "in": "query",
            "required": false,
            "schema": {
              "type": "number"
            },
            "description": "每页数量，默认10"
          },
          {
            "name": "name",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "description": "名称（模糊搜索）"
          },
          {
            "name": "code",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "description": "编码（模糊搜索）"
          }
        ],
        "responses": {
          "200": {
            "description": "成功响应",
            "content": {
              "application/json": {
                "example": {
                  "success": {
                    "code": "0000",
                    "message": "查询成功",
                    "data": {
                      "list": [
                        {
                          "id": 1,
                          "code": "RES0001",
                          "name": "用户管理",
                          "title": "用户管理模块",
                          "type": "page",
                          "description": "用户管理页面资源",
                          "status": 1,
                          "url": "/users",
                          "icon": "user",
                          "orderNum": 1,
                          "createTime": "2025-01-01T10:00:00.000Z",
                          "updateTime": "2025-01-01T10:00:00.000Z"
                        }
                      ],
                      "total": 1,
                      "pageNum": 1,
                      "pageSize": 10
                    }
                  }
                }
              }
            }
          }
        },
        "tags": [
          "OpenAPI 接口"
        ]
      }
    },
    "/openapi/resources/list/simple": {
      "get": {
        "summary": "资源管理 - 简单列表查询",
        "description": "无分页返回资源管理前100条状态有效数据的列表，支持多种可选查询条件用于筛选以及排序。必须提供有效的X-Site和X-System-Code header。",
        "parameters": [
          {
            "name": "X-Site",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "站点标识（必填）"
          },
          {
            "name": "X-System-Code",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "系统编码（必填）"
          },
          {
            "name": "name",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "description": "名称（模糊搜索）"
          },
          {
            "name": "code",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "description": "编码（模糊搜索）"
          },
          {
            "name": "sortBy",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "description": "排序字段，默认createTime"
          },
          {
            "name": "sortOrder",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "description": "排序方向：asc-升序，desc-降序，默认desc"
          }
        ],
        "responses": {
          "200": {
            "description": "成功响应",
            "content": {
              "application/json": {
                "example": {
                  "success": {
                    "code": "0000",
                    "message": "查询成功",
                    "data": {
                      "list": [
                        {
                          "id": 1,
                          "code": "RES0001",
                          "name": "用户管理",
                          "title": "用户管理模块",
                          "type": "page",
                          "description": "用户管理页面资源",
                          "status": 1,
                          "url": "/users",
                          "icon": "user",
                          "orderNum": 1,
                          "createTime": "2025-01-01T10:00:00.000Z",
                          "updateTime": "2025-01-01T10:00:00.000Z"
                        }
                      ]
                    }
                  }
                }
              }
            }
          }
        },
        "tags": [
          "OpenAPI 接口"
        ]
      }
    },
    "/openapi/permissions/list": {
      "get": {
        "summary": "权限管理 - 分页列表查询",
        "description": "分页查询权限管理状态有效的列表数据，支持多种可选查询条件用于筛选。必须提供有效的X-Site和X-System-Code header。",
        "parameters": [
          {
            "name": "X-Site",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "站点标识（必填）"
          },
          {
            "name": "X-System-Code",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "系统编码（必填）"
          },
          {
            "name": "pageNum",
            "in": "query",
            "required": false,
            "schema": {
              "type": "number"
            },
            "description": "页码，默认1"
          },
          {
            "name": "pageSize",
            "in": "query",
            "required": false,
            "schema": {
              "type": "number"
            },
            "description": "每页数量，默认10"
          },
          {
            "name": "name",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "description": "名称（模糊搜索）"
          },
          {
            "name": "code",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "description": "编码（模糊搜索）"
          }
        ],
        "responses": {
          "200": {
            "description": "成功响应",
            "content": {
              "application/json": {
                "example": {
                  "success": {
                    "code": "0000",
                    "message": "查询成功",
                    "data": {
                      "list": [
                        {
                          "id": 1,
                          "code": "PERM0001",
                          "name": "用户查看",
                          "title": "用户查看权限",
                          "type": "global",
                          "description": "用户查看权限",
                          "status": 1,
                          "orderNum": 1,
                          "createTime": "2025-01-01T10:00:00.000Z",
                          "updateTime": "2025-01-01T10:00:00.000Z"
                        }
                      ],
                      "total": 1,
                      "pageNum": 1,
                      "pageSize": 10
                    }
                  }
                }
              }
            }
          }
        },
        "tags": [
          "OpenAPI 接口"
        ]
      }
    },
    "/openapi/permissions/list/simple": {
      "get": {
        "summary": "权限管理 - 简单列表查询",
        "description": "无分页返回权限管理前100条状态有效数据的列表，支持多种可选查询条件用于筛选以及排序。必须提供有效的X-Site和X-System-Code header。",
        "parameters": [
          {
            "name": "X-Site",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "站点标识（必填）"
          },
          {
            "name": "X-System-Code",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "系统编码（必填）"
          },
          {
            "name": "name",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "description": "名称（模糊搜索）"
          },
          {
            "name": "code",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "description": "编码（模糊搜索）"
          },
          {
            "name": "sortBy",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "description": "排序字段，默认createTime"
          },
          {
            "name": "sortOrder",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "description": "排序方向：asc-升序，desc-降序，默认desc"
          }
        ],
        "responses": {
          "200": {
            "description": "成功响应",
            "content": {
              "application/json": {
                "example": {
                  "success": {
                    "code": "0000",
                    "message": "查询成功",
                    "data": {
                      "list": [
                        {
                          "id": 1,
                          "code": "PERM0001",
                          "name": "用户查看",
                          "title": "用户查看权限",
                          "type": "global",
                          "description": "用户查看权限",
                          "status": 1,
                          "orderNum": 1,
                          "createTime": "2025-01-01T10:00:00.000Z",
                          "updateTime": "2025-01-01T10:00:00.000Z"
                        }
                      ]
                    }
                  }
                }
              }
            }
          }
        },
        "tags": [
          "OpenAPI 接口"
        ]
      }
    },
    "/openapi/customers/list": {
      "get": {
        "summary": "客户管理 - 分页列表查询",
        "description": "分页查询客户管理状态有效的列表数据，支持多种可选查询条件用于筛选。必须提供有效的X-Site和X-System-Code header。",
        "parameters": [
          {
            "name": "X-Site",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "站点标识（必填）"
          },
          {
            "name": "X-System-Code",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "系统编码（必填）"
          },
          {
            "name": "pageNum",
            "in": "query",
            "required": false,
            "schema": {
              "type": "number"
            },
            "description": "页码，默认1"
          },
          {
            "name": "pageSize",
            "in": "query",
            "required": false,
            "schema": {
              "type": "number"
            },
            "description": "每页数量，默认10"
          },
          {
            "name": "name",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "description": "名称（模糊搜索）"
          },
          {
            "name": "code",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "description": "编码（模糊搜索）"
          }
        ],
        "responses": {
          "200": {
            "description": "成功响应",
            "content": {
              "application/json": {
                "example": {
                  "success": {
                    "code": "0000",
                    "message": "查询成功",
                    "data": {
                      "list": [
                        {
                          "id": 1,
                          "code": "CUST0001",
                          "name": "客户A",
                          "title": "客户A公司",
                          "phone": "13600136000",
                          "email": "customer@example.com",
                          "address": "北京市朝阳区",
                          "status": 1,
                          "createTime": "2025-01-01T10:00:00.000Z",
                          "updateTime": "2025-01-01T10:00:00.000Z"
                        }
                      ],
                      "total": 1,
                      "pageNum": 1,
                      "pageSize": 10
                    }
                  }
                }
              }
            }
          }
        },
        "tags": [
          "OpenAPI 接口"
        ]
      }
    },
    "/openapi/customers/list/simple": {
      "get": {
        "summary": "客户管理 - 简单列表查询",
        "description": "无分页返回客户管理前100条状态有效数据的列表，支持多种可选查询条件用于筛选以及排序。必须提供有效的X-Site和X-System-Code header。",
        "parameters": [
          {
            "name": "X-Site",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "站点标识（必填）"
          },
          {
            "name": "X-System-Code",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "系统编码（必填）"
          },
          {
            "name": "name",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "description": "名称（模糊搜索）"
          },
          {
            "name": "code",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "description": "编码（模糊搜索）"
          },
          {
            "name": "sortBy",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "description": "排序字段，默认createTime"
          },
          {
            "name": "sortOrder",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "description": "排序方向：asc-升序，desc-降序，默认desc"
          }
        ],
        "responses": {
          "200": {
            "description": "成功响应",
            "content": {
              "application/json": {
                "example": {
                  "success": {
                    "code": "0000",
                    "message": "查询成功",
                    "data": {
                      "list": [
                        {
                          "id": 1,
                          "code": "CUST0001",
                          "name": "客户A",
                          "title": "客户A公司",
                          "phone": "13600136000",
                          "email": "customer@example.com",
                          "address": "北京市朝阳区",
                          "status": 1,
                          "createTime": "2025-01-01T10:00:00.000Z",
                          "updateTime": "2025-01-01T10:00:00.000Z"
                        }
                      ]
                    }
                  }
                }
              }
            }
          }
        },
        "tags": [
          "OpenAPI 接口"
        ]
      }
    },
    "/openapi/orders/list": {
      "get": {
        "summary": "订单管理 - 分页列表查询",
        "description": "分页查询订单管理状态有效的列表数据，支持多种可选查询条件用于筛选。必须提供有效的X-Site和X-System-Code header。",
        "parameters": [
          {
            "name": "X-Site",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "站点标识（必填）"
          },
          {
            "name": "X-System-Code",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "系统编码（必填）"
          },
          {
            "name": "pageNum",
            "in": "query",
            "required": false,
            "schema": {
              "type": "number"
            },
            "description": "页码，默认1"
          },
          {
            "name": "pageSize",
            "in": "query",
            "required": false,
            "schema": {
              "type": "number"
            },
            "description": "每页数量，默认10"
          },
          {
            "name": "name",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "description": "名称（模糊搜索）"
          },
          {
            "name": "code",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "description": "编码（模糊搜索）"
          }
        ],
        "responses": {
          "200": {
            "description": "成功响应",
            "content": {
              "application/json": {
                "example": {
                  "success": {
                    "code": "0000",
                    "message": "查询成功",
                    "data": {
                      "list": [
                        {
                          "id": 1,
                          "code": "ORDER0001",
                          "orderNo": "ORD20250101001",
                          "orderType": "MEMBER",
                          "orderName": "会员订单",
                          "orderDetail": "会员开通订单",
                          "orderPhone": "13800138000",
                          "amount": 99,
                          "status": "PAID",
                          "createTime": "2025-01-01T10:00:00.000Z",
                          "updateTime": "2025-01-01T10:00:00.000Z"
                        }
                      ],
                      "total": 1,
                      "pageNum": 1,
                      "pageSize": 10
                    }
                  }
                }
              }
            }
          }
        },
        "tags": [
          "OpenAPI 接口"
        ]
      }
    },
    "/openapi/orders/list/simple": {
      "get": {
        "summary": "订单管理 - 简单列表查询",
        "description": "无分页返回订单管理前100条状态有效数据的列表，支持多种可选查询条件用于筛选以及排序。必须提供有效的X-Site和X-System-Code header。",
        "parameters": [
          {
            "name": "X-Site",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "站点标识（必填）"
          },
          {
            "name": "X-System-Code",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "系统编码（必填）"
          },
          {
            "name": "name",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "description": "名称（模糊搜索）"
          },
          {
            "name": "code",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "description": "编码（模糊搜索）"
          },
          {
            "name": "sortBy",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "description": "排序字段，默认createTime"
          },
          {
            "name": "sortOrder",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "description": "排序方向：asc-升序，desc-降序，默认desc"
          }
        ],
        "responses": {
          "200": {
            "description": "成功响应",
            "content": {
              "application/json": {
                "example": {
                  "success": {
                    "code": "0000",
                    "message": "查询成功",
                    "data": {
                      "list": [
                        {
                          "id": 1,
                          "code": "ORDER0001",
                          "orderNo": "ORD20250101001",
                          "orderType": "MEMBER",
                          "orderName": "会员订单",
                          "orderDetail": "会员开通订单",
                          "orderPhone": "13800138000",
                          "amount": 99,
                          "status": "PAID",
                          "createTime": "2025-01-01T10:00:00.000Z",
                          "updateTime": "2025-01-01T10:00:00.000Z"
                        }
                      ]
                    }
                  }
                }
              }
            }
          }
        },
        "tags": [
          "OpenAPI 接口"
        ]
      }
    },
    "/openapi/members/list": {
      "get": {
        "summary": "会员管理 - 分页列表查询",
        "description": "分页查询会员管理状态有效的列表数据，支持多种可选查询条件用于筛选。必须提供有效的X-Site和X-System-Code header。",
        "parameters": [
          {
            "name": "X-Site",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "站点标识（必填）"
          },
          {
            "name": "X-System-Code",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "系统编码（必填）"
          },
          {
            "name": "pageNum",
            "in": "query",
            "required": false,
            "schema": {
              "type": "number"
            },
            "description": "页码，默认1"
          },
          {
            "name": "pageSize",
            "in": "query",
            "required": false,
            "schema": {
              "type": "number"
            },
            "description": "每页数量，默认10"
          },
          {
            "name": "name",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "description": "名称（模糊搜索）"
          },
          {
            "name": "code",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "description": "编码（模糊搜索）"
          }
        ],
        "responses": {
          "200": {
            "description": "成功响应",
            "content": {
              "application/json": {
                "example": {
                  "success": {
                    "code": "0000",
                    "message": "查询成功",
                    "data": {
                      "list": [
                        {
                          "id": 1,
                          "code": "MEMBER0001",
                          "name": "会员A",
                          "description": "会员描述",
                          "status": 1,
                          "memberTypeId": "MT0001",
                          "price": "99.00",
                          "validityDays": 365,
                          "createTime": "2025-01-01T10:00:00.000Z",
                          "updateTime": "2025-01-01T10:00:00.000Z"
                        }
                      ],
                      "total": 1,
                      "pageNum": 1,
                      "pageSize": 10
                    }
                  }
                }
              }
            }
          }
        },
        "tags": [
          "OpenAPI 接口"
        ]
      }
    },
    "/openapi/members/list/simple": {
      "get": {
        "summary": "会员管理 - 简单列表查询",
        "description": "无分页返回会员管理前100条状态有效数据的列表，支持多种可选查询条件用于筛选以及排序。必须提供有效的X-Site和X-System-Code header。",
        "parameters": [
          {
            "name": "X-Site",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "站点标识（必填）"
          },
          {
            "name": "X-System-Code",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "系统编码（必填）"
          },
          {
            "name": "name",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "description": "名称（模糊搜索）"
          },
          {
            "name": "code",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "description": "编码（模糊搜索）"
          },
          {
            "name": "sortBy",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "description": "排序字段，默认createTime"
          },
          {
            "name": "sortOrder",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "description": "排序方向：asc-升序，desc-降序，默认desc"
          }
        ],
        "responses": {
          "200": {
            "description": "成功响应",
            "content": {
              "application/json": {
                "example": {
                  "success": {
                    "code": "0000",
                    "message": "查询成功",
                    "data": {
                      "list": [
                        {
                          "id": 1,
                          "code": "MEMBER0001",
                          "name": "会员A",
                          "description": "会员描述",
                          "status": 1,
                          "memberTypeId": "MT0001",
                          "price": "99.00",
                          "validityDays": 365,
                          "createTime": "2025-01-01T10:00:00.000Z",
                          "updateTime": "2025-01-01T10:00:00.000Z"
                        }
                      ]
                    }
                  }
                }
              }
            }
          }
        },
        "tags": [
          "OpenAPI 接口"
        ]
      }
    },
    "/openapi/stateless-members/list": {
      "get": {
        "summary": "无状态会员管理 - 分页列表查询",
        "description": "分页查询无状态会员管理状态有效的列表数据，支持多种可选查询条件用于筛选。必须提供有效的X-Site和X-System-Code header。",
        "parameters": [
          {
            "name": "X-Site",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "站点标识（必填）"
          },
          {
            "name": "X-System-Code",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "系统编码（必填）"
          },
          {
            "name": "pageNum",
            "in": "query",
            "required": false,
            "schema": {
              "type": "number"
            },
            "description": "页码，默认1"
          },
          {
            "name": "pageSize",
            "in": "query",
            "required": false,
            "schema": {
              "type": "number"
            },
            "description": "每页数量，默认10"
          },
          {
            "name": "name",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "description": "名称（模糊搜索）"
          },
          {
            "name": "code",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "description": "编码（模糊搜索）"
          }
        ],
        "responses": {
          "200": {
            "description": "成功响应",
            "content": {
              "application/json": {
                "example": {
                  "success": {
                    "code": "0000",
                    "message": "查询成功",
                    "data": {
                      "list": [
                        {
                          "id": 1,
                          "code": "SM0001",
                          "name": "无状态会员",
                          "description": "无状态会员描述",
                          "status": 1,
                          "memberTypeId": "MT0001",
                          "validityDays": 365,
                          "effectiveDate": "2025-01-01",
                          "createTime": "2025-01-01T10:00:00.000Z",
                          "updateTime": "2025-01-01T10:00:00.000Z"
                        }
                      ],
                      "total": 1,
                      "pageNum": 1,
                      "pageSize": 10
                    }
                  }
                }
              }
            }
          }
        },
        "tags": [
          "OpenAPI 接口"
        ]
      }
    },
    "/openapi/stateless-members/list/simple": {
      "get": {
        "summary": "无状态会员管理 - 简单列表查询",
        "description": "无分页返回无状态会员管理前100条状态有效数据的列表，支持多种可选查询条件用于筛选以及排序。必须提供有效的X-Site和X-System-Code header。",
        "parameters": [
          {
            "name": "X-Site",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "站点标识（必填）"
          },
          {
            "name": "X-System-Code",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "系统编码（必填）"
          },
          {
            "name": "name",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "description": "名称（模糊搜索）"
          },
          {
            "name": "code",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "description": "编码（模糊搜索）"
          },
          {
            "name": "sortBy",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "description": "排序字段，默认createTime"
          },
          {
            "name": "sortOrder",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "description": "排序方向：asc-升序，desc-降序，默认desc"
          }
        ],
        "responses": {
          "200": {
            "description": "成功响应",
            "content": {
              "application/json": {
                "example": {
                  "success": {
                    "code": "0000",
                    "message": "查询成功",
                    "data": {
                      "list": [
                        {
                          "id": 1,
                          "code": "SM0001",
                          "name": "无状态会员",
                          "description": "无状态会员描述",
                          "status": 1,
                          "memberTypeId": "MT0001",
                          "validityDays": 365,
                          "effectiveDate": "2025-01-01",
                          "createTime": "2025-01-01T10:00:00.000Z",
                          "updateTime": "2025-01-01T10:00:00.000Z"
                        }
                      ]
                    }
                  }
                }
              }
            }
          }
        },
        "tags": [
          "OpenAPI 接口"
        ]
      }
    },
    "/openapi/member-users/list": {
      "get": {
        "summary": "会员用户管理 - 分页列表查询",
        "description": "分页查询会员用户管理状态有效的列表数据，支持多种可选查询条件用于筛选。必须提供有效的X-Site和X-System-Code header。",
        "parameters": [
          {
            "name": "X-Site",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "站点标识（必填）"
          },
          {
            "name": "X-System-Code",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "系统编码（必填）"
          },
          {
            "name": "pageNum",
            "in": "query",
            "required": false,
            "schema": {
              "type": "number"
            },
            "description": "页码，默认1"
          },
          {
            "name": "pageSize",
            "in": "query",
            "required": false,
            "schema": {
              "type": "number"
            },
            "description": "每页数量，默认10"
          },
          {
            "name": "name",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "description": "名称（模糊搜索）"
          },
          {
            "name": "code",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "description": "编码（模糊搜索）"
          }
        ],
        "responses": {
          "200": {
            "description": "成功响应",
            "content": {
              "application/json": {
                "example": {
                  "success": {
                    "code": "0000",
                    "message": "查询成功",
                    "data": {
                      "list": [
                        {
                          "id": 1,
                          "code": "MU0001",
                          "memberId": "MEMBER0001",
                          "userId": "USER0001",
                          "status": 1,
                          "createTime": "2025-01-01T10:00:00.000Z",
                          "updateTime": "2025-01-01T10:00:00.000Z"
                        }
                      ],
                      "total": 1,
                      "pageNum": 1,
                      "pageSize": 10
                    }
                  }
                }
              }
            }
          }
        },
        "tags": [
          "OpenAPI 接口"
        ]
      }
    },
    "/openapi/member-users/list/simple": {
      "get": {
        "summary": "会员用户管理 - 简单列表查询",
        "description": "无分页返回会员用户管理前100条状态有效数据的列表，支持多种可选查询条件用于筛选以及排序。必须提供有效的X-Site和X-System-Code header。",
        "parameters": [
          {
            "name": "X-Site",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "站点标识（必填）"
          },
          {
            "name": "X-System-Code",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "系统编码（必填）"
          },
          {
            "name": "name",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "description": "名称（模糊搜索）"
          },
          {
            "name": "code",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "description": "编码（模糊搜索）"
          },
          {
            "name": "sortBy",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "description": "排序字段，默认createTime"
          },
          {
            "name": "sortOrder",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "description": "排序方向：asc-升序，desc-降序，默认desc"
          }
        ],
        "responses": {
          "200": {
            "description": "成功响应",
            "content": {
              "application/json": {
                "example": {
                  "success": {
                    "code": "0000",
                    "message": "查询成功",
                    "data": {
                      "list": [
                        {
                          "id": 1,
                          "code": "MU0001",
                          "memberId": "MEMBER0001",
                          "userId": "USER0001",
                          "status": 1,
                          "createTime": "2025-01-01T10:00:00.000Z",
                          "updateTime": "2025-01-01T10:00:00.000Z"
                        }
                      ]
                    }
                  }
                }
              }
            }
          }
        },
        "tags": [
          "OpenAPI 接口"
        ]
      }
    },
    "/openapi/member-functions/list": {
      "get": {
        "summary": "会员功能管理 - 分页列表查询",
        "description": "分页查询会员功能管理状态有效的列表数据，支持多种可选查询条件用于筛选。必须提供有效的X-Site和X-System-Code header。",
        "parameters": [
          {
            "name": "X-Site",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "站点标识（必填）"
          },
          {
            "name": "X-System-Code",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "系统编码（必填）"
          },
          {
            "name": "pageNum",
            "in": "query",
            "required": false,
            "schema": {
              "type": "number"
            },
            "description": "页码，默认1"
          },
          {
            "name": "pageSize",
            "in": "query",
            "required": false,
            "schema": {
              "type": "number"
            },
            "description": "每页数量，默认10"
          },
          {
            "name": "name",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "description": "名称（模糊搜索）"
          },
          {
            "name": "code",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "description": "编码（模糊搜索）"
          }
        ],
        "responses": {
          "200": {
            "description": "成功响应",
            "content": {
              "application/json": {
                "example": {
                  "success": {
                    "code": "0000",
                    "message": "查询成功",
                    "data": {
                      "list": [
                        {
                          "id": 1,
                          "memberTypeId": "MT0001",
                          "memberTypeName": "VIP会员",
                          "systemId": "SYS0001",
                          "systemName": "权限系统",
                          "status": 1,
                          "createTime": "2025-01-01T10:00:00.000Z",
                          "updateTime": "2025-01-01T10:00:00.000Z"
                        }
                      ],
                      "total": 1,
                      "pageNum": 1,
                      "pageSize": 10
                    }
                  }
                }
              }
            }
          }
        },
        "tags": [
          "OpenAPI 接口"
        ]
      }
    },
    "/openapi/member-functions/list/simple": {
      "get": {
        "summary": "会员功能管理 - 简单列表查询",
        "description": "无分页返回会员功能管理前100条状态有效数据的列表，支持多种可选查询条件用于筛选以及排序。必须提供有效的X-Site和X-System-Code header。",
        "parameters": [
          {
            "name": "X-Site",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "站点标识（必填）"
          },
          {
            "name": "X-System-Code",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "系统编码（必填）"
          },
          {
            "name": "name",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "description": "名称（模糊搜索）"
          },
          {
            "name": "code",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "description": "编码（模糊搜索）"
          },
          {
            "name": "sortBy",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "description": "排序字段，默认createTime"
          },
          {
            "name": "sortOrder",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "description": "排序方向：asc-升序，desc-降序，默认desc"
          }
        ],
        "responses": {
          "200": {
            "description": "成功响应",
            "content": {
              "application/json": {
                "example": {
                  "success": {
                    "code": "0000",
                    "message": "查询成功",
                    "data": {
                      "list": [
                        {
                          "id": 1,
                          "memberTypeId": "MT0001",
                          "memberTypeName": "VIP会员",
                          "systemId": "SYS0001",
                          "systemName": "权限系统",
                          "status": 1,
                          "createTime": "2025-01-01T10:00:00.000Z",
                          "updateTime": "2025-01-01T10:00:00.000Z"
                        }
                      ]
                    }
                  }
                }
              }
            }
          }
        },
        "tags": [
          "OpenAPI 接口"
        ]
      }
    },
    "/openapi/member-types/list": {
      "get": {
        "summary": "会员类型管理 - 分页列表查询",
        "description": "分页查询会员类型管理状态有效的列表数据，支持多种可选查询条件用于筛选。必须提供有效的X-Site和X-System-Code header。",
        "parameters": [
          {
            "name": "X-Site",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "站点标识（必填）"
          },
          {
            "name": "X-System-Code",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "系统编码（必填）"
          },
          {
            "name": "pageNum",
            "in": "query",
            "required": false,
            "schema": {
              "type": "number"
            },
            "description": "页码，默认1"
          },
          {
            "name": "pageSize",
            "in": "query",
            "required": false,
            "schema": {
              "type": "number"
            },
            "description": "每页数量，默认10"
          },
          {
            "name": "name",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "description": "名称（模糊搜索）"
          },
          {
            "name": "code",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "description": "编码（模糊搜索）"
          }
        ],
        "responses": {
          "200": {
            "description": "成功响应",
            "content": {
              "application/json": {
                "example": {
                  "success": {
                    "code": "0000",
                    "message": "查询成功",
                    "data": {
                      "list": [
                        {
                          "id": 1,
                          "code": "MT0001",
                          "name": "VIP会员",
                          "title": "VIP会员类型",
                          "description": "VIP会员类型描述",
                          "status": 1,
                          "price": "99.00",
                          "validityDays": 365,
                          "createTime": "2025-01-01T10:00:00.000Z",
                          "updateTime": "2025-01-01T10:00:00.000Z"
                        }
                      ],
                      "total": 1,
                      "pageNum": 1,
                      "pageSize": 10
                    }
                  }
                }
              }
            }
          }
        },
        "tags": [
          "OpenAPI 接口"
        ]
      }
    },
    "/openapi/member-types/list/simple": {
      "get": {
        "summary": "会员类型管理 - 简单列表查询",
        "description": "无分页返回会员类型管理前100条状态有效数据的列表，支持多种可选查询条件用于筛选以及排序。必须提供有效的X-Site和X-System-Code header。",
        "parameters": [
          {
            "name": "X-Site",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "站点标识（必填）"
          },
          {
            "name": "X-System-Code",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "系统编码（必填）"
          },
          {
            "name": "name",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "description": "名称（模糊搜索）"
          },
          {
            "name": "code",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "description": "编码（模糊搜索）"
          },
          {
            "name": "sortBy",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "description": "排序字段，默认createTime"
          },
          {
            "name": "sortOrder",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "description": "排序方向：asc-升序，desc-降序，默认desc"
          }
        ],
        "responses": {
          "200": {
            "description": "成功响应",
            "content": {
              "application/json": {
                "example": {
                  "success": {
                    "code": "0000",
                    "message": "查询成功",
                    "data": {
                      "list": [
                        {
                          "id": 1,
                          "code": "MT0001",
                          "name": "VIP会员",
                          "title": "VIP会员类型",
                          "description": "VIP会员类型描述",
                          "status": 1,
                          "price": "99.00",
                          "validityDays": 365,
                          "createTime": "2025-01-01T10:00:00.000Z",
                          "updateTime": "2025-01-01T10:00:00.000Z"
                        }
                      ]
                    }
                  }
                }
              }
            }
          }
        },
        "tags": [
          "OpenAPI 接口"
        ]
      }
    },
    "/openapi/member-function-limits/list": {
      "get": {
        "summary": "会员功能限制管理 - 分页列表查询",
        "description": "分页查询会员功能限制管理状态有效的列表数据，支持多种可选查询条件用于筛选。必须提供有效的X-Site和X-System-Code header。",
        "parameters": [
          {
            "name": "X-Site",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "站点标识（必填）"
          },
          {
            "name": "X-System-Code",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "系统编码（必填）"
          },
          {
            "name": "pageNum",
            "in": "query",
            "required": false,
            "schema": {
              "type": "number"
            },
            "description": "页码，默认1"
          },
          {
            "name": "pageSize",
            "in": "query",
            "required": false,
            "schema": {
              "type": "number"
            },
            "description": "每页数量，默认10"
          },
          {
            "name": "name",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "description": "名称（模糊搜索）"
          },
          {
            "name": "code",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "description": "编码（模糊搜索）"
          }
        ],
        "responses": {
          "200": {
            "description": "成功响应",
            "content": {
              "application/json": {
                "example": {
                  "success": {
                    "code": "0000",
                    "message": "查询成功",
                    "data": {
                      "list": [
                        {
                          "id": 1,
                          "memberTypeId": "MT0001",
                          "memberTypeName": "VIP会员",
                          "systemId": "SYS0001",
                          "systemName": "权限系统",
                          "moduleId": "MOD0001",
                          "moduleName": "用户管理",
                          "limitValue": 100,
                          "status": 1,
                          "description": "会员功能限制描述",
                          "createTime": "2025-01-01T10:00:00.000Z",
                          "updateTime": "2025-01-01T10:00:00.000Z"
                        }
                      ],
                      "total": 1,
                      "pageNum": 1,
                      "pageSize": 10
                    }
                  }
                }
              }
            }
          }
        },
        "tags": [
          "OpenAPI 接口"
        ]
      }
    },
    "/openapi/member-function-limits/list/simple": {
      "get": {
        "summary": "会员功能限制管理 - 简单列表查询",
        "description": "无分页返回会员功能限制管理前100条状态有效数据的列表，支持多种可选查询条件用于筛选以及排序。必须提供有效的X-Site和X-System-Code header。",
        "parameters": [
          {
            "name": "X-Site",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "站点标识（必填）"
          },
          {
            "name": "X-System-Code",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "系统编码（必填）"
          },
          {
            "name": "name",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "description": "名称（模糊搜索）"
          },
          {
            "name": "code",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "description": "编码（模糊搜索）"
          },
          {
            "name": "sortBy",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "description": "排序字段，默认createTime"
          },
          {
            "name": "sortOrder",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "description": "排序方向：asc-升序，desc-降序，默认desc"
          }
        ],
        "responses": {
          "200": {
            "description": "成功响应",
            "content": {
              "application/json": {
                "example": {
                  "success": {
                    "code": "0000",
                    "message": "查询成功",
                    "data": {
                      "list": [
                        {
                          "id": 1,
                          "memberTypeId": "MT0001",
                          "memberTypeName": "VIP会员",
                          "systemId": "SYS0001",
                          "systemName": "权限系统",
                          "moduleId": "MOD0001",
                          "moduleName": "用户管理",
                          "limitValue": 100,
                          "status": 1,
                          "description": "会员功能限制描述",
                          "createTime": "2025-01-01T10:00:00.000Z",
                          "updateTime": "2025-01-01T10:00:00.000Z"
                        }
                      ]
                    }
                  }
                }
              }
            }
          }
        },
        "tags": [
          "OpenAPI 接口"
        ]
      }
    },
    "/openapi/whitelists/list": {
      "get": {
        "summary": "白名单管理 - 分页列表查询",
        "description": "分页查询白名单管理状态有效的列表数据，支持多种可选查询条件用于筛选。必须提供有效的X-Site和X-System-Code header。",
        "parameters": [
          {
            "name": "X-Site",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "站点标识（必填）"
          },
          {
            "name": "X-System-Code",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "系统编码（必填）"
          },
          {
            "name": "pageNum",
            "in": "query",
            "required": false,
            "schema": {
              "type": "number"
            },
            "description": "页码，默认1"
          },
          {
            "name": "pageSize",
            "in": "query",
            "required": false,
            "schema": {
              "type": "number"
            },
            "description": "每页数量，默认10"
          },
          {
            "name": "name",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "description": "名称（模糊搜索）"
          },
          {
            "name": "code",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "description": "编码（模糊搜索）"
          }
        ],
        "responses": {
          "200": {
            "description": "成功响应",
            "content": {
              "application/json": {
                "example": {
                  "success": {
                    "code": "0000",
                    "message": "查询成功",
                    "data": {
                      "list": [
                        {
                          "id": 1,
                          "code": "WL0001",
                          "name": "白名单A",
                          "userId": "USER0001",
                          "ip": "192.168.1.1",
                          "description": "白名单描述",
                          "status": 1,
                          "createTime": "2025-01-01T10:00:00.000Z",
                          "updateTime": "2025-01-01T10:00:00.000Z"
                        }
                      ],
                      "total": 1,
                      "pageNum": 1,
                      "pageSize": 10
                    }
                  }
                }
              }
            }
          }
        },
        "tags": [
          "OpenAPI 接口"
        ]
      }
    },
    "/openapi/whitelists/list/simple": {
      "get": {
        "summary": "白名单管理 - 简单列表查询",
        "description": "无分页返回白名单管理前100条状态有效数据的列表，支持多种可选查询条件用于筛选以及排序。必须提供有效的X-Site和X-System-Code header。",
        "parameters": [
          {
            "name": "X-Site",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "站点标识（必填）"
          },
          {
            "name": "X-System-Code",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "系统编码（必填）"
          },
          {
            "name": "name",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "description": "名称（模糊搜索）"
          },
          {
            "name": "code",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "description": "编码（模糊搜索）"
          },
          {
            "name": "sortBy",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "description": "排序字段，默认createTime"
          },
          {
            "name": "sortOrder",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "description": "排序方向：asc-升序，desc-降序，默认desc"
          }
        ],
        "responses": {
          "200": {
            "description": "成功响应",
            "content": {
              "application/json": {
                "example": {
                  "success": {
                    "code": "0000",
                    "message": "查询成功",
                    "data": {
                      "list": [
                        {
                          "id": 1,
                          "code": "WL0001",
                          "name": "白名单A",
                          "userId": "USER0001",
                          "ip": "192.168.1.1",
                          "description": "白名单描述",
                          "status": 1,
                          "createTime": "2025-01-01T10:00:00.000Z",
                          "updateTime": "2025-01-01T10:00:00.000Z"
                        }
                      ]
                    }
                  }
                }
              }
            }
          }
        },
        "tags": [
          "OpenAPI 接口"
        ]
      }
    },
    "/openapi/blacklists/list": {
      "get": {
        "summary": "黑名单管理 - 分页列表查询",
        "description": "分页查询黑名单管理状态有效的列表数据，支持多种可选查询条件用于筛选。必须提供有效的X-Site和X-System-Code header。",
        "parameters": [
          {
            "name": "X-Site",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "站点标识（必填）"
          },
          {
            "name": "X-System-Code",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "系统编码（必填）"
          },
          {
            "name": "pageNum",
            "in": "query",
            "required": false,
            "schema": {
              "type": "number"
            },
            "description": "页码，默认1"
          },
          {
            "name": "pageSize",
            "in": "query",
            "required": false,
            "schema": {
              "type": "number"
            },
            "description": "每页数量，默认10"
          },
          {
            "name": "name",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "description": "名称（模糊搜索）"
          },
          {
            "name": "code",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "description": "编码（模糊搜索）"
          }
        ],
        "responses": {
          "200": {
            "description": "成功响应",
            "content": {
              "application/json": {
                "example": {
                  "success": {
                    "code": "0000",
                    "message": "查询成功",
                    "data": {
                      "list": [
                        {
                          "id": 1,
                          "code": "BL0001",
                          "name": "黑名单A",
                          "userId": "USER0001",
                          "ip": "192.168.1.100",
                          "description": "黑名单描述",
                          "status": 1,
                          "createTime": "2025-01-01T10:00:00.000Z",
                          "updateTime": "2025-01-01T10:00:00.000Z"
                        }
                      ],
                      "total": 1,
                      "pageNum": 1,
                      "pageSize": 10
                    }
                  }
                }
              }
            }
          }
        },
        "tags": [
          "OpenAPI 接口"
        ]
      }
    },
    "/openapi/blacklists/list/simple": {
      "get": {
        "summary": "黑名单管理 - 简单列表查询",
        "description": "无分页返回黑名单管理前100条状态有效数据的列表，支持多种可选查询条件用于筛选以及排序。必须提供有效的X-Site和X-System-Code header。",
        "parameters": [
          {
            "name": "X-Site",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "站点标识（必填）"
          },
          {
            "name": "X-System-Code",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "系统编码（必填）"
          },
          {
            "name": "name",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "description": "名称（模糊搜索）"
          },
          {
            "name": "code",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "description": "编码（模糊搜索）"
          },
          {
            "name": "sortBy",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "description": "排序字段，默认createTime"
          },
          {
            "name": "sortOrder",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "description": "排序方向：asc-升序，desc-降序，默认desc"
          }
        ],
        "responses": {
          "200": {
            "description": "成功响应",
            "content": {
              "application/json": {
                "example": {
                  "success": {
                    "code": "0000",
                    "message": "查询成功",
                    "data": {
                      "list": [
                        {
                          "id": 1,
                          "code": "BL0001",
                          "name": "黑名单A",
                          "userId": "USER0001",
                          "ip": "192.168.1.100",
                          "description": "黑名单描述",
                          "status": 1,
                          "createTime": "2025-01-01T10:00:00.000Z",
                          "updateTime": "2025-01-01T10:00:00.000Z"
                        }
                      ]
                    }
                  }
                }
              }
            }
          }
        },
        "tags": [
          "OpenAPI 接口"
        ]
      }
    },
    "/openapi/support-systems/list": {
      "get": {
        "summary": "系统管理 - 分页列表查询",
        "description": "分页查询系统管理状态有效的列表数据，支持多种可选查询条件用于筛选。必须提供有效的X-Site和X-System-Code header。",
        "parameters": [
          {
            "name": "X-Site",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "站点标识（必填）"
          },
          {
            "name": "X-System-Code",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "系统编码（必填）"
          },
          {
            "name": "pageNum",
            "in": "query",
            "required": false,
            "schema": {
              "type": "number"
            },
            "description": "页码，默认1"
          },
          {
            "name": "pageSize",
            "in": "query",
            "required": false,
            "schema": {
              "type": "number"
            },
            "description": "每页数量，默认10"
          },
          {
            "name": "name",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "description": "名称（模糊搜索）"
          },
          {
            "name": "code",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "description": "编码（模糊搜索）"
          }
        ],
        "responses": {
          "200": {
            "description": "成功响应",
            "content": {
              "application/json": {
                "example": {
                  "success": {
                    "code": "0000",
                    "message": "查询成功",
                    "data": {
                      "list": [
                        {
                          "id": 1,
                          "code": "SYS0001",
                          "name": "权限管理系统",
                          "description": "权限管理系统描述",
                          "status": 1,
                          "defaultAdminRoleId": "ROLE0001",
                          "createTime": "2025-01-01T10:00:00.000Z",
                          "updateTime": "2025-01-01T10:00:00.000Z"
                        }
                      ],
                      "total": 1,
                      "pageNum": 1,
                      "pageSize": 10
                    }
                  }
                }
              }
            }
          }
        },
        "tags": [
          "OpenAPI 接口"
        ]
      }
    },
    "/openapi/support-systems/list/simple": {
      "get": {
        "summary": "系统管理 - 简单列表查询",
        "description": "无分页返回系统管理前100条状态有效数据的列表，支持多种可选查询条件用于筛选以及排序。必须提供有效的X-Site和X-System-Code header。",
        "parameters": [
          {
            "name": "X-Site",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "站点标识（必填）"
          },
          {
            "name": "X-System-Code",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "系统编码（必填）"
          },
          {
            "name": "name",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "description": "名称（模糊搜索）"
          },
          {
            "name": "code",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "description": "编码（模糊搜索）"
          },
          {
            "name": "sortBy",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "description": "排序字段，默认createTime"
          },
          {
            "name": "sortOrder",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "description": "排序方向：asc-升序，desc-降序，默认desc"
          }
        ],
        "responses": {
          "200": {
            "description": "成功响应",
            "content": {
              "application/json": {
                "example": {
                  "success": {
                    "code": "0000",
                    "message": "查询成功",
                    "data": {
                      "list": [
                        {
                          "id": 1,
                          "code": "SYS0001",
                          "name": "权限管理系统",
                          "description": "权限管理系统描述",
                          "status": 1,
                          "defaultAdminRoleId": "ROLE0001",
                          "createTime": "2025-01-01T10:00:00.000Z",
                          "updateTime": "2025-01-01T10:00:00.000Z"
                        }
                      ]
                    }
                  }
                }
              }
            }
          }
        },
        "tags": [
          "OpenAPI 接口"
        ]
      }
    },
    "/openapi/sites/list": {
      "get": {
        "summary": "站点数据 - 列表查询",
        "description": "返回用户名和对应站点key的列表，用于查看。必须提供有效的X-Site和X-System-Code header。",
        "parameters": [
          {
            "name": "X-Site",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "站点标识（必填）"
          },
          {
            "name": "X-System-Code",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "系统编码（必填）"
          },
          {
            "name": "name",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "description": "站点名称（模糊搜索）"
          }
        ],
        "responses": {
          "200": {
            "description": "成功响应",
            "content": {
              "application/json": {
                "example": {
                  "success": {
                    "code": "0000",
                    "message": "查询成功",
                    "data": {
                      "list": [
                        {
                          "userName": "张三",
                          "siteKey": "47F38C4F-3437-4108-96EE-0621B30EF2B9-7B75868C742688BD3",
                          "siteName": "个人站点"
                        }
                      ]
                    }
                  }
                }
              }
            }
          }
        },
        "tags": [
          "OpenAPI 接口"
        ]
      }
    },
    "/openapi/users/statistics": {
      "get": {
        "summary": "用户管理 - 统计",
        "description": "返回用户管理的有效数据记录数和所有记录数两个字段。必须提供有效的X-Site和X-System-Code header。",
        "parameters": [
          {
            "name": "X-Site",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "站点标识（必填）"
          },
          {
            "name": "X-System-Code",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "系统编码（必填）"
          },
          {
            "name": "name",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "description": "名称（模糊搜索）"
          },
          {
            "name": "code",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "description": "编码（模糊搜索）"
          }
        ],
        "responses": {
          "200": {
            "description": "成功响应",
            "content": {
              "application/json": {
                "example": {
                  "success": {
                    "code": "0000",
                    "message": "统计成功",
                    "data": {
                      "validCount": 100,
                      "totalCount": 150
                    }
                  }
                }
              }
            }
          }
        },
        "tags": [
          "统计模块"
        ]
      }
    },
    "/openapi/client-users/statistics": {
      "get": {
        "summary": "客户端用户管理 - 统计",
        "description": "返回客户端用户管理的有效数据记录数和所有记录数两个字段。必须提供有效的X-Site和X-System-Code header。",
        "parameters": [
          {
            "name": "X-Site",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "站点标识（必填）"
          },
          {
            "name": "X-System-Code",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "系统编码（必填）"
          },
          {
            "name": "name",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "description": "名称（模糊搜索）"
          },
          {
            "name": "code",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "description": "编码（模糊搜索）"
          }
        ],
        "responses": {
          "200": {
            "description": "成功响应",
            "content": {
              "application/json": {
                "example": {
                  "success": {
                    "code": "0000",
                    "message": "统计成功",
                    "data": {
                      "validCount": 100,
                      "totalCount": 150
                    }
                  }
                }
              }
            }
          }
        },
        "tags": [
          "统计模块"
        ]
      }
    },
    "/openapi/organizations/statistics": {
      "get": {
        "summary": "组织管理 - 统计",
        "description": "返回组织管理的有效数据记录数和所有记录数两个字段。必须提供有效的X-Site和X-System-Code header。",
        "parameters": [
          {
            "name": "X-Site",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "站点标识（必填）"
          },
          {
            "name": "X-System-Code",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "系统编码（必填）"
          },
          {
            "name": "name",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "description": "名称（模糊搜索）"
          },
          {
            "name": "code",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "description": "编码（模糊搜索）"
          }
        ],
        "responses": {
          "200": {
            "description": "成功响应",
            "content": {
              "application/json": {
                "example": {
                  "success": {
                    "code": "0000",
                    "message": "统计成功",
                    "data": {
                      "validCount": 100,
                      "totalCount": 150
                    }
                  }
                }
              }
            }
          }
        },
        "tags": [
          "统计模块"
        ]
      }
    },
    "/openapi/departments/statistics": {
      "get": {
        "summary": "部门管理 - 统计",
        "description": "返回部门管理的有效数据记录数和所有记录数两个字段。必须提供有效的X-Site和X-System-Code header。",
        "parameters": [
          {
            "name": "X-Site",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "站点标识（必填）"
          },
          {
            "name": "X-System-Code",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "系统编码（必填）"
          },
          {
            "name": "name",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "description": "名称（模糊搜索）"
          },
          {
            "name": "code",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "description": "编码（模糊搜索）"
          }
        ],
        "responses": {
          "200": {
            "description": "成功响应",
            "content": {
              "application/json": {
                "example": {
                  "success": {
                    "code": "0000",
                    "message": "统计成功",
                    "data": {
                      "validCount": 100,
                      "totalCount": 150
                    }
                  }
                }
              }
            }
          }
        },
        "tags": [
          "统计模块"
        ]
      }
    },
    "/openapi/positions/statistics": {
      "get": {
        "summary": "岗位管理 - 统计",
        "description": "返回岗位管理的有效数据记录数和所有记录数两个字段。必须提供有效的X-Site和X-System-Code header。",
        "parameters": [
          {
            "name": "X-Site",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "站点标识（必填）"
          },
          {
            "name": "X-System-Code",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "系统编码（必填）"
          },
          {
            "name": "name",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "description": "名称（模糊搜索）"
          },
          {
            "name": "code",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "description": "编码（模糊搜索）"
          }
        ],
        "responses": {
          "200": {
            "description": "成功响应",
            "content": {
              "application/json": {
                "example": {
                  "success": {
                    "code": "0000",
                    "message": "统计成功",
                    "data": {
                      "validCount": 100,
                      "totalCount": 150
                    }
                  }
                }
              }
            }
          }
        },
        "tags": [
          "统计模块"
        ]
      }
    },
    "/openapi/staff/statistics": {
      "get": {
        "summary": "职员管理 - 统计",
        "description": "返回职员管理的有效数据记录数和所有记录数两个字段。必须提供有效的X-Site和X-System-Code header。",
        "parameters": [
          {
            "name": "X-Site",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "站点标识（必填）"
          },
          {
            "name": "X-System-Code",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "系统编码（必填）"
          },
          {
            "name": "name",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "description": "名称（模糊搜索）"
          },
          {
            "name": "code",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "description": "编码（模糊搜索）"
          }
        ],
        "responses": {
          "200": {
            "description": "成功响应",
            "content": {
              "application/json": {
                "example": {
                  "success": {
                    "code": "0000",
                    "message": "统计成功",
                    "data": {
                      "validCount": 100,
                      "totalCount": 150
                    }
                  }
                }
              }
            }
          }
        },
        "tags": [
          "统计模块"
        ]
      }
    },
    "/openapi/roles/statistics": {
      "get": {
        "summary": "角色管理 - 统计",
        "description": "返回角色管理的有效数据记录数和所有记录数两个字段。必须提供有效的X-Site和X-System-Code header。",
        "parameters": [
          {
            "name": "X-Site",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "站点标识（必填）"
          },
          {
            "name": "X-System-Code",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "系统编码（必填）"
          },
          {
            "name": "name",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "description": "名称（模糊搜索）"
          },
          {
            "name": "code",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "description": "编码（模糊搜索）"
          }
        ],
        "responses": {
          "200": {
            "description": "成功响应",
            "content": {
              "application/json": {
                "example": {
                  "success": {
                    "code": "0000",
                    "message": "统计成功",
                    "data": {
                      "validCount": 100,
                      "totalCount": 150
                    }
                  }
                }
              }
            }
          }
        },
        "tags": [
          "统计模块"
        ]
      }
    },
    "/openapi/resources/statistics": {
      "get": {
        "summary": "资源管理 - 统计",
        "description": "返回资源管理的有效数据记录数和所有记录数两个字段。必须提供有效的X-Site和X-System-Code header。",
        "parameters": [
          {
            "name": "X-Site",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "站点标识（必填）"
          },
          {
            "name": "X-System-Code",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "系统编码（必填）"
          },
          {
            "name": "name",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "description": "名称（模糊搜索）"
          },
          {
            "name": "code",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "description": "编码（模糊搜索）"
          }
        ],
        "responses": {
          "200": {
            "description": "成功响应",
            "content": {
              "application/json": {
                "example": {
                  "success": {
                    "code": "0000",
                    "message": "统计成功",
                    "data": {
                      "validCount": 100,
                      "totalCount": 150
                    }
                  }
                }
              }
            }
          }
        },
        "tags": [
          "统计模块"
        ]
      }
    },
    "/openapi/permissions/statistics": {
      "get": {
        "summary": "权限管理 - 统计",
        "description": "返回权限管理的有效数据记录数和所有记录数两个字段。必须提供有效的X-Site和X-System-Code header。",
        "parameters": [
          {
            "name": "X-Site",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "站点标识（必填）"
          },
          {
            "name": "X-System-Code",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "系统编码（必填）"
          },
          {
            "name": "name",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "description": "名称（模糊搜索）"
          },
          {
            "name": "code",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "description": "编码（模糊搜索）"
          }
        ],
        "responses": {
          "200": {
            "description": "成功响应",
            "content": {
              "application/json": {
                "example": {
                  "success": {
                    "code": "0000",
                    "message": "统计成功",
                    "data": {
                      "validCount": 100,
                      "totalCount": 150
                    }
                  }
                }
              }
            }
          }
        },
        "tags": [
          "统计模块"
        ]
      }
    },
    "/openapi/customers/statistics": {
      "get": {
        "summary": "客户管理 - 统计",
        "description": "返回客户管理的有效数据记录数和所有记录数两个字段。必须提供有效的X-Site和X-System-Code header。",
        "parameters": [
          {
            "name": "X-Site",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "站点标识（必填）"
          },
          {
            "name": "X-System-Code",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "系统编码（必填）"
          },
          {
            "name": "name",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "description": "名称（模糊搜索）"
          },
          {
            "name": "code",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "description": "编码（模糊搜索）"
          }
        ],
        "responses": {
          "200": {
            "description": "成功响应",
            "content": {
              "application/json": {
                "example": {
                  "success": {
                    "code": "0000",
                    "message": "统计成功",
                    "data": {
                      "validCount": 100,
                      "totalCount": 150
                    }
                  }
                }
              }
            }
          }
        },
        "tags": [
          "统计模块"
        ]
      }
    },
    "/openapi/orders/statistics": {
      "get": {
        "summary": "订单管理 - 统计",
        "description": "返回订单管理的有效数据记录数和所有记录数两个字段。必须提供有效的X-Site和X-System-Code header。",
        "parameters": [
          {
            "name": "X-Site",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "站点标识（必填）"
          },
          {
            "name": "X-System-Code",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "系统编码（必填）"
          },
          {
            "name": "name",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "description": "名称（模糊搜索）"
          },
          {
            "name": "code",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "description": "编码（模糊搜索）"
          }
        ],
        "responses": {
          "200": {
            "description": "成功响应",
            "content": {
              "application/json": {
                "example": {
                  "success": {
                    "code": "0000",
                    "message": "统计成功",
                    "data": {
                      "validCount": 100,
                      "totalCount": 150
                    }
                  }
                }
              }
            }
          }
        },
        "tags": [
          "统计模块"
        ]
      }
    },
    "/openapi/members/statistics": {
      "get": {
        "summary": "会员管理 - 统计",
        "description": "返回会员管理的有效数据记录数和所有记录数两个字段。必须提供有效的X-Site和X-System-Code header。",
        "parameters": [
          {
            "name": "X-Site",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "站点标识（必填）"
          },
          {
            "name": "X-System-Code",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "系统编码（必填）"
          },
          {
            "name": "name",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "description": "名称（模糊搜索）"
          },
          {
            "name": "code",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "description": "编码（模糊搜索）"
          }
        ],
        "responses": {
          "200": {
            "description": "成功响应",
            "content": {
              "application/json": {
                "example": {
                  "success": {
                    "code": "0000",
                    "message": "统计成功",
                    "data": {
                      "validCount": 100,
                      "totalCount": 150
                    }
                  }
                }
              }
            }
          }
        },
        "tags": [
          "统计模块"
        ]
      }
    },
    "/openapi/stateless-members/statistics": {
      "get": {
        "summary": "无状态会员管理 - 统计",
        "description": "返回无状态会员管理的有效数据记录数和所有记录数两个字段。必须提供有效的X-Site和X-System-Code header。",
        "parameters": [
          {
            "name": "X-Site",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "站点标识（必填）"
          },
          {
            "name": "X-System-Code",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "系统编码（必填）"
          },
          {
            "name": "name",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "description": "名称（模糊搜索）"
          },
          {
            "name": "code",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "description": "编码（模糊搜索）"
          }
        ],
        "responses": {
          "200": {
            "description": "成功响应",
            "content": {
              "application/json": {
                "example": {
                  "success": {
                    "code": "0000",
                    "message": "统计成功",
                    "data": {
                      "validCount": 100,
                      "totalCount": 150
                    }
                  }
                }
              }
            }
          }
        },
        "tags": [
          "统计模块"
        ]
      }
    },
    "/openapi/member-users/statistics": {
      "get": {
        "summary": "会员用户管理 - 统计",
        "description": "返回会员用户管理的有效数据记录数和所有记录数两个字段。必须提供有效的X-Site和X-System-Code header。",
        "parameters": [
          {
            "name": "X-Site",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "站点标识（必填）"
          },
          {
            "name": "X-System-Code",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "系统编码（必填）"
          },
          {
            "name": "name",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "description": "名称（模糊搜索）"
          },
          {
            "name": "code",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "description": "编码（模糊搜索）"
          }
        ],
        "responses": {
          "200": {
            "description": "成功响应",
            "content": {
              "application/json": {
                "example": {
                  "success": {
                    "code": "0000",
                    "message": "统计成功",
                    "data": {
                      "validCount": 100,
                      "totalCount": 150
                    }
                  }
                }
              }
            }
          }
        },
        "tags": [
          "统计模块"
        ]
      }
    },
    "/openapi/member-functions/statistics": {
      "get": {
        "summary": "会员功能管理 - 统计",
        "description": "返回会员功能管理的有效数据记录数和所有记录数两个字段。必须提供有效的X-Site和X-System-Code header。",
        "parameters": [
          {
            "name": "X-Site",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "站点标识（必填）"
          },
          {
            "name": "X-System-Code",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "系统编码（必填）"
          },
          {
            "name": "name",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "description": "名称（模糊搜索）"
          },
          {
            "name": "code",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "description": "编码（模糊搜索）"
          }
        ],
        "responses": {
          "200": {
            "description": "成功响应",
            "content": {
              "application/json": {
                "example": {
                  "success": {
                    "code": "0000",
                    "message": "统计成功",
                    "data": {
                      "validCount": 100,
                      "totalCount": 150
                    }
                  }
                }
              }
            }
          }
        },
        "tags": [
          "统计模块"
        ]
      }
    },
    "/openapi/member-types/statistics": {
      "get": {
        "summary": "会员类型管理 - 统计",
        "description": "返回会员类型管理的有效数据记录数和所有记录数两个字段。必须提供有效的X-Site和X-System-Code header。",
        "parameters": [
          {
            "name": "X-Site",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "站点标识（必填）"
          },
          {
            "name": "X-System-Code",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "系统编码（必填）"
          },
          {
            "name": "name",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "description": "名称（模糊搜索）"
          },
          {
            "name": "code",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "description": "编码（模糊搜索）"
          }
        ],
        "responses": {
          "200": {
            "description": "成功响应",
            "content": {
              "application/json": {
                "example": {
                  "success": {
                    "code": "0000",
                    "message": "统计成功",
                    "data": {
                      "validCount": 100,
                      "totalCount": 150
                    }
                  }
                }
              }
            }
          }
        },
        "tags": [
          "统计模块"
        ]
      }
    },
    "/openapi/member-function-limits/statistics": {
      "get": {
        "summary": "会员功能限制管理 - 统计",
        "description": "返回会员功能限制管理的有效数据记录数和所有记录数两个字段。必须提供有效的X-Site和X-System-Code header。",
        "parameters": [
          {
            "name": "X-Site",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "站点标识（必填）"
          },
          {
            "name": "X-System-Code",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "系统编码（必填）"
          },
          {
            "name": "name",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "description": "名称（模糊搜索）"
          },
          {
            "name": "code",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "description": "编码（模糊搜索）"
          }
        ],
        "responses": {
          "200": {
            "description": "成功响应",
            "content": {
              "application/json": {
                "example": {
                  "success": {
                    "code": "0000",
                    "message": "统计成功",
                    "data": {
                      "validCount": 100,
                      "totalCount": 150
                    }
                  }
                }
              }
            }
          }
        },
        "tags": [
          "统计模块"
        ]
      }
    },
    "/openapi/whitelists/statistics": {
      "get": {
        "summary": "白名单管理 - 统计",
        "description": "返回白名单管理的有效数据记录数和所有记录数两个字段。必须提供有效的X-Site和X-System-Code header。",
        "parameters": [
          {
            "name": "X-Site",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "站点标识（必填）"
          },
          {
            "name": "X-System-Code",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "系统编码（必填）"
          },
          {
            "name": "name",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "description": "名称（模糊搜索）"
          },
          {
            "name": "code",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "description": "编码（模糊搜索）"
          }
        ],
        "responses": {
          "200": {
            "description": "成功响应",
            "content": {
              "application/json": {
                "example": {
                  "success": {
                    "code": "0000",
                    "message": "统计成功",
                    "data": {
                      "validCount": 100,
                      "totalCount": 150
                    }
                  }
                }
              }
            }
          }
        },
        "tags": [
          "统计模块"
        ]
      }
    },
    "/openapi/blacklists/statistics": {
      "get": {
        "summary": "黑名单管理 - 统计",
        "description": "返回黑名单管理的有效数据记录数和所有记录数两个字段。必须提供有效的X-Site和X-System-Code header。",
        "parameters": [
          {
            "name": "X-Site",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "站点标识（必填）"
          },
          {
            "name": "X-System-Code",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "系统编码（必填）"
          },
          {
            "name": "name",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "description": "名称（模糊搜索）"
          },
          {
            "name": "code",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "description": "编码（模糊搜索）"
          }
        ],
        "responses": {
          "200": {
            "description": "成功响应",
            "content": {
              "application/json": {
                "example": {
                  "success": {
                    "code": "0000",
                    "message": "统计成功",
                    "data": {
                      "validCount": 100,
                      "totalCount": 150
                    }
                  }
                }
              }
            }
          }
        },
        "tags": [
          "统计模块"
        ]
      }
    },
    "/openapi/support-systems/statistics": {
      "get": {
        "summary": "系统管理 - 统计",
        "description": "返回系统管理的有效数据记录数和所有记录数两个字段。必须提供有效的X-Site和X-System-Code header。",
        "parameters": [
          {
            "name": "X-Site",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "站点标识（必填）"
          },
          {
            "name": "X-System-Code",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "系统编码（必填）"
          },
          {
            "name": "name",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "description": "名称（模糊搜索）"
          },
          {
            "name": "code",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "description": "编码（模糊搜索）"
          }
        ],
        "responses": {
          "200": {
            "description": "成功响应",
            "content": {
              "application/json": {
                "example": {
                  "success": {
                    "code": "0000",
                    "message": "统计成功",
                    "data": {
                      "validCount": 100,
                      "totalCount": 150
                    }
                  }
                }
              }
            }
          }
        },
        "tags": [
          "统计模块"
        ]
      }
    },
    "/openapi/sites/statistics": {
      "get": {
        "summary": "站点数据 - 统计",
        "description": "返回站点记录数。必须提供有效的X-Site和X-System-Code header。",
        "parameters": [
          {
            "name": "X-Site",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "站点标识（必填）"
          },
          {
            "name": "X-System-Code",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "系统编码（必填）"
          }
        ],
        "responses": {
          "200": {
            "description": "成功响应",
            "content": {
              "application/json": {
                "example": {
                  "success": {
                    "code": "0000",
                    "message": "统计成功",
                    "data": {
                      "validCount": 10,
                      "totalCount": 10
                    }
                  }
                }
              }
            }
          }
        },
        "tags": [
          "统计模块"
        ]
      }
    }
  },
  "servers": [
    {
      "url": "http://localhost:5600"
    }
  ],
  "tags": [
    {
      "name": "用户管理",
      "description": "用户管理"
    },
    {
      "name": "认证模块",
      "description": "认证模块"
    },
    {
      "name": "系统管理",
      "description": "系统管理"
    },
    {
      "name": "客户端用户管理",
      "description": "客户端用户管理"
    },
    {
      "name": "组织管理",
      "description": "组织管理"
    },
    {
      "name": "部门管理",
      "description": "部门管理"
    },
    {
      "name": "岗位管理",
      "description": "岗位管理"
    },
    {
      "name": "职员管理",
      "description": "职员管理"
    },
    {
      "name": "角色管理",
      "description": "角色管理"
    },
    {
      "name": "权限管理",
      "description": "权限管理"
    },
    {
      "name": "资源管理",
      "description": "资源管理"
    },
    {
      "name": "客户管理",
      "description": "客户管理"
    },
    {
      "name": "会员管理",
      "description": "会员管理"
    },
    {
      "name": "会员类型管理",
      "description": "会员类型管理"
    },
    {
      "name": "无状态会员管理",
      "description": "无状态会员管理"
    },
    {
      "name": "会员用户管理",
      "description": "会员用户管理"
    },
    {
      "name": "会员功能管理",
      "description": "会员功能管理"
    },
    {
      "name": "会员功能限制配置",
      "description": "会员功能限制配置"
    },
    {
      "name": "白名单管理",
      "description": "白名单管理"
    },
    {
      "name": "黑名单管理",
      "description": "黑名单管理"
    },
    {
      "name": "安全系统管理",
      "description": "安全系统管理"
    },
    {
      "name": "OpenAPI 接口",
      "description": "OpenAPI 接口"
    },
    {
      "name": "统计模块",
      "description": "统计模块"
    }
  ]
}