nex_buddy/server/app/schemas/auth.py

162 lines
4.4 KiB
Python
Raw Blame History

This file contains ambiguous Unicode characters!

This file contains ambiguous Unicode characters that may be confused with others in your current locale. If your use case is intentional and legitimate, you can safely ignore this warning. Use the Escape button to highlight these characters.

"""请求/响应模型。字段与 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