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

AdminSrc/AdminApi/Lottery/LotteryController.cs

@@ -19,6 +19,9 @@ namespace AdminApi.Lottery
             _gameConfigService = gameConfigService;
         }
 
+        /// <summary>
+        /// 获取奖池抽奖活动列表（基于 ActivityConfig 中的 LotteryActivityConfig）
+        /// </summary>
         [HttpGet("list")]
         public async Task<BaseResponse<List<LotteryActivityVm>>> List()
         {
@@ -47,6 +50,9 @@ namespace AdminApi.Lottery
             return this.ToResult(new List<LotteryActivityVm> { vm });
         }
 
+        /// <summary>
+        /// 获取奖池抽奖活动详情
+        /// </summary>
         [HttpGet("detail")]
         public async Task<BaseResponse<LotteryActivityVm>> Detail([FromQuery] string activityId)
         {
@@ -71,6 +77,9 @@ namespace AdminApi.Lottery
             return this.ToResult(vm);
         }
 
+        /// <summary>
+        /// 保存奖池抽奖活动配置（新增或更新）
+        /// </summary>
         [HttpPost("save")]
         public async Task<BaseResponse<string>> Save([FromBody] LotteryActivityVm param)
         {
@@ -135,6 +144,9 @@ namespace AdminApi.Lottery
             LotteryPrizeProductHelper.Enrich(new LotteryActivityConfig { Pools = pools }, gameConfig);
         }
 
+        /// <summary>
+        /// 切换奖池抽奖活动开启/关闭状态
+        /// </summary>
         [HttpPost("toggle")]
         public async Task<BaseResponse<string>> Toggle([FromBody] LotteryToggleParam param)
         {
@@ -151,6 +163,9 @@ namespace AdminApi.Lottery
                 return this.ToFailResult<string>(res.msg);
         }
 
+        /// <summary>
+        /// 从独立模板初始化完整奖池配置。只在管理员明确点击时执行，其他活动配置不变。
+        /// </summary>
         [HttpPost("initialize")]
         public async Task<BaseResponse<string>> Initialize()
         {
@@ -191,6 +206,9 @@ namespace AdminApi.Lottery
                 : this.ToFailResult<string>(result.msg);
         }
 
+        /// <summary>
+        /// 删除奖池抽奖活动配置（重置为默认空配置）
+        /// </summary>
         [HttpDelete("delete")]
         public async Task<BaseResponse<string>> Delete()
         {