前端: 新增 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,不受我们缓存控制;页面数值展示走自有缓存通路,统一且可控。
100 lines
2.3 KiB
Python
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
|