feat(odds): 支持基于开注商的赔率区分与优先级处理

- 在赔率数据表中新增 provider_code 字段，默认值为 GLOBAL
- 赔率接口与服务中新增 provider_code 参数支持，实现开注商特定赔率加载
- 解析赔率集合时，根据 provider_code 优先级进行排序与筛选，保证特定开注商赔率优先
- 优化赔率唯一索引，新增 provider_code 列以防止不同开注商赔率重复冲突
- 调整赔率相关验证规则，支持开注商代码的合法性与可选性检查
- 玩法解析与出票相关逻辑改造，支持多开注商环境下的投注处理
- 管理界面赔率替换接口增加 provider_code 字段支持
- 同步和测试用例覆盖 provider_code 相关功能，验证开注商赔率隔离与优先切换
- PlayEffectiveCatalogController 支持按 provider_code 返回赔率目录数据
- TicketPlacementService 与 TicketPreviewService 修改为支持 provider_code 多开注商玩法解析
- 维护 OddsStandardScopes 同步逻辑，保证开注商维度佣金与赔率正确同步
- AdminConfigPresenter 增加了对应数据的 provider_code 与 dimension 输出字段
- SDK接口添加 odds_snapshot_json 中开注商字段，完善赔率快照信息
- 路由配置调整管理文档地址，无关改动细微修改

app/Services/Config/EffectivePlayCatalogService.php

@@ -20,9 +20,10 @@ final class EffectivePlayCatalogService
     /**
      * @return array<string, mixed>
      */
-    public function build(?string $currencyCode = null): array
+    public function build(?string $currencyCode = null, ?string $providerCode = null): array
     {
         $currency = $this->resolveBettableCurrency($currencyCode);
+        $providerCode = strtoupper((string) ($providerCode ?: 'GLOBAL'));
 
         $playVersion = PlayConfigVersion::query()
             ->where('status', ConfigVersionStatus::Active->value)
@@ -45,6 +46,7 @@ final class EffectivePlayCatalogService
         $oddsRows = OddsItem::query()
             ->where('version_id', $oddsVersion->id)
             ->where('currency_code', $currency->code)
+            ->whereIn('provider_code', ['GLOBAL', $providerCode])
             ->get();
 
         /** @var Collection<string, Collection<int, OddsItem>> */
@@ -60,8 +62,11 @@ final class EffectivePlayCatalogService
                 ['display_order', 'asc'],
                 ['play_code', 'asc'],
             ])
-            ->map(function (PlayConfigItem $c) use ($oddsByPlay): array {
-                $items = $oddsByPlay->get($c->play_code, collect());
+            ->map(function (PlayConfigItem $c) use ($oddsByPlay, $providerCode): array {
+                $items = $this->resolveProviderOddsItems(
+                    $oddsByPlay->get($c->play_code, collect()),
+                    $providerCode,
+                );
                 $o = $this->pickPrimaryOddsItem($items);
 
                 return [
@@ -80,6 +85,7 @@ final class EffectivePlayCatalogService
 
         return [
             'currency_code' => $currency->code,
+            'provider_code' => $providerCode,
             'effective_versions' => [
                 'play_config' => $this->serializeVersionHead($playVersion),
                 'odds' => $this->serializeVersionHead($oddsVersion),
@@ -90,6 +96,30 @@ final class EffectivePlayCatalogService
         ];
     }
 
+    /**
+     * @param  Collection<int, OddsItem>  $items
+     * @return Collection<int, OddsItem>
+     */
+    private function resolveProviderOddsItems(Collection $items, string $providerCode): Collection
+    {
+        $selected = [];
+
+        foreach ($items->sortBy(fn (OddsItem $row): int => (string) $row->provider_code === $providerCode ? 0 : 1) as $row) {
+            $dimension = $row->dimension === null ? 'null' : (string) $row->dimension;
+            $key = implode('|', [
+                (string) $row->prize_scope,
+                strtoupper((string) $row->currency_code),
+                $dimension,
+            ]);
+
+            if (! isset($selected[$key])) {
+                $selected[$key] = $row;
+            }
+        }
+
+        return collect(array_values($selected));
+    }
+
     /**
      * 大厅列表展示单档赔率：优先头奖档 {@see first}，兼容历史 {@see default}。
      *
@@ -164,6 +194,7 @@ final class EffectivePlayCatalogService
     private function serializeOddsItem(OddsItem $r): array
     {
         return [
+            'provider_code' => $r->provider_code ?? 'GLOBAL',
             'prize_scope' => $r->prize_scope,
             'odds_value' => (int) $r->odds_value,
             'rebate_rate' => (string) $r->rebate_rate,