feat: Implement the PolyWeather dashboard including frontend components, data collection, analysis, and API endpoints.

frontend/hooks/useDashboardStore.tsx

@@ -35,7 +35,7 @@ interface DashboardStoreValue extends DashboardState {
   openFutureModal: (dateStr: string) => void;
   openGuide: () => void;
   openHistory: () => Promise<void>;
-  openTodayModal: () => void;
+  openTodayModal: () => Promise<void>;
   registerMapStopMotion: (stopMotion: () => void) => void;
   refreshAll: () => Promise<void>;
   refreshSelectedCity: () => Promise<void>;
@@ -64,6 +64,96 @@ function getInitialHistoryState(): HistoryState {
   };
 }
 
+const AI_EMPTY_PATTERNS = [
+  /暂无\s*AI\s*分析/i,
+  /当前以结构化气象与模型数据为主/i,
+  /No\s*AI\s*analysis\s*available/i,
+  /Structured\s+meteorological\s+and\s+model\s+data/i,
+];
+
+function normalizeText(value: unknown) {
+  return typeof value === "string" ? value.trim() : "";
+}
+
+function extractAiPayload(analysis: CityDetail["ai_analysis"]) {
+  if (!analysis) {
+    return {
+      bullets: [] as string[],
+      summary: "",
+    };
+  }
+
+  if (typeof analysis === "string") {
+    return {
+      bullets: [] as string[],
+      summary: normalizeText(analysis),
+    };
+  }
+
+  const summary =
+    normalizeText(analysis.summary) ||
+    normalizeText(analysis.text) ||
+    normalizeText(analysis.message);
+  const bulletsSource = Array.isArray(analysis.highlights)
+    ? analysis.highlights
+    : Array.isArray(analysis.points)
+      ? analysis.points
+      : [];
+
+  return {
+    bullets: bulletsSource.map((item) => normalizeText(item)).filter(Boolean),
+    summary,
+  };
+}
+
+function hasMeaningfulAiAnalysis(analysis: CityDetail["ai_analysis"]) {
+  const parsed = extractAiPayload(analysis);
+  const hasBullets = parsed.bullets.length > 0;
+  const hasSummary =
+    Boolean(parsed.summary) &&
+    !AI_EMPTY_PATTERNS.some((pattern) => pattern.test(parsed.summary));
+  return hasBullets || hasSummary;
+}
+
+function normalizeMetarSignature(detail?: CityDetail) {
+  if (!detail) return "";
+  const metar = normalizeText(detail.current?.raw_metar)
+    .replace(/\s+/g, " ")
+    .toUpperCase();
+  const obsTime = normalizeText(detail.current?.obs_time);
+  return [metar, obsTime].filter(Boolean).join("|");
+}
+
+function mergeAiAnalysisIfStable(
+  previousDetail: CityDetail | undefined,
+  nextDetail: CityDetail,
+) {
+  if (!previousDetail) return nextDetail;
+  if (hasMeaningfulAiAnalysis(nextDetail.ai_analysis)) return nextDetail;
+  if (!hasMeaningfulAiAnalysis(previousDetail.ai_analysis)) return nextDetail;
+
+  const prevTemp = Number(previousDetail.current?.temp);
+  const nextTemp = Number(nextDetail.current?.temp);
+  const tempUnchanged =
+    Number.isFinite(prevTemp) &&
+    Number.isFinite(nextTemp) &&
+    prevTemp === nextTemp;
+
+  const prevMetar = normalizeMetarSignature(previousDetail);
+  const nextMetar = normalizeMetarSignature(nextDetail);
+  const metarUnchanged =
+    Boolean(prevMetar) && Boolean(nextMetar) && prevMetar === nextMetar;
+
+  if (!tempUnchanged && !metarUnchanged) {
+    return nextDetail;
+  }
+
+  return {
+    ...nextDetail,
+    ai_analysis: previousDetail.ai_analysis,
+  };
+}
+
 export function DashboardStoreProvider({
   children,
 }: {
@@ -151,7 +241,8 @@ export function DashboardStoreProvider({
       }
     }
 
-    const detail = await dashboardClient.getCityDetail(cityName, { force });
+    const latestDetail = await dashboardClient.getCityDetail(cityName, { force });
+    const detail = mergeAiAnalysisIfStable(cached, latestDetail);
     setCityDetailsByName((current) => ({
       ...current,
       [cityName]: detail,
@@ -256,15 +347,22 @@ export function DashboardStoreProvider({
   };
 
   const refreshAll = async () => {
+    const previousSelectedDetail = selectedCity
+      ? cityDetailsByName[selectedCity]
+      : undefined;
     dashboardClient.clearCityDetailCache();
     setCityDetailsByName({});
     setCityDetailMetaByName({});
     if (selectedCity) {
       setLoadingState((current) => ({ ...current, refresh: true }));
       try {
-        const detail = await dashboardClient.getCityDetail(selectedCity, {
+        const latestDetail = await dashboardClient.getCityDetail(selectedCity, {
           force: true,
         });
+        const detail = mergeAiAnalysisIfStable(
+          previousSelectedDetail,
+          latestDetail,
+        );
         setCityDetailsByName({ [selectedCity]: detail });
         setCitySummariesByName((current) => ({
           ...current,
@@ -335,10 +433,24 @@ export function DashboardStoreProvider({
       },
       openGuide: () => setIsGuideOpen(true),
       openHistory,
-      openTodayModal: () => {
-        if (selectedDetail?.local_date) {
-          mapStopMotionRef.current();
-          setFutureModalDate(selectedDetail.local_date);
+      openTodayModal: async () => {
+        if (!selectedCity || loadingState.cityDetail || loadingState.refresh) {
+          return;
+        }
+
+        mapStopMotionRef.current();
+        setLoadingState((current) => ({ ...current, refresh: true }));
+        try {
+          const detail = await ensureCityDetail(selectedCity, true);
+          setSelectedForecastDate(detail.local_date);
+          setFutureModalDate(detail.local_date);
+        } catch {
+          const fallback = cityDetailsByName[selectedCity];
+          if (fallback?.local_date) {
+            setFutureModalDate(fallback.local_date);
+          }
+        } finally {
+          setLoadingState((current) => ({ ...current, refresh: false }));
         }
       },
       registerMapStopMotion: (stopMotion: () => void) => {