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

AdminSrc/AdminApi/BeautifulNumber/BeautifulNumberController.cs

@@ -23,6 +23,9 @@ namespace AdminApi.BeautifulNumber
             _beautifulNumberService = beautifulNumberService;
         }
 
+        /// <summary>
+        /// 获取靓号列表
+        /// </summary>
         [HttpGet("list")]
         public async Task<PageResponse<BeautifulNumberDto>> GetList([FromQuery] BeautifulNumberListParam param)
         {
@@ -33,6 +36,9 @@ namespace AdminApi.BeautifulNumber
             return this.ToPageResult(dtos, (int)result.count);
         }
 
+        /// <summary>
+        /// 获取可购买的靓号列表
+        /// </summary>
         [HttpGet("available")]
         public async Task<PageResponse<BeautifulNumberDto>> GetAvailableList([FromQuery] BeautifulNumberListParam param)
         {
@@ -44,6 +50,9 @@ namespace AdminApi.BeautifulNumber
             return this.ToPageResult(dtos, (int)result.count);
         }
 
+        /// <summary>
+        /// 查询靓号信息
+        /// </summary>
         [HttpGet("check/{number}")]
         public async Task<BaseResponse<BeautifulNumberDto>> CheckNumber(string number)
         {
@@ -70,6 +79,9 @@ namespace AdminApi.BeautifulNumber
             };
         }
 
+        /// <summary>
+        /// 删除靓号
+        /// </summary>
         [HttpPost("delete")]
         public async Task<BaseResponse<string>> Delete([FromBody] DeleteBeautifulNumberParam param)
         {
@@ -80,6 +92,9 @@ namespace AdminApi.BeautifulNumber
                 return this.ToFailResult<string>(result.msg);
         }
 
+        /// <summary>
+        /// 设置为普通号
+        /// </summary>
         [HttpPost("set-normal")]
         public async Task<BaseResponse<string>> SetToNormal([FromBody] DeleteBeautifulNumberParam param)
         {
@@ -90,6 +105,9 @@ namespace AdminApi.BeautifulNumber
                 return this.ToFailResult<string>(result.msg);
         }
 
+        /// <summary>
+        /// 冻结靓号
+        /// </summary>
         [HttpPost("freeze")]
         public async Task<BaseResponse<string>> Freeze([FromBody] DeleteBeautifulNumberParam param)
         {
@@ -100,6 +118,9 @@ namespace AdminApi.BeautifulNumber
                 return this.ToFailResult<string>(result.msg);
         }
 
+        /// <summary>
+        /// 解冻靓号
+        /// </summary>
         [HttpPost("unfreeze")]
         public async Task<BaseResponse<string>> Unfreeze([FromBody] DeleteBeautifulNumberParam param)
         {
@@ -110,6 +131,9 @@ namespace AdminApi.BeautifulNumber
                 return this.ToFailResult<string>(result.msg);
         }
 
+        /// <summary>
+        /// 修改价格
+        /// </summary>
         [HttpPost("update-price")]
         public async Task<BaseResponse<string>> UpdatePrice([FromBody] UpdateBeautifulNumberPriceParam param)
         {
@@ -120,6 +144,9 @@ namespace AdminApi.BeautifulNumber
                 return this.ToFailResult<string>(result.msg);
         }
 
+        /// <summary>
+        /// 修改靓号（等级和价格）
+        /// </summary>
         [HttpPost("update-number")]
         public async Task<BaseResponse<string>> UpdateNumber([FromBody] UpdateBeautifulNumberParam param)
         {
@@ -130,6 +157,9 @@ namespace AdminApi.BeautifulNumber
                 return this.ToFailResult<string>(result.msg);
         }
 
+        /// <summary>
+        /// 获取靓号规则列表
+        /// </summary>
         [HttpGet("rules")]
         public async Task<BaseResponse<List<BeautifulNumberRuleDto>>> GetRules()
         {
@@ -152,6 +182,9 @@ namespace AdminApi.BeautifulNumber
             };
         }
 
+        /// <summary>
+        /// 更新靓号规则
+        /// </summary>
         [HttpPost("update-rules")]
         public async Task<BaseResponse<string>> UpdateRules([FromBody] List<UpdateBeautifulNumberRuleParam> paramList)
         {
@@ -175,6 +208,9 @@ namespace AdminApi.BeautifulNumber
                 return this.ToFailResult<string>(result.msg);
         }
 
+        /// <summary>
+        /// 初始化靓号规则
+        /// </summary>
         [HttpPost("init-rules")]
         public async Task<BaseResponse<string>> InitRules()
         {
@@ -185,6 +221,9 @@ namespace AdminApi.BeautifulNumber
                 return this.ToFailResult<string>(result.msg);
         }
 
+        /// <summary>
+        /// 添加规则
+        /// </summary>
         [HttpPost("add-rule")]
         public async Task<BaseResponse<string>> AddRule([FromBody] BeautifulNumberRule rule)
         {
@@ -195,6 +234,9 @@ namespace AdminApi.BeautifulNumber
                 return this.ToFailResult<string>(result.msg);
         }
 
+        /// <summary>
+        /// 更新规则
+        /// </summary>
         [HttpPost("update-rule")]
         public async Task<BaseResponse<string>> UpdateRule([FromBody] BeautifulNumberRule rule)
         {
@@ -205,6 +247,9 @@ namespace AdminApi.BeautifulNumber
                 return this.ToFailResult<string>(result.msg);
         }
 
+        /// <summary>
+        /// 删除规则
+        /// </summary>
         [HttpPost("delete-rule")]
         public async Task<BaseResponse<string>> DeleteRule([FromBody] DeleteBeautifulNumberRuleParam param)
         {
@@ -215,6 +260,9 @@ namespace AdminApi.BeautifulNumber
                 return this.ToFailResult<string>(result.msg);
         }
 
+        /// <summary>
+        /// 赠送靓号给用户
+        /// </summary>
         [HttpPost("give-to-user")]
         public async Task<BaseResponse<string>> GiveToUser([FromBody] GiveBeautifulNumberParam param)
         {
@@ -225,6 +273,9 @@ namespace AdminApi.BeautifulNumber
                 return this.ToFailResult<string>(result.msg);
         }
 
+        /// <summary>
+        /// 初始化靓号（已售出不删除）
+        /// </summary>
         [HttpPost("init-numbers")]
         public async Task<BaseResponse<string>> InitNumbers()
         {
@@ -235,6 +286,9 @@ namespace AdminApi.BeautifulNumber
                 return this.ToFailResult<string>(result.msg);
         }
 
+        /// <summary>
+        /// 添加单个靓号
+        /// </summary>
         [HttpPost("add-number")]
         public async Task<BaseResponse<string>> AddNumber([FromBody] AddBeautifulNumberParam param)
         {
@@ -245,6 +299,9 @@ namespace AdminApi.BeautifulNumber
                 return this.ToFailResult<string>(result.msg);
         }
 
+        /// <summary>
+        /// 批量添加靓号
+        /// </summary>
         [HttpPost("batch-add-numbers")]
         public async Task<BaseResponse<BatchAddResult>> BatchAddNumbers([FromBody] BatchAddBeautifulNumbersParam param)
         {