162 lines
4.4 KiB
Python
162 lines
4.4 KiB
Python
"""请求/响应模型。字段与 01-总体设计.md 4.2 对齐。"""
|
||
|
||
from __future__ import annotations
|
||
|
||
import uuid
|
||
from datetime import date, datetime, time
|
||
|
||
from pydantic import BaseModel, ConfigDict, Field
|
||
|
||
|
||
class RegisterIn(BaseModel):
|
||
account: str = Field(description="邮箱或手机号")
|
||
password: str = Field(min_length=6, max_length=64)
|
||
nickname: str = ""
|
||
|
||
|
||
class LoginIn(BaseModel):
|
||
account: str
|
||
password: str
|
||
|
||
|
||
class QrLoginIn(BaseModel):
|
||
"""设备屏二维码里的一次性票据。"""
|
||
|
||
code: str
|
||
|
||
|
||
class UserOut(BaseModel):
|
||
model_config = ConfigDict(from_attributes=True)
|
||
|
||
id: uuid.UUID
|
||
email: str | None = None
|
||
phone: str | None = None
|
||
nickname: str = ""
|
||
real_name: str | None = None
|
||
|
||
birthday: date | None = None
|
||
birth_time: time | None = None
|
||
birth_city: str | None = None
|
||
birth_region_code: str | None = None
|
||
birth_place: str | None = None
|
||
|
||
residence_region_code: str | None = None
|
||
residence_city: str | None = None
|
||
residence_place: str | None = None
|
||
timezone: str | None = None
|
||
# 时区偏移(分钟):设备没有 tzdata,光有 IANA 名换算不了本地时间。
|
||
# 服务端算好直接给,夏令时也由服务端负责换。
|
||
tz_offset_min: int | None = None
|
||
|
||
# 星盘:只落 code,名字/符号按码表实时补(见 user_out)
|
||
sun_sign: str | None = None
|
||
sun_sign_name: str | None = None
|
||
sun_symbol: str | None = None
|
||
sun_degree: float | None = None
|
||
moon_sign: str | None = None
|
||
moon_sign_name: str | None = None
|
||
moon_symbol: str | None = None
|
||
moon_degree: float | None = None
|
||
|
||
role: str = "user"
|
||
status: str = "active"
|
||
created_at: datetime | None = None
|
||
|
||
|
||
def user_out(user: "User", zodiacs: dict[str, dict] | None = None) -> UserOut:
|
||
"""把 user 行转成出参;给了星座码表就把 code 翻成名字与符号。"""
|
||
out = UserOut.model_validate(user)
|
||
for kind in ("sun", "moon"):
|
||
code = getattr(user, f"{kind}_sign", None)
|
||
info = (zodiacs or {}).get(code or "")
|
||
if info:
|
||
setattr(out, f"{kind}_sign_name", info["name_cn"])
|
||
setattr(out, f"{kind}_symbol", info["symbol"])
|
||
out.tz_offset_min = _tz_offset_min(user.timezone)
|
||
return out
|
||
|
||
|
||
def _tz_offset_min(tz_name: str | None) -> int | None:
|
||
"""IANA 名 → 当前偏移分钟(夏令时按今天算)。算不出来返回 None。"""
|
||
from datetime import datetime, timedelta, timezone
|
||
from zoneinfo import ZoneInfo, ZoneInfoNotFoundError
|
||
|
||
try:
|
||
tz = ZoneInfo(tz_name or "Asia/Shanghai")
|
||
except (ZoneInfoNotFoundError, ValueError):
|
||
return None
|
||
off = datetime.now(timezone.utc).astimezone(tz).utcoffset() or timedelta(0)
|
||
return int(off.total_seconds() // 60)
|
||
|
||
|
||
|
||
class LoginOut(BaseModel):
|
||
token: str
|
||
user: UserOut
|
||
|
||
|
||
class ProfileIn(BaseModel):
|
||
nickname: str | None = None
|
||
real_name: str | None = None
|
||
birthday: date | None = None
|
||
birth_time: time | None = None
|
||
# 码表 code:出生地决定时区(进而决定月亮星座),居住地决定日常天气与运势「当月」
|
||
birth_region_code: str | None = None
|
||
residence_region_code: str | None = None
|
||
# 居住时区(IANA 名)。只影响日常语义,不影响星盘(星盘用出生地时区)
|
||
timezone: str | None = Field(default=None, max_length=64)
|
||
|
||
|
||
class DeviceOut(BaseModel):
|
||
model_config = ConfigDict(from_attributes=True)
|
||
|
||
id: uuid.UUID
|
||
chip_id: str
|
||
model: str
|
||
fw_version: str
|
||
bound_at: datetime | None = None
|
||
last_active_at: datetime | None = None
|
||
|
||
|
||
class PairCodeIn(BaseModel):
|
||
chip_id: str = Field(description="芯片 efuse MAC,十六进制 12~17 位")
|
||
model: str = "JC3636K518C_I_W"
|
||
fw_version: str = ""
|
||
code: str | None = Field(default=None, description="设备自行生成的 6 位码;不传则服务端生成")
|
||
|
||
|
||
class PairCodeOut(BaseModel):
|
||
code: str
|
||
expires_in: int
|
||
server_time: str
|
||
|
||
|
||
class PairStatusOut(BaseModel):
|
||
status: str # waiting / bound / claimed / expired
|
||
user_hint: str | None = None
|
||
|
||
|
||
class PairClaimIn(BaseModel):
|
||
code: str
|
||
chip_id: str
|
||
|
||
|
||
class PairClaimOut(BaseModel):
|
||
token: str
|
||
device_id: uuid.UUID
|
||
user: UserOut
|
||
|
||
|
||
class PairByCodeIn(BaseModel):
|
||
code: str
|
||
|
||
|
||
class AdminSettingIn(BaseModel):
|
||
key: str
|
||
value: str | int | dict | None
|
||
|
||
|
||
class OkOut(BaseModel):
|
||
ok: bool = True
|
||
detail: str | None = None
|