feat: 重构模型和响应结构，优化用户和对象管理逻辑，添加 Dockerfile

models/user.py

@@ -1,8 +1,7 @@
 from datetime import datetime
-from typing import Optional, TYPE_CHECKING
+from typing import Literal, Optional, TYPE_CHECKING
 
 from sqlmodel import Field, Relationship
-from pydantic import BaseModel
 
 from .base import TableBase, SQLModelBase
 
@@ -21,23 +20,48 @@ if TYPE_CHECKING:
 """
 Option 需求
 - 主题 跟随系统/浅色/深色
-- 颜色方案 参考.response.ThemeModel
+- 颜色方案 参考 ThemeResponse
 - 语言
 - 时区
 - 切换到不同存储策略是否提醒
 """
 
-class LoginRequest(BaseModel):
-    """
-    登录请求模型
-    """
-    username: str = Field(..., description="用户名或邮箱")
-    password: str = Field(..., description="用户密码")
-    captcha: str | None = Field(None, description="验证码")
-    twoFaCode: str | None = Field(None, description="两步验证代码")
 
-class WebAuthnInfo(BaseModel):
-    """WebAuthn 信息模型"""
+# ==================== Base 模型 ====================
+
+class UserBase(SQLModelBase):
+    """用户基础字段，供数据库模型和 DTO 共享"""
+
+    username: str
+    """用户名"""
+
+    status: bool = True
+    """用户状态: True=正常, False=封禁"""
+
+    score: int = 0
+    """用户积分"""
+
+
+# ==================== DTO 模型 ====================
+
+class LoginRequest(SQLModelBase):
+    """登录请求 DTO"""
+
+    username: str
+    """用户名或邮箱"""
+
+    password: str
+    """用户密码"""
+
+    captcha: str | None = None
+    """验证码"""
+
+    two_fa_code: str | None = None
+    """两步验证代码"""
+
+
+class WebAuthnInfo(SQLModelBase):
+    """WebAuthn 信息 DTO"""
 
     credential_id: str
     """凭证 ID"""
@@ -57,12 +81,152 @@ class WebAuthnInfo(BaseModel):
     transports: list[str]
     """支持的传输方式"""
 
-class User(TableBase, table=True):
+
+class ThemeResponse(SQLModelBase):
+    """主题响应 DTO"""
+
+    primary: str = "#3f51b5"
+    """主色调"""
+
+    secondary: str = "#f50057"
+    """次要色"""
+
+    accent: str = "#9c27b0"
+    """强调色"""
+
+    dark: str = "#1d1d1d"
+    """深色"""
+
+    dark_page: str = "#121212"
+    """深色页面背景"""
+
+    positive: str = "#21ba45"
+    """正面/成功色"""
+
+    negative: str = "#c10015"
+    """负面/错误色"""
+
+    info: str = "#31ccec"
+    """信息色"""
+
+    warning: str = "#f2c037"
+    """警告色"""
+
+
+class TokenResponse(SQLModelBase):
+    """访问令牌响应 DTO"""
+
+    access_expires: datetime
+    """访问令牌过期时间"""
+
+    access_token: str
+    """访问令牌"""
+
+    refresh_expires: datetime
+    """刷新令牌过期时间"""
+
+    refresh_token: str
+    """刷新令牌"""
+
+
+class UserResponse(UserBase):
+    """用户响应 DTO"""
+
+    id: int
+    """用户ID"""
+
+    nickname: str | None = None
+    """用户昵称"""
+
+    avatar: Literal["default", "gravatar", "file"] = "default"
+    """头像类型"""
+
+    created_at: datetime
+    """用户创建时间"""
+
+    preferred_theme: ThemeResponse | None = None
+    """用户首选主题"""
+
+    anonymous: bool = False
+    """是否为匿名用户"""
+
+    group: "GroupResponse | None" = None
+    """用户所属用户组"""
+
+    tags: list[str] = []
+    """用户标签列表"""
+
+
+class UserPublic(UserBase):
+    """用户公开信息 DTO，用于 API 响应"""
+
+    id: int | None = None
+    """用户ID"""
+
+    nick: str | None = None
+    """昵称"""
+
+    storage: int = 0
+    """已用存储空间（字节）"""
+
+    avatar: str | None = None
+    """头像地址"""
+
+    group_expires: datetime | None = None
+    """用户组过期时间"""
+
+    group_id: int | None = None
+    """所属用户组ID"""
+
+    created_at: datetime | None = None
+    """创建时间"""
+
+    updated_at: datetime | None = None
+    """更新时间"""
+
+
+class UserSettingResponse(SQLModelBase):
+    """用户设置响应 DTO"""
+
+    authn: "AuthnResponse | None" = None
+    """认证信息"""
+
+    group_expires: datetime | None = None
+    """用户组过期时间"""
+
+    prefer_theme: str = "#5898d4"
+    """用户首选主题"""
+
+    qq: str | None = None
+    """QQ号"""
+
+    themes: dict[str, str] = {}
+    """用户主题配置"""
+
+    two_factor: bool = False
+    """是否启用两步验证"""
+
+    uid: int = 0
+    """用户UID"""
+
+
+# 前向引用导入
+from .group import GroupResponse  # noqa: E402
+from .user_authn import AuthnResponse  # noqa: E402
+
+# 更新前向引用
+UserResponse.model_rebuild()
+UserSettingResponse.model_rebuild()
+
+
+# ==================== 数据库模型 ====================
+
+class User(UserBase, TableBase, table=True):
     """用户模型"""
 
     username: str = Field(max_length=50, unique=True, index=True)
     """用户名，唯一，一经注册不可更改"""
-    
+
     nick: str | None = Field(default=None, max_length=50)
     """用于公开展示的名字，可使用真实姓名或昵称"""
 
@@ -81,10 +245,9 @@ class User(TableBase, table=True):
     avatar: str | None = Field(default=None, max_length=255)
     """头像地址"""
 
-    options: str | None = Field(default=None)
+    options: str | None = None
     """[TODO] 用户个人设置 需要更改，参考上方的需求"""
 
-
     github_open_id: str | None = Field(default=None, unique=True, index=True)
     """Github OpenID"""
 
@@ -94,7 +257,7 @@ class User(TableBase, table=True):
     score: int = Field(default=0, sa_column_kwargs={"server_default": "0"}, ge=0)
     """用户积分"""
 
-    group_expires: datetime | None = Field(default=None)
+    group_expires: datetime | None = None
     """当前用户组过期时间"""
 
     phone: str | None = Field(default=None, max_length=32, unique=True, index=True)
@@ -108,7 +271,7 @@ class User(TableBase, table=True):
     """之前的用户组ID（用于过期后恢复）"""
 
     # [TODO] 待考虑：根目录 Object ID
-    
+
     # 关系
     group: "Group" = Relationship(
         back_populates="user",
@@ -122,7 +285,7 @@ class User(TableBase, table=True):
             "foreign_keys": "User.previous_group_id"
         }
     )
-    
+
     downloads: list["Download"] = Relationship(back_populates="user")
     objects: list["Object"] = Relationship(back_populates="owner")
     """用户的所有对象（文件和目录）"""
@@ -137,41 +300,4 @@ class User(TableBase, table=True):
     def to_public(self) -> "UserPublic":
         """转换为公开 DTO，排除敏感字段"""
         return UserPublic.model_validate(self)
-
-
-class UserPublic(SQLModelBase):
-    """用户公开信息 DTO，用于 API 响应"""
-
-    id: int | None = None
-    """用户ID"""
-
-    username: str
-    """用户名"""
-
-    nick: str | None = None
-    """昵称"""
-
-    status: bool = True
-    """用户状态"""
-
-    storage: int = 0
-    """已用存储空间（字节）"""
-
-    avatar: str | None = None
-    """头像地址"""
-
-    score: int = 0
-    """用户积分"""
-
-    group_expires: datetime | None = None
-    """用户组过期时间"""
-
-    group_id: int
-    """所属用户组ID"""
-
-    created_at: datetime | None = None
-    """创建时间"""
-
-    updated_at: datetime | None = None
-    """更新时间"""