✨ 新增几大中心功能

server/docs/swagger.yaml

@@ -1,4 +1,166 @@
 definitions:
+  admin.appInviteCodeDetailResponse:
+    properties:
+      code:
+        $ref: '#/definitions/app.AppInviteCode'
+      invitee:
+        properties:
+          id:
+            type: integer
+          username:
+            type: string
+        type: object
+      inviter:
+        properties:
+          id:
+            type: integer
+          username:
+            type: string
+        type: object
+      relation:
+        $ref: '#/definitions/app.AppUserInviteRelation'
+    type: object
+  admin.appUserDetailItem:
+    properties:
+      enable:
+        type: integer
+      id:
+        type: integer
+      nickName:
+        type: string
+      username:
+        type: string
+      uuid:
+        type: string
+      welcomePhrase:
+        type: string
+    type: object
+  admin.clearUnusedRequest:
+    properties:
+      scope:
+        description: active|all
+        type: string
+      userId:
+        type: integer
+    required:
+    - userId
+    type: object
+  admin.createAppUserRequest:
+    properties:
+      enable:
+        type: boolean
+      nickName:
+        type: string
+      password:
+        maxLength: 128
+        minLength: 6
+        type: string
+      username:
+        maxLength: 64
+        minLength: 3
+        type: string
+      welcomePhrase:
+        type: string
+    required:
+    - password
+    - username
+    type: object
+  admin.issueInviteCodeRequest:
+    properties:
+      expireHours:
+        type: integer
+      userId:
+        type: integer
+    required:
+    - userId
+    type: object
+  admin.issueInviteCodeResponse:
+    properties:
+      code:
+        type: string
+      codeLast4:
+        type: string
+      expiresAt:
+        type: string
+    type: object
+  admin.rechargeRequest:
+    properties:
+      assetType:
+        type: string
+      deltaLi:
+        type: integer
+      reason:
+        type: string
+      rechargeType:
+        type: string
+    required:
+    - assetType
+    - deltaLi
+    - reason
+    - rechargeType
+    type: object
+  admin.resetPasswordRequest:
+    properties:
+      newPassword:
+        maxLength: 128
+        minLength: 6
+        type: string
+    required:
+    - newPassword
+    type: object
+  admin.updateAppUserRequest:
+    properties:
+      enable:
+        type: boolean
+      welcomePhrase:
+        type: string
+    type: object
+  app.AppInviteCode:
+    properties:
+      codeLast4:
+        type: string
+      createdAt:
+        type: string
+      createdByUserId:
+        type: integer
+      expiresAt:
+        type: string
+      id:
+        type: integer
+      status:
+        $ref: '#/definitions/app.InviteCodeStatus'
+      updatedAt:
+        type: string
+      usedAt:
+        type: string
+      usedByUserId:
+        type: integer
+    type: object
+  app.AppUserInviteRelation:
+    properties:
+      createdAt:
+        type: string
+      id:
+        type: integer
+      inviteCodeId:
+        type: integer
+      inviteeUserId:
+        type: integer
+      inviterUserId:
+        type: integer
+    type: object
+  app.InviteCodeStatus:
+    enum:
+    - unused
+    - used
+    - revoked
+    - expired
+    type: string
+    x-enum-varnames:
+    - InviteCodeStatusUnused
+    - InviteCodeStatusUsed
+    - InviteCodeStatusRevoked
+    - InviteCodeStatusExpired
   common.ExaAttachmentCategory:
     properties:
       ID:
@@ -216,11 +378,6 @@ definitions:
         description: 收件人:多个以英文逗号分隔 例：a@qq.com b@qq.com 正式开发中请把此项目作为参数使用
         type: string
     type: object
-  config.Excel:
-    properties:
-      dir:
-        type: string
-    type: object
   config.HuaWeiObs:
     properties:
       access-key:
@@ -251,8 +408,11 @@ definitions:
     type: object
   config.Local:
     properties:
+      base-url:
+        description: 文件访问域名前缀，如 https://api.wanjia.ai
+        type: string
       path:
-        description: 本地文件访问路径
+        description: 本地文件访问路径（相对路径）
         type: string
       store-path:
         description: 本地文件存储路径
@@ -597,8 +757,6 @@ definitions:
         type: array
       email:
         $ref: '#/definitions/config.Email'
-      excel:
-        $ref: '#/definitions/config.Excel'
       hua-wei-obs:
         $ref: '#/definitions/config.HuaWeiObs'
       jwt:
@@ -812,6 +970,21 @@ definitions:
         description: 栈名
         type: string
     type: object
+  git_echol_cn_loser_Go-Web-Template_server_model_system_request.Login:
+    properties:
+      captcha:
+        description: 验证码
+        type: string
+      captchaId:
+        description: 验证码ID
+        type: string
+      password:
+        description: 密码
+        type: string
+      username:
+        description: 用户名
+        type: string
+    type: object
   request.AddMenuAuthorityInfo:
     properties:
       authorityId:
@@ -951,21 +1124,6 @@ definitions:
     - adminPassword
     - dbName
     type: object
-  request.Login:
-    properties:
-      captcha:
-        description: 验证码
-        type: string
-      captchaId:
-        description: 验证码ID
-        type: string
-      password:
-        description: 密码
-        type: string
-      username:
-        description: 用户名
-        type: string
-    type: object
   request.PageInfo:
     properties:
       keyword:
@@ -1231,6 +1389,15 @@ definitions:
       user:
         $ref: '#/definitions/system.SysUser'
     type: object
+  system.InviteCodeGenerated:
+    properties:
+      code:
+        type: string
+      codeLast4:
+        type: string
+      expiresAt:
+        type: string
+    type: object
   system.Meta:
     properties:
       activeName:
@@ -1691,18 +1858,410 @@ definitions:
       uuid:
         description: 用户UUID
         type: string
+      welcomePhrase:
+        description: 安全欢迎词（用户自定义）
+        type: string
     type: object
   system.System:
     properties:
       config:
         $ref: '#/definitions/config.Server'
     type: object
+  system.inviteCodeCurrentResponse:
+    properties:
+      hasUnused:
+        type: boolean
+      record: {}
+    type: object
 info:
   contact: {}
   description: 使用gin+react进行极速开发的全栈开发基础平台
   title: Gin-React-Admin Swagger API接口文档
   version: v2.9.1
 paths:
+  /admin/app-invite-codes:
+    get:
+      parameters:
+      - default: 1
+        description: 页码
+        in: query
+        name: page
+        type: integer
+      - default: 10
+        description: 每页大小
+        in: query
+        name: pageSize
+        type: integer
+      - description: 状态 unused|used|revoked|expired
+        in: query
+        name: status
+        type: string
+      - description: 邀请人用户ID
+        in: query
+        name: createdByUserId
+        type: integer
+      - description: 使用人用户ID
+        in: query
+        name: usedByUserId
+        type: integer
+      - description: 末4位
+        in: query
+        name: codeLast4
+        type: string
+      produces:
+      - application/json
+      responses:
+        "200":
+          description: 获取成功
+          schema:
+            allOf:
+            - $ref: '#/definitions/response.Response'
+            - properties:
+                data:
+                  $ref: '#/definitions/response.PageResult'
+                msg:
+                  type: string
+              type: object
+      security:
+      - ApiKeyAuth: []
+      summary: 后台获取玩家邀请码列表
+      tags:
+      - AppInviteCodesAdmin
+  /admin/app-invite-codes/{id}:
+    get:
+      parameters:
+      - description: 邀请码ID
+        in: path
+        name: id
+        required: true
+        type: integer
+      produces:
+      - application/json
+      responses:
+        "200":
+          description: 获取成功
+          schema:
+            allOf:
+            - $ref: '#/definitions/response.Response'
+            - properties:
+                data:
+                  $ref: '#/definitions/admin.appInviteCodeDetailResponse'
+                msg:
+                  type: string
+              type: object
+      security:
+      - ApiKeyAuth: []
+      summary: 后台获取玩家邀请码详情
+      tags:
+      - AppInviteCodesAdmin
+  /admin/app-invite-codes/{id}/revoke:
+    post:
+      parameters:
+      - description: 邀请码ID
+        in: path
+        name: id
+        required: true
+        type: integer
+      produces:
+      - application/json
+      responses:
+        "200":
+          description: 作废成功
+          schema:
+            allOf:
+            - $ref: '#/definitions/response.Response'
+            - properties:
+                msg:
+                  type: string
+              type: object
+      security:
+      - ApiKeyAuth: []
+      summary: 作废玩家邀请码
+      tags:
+      - AppInviteCodesAdmin
+  /admin/app-invite-codes/clear-unused:
+    post:
+      parameters:
+      - description: 用户ID
+        in: body
+        name: data
+        required: true
+        schema:
+          $ref: '#/definitions/admin.clearUnusedRequest'
+      produces:
+      - application/json
+      responses:
+        "200":
+          description: 清空成功
+          schema:
+            allOf:
+            - $ref: '#/definitions/response.Response'
+            - properties:
+                msg:
+                  type: string
+              type: object
+      security:
+      - ApiKeyAuth: []
+      summary: 强制清空用户未使用邀请码（批量作废）
+      tags:
+      - AppInviteCodesAdmin
+  /admin/app-invite-codes/issue:
+    post:
+      parameters:
+      - description: 用户ID
+        in: body
+        name: data
+        required: true
+        schema:
+          $ref: '#/definitions/admin.issueInviteCodeRequest'
+      produces:
+      - application/json
+      responses:
+        "200":
+          description: 生成成功
+          schema:
+            allOf:
+            - $ref: '#/definitions/response.Response'
+            - properties:
+                data:
+                  $ref: '#/definitions/admin.issueInviteCodeResponse'
+                msg:
+                  type: string
+              type: object
+      security:
+      - ApiKeyAuth: []
+      summary: 后台代用户生成邀请码（返回明文一次性）
+      tags:
+      - AppInviteCodesAdmin
+  /admin/app-users:
+    get:
+      parameters:
+      - default: 1
+        description: 页码
+        in: query
+        name: page
+        type: integer
+      - default: 10
+        description: 每页大小
+        in: query
+        name: pageSize
+        type: integer
+      - description: 用户名关键字
+        in: query
+        name: keyword
+        type: string
+      produces:
+      - application/json
+      responses:
+        "200":
+          description: 获取成功
+          schema:
+            allOf:
+            - $ref: '#/definitions/response.Response'
+            - properties:
+                data:
+                  $ref: '#/definitions/response.PageResult'
+                msg:
+                  type: string
+              type: object
+      security:
+      - ApiKeyAuth: []
+      summary: 后台获取玩家列表
+      tags:
+      - AppUsersAdmin
+    post:
+      parameters:
+      - description: 玩家信息
+        in: body
+        name: data
+        required: true
+        schema:
+          $ref: '#/definitions/admin.createAppUserRequest'
+      produces:
+      - application/json
+      responses:
+        "200":
+          description: 创建成功
+          schema:
+            allOf:
+            - $ref: '#/definitions/response.Response'
+            - properties:
+                msg:
+                  type: string
+              type: object
+      security:
+      - ApiKeyAuth: []
+      summary: 后台手动新增玩家
+      tags:
+      - AppUsersAdmin
+  /admin/app-users/{id}:
+    delete:
+      parameters:
+      - description: 玩家ID
+        in: path
+        name: id
+        required: true
+        type: integer
+      produces:
+      - application/json
+      responses:
+        "200":
+          description: 删除成功
+          schema:
+            allOf:
+            - $ref: '#/definitions/response.Response'
+            - properties:
+                msg:
+                  type: string
+              type: object
+      security:
+      - ApiKeyAuth: []
+      summary: 软删除玩家
+      tags:
+      - AppUsersAdmin
+    get:
+      parameters:
+      - description: 玩家ID
+        in: path
+        name: id
+        required: true
+        type: integer
+      produces:
+      - application/json
+      responses:
+        "200":
+          description: 获取成功
+          schema:
+            allOf:
+            - $ref: '#/definitions/response.Response'
+            - properties:
+                data:
+                  $ref: '#/definitions/admin.appUserDetailItem'
+                msg:
+                  type: string
+              type: object
+      security:
+      - ApiKeyAuth: []
+      summary: 后台获取玩家详情
+      tags:
+      - AppUsersAdmin
+    patch:
+      parameters:
+      - description: 玩家ID
+        in: path
+        name: id
+        required: true
+        type: integer
+      - description: 更新字段
+        in: body
+        name: data
+        required: true
+        schema:
+          $ref: '#/definitions/admin.updateAppUserRequest'
+      produces:
+      - application/json
+      responses:
+        "200":
+          description: 更新成功
+          schema:
+            allOf:
+            - $ref: '#/definitions/response.Response'
+            - properties:
+                msg:
+                  type: string
+              type: object
+      security:
+      - ApiKeyAuth: []
+      summary: 编辑玩家（仅启用状态/欢迎词）
+      tags:
+      - AppUsersAdmin
+  /admin/app-users/{id}/recharge:
+    post:
+      parameters:
+      - description: 玩家ID
+        in: path
+        name: id
+        required: true
+        type: integer
+      - description: 充值信息
+        in: body
+        name: data
+        required: true
+        schema:
+          $ref: '#/definitions/admin.rechargeRequest'
+      produces:
+      - application/json
+      responses:
+        "200":
+          description: 充值成功
+          schema:
+            allOf:
+            - $ref: '#/definitions/response.Response'
+            - properties:
+                msg:
+                  type: string
+              type: object
+      security:
+      - ApiKeyAuth: []
+      summary: 后台手动充值（账户余额/游戏币，单位：厘）
+      tags:
+      - AppUsersAdmin
+  /admin/app-users/{id}/reset-password:
+    post:
+      parameters:
+      - description: 玩家ID
+        in: path
+        name: id
+        required: true
+        type: integer
+      - description: 新密码
+        in: body
+        name: data
+        required: true
+        schema:
+          $ref: '#/definitions/admin.resetPasswordRequest'
+      produces:
+      - application/json
+      responses:
+        "200":
+          description: 重置成功
+          schema:
+            allOf:
+            - $ref: '#/definitions/response.Response'
+            - properties:
+                msg:
+                  type: string
+              type: object
+      security:
+      - ApiKeyAuth: []
+      summary: 重置玩家密码
+      tags:
+      - AppUsersAdmin
+  /admin/app-users/{id}/toggle-enable:
+    post:
+      parameters:
+      - description: 玩家ID
+        in: path
+        name: id
+        required: true
+        type: integer
+      produces:
+      - application/json
+      responses:
+        "200":
+          description: 操作成功
+          schema:
+            allOf:
+            - $ref: '#/definitions/response.Response'
+            - properties:
+                msg:
+                  type: string
+              type: object
+      security:
+      - ApiKeyAuth: []
+      summary: 启用/停用玩家
+      tags:
+      - AppUsersAdmin
   /api/createApi:
     post:
       consumes:
@@ -2475,7 +3034,7 @@ paths:
         name: data
         required: true
         schema:
-          $ref: '#/definitions/request.Login'
+          $ref: '#/definitions/git_echol_cn_loser_Go-Web-Template_server_model_system_request.Login'
       produces:
       - application/json
       responses:
@@ -3155,6 +3714,40 @@ paths:
       summary: 更新菜单
       tags:
       - Menu
+  /public/auth/register:
+    post:
+      produces:
+      - application/json
+      responses:
+        "200":
+          description: 已废弃
+          schema:
+            allOf:
+            - $ref: '#/definitions/response.Response'
+            - properties:
+                msg:
+                  type: string
+              type: object
+      summary: （废弃）用户前端注册
+      tags:
+      - PublicAuth
+  /public/auth/register/status:
+    get:
+      produces:
+      - application/json
+      responses:
+        "200":
+          description: 已废弃
+          schema:
+            allOf:
+            - $ref: '#/definitions/response.Response'
+            - properties:
+                msg:
+                  type: string
+              type: object
+      summary: （废弃）获取注册开放状态
+      tags:
+      - PublicAuth
   /sysDictionary/createSysDictionary:
     post:
       consumes:
@@ -4742,6 +5335,48 @@ paths:
       summary: 分页获取用户列表
       tags:
       - SysUser
+  /user/invite-code/current:
+    get:
+      produces:
+      - application/json
+      responses:
+        "200":
+          description: 获取成功
+          schema:
+            allOf:
+            - $ref: '#/definitions/response.Response'
+            - properties:
+                data:
+                  $ref: '#/definitions/system.inviteCodeCurrentResponse'
+                msg:
+                  type: string
+              type: object
+      security:
+      - ApiKeyAuth: []
+      summary: 获取当前未使用邀请码（不返回明文）
+      tags:
+      - InviteCode
+  /user/invite-code/generate:
+    post:
+      produces:
+      - application/json
+      responses:
+        "200":
+          description: 生成成功
+          schema:
+            allOf:
+            - $ref: '#/definitions/response.Response'
+            - properties:
+                data:
+                  $ref: '#/definitions/system.InviteCodeGenerated'
+                msg:
+                  type: string
+              type: object
+      security:
+      - ApiKeyAuth: []
+      summary: 生成邀请码（同一时间仅允许一个未使用码）
+      tags:
+      - InviteCode
   /user/resetPassword:
     post:
       parameters: