复制 local 代码到 serve

serve/frontend/src/pages/Financials.tsx

@@ -0,0 +1,331 @@
+import { useState, useEffect } from 'react'
+import { RefreshCw, Lock, Loader2, X, Search, FileText, Database, Clock, CheckCircle2, Hourglass, Lightbulb, ExternalLink } from 'lucide-react'
+import { PageHeader } from '@/components/PageHeader'
+import { EmptyState } from '@/components/EmptyState'
+import { useCapabilities } from '@/lib/useSharedQueries'
+import { useFinancialStatus, useFinancialSync } from '@/lib/useFinancials'
+import { StockFinancialSearch } from '@/components/financials/StockFinancialSearch'
+import { StockFinancialDetail } from '@/components/financials/StockFinancialDetail'
+import { ReportHistoryPanel } from '@/components/financials/ReportHistoryPanel'
+import { LastStockChip } from '@/components/LastStockChip'
+import { useLastStock } from '@/lib/useLastStock'
+import { fmtBigNum } from '@/lib/format'
+import { toast } from '@/components/Toast'
+
+const TABLE_LABELS: Record<string, string> = {
+  metrics: '核心指标',
+  income: '利润表',
+  balance_sheet: '资产负债表',
+  cash_flow: '现金流量表',
+}
+
+const TABLE_ICON: Record<string, typeof FileText> = {
+  metrics: Database,
+  income: FileText,
+  balance_sheet: FileText,
+  cash_flow: FileText,
+}
+
+export function Financials() {
+  const { data: caps } = useCapabilities()
+  const hasFinancial = caps?.capabilities?.['financial'] != null
+  const { data: status, isLoading } = useFinancialStatus()
+  const syncMut = useFinancialSync()
+  // 同步进行中 = 服务端真值(status.syncing)或本地乐观态(请求已发出待确认)。
+  // 乐观窗口:点击后到 invalidate 触发的 refetch 返回之间,status.syncing 暂为 false,
+  // 用 syncMut.isPending 覆盖,让按钮立即置灰、避免重复点击。
+  // 后端 trigger() 返回时 syncing 已为 true,refetch 到达后 status.syncing 接管。
+  const syncing = (status?.syncing ?? false) || syncMut.isPending
+  // 本次同步开始时间戳(ms): 用于判断每张表的 last_sync 是否属于本次同步
+  // (后端每张表完成即更新 last_sync, 前端轮询时对比时间戳得到精确进度)
+  const [syncStartedAt, setSyncStartedAt] = useState<number | null>(null)
+  // 单表同步时记录表名 (null = 全量同步), 用于区分卡片状态
+  const [syncSingleTable, setSyncSingleTable] = useState<string | null>(null)
+  // 同步自然结束(服务端 syncing 由 true→false):清空本次同步记录。
+  // 这是可靠的收尾时机 —— 不依赖 mutation 的 onSettled(它现在瞬间触发,会误清)。
+  useEffect(() => {
+    if (!syncing && syncStartedAt !== null) {
+      setSyncStartedAt(null)
+      setSyncSingleTable(null)
+    }
+  }, [syncing, syncStartedAt])
+  // 选中的个股(模糊搜索结果);null 时显示搜索引导
+  const [selected, setSelected] = useState<{ symbol: string; name: string } | null>(null)
+  const { last: lastStock, remember: rememberStock } = useLastStock('financials')
+  const pick = (symbol: string, name: string) => {
+    setSelected({ symbol, name })
+    rememberStock(symbol, name)
+  }
+
+  if (!hasFinancial) {
+    return (
+      <>
+        <PageHeader title="财务分析" subtitle="利润表 / 资负表 / 现金流 / 关键指标 / AI分析 · Expert" />
+        <div className="px-8 py-10">
+          <div className="mx-auto max-w-md rounded-card border border-warning/30 bg-warning/[0.04] p-8 text-center">
+            <div className="mx-auto flex h-12 w-12 items-center justify-center rounded-full bg-warning/10">
+              <Lock className="h-6 w-6 text-warning" />
+            </div>
+            <h3 className="mt-4 text-base font-semibold text-foreground">需要 Expert 套餐</h3>
+            <p className="mt-2 text-xs leading-relaxed text-secondary">
+              财务数据接口仅 Expert 套餐可用。升级后此页自动显示财务数据面板。
+            </p>
+            {/* 当前财务数据源(TickFlow)需付费,后续将接入免费数据源;期间欢迎在 issues 推荐免费源 */}
+            <div className="mt-5 rounded-btn border border-accent/25 bg-accent/[0.05] px-3.5 py-3 text-left">
+              <div className="flex items-center gap-1.5 text-xs font-medium text-accent">
+                <Lightbulb className="h-3.5 w-3.5 shrink-0" />
+                关于数据源
+              </div>
+              <p className="mt-1.5 text-[11px] leading-relaxed text-secondary">
+                当前财务数据源需付费,后续会接入免费数据源。如你常用某个免费财务数据源,欢迎在 Issues 中多多推荐哈 ~
+              </p>
+              <a
+                href="https://github.com/shy3130/tickflow-stock-panel/issues"
+                target="_blank"
+                rel="noreferrer"
+                className="mt-2 inline-flex items-center gap-1 text-[11px] font-medium text-accent hover:underline"
+              >
+                前往 Issues 推荐
+                <ExternalLink className="h-3 w-3" />
+              </a>
+            </div>
+          </div>
+        </div>
+      </>
+    )
+  }
+
+  const handleSync = (table: string) => {
+    // 防重复点击:syncing 中不再触发(后端 trigger 也有 _is_syncing 兜底)
+    if (syncing) return
+    // 记录开始时间: 全量同步判断所有 4 张表, 单表同步只判断这一张
+    setSyncStartedAt(Date.now())
+    setSyncSingleTable(table === 'all' ? null : table)
+    syncMut.mutate(table, {
+      onSuccess: (r) => {
+        // 后端 trigger 立即返回 started 状态;若被防并发跳过(已有同步在进行),
+        // 给用户明确反馈,并清空本次误设的记录。
+        if (!r.synced?.started) {
+          if (r.synced?.reason === 'already running') {
+            toast('财务数据正在同步中,请稍候', 'success')
+          } else if (r.synced?.reason === 'no FINANCIAL capability') {
+            // 能力未就绪:通常发生在升级/刷新 Key 后调度器状态未同步 —— 提示用户检查 Key
+            toast('财务数据能力未就绪,请检查 API Key 或刷新页面后重试', 'error')
+          } else {
+            toast(`同步未能开始${r.synced?.reason ? `:${r.synced.reason}` : ''}`, 'error')
+          }
+          setSyncStartedAt(null)
+          setSyncSingleTable(null)
+        }
+      },
+      onError: () => {
+        // 请求失败:清空本次记录(request 已弹错误 toast)
+        setSyncStartedAt(null)
+        setSyncSingleTable(null)
+      },
+    })
+  }
+
+  const tables = status?.tables ?? {}
+  const available = status?.available ?? false
+  const lastSync = status?.last_sync ?? {}
+  // 本次同步进度: 仅当 syncStartedAt 存在且 syncing 时, 按 last_sync 时间戳判断
+  const isFullSync = syncing && syncStartedAt && !syncSingleTable  // 全量同步
+  const isSingleSync = syncing && syncStartedAt && !!syncSingleTable  // 单表同步
+  const TABLE_ORDER = ['metrics', 'income', 'balance_sheet', 'cash_flow'] as const
+  const tableDoneThisRound = (key: string): boolean => {
+    if (!syncStartedAt || !syncing) return false
+    // 单表同步: 只判断这一张表是否完成
+    if (syncSingleTable && key !== syncSingleTable) return false
+    const ls = lastSync[key]
+    if (!ls) return false
+    return new Date(ls).getTime() >= syncStartedAt
+  }
+  // 当前正在同步的表:
+  // 全量同步 → 第一个未完成的; 单表同步 → 那张表(未完成时)
+  const currentSyncingTable = syncing && syncStartedAt
+    ? (syncSingleTable
+        ? (tableDoneThisRound(syncSingleTable) ? null : syncSingleTable)
+        : TABLE_ORDER.find(t => !tableDoneThisRound(t)) ?? null)
+    : null
+  const syncedCount = TABLE_ORDER.filter(t => tableDoneThisRound(t)).length
+  // 卡片三态: 仅全量同步时未轮到的表显示"等待"; 单表同步时其他表保持原样
+  const isWaitingTable = (key: string): boolean =>
+    !!isFullSync && !tableDoneThisRound(key) && currentSyncingTable !== key
+
+  return (
+    <>
+      <PageHeader
+        title="财务分析"
+        subtitle="利润表 / 资负表 / 现金流 / 关键指标 / AI分析 · Expert"
+        right={
+          <div className="flex items-center gap-2">
+            <LastStockChip stock={lastStock} onSelect={pick} />
+            {syncing && (
+              <span className="text-xs text-accent/80 flex items-center gap-1.5">
+                <Loader2 className="w-3 h-3 animate-spin" />
+                {isFullSync
+                  ? `已同步 ${syncedCount}/4 张表…`
+                  : isSingleSync
+                    ? `同步${TABLE_LABELS[syncSingleTable!] ?? syncSingleTable}…`
+                    : '同步中…'}
+              </span>
+            )}
+            <button
+              className="inline-flex items-center gap-1.5 px-3 py-1.5 rounded-btn bg-gradient-to-r from-accent/25 to-accent/10 border border-accent/30 text-accent text-xs font-medium hover:from-accent/35 hover:to-accent/20 transition-all duration-150 disabled:opacity-40 disabled:cursor-not-allowed"
+              onClick={() => handleSync('all')}
+              disabled={syncing}
+              title={syncing ? '正在同步，请稍候…' : '同步全部财务表'}
+            >
+              {syncing
+                ? <Loader2 className="h-3.5 w-3.5 animate-spin" />
+                : <RefreshCw className="h-3.5 w-3.5" />}
+              {syncing ? '同步中…' : '全部同步'}
+            </button>
+          </div>
+        }
+      />
+
+      <div className="px-8 py-6 space-y-6 max-w-7xl">
+        {syncing && (
+          <div className="flex items-center gap-2 rounded-card border border-accent/30 bg-accent/[0.06] px-3 py-2 text-xs text-accent">
+            <Loader2 className="h-3.5 w-3.5 animate-spin shrink-0" />
+            正在从 TickFlow 拉取财务数据，请稍候…
+          </div>
+        )}
+
+        {/* 同步状态卡片 —— 始终显示,反映本地财务数据概况 */}
+        {!isLoading && available && (
+          <div>
+            <div className="grid grid-cols-2 md:grid-cols-4 gap-3">
+              {Object.entries(TABLE_LABELS).map(([key, label]) => {
+                const info = tables[key]
+                const TIcon = TABLE_ICON[key] ?? Database
+                const hasData = (info?.rows ?? 0) > 0
+                // 本次同步三态: 完成 / 同步中 / 等待 (仅全量同步时未轮到的表才"等待")
+                const doneThisRound = tableDoneThisRound(key)
+                const isThisSyncing = currentSyncingTable === key
+                const isWaiting = isWaitingTable(key)
+                const lsTime = lastSync[key]
+                return (
+                  <div
+                    key={key}
+                    className={`rounded-card border p-3.5 transition-colors flex flex-col ${
+                      isThisSyncing
+                        ? 'border-accent/40 bg-accent/[0.04]'
+                        : isWaiting
+                          ? 'border-border/50 bg-elevated/15'
+                          : hasData
+                            ? 'border-border bg-surface'
+                            : 'border-dashed border-border/60 bg-elevated/20'
+                    }`}
+                  >
+                    <div className="flex items-center justify-between">
+                      <div className="flex items-center gap-1.5">
+                        {doneThisRound ? (
+                          <CheckCircle2 className="h-3.5 w-3.5 text-emerald-400" />
+                        ) : isThisSyncing ? (
+                          <Loader2 className="h-3.5 w-3.5 animate-spin text-accent" />
+                        ) : isWaiting ? (
+                          <Hourglass className="h-3.5 w-3.5 text-muted/60" />
+                        ) : (
+                          <TIcon className={`h-3.5 w-3.5 ${hasData ? 'text-accent' : 'text-muted'}`} />
+                        )}
+                        <span className="text-xs font-medium text-foreground">{label}</span>
+                      </div>
+                      <button
+                        className="text-muted hover:text-accent transition-colors disabled:opacity-30 disabled:cursor-not-allowed"
+                        onClick={() => handleSync(key)}
+                        disabled={syncing}
+                        title={syncing ? '正在同步…' : `同步${label}`}
+                      >
+                        {syncing
+                          ? <Loader2 className="h-3.5 w-3.5 animate-spin" />
+                          : <RefreshCw className="h-3.5 w-3.5" />}
+                      </button>
+                    </div>
+                    <div className="mt-2 text-xl font-semibold tabular-nums text-foreground">
+                      {fmtBigNum(info?.rows ?? 0)}
+                      <span className="text-[10px] text-muted ml-1 font-normal">行</span>
+                    </div>
+                    <div className="text-[11px] text-muted mt-0.5">
+                      {fmtBigNum(info?.symbols ?? 0)} 只标的
+                    </div>
+                    <div className="mt-auto pt-2 border-t border-border/40 text-[10px] text-muted flex items-center gap-1">
+                      <Clock className="h-2.5 w-2.5 shrink-0" />
+                      {lsTime
+                        ? new Date(lsTime).toLocaleString('zh-CN', { month: '2-digit', day: '2-digit', hour: '2-digit', minute: '2-digit' })
+                        : '尚未同步'}
+                    </div>
+                  </div>
+                )
+              })}
+            </div>
+          </div>
+        )}
+
+        {isLoading ? (
+          <div className="flex items-center justify-center py-16">
+            <Loader2 className="h-5 w-5 animate-spin text-muted" />
+          </div>
+        ) : !available ? (
+          <div className="rounded-card border border-dashed border-border bg-surface px-6 py-14 text-center">
+            <Database className="mx-auto h-8 w-8 text-muted" />
+            <div className="mt-3 text-sm text-secondary">暂无财务数据</div>
+            <div className="mt-1 text-xs text-muted">点击右上角"全部同步"从 TickFlow 拉取</div>
+          </div>
+        ) : (
+          <>
+            {/* 个股搜索区 */}
+            <div>
+              {selected ? (
+                // 已选股:紧凑搜索条 + 清除按钮(便于换股)
+                <div className="flex items-center gap-3">
+                  <div className="flex-1 max-w-xl">
+                    <StockFinancialSearch onSelect={pick} />
+                  </div>
+                  <button
+                    onClick={() => setSelected(null)}
+                    className="inline-flex items-center gap-1 px-2.5 py-1.5 text-xs text-secondary hover:text-foreground rounded-btn border border-border hover:bg-elevated transition-colors shrink-0"
+                    title="清除选择"
+                  >
+                    <X className="h-3.5 w-3.5" />
+                    清除
+                  </button>
+                </div>
+              ) : (
+                // 未选股:醒目居中引导
+                <div className="flex flex-col items-center gap-3 py-8">
+                  <div className="flex items-center gap-2 text-sm text-secondary">
+                    <Search className="h-4 w-4 text-accent" />
+                    <span>搜索个股查看详细财务数据</span>
+                  </div>
+                  <div className="w-full max-w-xl">
+                    <StockFinancialSearch onSelect={pick} />
+                  </div>
+                  <div className="text-[11px] text-muted">支持股票代码或名称模糊匹配，如 600000 / 浦发</div>
+                </div>
+              )}
+            </div>
+
+            {/* 个股详情 / 空引导 */}
+            <div className="pb-4">
+              {selected ? (
+                <StockFinancialDetail symbol={selected.symbol} name={selected.name} />
+              ) : (
+                <EmptyState
+                  icon={Search}
+                  title="未选择股票"
+                  hint="在上方搜索框输入股票代码或名称，选择后即可查看该股的核心指标、利润表、资产负债表与现金流量表。"
+                />
+              )}
+            </div>
+
+            {/* AI 历史分析报告 */}
+            {available && <ReportHistoryPanel />}
+          </>
+        )}
+      </div>
+    </>
+  )
+}