Fundamental_Analysis/backend/app/schemas/financial.py
Lv, Qi 21155bc4f8 feat(realtime): 接入前端实时报价并完善后端缓存
前端: 新增 RealTimeQuoteResponse 类型;新增 useRealtimeQuote Hook 并在报告页图表旁展示价格与时间戳(严格 TTL,无兜底)

FastAPI: 新增 GET /financials/{market}/{symbol}/realtime?max_age_seconds=.. 只读端点;通过 DataPersistenceClient 读取 Rust 缓存

Rust: 新增 realtime_quotes hypertable 迁移;新增 POST /api/v1/market-data/quotes 与 GET /api/v1/market-data/quotes/{symbol}?market=..;新增 DTO/Model/DB 函数;修正 #[api] 宏与路径参数;生成 SQLx 离线缓存 (.sqlx) 以支持离线构建

Python: DataPersistenceClient 新增 upsert/get 实时报价,并调整 GET 路径与参数

说明: TradingView 图表是第三方 websocket,不受我们缓存控制;页面数值展示走自有缓存通路,统一且可控。
2025-11-09 05:12:14 +08:00

100 lines
2.3 KiB
Python

"""
Pydantic schemas for financial APIs
"""
from typing import Dict, List, Optional
from pydantic import BaseModel
class PeriodDataPoint(BaseModel):
period: str
value: Optional[float]
class StepRecord(BaseModel):
name: str
start_ts: str # ISO8601
end_ts: Optional[str] = None
duration_ms: Optional[int] = None
status: str # running|done|error
error: Optional[str] = None
class FinancialMeta(BaseModel):
started_at: str # ISO8601
finished_at: Optional[str] = None
elapsed_ms: Optional[int] = None
api_calls_total: int = 0
api_calls_by_group: Dict[str, int] = {}
current_action: Optional[str] = None
steps: List[StepRecord] = []
class BatchFinancialDataResponse(BaseModel):
ts_code: str
name: Optional[str] = None
series: Dict[str, List[PeriodDataPoint]]
meta: Optional[FinancialMeta] = None
class FinancialConfigResponse(BaseModel):
api_groups: Dict[str, List[dict]]
class TokenUsage(BaseModel):
prompt_tokens: int = 0
completion_tokens: int = 0
total_tokens: int = 0
class CompanyProfileResponse(BaseModel):
ts_code: str
company_name: Optional[str] = None
content: str
model: str
tokens: TokenUsage
elapsed_ms: int
success: bool = True
error: Optional[str] = None
class AnalysisResponse(BaseModel):
ts_code: str
company_name: Optional[str] = None
analysis_type: str
content: str
model: str
tokens: TokenUsage
elapsed_ms: int
success: bool = True
error: Optional[str] = None
class AnalysisConfigResponse(BaseModel):
analysis_modules: Dict[str, Dict]
class TodaySnapshotResponse(BaseModel):
ts_code: str
trade_date: str
name: Optional[str] = None
close: Optional[float] = None
pe: Optional[float] = None
pb: Optional[float] = None
dv_ratio: Optional[float] = None
total_mv: Optional[float] = None
class RealTimeQuoteResponse(BaseModel):
symbol: str
market: str
ts: str
price: float
open_price: Optional[float] = None
high_price: Optional[float] = None
low_price: Optional[float] = None
prev_close: Optional[float] = None
change: Optional[float] = None
change_percent: Optional[float] = None
volume: Optional[int] = None
source: Optional[str] = None