张胜宇
e239eb778b
1) 客服 Agent 四份交付文档 + 构建脚手架：品牌由包装占位 XX科技 / 旧名 南方财富 统一为南方基金（热线 400-889-8899 / 官网 nffund.com），系统名改为「智能服务系统」； 同步追加 §0.4 修订记录行，工程记录行保留原占位字面以支撑硬编码扫描验收。 2) 开发文档：清理 28 份已作废/残留文档（14 份移出归档 + 14 份仓库副本）， 新增《文档规整方案与开发前待决事项-2026-09-17》。 3) 客服agent 四份交付文档首次纳入本分支。
44 lines
1.4 KiB
Python
44 lines
1.4 KiB
Python
"""基金行情公共契约。内部使用稳定英文字段，不暴露供应商字段名。"""
|
|
|
|
from datetime import date, datetime
|
|
from decimal import Decimal
|
|
from typing import Literal
|
|
|
|
from pydantic import BaseModel, ConfigDict, Field, field_validator
|
|
|
|
|
|
class FundQuoteQuery(BaseModel):
|
|
model_config = ConfigDict(extra="forbid", frozen=True)
|
|
|
|
fund_codes: tuple[str, ...] = ()
|
|
fund_type: str | None = None
|
|
target_date: date | None = None
|
|
limit: int = Field(default=50, ge=1, le=1000)
|
|
|
|
@field_validator("fund_codes")
|
|
@classmethod
|
|
def validate_codes(cls, value: tuple[str, ...]) -> tuple[str, ...]:
|
|
for code in value:
|
|
if len(code) != 6 or not code.isdigit():
|
|
raise ValueError("fund code must be a six-digit number")
|
|
return tuple(dict.fromkeys(value))
|
|
|
|
|
|
class FundQuote(BaseModel):
|
|
model_config = ConfigDict(extra="forbid", frozen=True)
|
|
|
|
fund_code: str
|
|
fund_name: str
|
|
fund_type: str | None = None
|
|
nav: Decimal | None = None
|
|
nav_date: date | None = None
|
|
daily_change: Decimal | None = None
|
|
half_year_return: Decimal | None = None
|
|
one_year_return: Decimal | None = None
|
|
year_to_date_return: Decimal | None = None
|
|
since_inception_return: Decimal | None = None
|
|
quote_time: datetime
|
|
quote_source: Literal["eastmoney", "cache", "degraded"]
|
|
is_intraday: bool
|
|
degraded: bool = False
|