refactor: 使用 ApiMessage 统一错误响应格式

- 在多个控制器中引入 ApiMessage，替换原有的 ApiResponse 错误处理逻辑，确保错误信息的一致性与可读性。
- 更新错误返回信息，使用更具语义的键值，提升 API 的可维护性与用户体验。
- 适配相关控制器的请求参数，确保在处理错误时能够正确返回相应的错误信息。

lang/zh/api.php

@@ -1,9 +1,16 @@
 <?php
 
 return [
+    'success' => [
+        'ok' => '操作成功',
+    ],
+
     'validation_failed' => '请求参数校验未通过。',
     'client_error' => '请求无法完成。',
+    'invalid_params' => '请求参数无效。',
+    'invalid_settings_group' => '不允许读取该配置分组。',
     'draw_no_exists' => '期号已存在，请更换期号或流水号。',
+    'draw_not_found' => '期号不存在。',
     'draw_timeline_invalid' => '开始时间须早于封盘时间，封盘时间须早于开奖时间。',
     'draw_not_editable' => '仅「未开始」或「可下注且无注单」的期号可编辑时间。',
     'draw_not_deletable' => '仅「未开始」且无注单的期号可删除。',
@@ -14,4 +21,37 @@ return [
     'too_many_requests' => '请求过于频繁，请稍后再试。',
     'server_error' => '服务暂时不可用，请稍后再试。',
     'jackpot_manual_burst_failed' => '手动爆池失败：:reason',
+    'config_version_not_draft' => '配置版本不是草稿状态，无法执行该操作。',
+    'config_version_cannot_delete_active' => '不能删除当前生效中的配置版本。',
+    'effective_config_not_initialized' => '玩法配置尚未初始化。',
+    'invalid_or_disabled_currency' => '币种无效或未启用。',
+    'risk_pool_no_remaining_amount' => '风险池剩余额度不足。',
+
+    'reasons' => [
+        'jackpot_disabled' => '奖池已停用。',
+        'jackpot_pool_empty' => '奖池余额为 0，无法爆池。',
+        'jackpot_already_burst_for_draw' => '该期已执行过爆池。',
+        'jackpot_manual_no_first_prize_winners' => '该期没有头奖中奖注单，无法手动爆池。',
+        'jackpot_already_allocated_for_draw' => '该期已分配过奖池派彩。',
+        'draw_not_ready_for_jackpot_burst' => '期号尚未进入结算中或已结算，无法手动爆池。',
+        'draw_result_not_published' => '该期开奖结果尚未发布。',
+        'settlement_batch_not_found' => '未找到该期的结算批次。',
+        'settlement_not_pending_review' => '结算批次不在待审核状态。',
+        'settlement_not_approved' => '结算批次尚未审核通过。',
+        'draw_has_unsettled_tickets' => '该期仍有未结算注单。',
+        'batch_not_pending_review' => '开奖结果批次不在待审核状态。',
+        'draw_not_ready_to_publish' => '期号状态不允许发布开奖结果。',
+        'batch_result_version_stale' => '开奖结果版本已过期，请刷新后重试。',
+        'draw_settlement_in_progress' => '该期正在结算中，无法发布结果。',
+        'draw_already_settled' => '该期已结算完成。',
+        'draw_pending_result_batch_exists' => '该期已有待审核的开奖批次。',
+        'draw_not_closeable' => '当前期号状态不允许手动封盘。',
+        'draw_not_cancelable' => '当前期号状态不允许取消。',
+        'draw_has_settled_tickets' => '该期已有已结算注单，无法执行此操作。',
+        'draw_not_runnable' => '当前期号不可执行 RNG 开奖。',
+        'draw_not_in_cooldown' => '期号不在冷静期，无法重开。',
+        'adjustment_delta_zero' => '调整金额不能为 0。',
+        'adjustment_reason_required' => '请填写调整原因。',
+        'adjustment_would_make_balance_negative' => '调整后奖池余额不能为负数。',
+    ],
 ];