add doc

docs/api_torna/user-and-role.md

@@ -4,7 +4,6 @@
 
 ## 账号管理
 
-
 ### 获取账号列表（分页）
 
 维护人：root
@@ -14,7 +13,6 @@
 - 本地开发环境: `POST` http://localhost:10050/api/admin/accounts/list
 - 开发环境: `POST` https://tg-live-game.pwtk.cc/api/admin/accounts/list
 
-
 描述：获取账号列表（分页）
 
 ContentType：`application/json`
@@ -23,14 +21,14 @@ 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    | Integer | 否   | -        | 页码 (从 1 开始)                                | 1         |
+| size    | Integer | 否   | -        | 每页条数                                        | 10        |
+| keyword | String  | 否   | -        | 搜索关键词 (模糊匹配名称、ID 等)                | 摄像头    |
+| enabled | Boolean | 否   | -        | 启用状态过滤 (null=全部, true=启用, false=禁用) | true      |
+| sortBy  | String  | 否   | -        | 排序字段                                        | createdAt |
+| sortDir | String  | 否   | -        | 排序方向 (ASC/DESC)                             | DESC      |
 
 #### 请求示例
 
@@ -53,24 +51,24 @@ ContentType：`application/json`
 | 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 |
+| └ 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 |
 
 #### 响应示例
 
@@ -121,7 +119,6 @@ ContentType：`application/json`
 - 本地开发环境: `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`
@@ -130,9 +127,9 @@ ContentType：`application/x-www-form-urlencoded;charset=UTF-8`
 
 ##### Query Parameter
 
-| 名称 | 类型 | 必填 | 最大长度 | 描述 | 示例值 |
-| --- | --- | --- | --- | --- | --- |
-| id | int64 | 是 | - | 账号ID | 0 |
+| 名称 | 类型  | 必填 | 最大长度 | 描述    | 示例值 |
+| ---- | ----- | ---- | -------- | ------- | ------ |
+| id   | int64 | 是   | -        | 账号 ID | 0      |
 
 #### 响应参数
 
@@ -142,17 +139,17 @@ ContentType：`application/x-www-form-urlencoded;charset=UTF-8`
 | 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 |
+| └ 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 |
 
 #### 响应示例
 
@@ -193,7 +190,6 @@ ContentType：`application/x-www-form-urlencoded;charset=UTF-8`
 - 本地开发环境: `POST` http://localhost:10050/api/admin/accounts/add
 - 开发环境: `POST` https://tg-live-game.pwtk.cc/api/admin/accounts/add
 
-
 描述：新增账号
 
 ContentType：`application/json`
@@ -202,12 +198,12 @@ 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 | 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]     |
 
 #### 请求示例
 
@@ -231,17 +227,17 @@ ContentType：`application/json`
 | 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 |
+| └ 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 |
 
 #### 响应示例
 
@@ -282,7 +278,6 @@ ContentType：`application/json`
 - 本地开发环境: `POST` http://localhost:10050/api/admin/accounts/update
 - 开发环境: `POST` https://tg-live-game.pwtk.cc/api/admin/accounts/update
 
-
 描述：更新账号
 
 ContentType：`application/json`
@@ -291,13 +286,13 @@ 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       | 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]         |
 
 #### 请求示例
 
@@ -322,17 +317,17 @@ ContentType：`application/json`
 | 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 |
+| └ 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 |
 
 #### 响应示例
 
@@ -373,7 +368,6 @@ ContentType：`application/json`
 - 本地开发环境: `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`
@@ -382,18 +376,18 @@ ContentType：`application/x-www-form-urlencoded;charset=UTF-8`
 
 ##### Query Parameter
 
-| 名称 | 类型 | 必填 | 最大长度 | 描述 | 示例值 |
-| --- | --- | --- | --- | --- | --- |
-| id | int64 | 是 | - | 账号ID | 0 |
+| 名称 | 类型  | 必填 | 最大长度 | 描述    | 示例值 |
+| ---- | ----- | ---- | -------- | ------- | ------ |
+| id   | int64 | 是   | -        | 账号 ID | 0      |
 
 #### 响应参数
 
-| 名称 | 类型 | 必填 | 最大长度 | 描述 | 示例值 |
-| --- | --- | --- | --- | --- | --- |
-| success | Boolean | 否 | - | 请求是否成功 | true |
-| errCode | String | 否 | - | 错误码（失败时返回） |  |
-| errMessage | String | 否 | - | 错误信息（失败时返回） |  |
-| data | object | 否 | - | 响应数据 (ActualType: Void) |  |
+| 名称       | 类型    | 必填 | 最大长度 | 描述                        | 示例值 |
+| ---------- | ------- | ---- | -------- | --------------------------- | ------ |
+| success    | Boolean | 否   | -        | 请求是否成功                | true   |
+| errCode    | String  | 否   | -        | 错误码（失败时返回）        |        |
+| errMessage | String  | 否   | -        | 错误信息（失败时返回）      |        |
+| data       | object  | 否   | -        | 响应数据 (ActualType: Void) |        |
 
 #### 响应示例
 
@@ -419,7 +413,6 @@ ContentType：`application/x-www-form-urlencoded;charset=UTF-8`
 - 本地开发环境: `POST` http://localhost:10050/api/admin/accounts/deleteBatch
 - 开发环境: `POST` https://tg-live-game.pwtk.cc/api/admin/accounts/deleteBatch
 
-
 描述：批量删除账号
 
 ContentType：`application/json`
@@ -428,9 +421,9 @@ ContentType：`application/json`
 
 ##### Body Parameter
 
-| 名称 | 类型 | 必填 | 最大长度 | 描述 | 示例值 |
-| --- | --- | --- | --- | --- | --- |
-| ids | List<Long> | 是 | - | ID列表 (ActualType: Long) | [1, 2, 3] |
+| 名称 | 类型       | 必填 | 最大长度 | 描述                       | 示例值    |
+| ---- | ---------- | ---- | -------- | -------------------------- | --------- |
+| ids  | List<Long> | 是   | -        | ID 列表 (ActualType: Long) | [1, 2, 3] |
 
 #### 请求示例
 
@@ -446,12 +439,12 @@ ContentType：`application/json`
 
 #### 响应参数
 
-| 名称 | 类型 | 必填 | 最大长度 | 描述 | 示例值 |
-| --- | --- | --- | --- | --- | --- |
-| success | Boolean | 否 | - | 请求是否成功 | true |
-| errCode | String | 否 | - | 错误码（失败时返回） |  |
-| errMessage | String | 否 | - | 错误信息（失败时返回） |  |
-| data | int32 | 否 | - | 响应数据 (ActualType: Integer) |  |
+| 名称       | 类型    | 必填 | 最大长度 | 描述                           | 示例值 |
+| ---------- | ------- | ---- | -------- | ------------------------------ | ------ |
+| success    | Boolean | 否   | -        | 请求是否成功                   | true   |
+| errCode    | String  | 否   | -        | 错误码（失败时返回）           |        |
+| errMessage | String  | 否   | -        | 错误信息（失败时返回）         |        |
+| data       | int32   | 否   | -        | 响应数据 (ActualType: Integer) |        |
 
 #### 响应示例
 
@@ -467,8 +460,8 @@ ContentType：`application/json`
 #### 错误码
 
 无
-## 角色管理
 
+## 角色管理
 
 ### 获取角色列表（分页）
 
@@ -479,7 +472,6 @@ ContentType：`application/json`
 - 本地开发环境: `POST` http://localhost:10050/api/admin/roles/list
 - 开发环境: `POST` https://tg-live-game.pwtk.cc/api/admin/roles/list
 
-
 描述：获取角色列表（分页）
 
 ContentType：`application/json`
@@ -488,14 +480,14 @@ 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    | Integer | 否   | -        | 页码 (从 1 开始)                                | 1         |
+| size    | Integer | 否   | -        | 每页条数                                        | 10        |
+| keyword | String  | 否   | -        | 搜索关键词 (模糊匹配名称、ID 等)                | 摄像头    |
+| enabled | Boolean | 否   | -        | 启用状态过滤 (null=全部, true=启用, false=禁用) | true      |
+| sortBy  | String  | 否   | -        | 排序字段                                        | createdAt |
+| sortDir | String  | 否   | -        | 排序方向 (ASC/DESC)                             | DESC      |
 
 #### 请求示例
 
@@ -512,27 +504,27 @@ ContentType：`application/json`
 
 #### 响应参数
 
-| 名称 | 类型 | 必填 | 最大长度 | 描述 | 示例值 |
-| --- | --- | --- | --- | --- | --- |
-| 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       | 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               |
 
 #### 响应示例
 
@@ -577,7 +569,6 @@ ContentType：`application/json`
 - 本地开发环境: `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`
@@ -586,15 +577,15 @@ 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    | Boolean | 否   | -        | 请求是否成功                | true   |
+| errCode    | String  | 否   | -        | 错误码（失败时返回）        |        |
+| errMessage | String  | 否   | -        | 错误信息（失败时返回）      |        |
+| data       | array   | 否   |          | 响应数据 (ActualType: List) |        |
+| └ id       | Long    | 否   | -        | 主键 ID                     | 1      |
+| └ code     | String  | 否   | -        | 角色编码                    | ADMIN  |
+| └ name     | String  | 否   | -        | 角色名称                    | 管理员 |
 
 #### 响应示例
 
@@ -626,7 +617,6 @@ ContentType：`application/x-www-form-urlencoded;charset=UTF-8`
 - 本地开发环境: `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`
@@ -635,26 +625,26 @@ ContentType：`application/x-www-form-urlencoded;charset=UTF-8`
 
 ##### Query Parameter
 
-| 名称 | 类型 | 必填 | 最大长度 | 描述 | 示例值 |
-| --- | --- | --- | --- | --- | --- |
-| id | int64 | 是 | - | 角色ID | 0 |
+| 名称 | 类型  | 必填 | 最大长度 | 描述    | 示例值 |
+| ---- | ----- | ---- | -------- | ------- | ------ |
+| 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       | 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 |
 
 #### 响应示例
 
@@ -689,7 +679,6 @@ ContentType：`application/x-www-form-urlencoded;charset=UTF-8`
 - 本地开发环境: `POST` http://localhost:10050/api/admin/roles/add
 - 开发环境: `POST` https://tg-live-game.pwtk.cc/api/admin/roles/add
 
-
 描述：新增角色
 
 ContentType：`application/json`
@@ -700,7 +689,7 @@ ContentType：`application/json`
 
 | 名称 | 类型 | 必填 | 最大长度 | 描述 | 示例值 |
 | --- | --- | --- | --- | --- | --- |
-| code | String | 是 | 50 | 角色编码（唯一标识，只允许大写字母、数字和下划线）<br>Validate[max: 50; regexp: ^[A-Z][A-Z0-9_]*$; ] | OPERATOR |
+| 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; ] | 拥有日常操作权限 |
 
@@ -716,20 +705,20 @@ ContentType：`application/json`
 
 #### 响应参数
 
-| 名称 | 类型 | 必填 | 最大长度 | 描述 | 示例值 |
-| --- | --- | --- | --- | --- | --- |
-| 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       | 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 |
 
 #### 响应示例
 
@@ -764,7 +753,6 @@ ContentType：`application/json`
 - 本地开发环境: `POST` http://localhost:10050/api/admin/roles/update
 - 开发环境: `POST` https://tg-live-game.pwtk.cc/api/admin/roles/update
 
-
 描述：更新角色
 
 ContentType：`application/json`
@@ -775,8 +763,8 @@ ContentType：`application/json`
 
 | 名称 | 类型 | 必填 | 最大长度 | 描述 | 示例值 |
 | --- | --- | --- | --- | --- | --- |
-| id | Long | 是 | - | 角色ID | 1 |
-| code | String | 是 | 50 | 角色编码<br>Validate[max: 50; regexp: ^[A-Z][A-Z0-9_]*$; ] | OPERATOR |
+| 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 |
@@ -795,20 +783,20 @@ ContentType：`application/json`
 
 #### 响应参数
 
-| 名称 | 类型 | 必填 | 最大长度 | 描述 | 示例值 |
-| --- | --- | --- | --- | --- | --- |
-| 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       | 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 |
 
 #### 响应示例
 
@@ -843,7 +831,6 @@ ContentType：`application/json`
 - 本地开发环境: `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`
@@ -852,18 +839,18 @@ ContentType：`application/x-www-form-urlencoded;charset=UTF-8`
 
 ##### Query Parameter
 
-| 名称 | 类型 | 必填 | 最大长度 | 描述 | 示例值 |
-| --- | --- | --- | --- | --- | --- |
-| id | int64 | 是 | - | 角色ID | 0 |
+| 名称 | 类型  | 必填 | 最大长度 | 描述    | 示例值 |
+| ---- | ----- | ---- | -------- | ------- | ------ |
+| id   | int64 | 是   | -        | 角色 ID | 0      |
 
 #### 响应参数
 
-| 名称 | 类型 | 必填 | 最大长度 | 描述 | 示例值 |
-| --- | --- | --- | --- | --- | --- |
-| success | Boolean | 否 | - | 请求是否成功 | true |
-| errCode | String | 否 | - | 错误码（失败时返回） |  |
-| errMessage | String | 否 | - | 错误信息（失败时返回） |  |
-| data | object | 否 | - | 响应数据 (ActualType: Void) |  |
+| 名称       | 类型    | 必填 | 最大长度 | 描述                        | 示例值 |
+| ---------- | ------- | ---- | -------- | --------------------------- | ------ |
+| success    | Boolean | 否   | -        | 请求是否成功                | true   |
+| errCode    | String  | 否   | -        | 错误码（失败时返回）        |        |
+| errMessage | String  | 否   | -        | 错误信息（失败时返回）      |        |
+| data       | object  | 否   | -        | 响应数据 (ActualType: Void) |        |
 
 #### 响应示例
 
@@ -889,7 +876,6 @@ ContentType：`application/x-www-form-urlencoded;charset=UTF-8`
 - 本地开发环境: `POST` http://localhost:10050/api/admin/roles/deleteBatch
 - 开发环境: `POST` https://tg-live-game.pwtk.cc/api/admin/roles/deleteBatch
 
-
 描述：批量删除角色
 
 ContentType：`application/json`
@@ -898,9 +884,9 @@ ContentType：`application/json`
 
 ##### Body Parameter
 
-| 名称 | 类型 | 必填 | 最大长度 | 描述 | 示例值 |
-| --- | --- | --- | --- | --- | --- |
-| ids | List<Long> | 是 | - | ID列表 (ActualType: Long) | [1, 2, 3] |
+| 名称 | 类型       | 必填 | 最大长度 | 描述                       | 示例值    |
+| ---- | ---------- | ---- | -------- | -------------------------- | --------- |
+| ids  | List<Long> | 是   | -        | ID 列表 (ActualType: Long) | [1, 2, 3] |
 
 #### 请求示例
 
@@ -916,12 +902,12 @@ ContentType：`application/json`
 
 #### 响应参数
 
-| 名称 | 类型 | 必填 | 最大长度 | 描述 | 示例值 |
-| --- | --- | --- | --- | --- | --- |
-| success | Boolean | 否 | - | 请求是否成功 | true |
-| errCode | String | 否 | - | 错误码（失败时返回） |  |
-| errMessage | String | 否 | - | 错误信息（失败时返回） |  |
-| data | int32 | 否 | - | 响应数据 (ActualType: Integer) |  |
+| 名称       | 类型    | 必填 | 最大长度 | 描述                           | 示例值 |
+| ---------- | ------- | ---- | -------- | ------------------------------ | ------ |
+| success    | Boolean | 否   | -        | 请求是否成功                   | true   |
+| errCode    | String  | 否   | -        | 错误码（失败时返回）           |        |
+| errMessage | String  | 否   | -        | 错误信息（失败时返回）         |        |
+| data       | int32   | 否   | -        | 响应数据 (ActualType: Integer) |        |
 
 #### 响应示例