add doc

docs/api_torna/user-and-role.md

@@ -0,0 +1,939 @@
+# 文档
+
+## 管理后台
+
+## 账号管理
+
+
+### 获取账号列表（分页）
+
+维护人：root
+
+#### URL
+
+- 本地开发环境: `POST` http://localhost:10050/api/admin/accounts/list
+- 开发环境: `POST` https://tg-live-game.pwtk.cc/api/admin/accounts/list
+
+
+描述：获取账号列表（分页）
+
+ContentType：`application/json`
+
+#### 请求参数
+
+##### Body Parameter
+
+| 名称 | 类型 | 必填 | 最大长度 | 描述 | 示例值 |
+| --- | --- | --- | --- | --- | --- |
+| page | Integer | 否 | - | 页码 (从1开始) | 1 |
+| size | Integer | 否 | - | 每页条数 | 10 |
+| keyword | String | 否 | - | 搜索关键词 (模糊匹配名称、ID等) | 摄像头 |
+| enabled | Boolean | 否 | - | 启用状态过滤 (null=全部, true=启用, false=禁用) | true |
+| sortBy | String | 否 | - | 排序字段 | createdAt |
+| sortDir | String | 否 | - | 排序方向 (ASC/DESC) | DESC |
+
+#### 请求示例
+
+```
+{
+    "page": 1,
+    "size": 10,
+    "keyword": "摄像头",
+    "enabled": true,
+    "sortBy": "createdAt",
+    "sortDir": "DESC"
+}
+```
+
+#### 响应参数
+
+| 名称 | 类型 | 必填 | 最大长度 | 描述 | 示例值 |
+| --- | --- | --- | --- | --- | --- |
+| success | Boolean | 否 | - | 请求是否成功 | true |
+| errCode | String | 否 | - | 错误码（失败时返回） |  |
+| errMessage | String | 否 | - | 错误信息（失败时返回） |  |
+| data | object | 否 |  | 响应数据 (ActualType: PageResponse) |  |
+|   └ list | List<T> | 否 |  | 数据列表 (ActualType: T) |  |
+|     └ id | Long | 否 | - | 主键ID | 1 |
+|     └ username | String | 否 | - | 用户名 | admin |
+|     └ nickname | String | 否 | - | 昵称 | 管理员 |
+|     └ enabled | Boolean | 否 | - | 是否启用 | true |
+|     └ lastLoginAt | LocalDateTime | 否 | - | 最后登录时间 | 2026-01-26T10:00:00 |
+|     └ roles | List<RoleSimpleDTO> | 否 |  | 关联的角色列表 (ActualType: RoleSimpleDTO) |  |
+|       └ id | Long | 否 | - | 主键ID | 1 |
+|       └ code | String | 否 | - | 角色编码 | ADMIN |
+|       └ name | String | 否 | - | 角色名称 | 管理员 |
+|     └ createdAt | LocalDateTime | 否 | - | 创建时间 | 2026-01-26T10:00:00 |
+|     └ updatedAt | LocalDateTime | 否 | - | 更新时间 | 2026-01-26T10:00:00 |
+|   └ page | Integer | 否 | - | 当前页码 (从1开始) | 1 |
+|   └ size | Integer | 否 | - | 每页条数 | 10 |
+|   └ total | Long | 否 | - | 总记录数 | 100 |
+|   └ totalPages | Integer | 否 | - | 总页数 | 10 |
+|   └ hasNext | Boolean | 否 | - | 是否有下一页 | true |
+|   └ hasPrevious | Boolean | 否 | - | 是否有上一页 | false |
+
+#### 响应示例
+
+```
+{
+    "success": true,
+    "errCode": "string",
+    "errMessage": "string",
+    "data": {
+        "list": [
+            {
+                "id": 1,
+                "username": "admin",
+                "nickname": "管理员",
+                "enabled": true,
+                "lastLoginAt": "2026-01-26T10:00:00",
+                "roles": [
+                    {
+                        "id": 1,
+                        "code": "ADMIN",
+                        "name": "管理员"
+                    }
+                ],
+                "createdAt": "2026-01-26T10:00:00",
+                "updatedAt": "2026-01-26T10:00:00"
+            }
+        ],
+        "page": 1,
+        "size": 10,
+        "total": 100,
+        "totalPages": 10,
+        "hasNext": true,
+        "hasPrevious": false
+    }
+}
+```
+
+#### 错误码
+
+无
+
+### 获取账号详情
+
+维护人：root
+
+#### URL
+
+- 本地开发环境: `GET` http://localhost:10050/api/admin/accounts/detail
+- 开发环境: `GET` https://tg-live-game.pwtk.cc/api/admin/accounts/detail
+
+
+描述：获取账号详情
+
+ContentType：`application/x-www-form-urlencoded;charset=UTF-8`
+
+#### 请求参数
+
+##### Query Parameter
+
+| 名称 | 类型 | 必填 | 最大长度 | 描述 | 示例值 |
+| --- | --- | --- | --- | --- | --- |
+| id | int64 | 是 | - | 账号ID | 0 |
+
+#### 响应参数
+
+| 名称 | 类型 | 必填 | 最大长度 | 描述 | 示例值 |
+| --- | --- | --- | --- | --- | --- |
+| success | Boolean | 否 | - | 请求是否成功 | true |
+| errCode | String | 否 | - | 错误码（失败时返回） |  |
+| errMessage | String | 否 | - | 错误信息（失败时返回） |  |
+| data | object | 否 |  | 响应数据 (ActualType: AdminDTO) |  |
+|   └ id | Long | 否 | - | 主键ID | 1 |
+|   └ username | String | 否 | - | 用户名 | admin |
+|   └ nickname | String | 否 | - | 昵称 | 管理员 |
+|   └ enabled | Boolean | 否 | - | 是否启用 | true |
+|   └ lastLoginAt | LocalDateTime | 否 | - | 最后登录时间 | 2026-01-26T10:00:00 |
+|   └ roles | List<RoleSimpleDTO> | 否 |  | 关联的角色列表 (ActualType: RoleSimpleDTO) |  |
+|     └ id | Long | 否 | - | 主键ID | 1 |
+|     └ code | String | 否 | - | 角色编码 | ADMIN |
+|     └ name | String | 否 | - | 角色名称 | 管理员 |
+|   └ createdAt | LocalDateTime | 否 | - | 创建时间 | 2026-01-26T10:00:00 |
+|   └ updatedAt | LocalDateTime | 否 | - | 更新时间 | 2026-01-26T10:00:00 |
+
+#### 响应示例
+
+```
+{
+    "success": true,
+    "errCode": "string",
+    "errMessage": "string",
+    "data": {
+        "id": 1,
+        "username": "admin",
+        "nickname": "管理员",
+        "enabled": true,
+        "lastLoginAt": "2026-01-26T10:00:00",
+        "roles": [
+            {
+                "id": 1,
+                "code": "ADMIN",
+                "name": "管理员"
+            }
+        ],
+        "createdAt": "2026-01-26T10:00:00",
+        "updatedAt": "2026-01-26T10:00:00"
+    }
+}
+```
+
+#### 错误码
+
+无
+
+### 新增账号
+
+维护人：root
+
+#### URL
+
+- 本地开发环境: `POST` http://localhost:10050/api/admin/accounts/add
+- 开发环境: `POST` https://tg-live-game.pwtk.cc/api/admin/accounts/add
+
+
+描述：新增账号
+
+ContentType：`application/json`
+
+#### 请求参数
+
+##### Body Parameter
+
+| 名称 | 类型 | 必填 | 最大长度 | 描述 | 示例值 |
+| --- | --- | --- | --- | --- | --- |
+| username | String | 是 | 50 | 用户名<br>Validate[max: 50; ] | operator1 |
+| password | String | 是 | 100 | 密码<br>Validate[max: 100; ] | 123456 |
+| nickname | String | 否 | 50 | 昵称<br>Validate[max: 50; ] | 操作员小王 |
+| roleIds | List<Long> | 否 | - | 关联的角色ID列表 (ActualType: Long) | [1, 2] |
+
+#### 请求示例
+
+```
+{
+    "username": "operator1",
+    "password": "123456",
+    "nickname": "操作员小王",
+    "roleIds": [
+        1,
+        2
+    ]
+}
+```
+
+#### 响应参数
+
+| 名称 | 类型 | 必填 | 最大长度 | 描述 | 示例值 |
+| --- | --- | --- | --- | --- | --- |
+| success | Boolean | 否 | - | 请求是否成功 | true |
+| errCode | String | 否 | - | 错误码（失败时返回） |  |
+| errMessage | String | 否 | - | 错误信息（失败时返回） |  |
+| data | object | 否 |  | 响应数据 (ActualType: AdminDTO) |  |
+|   └ id | Long | 否 | - | 主键ID | 1 |
+|   └ username | String | 否 | - | 用户名 | admin |
+|   └ nickname | String | 否 | - | 昵称 | 管理员 |
+|   └ enabled | Boolean | 否 | - | 是否启用 | true |
+|   └ lastLoginAt | LocalDateTime | 否 | - | 最后登录时间 | 2026-01-26T10:00:00 |
+|   └ roles | List<RoleSimpleDTO> | 否 |  | 关联的角色列表 (ActualType: RoleSimpleDTO) |  |
+|     └ id | Long | 否 | - | 主键ID | 1 |
+|     └ code | String | 否 | - | 角色编码 | ADMIN |
+|     └ name | String | 否 | - | 角色名称 | 管理员 |
+|   └ createdAt | LocalDateTime | 否 | - | 创建时间 | 2026-01-26T10:00:00 |
+|   └ updatedAt | LocalDateTime | 否 | - | 更新时间 | 2026-01-26T10:00:00 |
+
+#### 响应示例
+
+```
+{
+    "success": true,
+    "errCode": "string",
+    "errMessage": "string",
+    "data": {
+        "id": 1,
+        "username": "admin",
+        "nickname": "管理员",
+        "enabled": true,
+        "lastLoginAt": "2026-01-26T10:00:00",
+        "roles": [
+            {
+                "id": 1,
+                "code": "ADMIN",
+                "name": "管理员"
+            }
+        ],
+        "createdAt": "2026-01-26T10:00:00",
+        "updatedAt": "2026-01-26T10:00:00"
+    }
+}
+```
+
+#### 错误码
+
+无
+
+### 更新账号
+
+维护人：root
+
+#### URL
+
+- 本地开发环境: `POST` http://localhost:10050/api/admin/accounts/update
+- 开发环境: `POST` https://tg-live-game.pwtk.cc/api/admin/accounts/update
+
+
+描述：更新账号
+
+ContentType：`application/json`
+
+#### 请求参数
+
+##### Body Parameter
+
+| 名称 | 类型 | 必填 | 最大长度 | 描述 | 示例值 |
+| --- | --- | --- | --- | --- | --- |
+| id | Long | 是 | - | 管理员ID | 1 |
+| nickname | String | 否 | 50 | 昵称<br>Validate[max: 50; ] | 操作员小王 |
+| password | String | 否 | 100 | 密码（为空则不修改）<br>Validate[max: 100; ] | newPassword123 |
+| enabled | Boolean | 否 | - | 是否启用 | true |
+| roleIds | List<Long> | 否 | - | 关联的角色ID列表 (ActualType: Long) | [1, 2] |
+
+#### 请求示例
+
+```
+{
+    "id": 1,
+    "nickname": "操作员小王",
+    "password": "newPassword123",
+    "enabled": true,
+    "roleIds": [
+        1,
+        2
+    ]
+}
+```
+
+#### 响应参数
+
+| 名称 | 类型 | 必填 | 最大长度 | 描述 | 示例值 |
+| --- | --- | --- | --- | --- | --- |
+| success | Boolean | 否 | - | 请求是否成功 | true |
+| errCode | String | 否 | - | 错误码（失败时返回） |  |
+| errMessage | String | 否 | - | 错误信息（失败时返回） |  |
+| data | object | 否 |  | 响应数据 (ActualType: AdminDTO) |  |
+|   └ id | Long | 否 | - | 主键ID | 1 |
+|   └ username | String | 否 | - | 用户名 | admin |
+|   └ nickname | String | 否 | - | 昵称 | 管理员 |
+|   └ enabled | Boolean | 否 | - | 是否启用 | true |
+|   └ lastLoginAt | LocalDateTime | 否 | - | 最后登录时间 | 2026-01-26T10:00:00 |
+|   └ roles | List<RoleSimpleDTO> | 否 |  | 关联的角色列表 (ActualType: RoleSimpleDTO) |  |
+|     └ id | Long | 否 | - | 主键ID | 1 |
+|     └ code | String | 否 | - | 角色编码 | ADMIN |
+|     └ name | String | 否 | - | 角色名称 | 管理员 |
+|   └ createdAt | LocalDateTime | 否 | - | 创建时间 | 2026-01-26T10:00:00 |
+|   └ updatedAt | LocalDateTime | 否 | - | 更新时间 | 2026-01-26T10:00:00 |
+
+#### 响应示例
+
+```
+{
+    "success": true,
+    "errCode": "string",
+    "errMessage": "string",
+    "data": {
+        "id": 1,
+        "username": "admin",
+        "nickname": "管理员",
+        "enabled": true,
+        "lastLoginAt": "2026-01-26T10:00:00",
+        "roles": [
+            {
+                "id": 1,
+                "code": "ADMIN",
+                "name": "管理员"
+            }
+        ],
+        "createdAt": "2026-01-26T10:00:00",
+        "updatedAt": "2026-01-26T10:00:00"
+    }
+}
+```
+
+#### 错误码
+
+无
+
+### 删除账号
+
+维护人：root
+
+#### URL
+
+- 本地开发环境: `POST` http://localhost:10050/api/admin/accounts/delete
+- 开发环境: `POST` https://tg-live-game.pwtk.cc/api/admin/accounts/delete
+
+
+描述：删除账号
+
+ContentType：`application/x-www-form-urlencoded;charset=UTF-8`
+
+#### 请求参数
+
+##### Query Parameter
+
+| 名称 | 类型 | 必填 | 最大长度 | 描述 | 示例值 |
+| --- | --- | --- | --- | --- | --- |
+| id | int64 | 是 | - | 账号ID | 0 |
+
+#### 响应参数
+
+| 名称 | 类型 | 必填 | 最大长度 | 描述 | 示例值 |
+| --- | --- | --- | --- | --- | --- |
+| success | Boolean | 否 | - | 请求是否成功 | true |
+| errCode | String | 否 | - | 错误码（失败时返回） |  |
+| errMessage | String | 否 | - | 错误信息（失败时返回） |  |
+| data | object | 否 | - | 响应数据 (ActualType: Void) |  |
+
+#### 响应示例
+
+```
+{
+    "success": true,
+    "errCode": "string",
+    "errMessage": "string",
+    "data": {}
+}
+```
+
+#### 错误码
+
+无
+
+### 批量删除账号
+
+维护人：root
+
+#### URL
+
+- 本地开发环境: `POST` http://localhost:10050/api/admin/accounts/deleteBatch
+- 开发环境: `POST` https://tg-live-game.pwtk.cc/api/admin/accounts/deleteBatch
+
+
+描述：批量删除账号
+
+ContentType：`application/json`
+
+#### 请求参数
+
+##### Body Parameter
+
+| 名称 | 类型 | 必填 | 最大长度 | 描述 | 示例值 |
+| --- | --- | --- | --- | --- | --- |
+| ids | List<Long> | 是 | - | ID列表 (ActualType: Long) | [1, 2, 3] |
+
+#### 请求示例
+
+```
+{
+    "ids": [
+        1,
+        2,
+        3
+    ]
+}
+```
+
+#### 响应参数
+
+| 名称 | 类型 | 必填 | 最大长度 | 描述 | 示例值 |
+| --- | --- | --- | --- | --- | --- |
+| success | Boolean | 否 | - | 请求是否成功 | true |
+| errCode | String | 否 | - | 错误码（失败时返回） |  |
+| errMessage | String | 否 | - | 错误信息（失败时返回） |  |
+| data | int32 | 否 | - | 响应数据 (ActualType: Integer) |  |
+
+#### 响应示例
+
+```
+{
+    "success": true,
+    "errCode": "string",
+    "errMessage": "string",
+    "data": 0
+}
+```
+
+#### 错误码
+
+无
+## 角色管理
+
+
+### 获取角色列表（分页）
+
+维护人：root
+
+#### URL
+
+- 本地开发环境: `POST` http://localhost:10050/api/admin/roles/list
+- 开发环境: `POST` https://tg-live-game.pwtk.cc/api/admin/roles/list
+
+
+描述：获取角色列表（分页）
+
+ContentType：`application/json`
+
+#### 请求参数
+
+##### Body Parameter
+
+| 名称 | 类型 | 必填 | 最大长度 | 描述 | 示例值 |
+| --- | --- | --- | --- | --- | --- |
+| page | Integer | 否 | - | 页码 (从1开始) | 1 |
+| size | Integer | 否 | - | 每页条数 | 10 |
+| keyword | String | 否 | - | 搜索关键词 (模糊匹配名称、ID等) | 摄像头 |
+| enabled | Boolean | 否 | - | 启用状态过滤 (null=全部, true=启用, false=禁用) | true |
+| sortBy | String | 否 | - | 排序字段 | createdAt |
+| sortDir | String | 否 | - | 排序方向 (ASC/DESC) | DESC |
+
+#### 请求示例
+
+```
+{
+    "page": 1,
+    "size": 10,
+    "keyword": "摄像头",
+    "enabled": true,
+    "sortBy": "createdAt",
+    "sortDir": "DESC"
+}
+```
+
+#### 响应参数
+
+| 名称 | 类型 | 必填 | 最大长度 | 描述 | 示例值 |
+| --- | --- | --- | --- | --- | --- |
+| success | Boolean | 否 | - | 请求是否成功 | true |
+| errCode | String | 否 | - | 错误码（失败时返回） |  |
+| errMessage | String | 否 | - | 错误信息（失败时返回） |  |
+| data | object | 否 |  | 响应数据 (ActualType: PageResponse) |  |
+|   └ list | List<T> | 否 |  | 数据列表 (ActualType: T) |  |
+|     └ id | Long | 否 | - | 主键ID | 1 |
+|     └ code | String | 否 | - | 角色编码 | ADMIN |
+|     └ name | String | 否 | - | 角色名称 | 管理员 |
+|     └ description | String | 否 | - | 角色说明 | 拥有大部分管理权限 |
+|     └ enabled | Boolean | 否 | - | 是否启用 | true |
+|     └ userCount | Integer | 否 | - | 关联用户数量 | 5 |
+|     └ createdAt | LocalDateTime | 否 | - | 创建时间 | 2026-01-26T10:00:00 |
+|     └ updatedAt | LocalDateTime | 否 | - | 更新时间 | 2026-01-26T10:00:00 |
+|   └ page | Integer | 否 | - | 当前页码 (从1开始) | 1 |
+|   └ size | Integer | 否 | - | 每页条数 | 10 |
+|   └ total | Long | 否 | - | 总记录数 | 100 |
+|   └ totalPages | Integer | 否 | - | 总页数 | 10 |
+|   └ hasNext | Boolean | 否 | - | 是否有下一页 | true |
+|   └ hasPrevious | Boolean | 否 | - | 是否有上一页 | false |
+
+#### 响应示例
+
+```
+{
+    "success": true,
+    "errCode": "string",
+    "errMessage": "string",
+    "data": {
+        "list": [
+            {
+                "id": 1,
+                "code": "ADMIN",
+                "name": "管理员",
+                "description": "拥有大部分管理权限",
+                "enabled": true,
+                "userCount": 5,
+                "createdAt": "2026-01-26T10:00:00",
+                "updatedAt": "2026-01-26T10:00:00"
+            }
+        ],
+        "page": 1,
+        "size": 10,
+        "total": 100,
+        "totalPages": 10,
+        "hasNext": true,
+        "hasPrevious": false
+    }
+}
+```
+
+#### 错误码
+
+无
+
+### 获取全部启用角色（用于下拉选择）
+
+维护人：root
+
+#### URL
+
+- 本地开发环境: `GET` http://localhost:10050/api/admin/roles/listAll
+- 开发环境: `GET` https://tg-live-game.pwtk.cc/api/admin/roles/listAll
+
+
+描述：获取全部启用角色（用于下拉选择）
+
+ContentType：`application/x-www-form-urlencoded;charset=UTF-8`
+
+#### 请求参数
+
+#### 响应参数
+
+| 名称 | 类型 | 必填 | 最大长度 | 描述 | 示例值 |
+| --- | --- | --- | --- | --- | --- |
+| success | Boolean | 否 | - | 请求是否成功 | true |
+| errCode | String | 否 | - | 错误码（失败时返回） |  |
+| errMessage | String | 否 | - | 错误信息（失败时返回） |  |
+| data | array | 否 |  | 响应数据 (ActualType: List) |  |
+|   └ id | Long | 否 | - | 主键ID | 1 |
+|   └ code | String | 否 | - | 角色编码 | ADMIN |
+|   └ name | String | 否 | - | 角色名称 | 管理员 |
+
+#### 响应示例
+
+```
+{
+    "success": true,
+    "errCode": "string",
+    "errMessage": "string",
+    "data": [
+        {
+            "id": 1,
+            "code": "ADMIN",
+            "name": "管理员"
+        }
+    ]
+}
+```
+
+#### 错误码
+
+无
+
+### 获取角色详情
+
+维护人：root
+
+#### URL
+
+- 本地开发环境: `GET` http://localhost:10050/api/admin/roles/detail
+- 开发环境: `GET` https://tg-live-game.pwtk.cc/api/admin/roles/detail
+
+
+描述：获取角色详情
+
+ContentType：`application/x-www-form-urlencoded;charset=UTF-8`
+
+#### 请求参数
+
+##### Query Parameter
+
+| 名称 | 类型 | 必填 | 最大长度 | 描述 | 示例值 |
+| --- | --- | --- | --- | --- | --- |
+| id | int64 | 是 | - | 角色ID | 0 |
+
+#### 响应参数
+
+| 名称 | 类型 | 必填 | 最大长度 | 描述 | 示例值 |
+| --- | --- | --- | --- | --- | --- |
+| success | Boolean | 否 | - | 请求是否成功 | true |
+| errCode | String | 否 | - | 错误码（失败时返回） |  |
+| errMessage | String | 否 | - | 错误信息（失败时返回） |  |
+| data | object | 否 |  | 响应数据 (ActualType: RoleDTO) |  |
+|   └ id | Long | 否 | - | 主键ID | 1 |
+|   └ code | String | 否 | - | 角色编码 | ADMIN |
+|   └ name | String | 否 | - | 角色名称 | 管理员 |
+|   └ description | String | 否 | - | 角色说明 | 拥有大部分管理权限 |
+|   └ enabled | Boolean | 否 | - | 是否启用 | true |
+|   └ userCount | Integer | 否 | - | 关联用户数量 | 5 |
+|   └ createdAt | LocalDateTime | 否 | - | 创建时间 | 2026-01-26T10:00:00 |
+|   └ updatedAt | LocalDateTime | 否 | - | 更新时间 | 2026-01-26T10:00:00 |
+
+#### 响应示例
+
+```
+{
+    "success": true,
+    "errCode": "string",
+    "errMessage": "string",
+    "data": {
+        "id": 1,
+        "code": "ADMIN",
+        "name": "管理员",
+        "description": "拥有大部分管理权限",
+        "enabled": true,
+        "userCount": 5,
+        "createdAt": "2026-01-26T10:00:00",
+        "updatedAt": "2026-01-26T10:00:00"
+    }
+}
+```
+
+#### 错误码
+
+无
+
+### 新增角色
+
+维护人：root
+
+#### URL
+
+- 本地开发环境: `POST` http://localhost:10050/api/admin/roles/add
+- 开发环境: `POST` https://tg-live-game.pwtk.cc/api/admin/roles/add
+
+
+描述：新增角色
+
+ContentType：`application/json`
+
+#### 请求参数
+
+##### Body Parameter
+
+| 名称 | 类型 | 必填 | 最大长度 | 描述 | 示例值 |
+| --- | --- | --- | --- | --- | --- |
+| code | String | 是 | 50 | 角色编码（唯一标识，只允许大写字母、数字和下划线）<br>Validate[max: 50; regexp: ^[A-Z][A-Z0-9_]*$; ] | OPERATOR |
+| name | String | 是 | 100 | 角色名称<br>Validate[max: 100; ] | 操作员 |
+| description | String | 否 | 500 | 角色说明<br>Validate[max: 500; ] | 拥有日常操作权限 |
+
+#### 请求示例
+
+```
+{
+    "code": "OPERATOR",
+    "name": "操作员",
+    "description": "拥有日常操作权限"
+}
+```
+
+#### 响应参数
+
+| 名称 | 类型 | 必填 | 最大长度 | 描述 | 示例值 |
+| --- | --- | --- | --- | --- | --- |
+| success | Boolean | 否 | - | 请求是否成功 | true |
+| errCode | String | 否 | - | 错误码（失败时返回） |  |
+| errMessage | String | 否 | - | 错误信息（失败时返回） |  |
+| data | object | 否 |  | 响应数据 (ActualType: RoleDTO) |  |
+|   └ id | Long | 否 | - | 主键ID | 1 |
+|   └ code | String | 否 | - | 角色编码 | ADMIN |
+|   └ name | String | 否 | - | 角色名称 | 管理员 |
+|   └ description | String | 否 | - | 角色说明 | 拥有大部分管理权限 |
+|   └ enabled | Boolean | 否 | - | 是否启用 | true |
+|   └ userCount | Integer | 否 | - | 关联用户数量 | 5 |
+|   └ createdAt | LocalDateTime | 否 | - | 创建时间 | 2026-01-26T10:00:00 |
+|   └ updatedAt | LocalDateTime | 否 | - | 更新时间 | 2026-01-26T10:00:00 |
+
+#### 响应示例
+
+```
+{
+    "success": true,
+    "errCode": "string",
+    "errMessage": "string",
+    "data": {
+        "id": 1,
+        "code": "ADMIN",
+        "name": "管理员",
+        "description": "拥有大部分管理权限",
+        "enabled": true,
+        "userCount": 5,
+        "createdAt": "2026-01-26T10:00:00",
+        "updatedAt": "2026-01-26T10:00:00"
+    }
+}
+```
+
+#### 错误码
+
+无
+
+### 更新角色
+
+维护人：root
+
+#### URL
+
+- 本地开发环境: `POST` http://localhost:10050/api/admin/roles/update
+- 开发环境: `POST` https://tg-live-game.pwtk.cc/api/admin/roles/update
+
+
+描述：更新角色
+
+ContentType：`application/json`
+
+#### 请求参数
+
+##### Body Parameter
+
+| 名称 | 类型 | 必填 | 最大长度 | 描述 | 示例值 |
+| --- | --- | --- | --- | --- | --- |
+| id | Long | 是 | - | 角色ID | 1 |
+| code | String | 是 | 50 | 角色编码<br>Validate[max: 50; regexp: ^[A-Z][A-Z0-9_]*$; ] | OPERATOR |
+| name | String | 是 | 100 | 角色名称<br>Validate[max: 100; ] | 操作员 |
+| description | String | 否 | 500 | 角色说明<br>Validate[max: 500; ] | 拥有日常操作权限 |
+| enabled | Boolean | 否 | - | 是否启用 | true |
+
+#### 请求示例
+
+```
+{
+    "id": 1,
+    "code": "OPERATOR",
+    "name": "操作员",
+    "description": "拥有日常操作权限",
+    "enabled": true
+}
+```
+
+#### 响应参数
+
+| 名称 | 类型 | 必填 | 最大长度 | 描述 | 示例值 |
+| --- | --- | --- | --- | --- | --- |
+| success | Boolean | 否 | - | 请求是否成功 | true |
+| errCode | String | 否 | - | 错误码（失败时返回） |  |
+| errMessage | String | 否 | - | 错误信息（失败时返回） |  |
+| data | object | 否 |  | 响应数据 (ActualType: RoleDTO) |  |
+|   └ id | Long | 否 | - | 主键ID | 1 |
+|   └ code | String | 否 | - | 角色编码 | ADMIN |
+|   └ name | String | 否 | - | 角色名称 | 管理员 |
+|   └ description | String | 否 | - | 角色说明 | 拥有大部分管理权限 |
+|   └ enabled | Boolean | 否 | - | 是否启用 | true |
+|   └ userCount | Integer | 否 | - | 关联用户数量 | 5 |
+|   └ createdAt | LocalDateTime | 否 | - | 创建时间 | 2026-01-26T10:00:00 |
+|   └ updatedAt | LocalDateTime | 否 | - | 更新时间 | 2026-01-26T10:00:00 |
+
+#### 响应示例
+
+```
+{
+    "success": true,
+    "errCode": "string",
+    "errMessage": "string",
+    "data": {
+        "id": 1,
+        "code": "ADMIN",
+        "name": "管理员",
+        "description": "拥有大部分管理权限",
+        "enabled": true,
+        "userCount": 5,
+        "createdAt": "2026-01-26T10:00:00",
+        "updatedAt": "2026-01-26T10:00:00"
+    }
+}
+```
+
+#### 错误码
+
+无
+
+### 删除角色
+
+维护人：root
+
+#### URL
+
+- 本地开发环境: `POST` http://localhost:10050/api/admin/roles/delete
+- 开发环境: `POST` https://tg-live-game.pwtk.cc/api/admin/roles/delete
+
+
+描述：删除角色
+
+ContentType：`application/x-www-form-urlencoded;charset=UTF-8`
+
+#### 请求参数
+
+##### Query Parameter
+
+| 名称 | 类型 | 必填 | 最大长度 | 描述 | 示例值 |
+| --- | --- | --- | --- | --- | --- |
+| id | int64 | 是 | - | 角色ID | 0 |
+
+#### 响应参数
+
+| 名称 | 类型 | 必填 | 最大长度 | 描述 | 示例值 |
+| --- | --- | --- | --- | --- | --- |
+| success | Boolean | 否 | - | 请求是否成功 | true |
+| errCode | String | 否 | - | 错误码（失败时返回） |  |
+| errMessage | String | 否 | - | 错误信息（失败时返回） |  |
+| data | object | 否 | - | 响应数据 (ActualType: Void) |  |
+
+#### 响应示例
+
+```
+{
+    "success": true,
+    "errCode": "string",
+    "errMessage": "string",
+    "data": {}
+}
+```
+
+#### 错误码
+
+无
+
+### 批量删除角色
+
+维护人：root
+
+#### URL
+
+- 本地开发环境: `POST` http://localhost:10050/api/admin/roles/deleteBatch
+- 开发环境: `POST` https://tg-live-game.pwtk.cc/api/admin/roles/deleteBatch
+
+
+描述：批量删除角色
+
+ContentType：`application/json`
+
+#### 请求参数
+
+##### Body Parameter
+
+| 名称 | 类型 | 必填 | 最大长度 | 描述 | 示例值 |
+| --- | --- | --- | --- | --- | --- |
+| ids | List<Long> | 是 | - | ID列表 (ActualType: Long) | [1, 2, 3] |
+
+#### 请求示例
+
+```
+{
+    "ids": [
+        1,
+        2,
+        3
+    ]
+}
+```
+
+#### 响应参数
+
+| 名称 | 类型 | 必填 | 最大长度 | 描述 | 示例值 |
+| --- | --- | --- | --- | --- | --- |
+| success | Boolean | 否 | - | 请求是否成功 | true |
+| errCode | String | 否 | - | 错误码（失败时返回） |  |
+| errMessage | String | 否 | - | 错误信息（失败时返回） |  |
+| data | int32 | 否 | - | 响应数据 (ActualType: Integer) |  |
+
+#### 响应示例
+
+```
+{
+    "success": true,
+    "errCode": "string",
+    "errMessage": "string",
+    "data": 0
+}
+```
+
+#### 错误码
+
+无