feat(admin,player,api): 公共管理与优胜冠军国旗、玩家端内容对接

新增公共内容 CRUD 与批量操作；公告滚动合并管理；优胜冠军内置国家选择与单行保存；玩家端统一 usePlayerHome 对接轮播与跑马灯。

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

apps/player/src/composables/useAnnouncements.ts

@@ -1,38 +1,7 @@
-import { ref } from 'vue';
-import { useI18n } from 'vue-i18n';
-import api from '../api';
-import { resolveAnnouncements } from '../constants/defaultAnnouncement';
-
-function collectAnnouncementLines(data: {
-  ticker?: Array<{ translation?: { title?: string; body?: string } }>;
-  notices?: Array<{ translation?: { title?: string; body?: string } }>;
-} | null): string[] {
-  const lines: string[] = [];
-  if (!data) return lines;
-  for (const item of data.ticker ?? []) {
-    const text = item.translation?.body || item.translation?.title;
-    if (text) lines.push(text);
-  }
-  for (const item of data.notices ?? []) {
-    const text = item.translation?.title || item.translation?.body;
-    if (text) lines.push(text);
-  }
-  return lines;
-}
+import { usePlayerHome } from './usePlayerHome';
 
+/** @deprecated 请使用 usePlayerHome */
 export function useAnnouncements() {
-  const { t } = useI18n();
-  const items = ref<string[]>(resolveAnnouncements([], t('home.announcement_default')));
-
-  async function load() {
-    const fallback = t('home.announcement_default');
-    try {
-      const { data } = await api.get('/player/home');
-      items.value = resolveAnnouncements(collectAnnouncementLines(data.data), fallback);
-    } catch {
-      items.value = resolveAnnouncements([], fallback);
-    }
-  }
-
-  return { items, load };
+  const { announcements, load } = usePlayerHome();
+  return { items: announcements, load };
 }

apps/player/src/composables/usePlayerHome.ts

@@ -0,0 +1,72 @@
+import { ref, computed } from 'vue';
+import { useI18n } from 'vue-i18n';
+import api from '../api';
+import type { BannerItem } from '../components/BannerCarousel.vue';
+import { resolveBanners } from '../constants/defaultBanner';
+import { resolveAnnouncements } from '../constants/defaultAnnouncement';
+
+export interface PlayerHomeMatch {
+  id: string;
+  homeTeamName: string;
+  awayTeamName: string;
+  startTime: string;
+  isHot?: boolean;
+}
+
+interface HomePayload {
+  banners?: BannerItem[];
+  announcements?: Array<{ translation?: { title?: string; body?: string } }>;
+  ticker?: Array<{ translation?: { title?: string; body?: string } }>;
+  notices?: Array<{ translation?: { title?: string; body?: string } }>;
+  hotMatches?: PlayerHomeMatch[];
+}
+
+const homeRaw = ref<HomePayload | null>(null);
+const loading = ref(false);
+
+function collectAnnouncementLines(data: HomePayload | null): string[] {
+  if (!data) return [];
+  const source =
+    data.announcements && data.announcements.length > 0
+      ? data.announcements
+      : [...(data.ticker ?? []), ...(data.notices ?? [])];
+
+  const lines: string[] = [];
+  for (const item of source) {
+    const text = item.translation?.title || item.translation?.body;
+    if (text) lines.push(text);
+  }
+  return lines;
+}
+
+/** 管理端公共内容 → 玩家端首页/跑马灯（单例，避免重复请求） */
+export function usePlayerHome() {
+  const { t } = useI18n();
+
+  async function load() {
+    loading.value = true;
+    try {
+      const { data } = await api.get('/player/home');
+      homeRaw.value = (data.data ?? null) as HomePayload | null;
+    } catch {
+      homeRaw.value = null;
+    } finally {
+      loading.value = false;
+    }
+  }
+
+  const banners = computed(() => resolveBanners(homeRaw.value?.banners));
+  const announcements = computed(() =>
+    resolveAnnouncements(collectAnnouncementLines(homeRaw.value), t('home.announcement_default')),
+  );
+  const hotMatches = computed(() => homeRaw.value?.hotMatches ?? []);
+
+  return {
+    homeRaw,
+    loading,
+    load,
+    banners,
+    announcements,
+    hotMatches,
+  };
+}