初始化提交

backend/app/schemas/time.py

@@ -0,0 +1,84 @@
+"""辰正时态 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