优化

2026-08-17 19:51:54 +08:00
parent cddd23e4c7
commit 45b51415cf
84 changed files with 1278 additions and 158 deletions
@@ -502,7 +502,11 @@ paths:
      tags: [Merchant Tenant / 商户企业]
      summary: List enterprise members / 查询企业成员
      responses:
-        '200': {$ref: '#/components/responses/Success'}
+        '200':
+          description: 企业成员列表，包含真实登录账号与最后登录时间
+          content:
+            application/json:
+              schema: {$ref: '#/components/schemas/MerchantMemberListApiResponse'}
        '403': {$ref: '#/components/responses/Forbidden'}
    post:
      tags: [Merchant Tenant / 商户企业]
@@ -514,7 +518,11 @@ paths:
          application/json:
            schema: {$ref: '#/components/schemas/CreateMemberRequest'}
      responses:
-        '200': {$ref: '#/components/responses/Success'}
+        '200':
+          description: 新增后的企业成员
+          content:
+            application/json:
+              schema: {$ref: '#/components/schemas/MerchantMemberApiResponse'}
        '400': {$ref: '#/components/responses/BadRequest'}
        '403': {$ref: '#/components/responses/Forbidden'}
        '409': {$ref: '#/components/responses/Conflict'}
@@ -530,7 +538,11 @@ paths:
      summary: 查询成员详情及当前角色
      description: 返回当前客户成员资料，roleIds 为服务端实时查询的当前角色集合；跨客户成员按不存在处理。
      responses:
-        '200': {$ref: '#/components/responses/Success'}
+        '200':
+          description: 企业成员详情
+          content:
+            application/json:
+              schema: {$ref: '#/components/schemas/MerchantMemberApiResponse'}
        '403': {$ref: '#/components/responses/Forbidden'}
        '404': {$ref: '#/components/responses/NotFound'}
    put:
@@ -543,7 +555,11 @@ paths:
          application/json:
            schema: {$ref: '#/components/schemas/UpdateMemberRequest'}
      responses:
-        '200': {$ref: '#/components/responses/Success'}
+        '200':
+          description: 更新后的企业成员
+          content:
+            application/json:
+              schema: {$ref: '#/components/schemas/MerchantMemberApiResponse'}
        '403': {$ref: '#/components/responses/Forbidden'}
        '404': {$ref: '#/components/responses/NotFound'}
        '409': {$ref: '#/components/responses/Conflict'}
@@ -552,7 +568,11 @@ paths:
      tags: [IAM Resources / IAM 资源]
      summary: List tenant addresses / 查询企业地址
      responses:
-        '200': {$ref: '#/components/responses/Success'}
+        '200':
+          description: 角色列表及各角色实时成员数
+          content:
+            application/json:
+              schema: {$ref: '#/components/schemas/RoleListApiResponse'}
        '403': {$ref: '#/components/responses/Forbidden'}
    post:
      tags: [IAM Resources / IAM 资源]
@@ -563,7 +583,11 @@ paths:
          application/json:
            schema: {$ref: '#/components/schemas/AddressRequest'}
      responses:
-        '200': {$ref: '#/components/responses/Success'}
+        '200':
+          description: 新增后的角色及实时成员数
+          content:
+            application/json:
+              schema: {$ref: '#/components/schemas/RoleApiResponse'}
        '400': {$ref: '#/components/responses/BadRequest'}
        '403': {$ref: '#/components/responses/Forbidden'}
  /api/merchant/v1/iam/tenant/qualifications:
@@ -887,6 +911,60 @@ components:
              type: array
              uniqueItems: true
              items: {type: string}
+    MerchantMemberResponse:
+      type: object
+      required: [membershipId, userId, authUserId, username, displayName, memberType, status, lastLoginAt, roleIds]
+      properties:
+        membershipId: {type: string, pattern: '^\d+$'}
+        userId: {type: string, pattern: '^\d+$'}
+        authUserId: {type: string, pattern: '^\d+$'}
+        username: {type: string, description: 统一认证登录账号}
+        displayName: {type: string}
+        phone: {type: string, nullable: true}
+        email: {type: string, format: email, nullable: true}
+        memberType: {type: string, enum: [OWNER, EMPLOYEE]}
+        memberNo: {type: string, nullable: true, description: 企业内部成员编号，不作为登录账号}
+        status: {type: string, enum: [ACTIVE, DISABLED]}
+        lastLoginAt: {type: string, format: date-time, nullable: true, description: 从 Auth 账号事实返回；null 表示从未登录}
+        roleIds: {type: array, items: {type: string, pattern: '^\d+$'}}
+    MerchantMemberListApiResponse:
+      allOf:
+        - {$ref: '#/components/schemas/ApiResponse'}
+        - type: object
+          properties:
+            data: {type: array, items: {$ref: '#/components/schemas/MerchantMemberResponse'}}
+    MerchantMemberApiResponse:
+      allOf:
+        - {$ref: '#/components/schemas/ApiResponse'}
+        - type: object
+          properties:
+            data: {$ref: '#/components/schemas/MerchantMemberResponse'}
+    RoleResponse:
+      type: object
+      required: [id, tenantId, appCode, roleCode, roleName, roleType, status, memberCount, permissionIds]
+      properties:
+        id: {type: string, pattern: '^\d+$'}
+        tenantId: {type: string, pattern: '^\d+$'}
+        appCode: {type: string, enum: [PLATFORM, MERCHANT]}
+        roleCode: {type: string}
+        roleName: {type: string}
+        roleType: {type: string, enum: [SYSTEM, CUSTOM]}
+        status: {type: string, enum: [ACTIVE, DISABLED]}
+        description: {type: string, nullable: true}
+        memberCount: {type: integer, format: int64, minimum: 0, description: 当前客户及应用域内分配该角色的成员数}
+        permissionIds: {type: array, uniqueItems: true, items: {type: string, pattern: '^\d+$'}}
+    RoleListApiResponse:
+      allOf:
+        - {$ref: '#/components/schemas/ApiResponse'}
+        - type: object
+          properties:
+            data: {type: array, items: {$ref: '#/components/schemas/RoleResponse'}}
+    RoleApiResponse:
+      allOf:
+        - {$ref: '#/components/schemas/ApiResponse'}
+        - type: object
+          properties:
+            data: {$ref: '#/components/schemas/RoleResponse'}
    TenantPageApiResponse:
      allOf:
        - {$ref: '#/components/schemas/ApiResponse'}