feat(core): harden sessions settlement and credit activity

app/Http/Controllers/Api/V1/Admin/Draw/DrawSettlementRunController.php

@@ -5,18 +5,21 @@ namespace App\Http\Controllers\Api\V1\Admin\Draw;
 use App\Models\Draw;
 use App\Models\AdminUser;
 use App\Lottery\ErrorCode;
+use App\Support\ApiMessage;
 use App\Support\ApiResponse;
 use Illuminate\Http\Request;
 use Illuminate\Http\JsonResponse;
 use App\Http\Controllers\Controller;
 use App\Services\Settlement\SettlementOrchestrator;
+use App\Services\Settlement\DrawSettlementStartService;
 
 /**
- * POST /api/v1/admin/draws/{draw}/settlement/run — 对 `settling` 期号执行结算（可关自动结算时手工触发）。
+ * POST /api/v1/admin/draws/{draw}/settlement/run — 冷静期可提前结算，结算中可幂等重试。
  */
 final class DrawSettlementRunController extends Controller
 {
     public function __construct(
+        private readonly DrawSettlementStartService $startService,
         private readonly SettlementOrchestrator $orchestrator,
     ) {}
 
@@ -32,7 +35,13 @@ final class DrawSettlementRunController extends Controller
             );
         }
 
-        $ran = $this->orchestrator->trySettleDraw($draw);
+        try {
+            $started = $this->startService->start($draw);
+        } catch (\RuntimeException $e) {
+            return ApiMessage::runtimeErrorResponse($request, $e);
+        }
+
+        $ran = $this->orchestrator->trySettleDraw($started['draw']);
 
         $draw->refresh();
 
@@ -44,6 +53,8 @@ final class DrawSettlementRunController extends Controller
                     'draw_no' => $draw->draw_no,
                     'status' => $draw->status,
                     'settle_version' => (int) $draw->settle_version,
+                    'cooldown_skipped' => $started['cooldown_skipped'],
+                    'cooling_end_time' => $draw->cooling_end_time?->toIso8601String(),
                 ],
                 409,
             );
@@ -54,6 +65,8 @@ final class DrawSettlementRunController extends Controller
             'draw_no' => $draw->draw_no,
             'status' => $draw->status,
             'settle_version' => (int) $draw->settle_version,
+            'cooldown_skipped' => $started['cooldown_skipped'],
+            'cooling_end_time' => $draw->cooling_end_time?->toIso8601String(),
         ]);
     }
 }