init: 初始化 dpb 桃育种系统代码库

前后端 + 后端 FastAPI 全量源码、部署脚本与文档。

backend/app/common/dataclasses.py

@@ -0,0 +1,89 @@
+import dataclasses
+from datetime import datetime
+
+from fastapi import Response
+
+
+@dataclasses.dataclass
+class IpInfo:
+    """IP 归属地解析结果。"""
+
+    ip: str
+    country: str | None
+    region: str | None
+    city: str | None
+
+
+@dataclasses.dataclass
+class UserAgentInfo:
+    """User-Agent 解析结果（操作系统、浏览器、设备）。"""
+
+    user_agent: str
+    os: str | None
+    browser: str | None
+    device: str | None
+
+
+@dataclasses.dataclass
+class RequestCallNext:
+    """请求链路 call_next 封装结果（状态码、消息、异常、响应）。"""
+
+    code: str
+    msg: str
+    err: Exception | None
+    response: Response
+
+
+@dataclasses.dataclass
+class AccessToken:
+    """访问令牌及过期时间、会话 UUID。"""
+
+    access_token: str
+    access_token_expire_time: datetime
+    session_uuid: str
+
+
+@dataclasses.dataclass
+class RefreshToken:
+    """刷新令牌及过期时间。"""
+
+    refresh_token: str
+    refresh_token_expire_time: datetime
+
+
+@dataclasses.dataclass
+class NewToken:
+    """刷新后的一对访问/刷新令牌及会话 UUID。"""
+
+    new_access_token: str
+    new_access_token_expire_time: datetime
+    new_refresh_token: str
+    new_refresh_token_expire_time: datetime
+    session_uuid: str
+
+
+@dataclasses.dataclass
+class TokenPayload:
+    """JWT/会话载荷中的用户与会话标识。"""
+
+    id: int
+    session_uuid: str
+    expire_time: datetime
+
+
+@dataclasses.dataclass
+class UploadUrl:
+    """上传完成后的访问 URL。"""
+
+    url: str
+
+
+@dataclasses.dataclass
+class SnowflakeInfo:
+    """雪花 ID 拆解后的各段信息。"""
+
+    timestamp: int
+    datetime: str
+    cluster_id: int
+    node_id: int
+    sequence: int