rogee/quyun-v2
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

tenant: add member management APIs

Browse Source
This commit is contained in:
Rogee
2025-12-18 17:29:17 +08:00
parent 5029234e47
commit de574bbd9d
11 changed files with 815 additions and 14 deletions
Download Patch File Download Diff File Expand all files Collapse all files

170
backend/docs/swagger.json
View File

@@ -797,6 +797,154 @@
}
}
},
"/t/{tenantCode}/v1/admin/users": {
"get": {
"consumes": [
"application/json"
],
"produces": [
"application/json"
],
"tags": [
"Tenant"
],
"summary": "成员列表（租户管理）",
"parameters": [
{
"type": "string",
"description": "Tenant Code",
"name": "tenantCode",
"in": "path",
"required": true
},
{
"type": "integer",
"description": "Limit is page size; only values in {10,20,50,100} are accepted (otherwise defaults to 10).",
"name": "limit",
"in": "query"
},
{
"type": "integer",
"description": "Page is 1-based page index; values \u003c= 0 are normalized to 1.",
"name": "page",
"in": "query"
},
{
"type": "integer",
"description": "UserID 按用户ID过滤（可选）。",
"name": "user_id",
"in": "query"
}
],
"responses": {
"200": {
"description": "OK",
"schema": {
"allOf": [
{
"$ref": "#/definitions/requests.Pager"
},
{
"type": "object",
"properties": {
"items": {
"$ref": "#/definitions/models.TenantUser"
}
}
}
]
}
}
}
}
},
"/t/{tenantCode}/v1/admin/users/{userID}/join": {
"post": {
"consumes": [
"application/json"
],
"produces": [
"application/json"
],
"tags": [
"Tenant"
],
"summary": "添加租户成员（租户管理）",
"parameters": [
{
"type": "string",
"description": "Tenant Code",
"name": "tenantCode",
"in": "path",
"required": true
},
{
"type": "integer",
"format": "int64",
"description": "UserID",
"name": "userID",
"in": "path",
"required": true
}
],
"responses": {
"200": {
"description": "OK",
"schema": {
"$ref": "#/definitions/dto.AdminTenantUserJoinResponse"
}
}
}
}
},
"/t/{tenantCode}/v1/admin/users/{userID}/role": {
"patch": {
"consumes": [
"application/json"
],
"produces": [
"application/json"
],
"tags": [
"Tenant"
],
"summary": "设置成员角色（租户管理）",
"parameters": [
{
"type": "string",
"description": "Tenant Code",
"name": "tenantCode",
"in": "path",
"required": true
},
{
"type": "integer",
"format": "int64",
"description": "UserID",
"name": "userID",
"in": "path",
"required": true
},
{
"description": "Form",
"name": "form",
"in": "body",
"required": true,
"schema": {
"$ref": "#/definitions/dto.AdminTenantUserRoleUpdateForm"
}
}
],
"responses": {
"200": {
"description": "OK",
"schema": {
"$ref": "#/definitions/dto.AdminTenantUserJoinResponse"
}
}
}
}
},
"/t/{tenantCode}/v1/admin/users/{userID}/topup": {
"post": {
"consumes": [
@@ -1547,6 +1695,28 @@
}
}
},
"dto.AdminTenantUserJoinResponse": {
"type": "object",
"properties": {
"tenant_user": {
"description": "TenantUser 租户成员关系记录。",
"allOf": [
{
"$ref": "#/definitions/models.TenantUser"
}
]
}
}
},
"dto.AdminTenantUserRoleUpdateForm": {
"type": "object",
"properties": {
"role": {
"description": "Role 角色：member/tenant_admin。",
"type": "string"
}
}
},
"dto.AdminTopupForm": {
"type": "object",
"properties": {