为各服务接口补 /// 中文注释：swagger 恢复中文说明（admin 203 / user 93 / customer 12 / fishgame 4）

2026-10-19 00:44:00 +08:00
parent ff2b779a56
commit 466a4b1cea
39 changed files with 947 additions and 6 deletions
@@ -32,6 +32,9 @@ namespace AdminApi.AdminUser
            _redisService = redisService;
        }

+        /// <summary>
+        /// 获取用户列表（管理员专用，增强版）
+        /// </summary>
        [HttpPost("GetUserList")]
        public async Task<PageResponse<UserListItemDto>> GetUserList(AdminUserListParam param)
        {
@@ -55,6 +58,9 @@ namespace AdminApi.AdminUser
            return this.ToPageResult(dtos, result.count);
        }

+        /// <summary>
+        /// 获取用户详情
+        /// </summary>
        [HttpGet("GetUserDetail")]
        public async Task<BaseResponse<UserEntity>> GetUserDetail(string userId)
        {
@@ -65,6 +71,9 @@ namespace AdminApi.AdminUser
            return this.ToResult(result);
        }

+        /// <summary>
+        /// 修改用户资产
+        /// </summary>
        [HttpPost("UpdateUserAssets")]
        public async Task<BaseResponse<string>> UpdateUserAssets(UpdateUserAssetsParam param)
        {
@@ -75,6 +84,9 @@ namespace AdminApi.AdminUser
                return this.ToFailResult<string>(result.msg);
        }

+        /// <summary>
+        /// 获取用户统计数据
+        /// </summary>
        [HttpGet("GetUserStatistics")]
        public async Task<BaseResponse<UserStatisticsDto>> GetUserStatistics()
        {
@@ -82,6 +94,9 @@ namespace AdminApi.AdminUser
            return this.ToResult(MapToUserStatisticsDto(result));
        }

+        /// <summary>
+        /// 获取邮件统计数据
+        /// </summary>
        [HttpGet("GetEmailStatistics")]
        public async Task<BaseResponse<EmailStatisticsDto>> GetEmailStatistics()
        {
@@ -89,6 +104,9 @@ namespace AdminApi.AdminUser
            return this.ToResult(MapToEmailStatisticsDto(result));
        }

+        /// <summary>
+        /// 批量封号
+        /// </summary>
        [HttpPost("BatchBanUser")]
        public async Task<BaseResponse<string>> BatchBanUser(BatchBanUserParam param)
        {
@@ -99,6 +117,9 @@ namespace AdminApi.AdminUser
                return this.ToFailResult<string>(result.msg);
        }

+        /// <summary>
+        /// 解封用户
+        /// </summary>
        [HttpGet("UnbanUser")]
        public async Task<BaseResponse<string>> UnbanUser(string userId)
        {
@@ -109,6 +130,9 @@ namespace AdminApi.AdminUser
                return this.ToFailResult<string>(result.msg);
        }

+        /// <summary>
+        /// 批量发送邮件
+        /// </summary>
        [HttpPost("BatchSendEmail")]
        public async Task<BaseResponse<string>> BatchSendEmail(BatchSendEmailParam param)
        {
@@ -119,6 +143,9 @@ namespace AdminApi.AdminUser
                return this.ToFailResult<string>(result.msg);
        }

+        /// <summary>
+        /// 注销用户
+        /// </summary>
        [HttpGet("CancelUser")]
        [Authorize]
        public async Task<BaseResponse<string>> CancelUser()
@@ -130,6 +157,9 @@ namespace AdminApi.AdminUser
                return this.ToFailResult<string>(result.msg);
        }

+        /// <summary>
+        /// 删除用户
+        /// </summary>
        [HttpGet("DeleteUser")]
        [Authorize]
        public async Task<BaseResponse<string>> DeleteUser(string id)
@@ -141,6 +171,9 @@ namespace AdminApi.AdminUser
                return this.ToFailResult<string>(result.msg);
        }

+        /// <summary>
+        /// 批量删除用户
+        /// </summary>
        [HttpPost("BatchDeleteUser")]
        [Authorize]
        public async Task<BaseResponse<string>> BatchDeleteUser([FromBody] BatchDeleteUserParam param)
@@ -152,6 +185,9 @@ namespace AdminApi.AdminUser
                return this.ToFailResult<string>(result.msg);
        }

+        /// <summary>
+        /// 封号
+        /// </summary>
        [HttpPost("BanUser")]
        [Authorize]
        public async Task<BaseResponse<string>> BanUser([FromBody] BanUserParam param)
@@ -163,6 +199,9 @@ namespace AdminApi.AdminUser
                return this.ToFailResult<string>(result.msg);
        }

+        /// <summary>
+        /// 更新用户信息
+        /// </summary>
        [HttpPost("UpdateUser")]
        [Authorize]
        public async Task<BaseResponse<string>> UpdateUser(UpdateUserDataParam param)
@@ -174,6 +213,9 @@ namespace AdminApi.AdminUser
                return this.ToFailResult<string>(result.msg);
        }

+        /// <summary>
+        /// 发送邮件
+        /// </summary>
        [HttpPost("SendEmail")]
        [Authorize]
        public async Task<BaseResponse<string>> SendEmail(SendEmailParam param)
@@ -185,6 +227,9 @@ namespace AdminApi.AdminUser
                return this.ToFailResult<string>(result.msg);
        }

+        /// <summary>
+        /// 分页查询邮件列表
+        /// </summary>
        [HttpPost("GetEmailList")]
        [Authorize]
        public async Task<PageResponse<EmailListItemDto>> GetEmailList([FromBody] EmailListQueryParam param)
@@ -216,6 +261,9 @@ namespace AdminApi.AdminUser
            return this.ToPageResult(dtos, (int)count);
        }

+        /// <summary>
+        /// 删除邮件
+        /// </summary>
        [HttpGet("DeleteEmail")]
        [Authorize]
        public async Task<BaseResponse<string>> DeleteEmail(string id)
@@ -227,6 +275,9 @@ namespace AdminApi.AdminUser
                return this.ToFailResult<string>(result.message ?? "删除失败");
        }

+        /// <summary>
+        /// 批量删除邮件
+        /// </summary>
        [HttpPost("BatchDeleteEmail")]
        [Authorize]
        public async Task<BaseResponse<string>> BatchDeleteEmail([FromBody] List<string> ids)
@@ -237,6 +288,9 @@ namespace AdminApi.AdminUser
            return this.ToResult($"删除完成：成功 {success} 条，失败 {fail} 条");
        }

+        /// <summary>
+        /// 设置用户类型
+        /// </summary>
        [HttpPost("SetUserType")]
        public async Task<BaseResponse<string>> SetUserType(string userId, int userType)
        {
@@ -247,6 +301,9 @@ namespace AdminApi.AdminUser
                return this.ToFailResult<string>(result.msg);
        }

+        /// <summary>
+        /// 批量设置用户类型
+        /// </summary>
        [HttpPost("BatchSetUserType")]
        public async Task<BaseResponse<string>> BatchSetUserType([FromBody] BatchSetUserTypeParam param)
        {
@@ -257,6 +314,9 @@ namespace AdminApi.AdminUser
                return this.ToFailResult<string>(result.msg);
        }

+        /// <summary>
+        /// 设置屏蔽状态
+        /// </summary>
        [HttpPost("SetBlackUser")]
        public async Task<BaseResponse<string>> SetBlackUser(string userId, bool isBlack)
        {
@@ -267,6 +327,9 @@ namespace AdminApi.AdminUser
                return this.ToFailResult<string>(result.msg);
        }

+        /// <summary>
+        /// 批量设置屏蔽状态
+        /// </summary>
        [HttpPost("BatchSetBlackUser")]
        public async Task<BaseResponse<string>> BatchSetBlackUser([FromBody] BatchSetBlackUserParam param)
        {
@@ -277,6 +340,9 @@ namespace AdminApi.AdminUser
                return this.ToFailResult<string>(result.msg);
        }

+        /// <summary>
+        /// 更新用户因子
+        /// </summary>
        [HttpPost("UpdateUserFactor")]
        public async Task<BaseResponse<string>> UpdateUserFactor([FromBody] UpdateUserFactorFlatParam param)
        {
@@ -297,6 +363,9 @@ namespace AdminApi.AdminUser
                return this.ToFailResult<string>(result.msg);
        }

+        /// <summary>
+        /// 获取屏蔽用户因子配置
+        /// </summary>
        [HttpGet("GetBlackFactorConfig")]
        public async Task<BaseResponse<PlayerFactorDto>> GetBlackFactorConfig()
        {
@@ -304,6 +373,9 @@ namespace AdminApi.AdminUser
            return this.ToResult(MapToPlayerFactorDto(result));
        }

+        /// <summary>
+        /// 重置用户因子为默认值
+        /// </summary>
        [HttpPost("ResetUserFactor")]
        public async Task<BaseResponse<string>> ResetUserFactor(string userId)
        {
@@ -314,6 +386,9 @@ namespace AdminApi.AdminUser
                return this.ToFailResult<string>(result.msg);
        }

+        /// <summary>
+        /// 初始化用户密码为123456
+        /// </summary>
        [HttpGet("InitUserPassword")]
        public async Task<BaseResponse<string>> InitUserPassword([FromQuery] string userId)
        {
@@ -324,6 +399,9 @@ namespace AdminApi.AdminUser
                return this.ToFailResult<string>(result.msg);
        }

+        /// <summary>
+        /// 初始化保险箱密码为123456
+        /// </summary>
        [HttpGet("InitSafeBoxPassword")]
        public async Task<BaseResponse<string>> InitSafeBoxPassword([FromQuery] string userId)
        {
@@ -334,6 +412,9 @@ namespace AdminApi.AdminUser
                return this.ToFailResult<string>(result.msg);
        }

+        /// <summary>
+        /// 获取用户因子列表
+        /// </summary>
        [HttpPost("GetUserFactorList")]
        public async Task<PageResponse<UserFactorListItemDto>> GetUserFactorList([FromBody] UserFactorListParam param)
        {
@@ -491,6 +572,9 @@ namespace AdminApi.AdminUser



+        /// <summary>
+        /// 获取用户背包道具
+        /// </summary>
        [HttpGet("GetUserProps")]
        public async Task<BaseResponse<List<BaseProductCount>>> GetUserProps(string userId)
        {
@@ -498,6 +582,9 @@ namespace AdminApi.AdminUser
            return this.ToResult(result);
        }

+        /// <summary>
+        /// 添加用户背包道具
+        /// </summary>
        [HttpPost("AddUserProp")]
        public async Task<BaseResponse<string>> AddUserProp(string userId, string propNumber, int count)
        {
@@ -506,6 +593,9 @@ namespace AdminApi.AdminUser
            return this.ToFailResult<string>(res.msg);
        }

+        /// <summary>
+        /// 修改用户道具数量（数量设为0则删除）
+        /// </summary>
        [HttpPost("UpdateUserPropCount")]
        public async Task<BaseResponse<string>> UpdateUserPropCount(string userId, string propNumber, int count)
        {
@@ -514,6 +604,9 @@ namespace AdminApi.AdminUser
            return this.ToFailResult<string>(res.msg);
        }

+        /// <summary>
+        /// 删除用户道具
+        /// </summary>
        [HttpPost("DeleteUserProp")]
        public async Task<BaseResponse<string>> DeleteUserProp(string userId, string propNumber)
        {
@@ -522,6 +615,9 @@ namespace AdminApi.AdminUser
            return this.ToFailResult<string>(res.msg);
        }

+        /// <summary>
+        /// 同步所有玩家的等级（根据经验值+充值重新计算）
+        /// </summary>
        [HttpGet("SyncAllUserLevel")]
        public async Task<BaseResponse<string>> SyncAllUserLevel()
        {