85 lines
2.5 KiB
Python
85 lines
2.5 KiB
Python
"""辰正时态 API schema（设计 §10）。对外字段不带 _json 后缀。"""
|
|
|
|
from pydantic import BaseModel, ConfigDict, Field
|
|
|
|
from app.modules.time_sense.modulation import ModulationFactors
|
|
from app.modules.time_sense.snapshot import TemporalSnapshot
|
|
|
|
|
|
class SnapshotResponse(BaseModel):
|
|
"""GET /time/snapshot 响应：快照 + 因子 + context_text。"""
|
|
|
|
model_config = ConfigDict(from_attributes=True)
|
|
|
|
snapshot: TemporalSnapshot | None
|
|
factors: ModulationFactors | None
|
|
context_text: str
|
|
|
|
|
|
class AnniversaryCreateRequest(BaseModel):
|
|
model_config = ConfigDict(
|
|
json_schema_extra={
|
|
"examples": [
|
|
{
|
|
"name": "我们的相遇日",
|
|
"calendar": "solar",
|
|
"date": "2025-09-19",
|
|
"recurs_yearly": True,
|
|
"kind": "anniversary",
|
|
"subject_type": "relationship",
|
|
"source": "manual",
|
|
}
|
|
]
|
|
}
|
|
)
|
|
|
|
name: str = Field(max_length=200, description="纪念日名称。")
|
|
calendar: str = Field(description="历法：solar / lunar。")
|
|
date: str = Field(description="日期：公历 ISO 或农历编码。")
|
|
recurs_yearly: bool = Field(default=True, description="是否每年 recur。")
|
|
kind: str = Field(description="类型，取值见契约 §11.4.2。")
|
|
subject_type: str = Field(description="对象类型，取值见契约 §11.4.3。")
|
|
source: str = Field(default="manual", description="来源，取值见契约 §11.4.4。")
|
|
|
|
|
|
class AnniversaryUpdateRequest(BaseModel):
|
|
name: str | None = Field(default=None, max_length=200)
|
|
calendar: str | None = None
|
|
date: str | None = None
|
|
recurs_yearly: bool | None = None
|
|
kind: str | None = None
|
|
subject_type: str | None = None
|
|
source: str | None = None
|
|
|
|
|
|
class AnniversaryResponse(BaseModel):
|
|
model_config = ConfigDict(from_attributes=True)
|
|
|
|
id: str
|
|
name: str
|
|
calendar: str
|
|
date: str
|
|
recurs_yearly: bool
|
|
kind: str
|
|
subject_type: str
|
|
source: str
|
|
|
|
|
|
class AcquaintanceResponse(BaseModel):
|
|
total_days: int
|
|
natural_language: str
|
|
|
|
|
|
class TimeConfigResponse(BaseModel):
|
|
"""GET /time/config：当前时态相关配置（只读，v1 经 env 覆盖）。"""
|
|
|
|
user_timezone: str
|
|
home_timezone: str
|
|
default_city: str
|
|
offline_active_minutes: float
|
|
offline_short_absence_minutes: float
|
|
offline_long_absence_minutes: float
|
|
offline_reunion_impact_minutes: float
|
|
care_enabled: bool
|
|
jetlag_threshold_minutes: int
|