fix: 部分收付累计释额并扩展结算 E2E 与 CI

账期收付改为按累计已付同步 credit_ledger，修复多笔 partial_paid 与坏账核销重复释额；新增 API E2E（占成、权限、部分收付/坏账）与 GitHub Actions e2e-api job。

Co-authored-by: Cursor <cursoragent@cursor.com>

app/Http/Controllers/Api/V1/E2E/E2EProvisionController.php

@@ -3,13 +3,16 @@
 namespace App\Http\Controllers\Api\V1\E2E;
 
 use App\Models\AdminSite;
+use App\Models\AdminUser;
 use App\Models\AgentNode;
 use App\Models\Player;
 use App\Models\PlayerWallet;
 use App\Services\Agent\AgentNodeService;
 use App\Services\Integration\PartnerSiteConfigResolver;
 use App\Support\ApiResponse;
+use App\Support\PlatformSystemRoles;
 use App\Support\PlayerAuthSource;
+use App\Support\SiteOperatorRoles;
 use Firebase\JWT\JWT;
 use Illuminate\Http\JsonResponse;
 use Illuminate\Http\Request;
@@ -139,6 +142,87 @@ final class E2EProvisionController extends \App\Http\Controllers\Controller
         ]);
     }
 
+    public function setupSiteOperator(Request $request): JsonResponse
+    {
+        PlatformSystemRoles::ensureAll();
+
+        $roleSlug = (string) ($request->input('role_slug') ?: SiteOperatorRoles::SLUG_SITE_FINANCE);
+        $username = (string) ($request->input('username') ?: 'e2e_site_finance');
+        $password = (string) ($request->input('password') ?: env('E2E_PLAYER_PASSWORD', '12345678'));
+        $siteCode = (string) ($request->input('site_code') ?: env('E2E_PLAYER_SITE_CODE', 'demo'));
+
+        $site = AdminSite::query()->where('code', $siteCode)->first();
+        if ($site === null) {
+            return ApiResponse::error('site not found', 'e2e_site_missing', null, 404);
+        }
+
+        $roleId = (int) DB::table('admin_roles')->where('slug', $roleSlug)->value('id');
+        if ($roleId <= 0) {
+            return ApiResponse::error('role not found', 'e2e_role_missing', null, 500);
+        }
+
+        /** @var AdminUser $user */
+        $user = AdminUser::query()->updateOrCreate(
+            ['username' => $username],
+            [
+                'name' => 'E2E Site Operator',
+                'email' => null,
+                'password' => $password,
+                'status' => 0,
+            ],
+        );
+
+        DB::table('admin_user_site_roles')->updateOrInsert(
+            ['admin_user_id' => $user->id, 'site_id' => $site->id],
+            ['role_id' => $roleId, 'granted_at' => now()],
+        );
+
+        return ApiResponse::success([
+            'admin_user_id' => (int) $user->id,
+            'username' => $username,
+            'password' => $password,
+            'role_slug' => $roleSlug,
+            'admin_site_id' => (int) $site->id,
+            'site_code' => $siteCode,
+        ]);
+    }
+
+    public function resetSiteSettlement(Request $request): JsonResponse
+    {
+        $siteCode = (string) ($request->input('site_code') ?: env('E2E_PLAYER_SITE_CODE', 'demo'));
+        $site = AdminSite::query()->where('code', $siteCode)->first();
+        if ($site === null) {
+            return ApiResponse::error('site not found', 'e2e_site_missing', null, 404);
+        }
+
+        $siteId = (int) $site->id;
+        $periodIds = DB::table('settlement_periods')
+            ->where('admin_site_id', $siteId)
+            ->pluck('id')
+            ->all();
+
+        if ($periodIds !== []) {
+            $billIds = DB::table('settlement_bills')
+                ->whereIn('settlement_period_id', $periodIds)
+                ->pluck('id')
+                ->all();
+
+            if ($billIds !== []) {
+                DB::table('payment_records')->whereIn('settlement_bill_id', $billIds)->delete();
+            }
+
+            DB::table('settlement_adjustments')->whereIn('settlement_period_id', $periodIds)->delete();
+            DB::table('settlement_bills')->whereIn('settlement_period_id', $periodIds)->delete();
+            DB::table('settlement_periods')->where('admin_site_id', $siteId)->delete();
+        }
+
+        return ApiResponse::success([
+            'site_code' => $siteCode,
+            'admin_site_id' => $siteId,
+            'cleared_periods' => count($periodIds),
+        ]);
+    }
+
     public function mintSsoJwt(Request $request): JsonResponse
     {
         $siteCode = (string) ($request->input('site_code') ?: env('E2E_PLAYER_SITE_CODE', 'demo'));