feat: 更新数据模型和API路由，优化用户信息获取及设置管理

models/response.py

@@ -8,18 +8,18 @@ from datetime import datetime, timezone
 from uuid import uuid4
 
 class ResponseModel(BaseModel):
-    '''
+    """
     默认响应模型
-    '''
+    """
     code: int = Field(default=0, description="系统内部状态码, 0表示成功，其他表示失败", lt=60000, gt=0)
     data: Union[dict, list, str, int, float, None] = Field(None, description="响应数据")
     msg: str | None = Field(default=None, description="响应消息，可以是错误消息或信息提示")
     instance_id: str = Field(default_factory=lambda: str(uuid4()), description="实例ID，用于标识请求的唯一性")
     
 class ThemeModel(BaseModel):
-    '''
+    """
     主题模型
-    '''
+    """
     primary: str = Field(default="#3f51b5", description="Primary color")
     secondary: str = Field(default="#f50057", description="Secondary color")
     accent: str = Field(default="#9c27b0", description="Accent color")
@@ -31,18 +31,18 @@ class ThemeModel(BaseModel):
     warning: str = Field(default="#f2c037", description="Warning color")
 
 class TokenModel(BaseModel):
-    '''
+    """
     访问令牌模型
-    '''
+    """
     access_expires: datetime = Field(default=None, description="访问令牌的过期时间")
     access_token: str = Field(default=None, description="访问令牌")
     refresh_expires: datetime = Field(default=None, description="刷新令牌的过期时间")
     refresh_token: str = Field(default=None, description="刷新令牌")
 
 class GroupModel(BaseModel):
-    '''
+    """
     用户组模型
-    '''
+    """
     id: int = Field(default=None, description="用户组ID")
     name: str = Field(default=None, description="用户组名称")
     allowShare: bool = Field(default=False, description="是否允许分享")
@@ -59,13 +59,13 @@ class GroupModel(BaseModel):
     advanceDelete: bool = Field(default=False, description="是否允许高级删除")
 
 class UserModel(BaseModel):
-    '''
+    """
     用户模型
-    '''
+    """
     id: int = Field(default=None, description="用户ID")
     username: str = Field(default=None, description="用户名")
     nickname: str = Field(default=None, description="用户昵称")
-    status: int = Field(default=0, description="用户状态")
+    status: bool = Field(default=0, description="用户状态")
     avatar: Literal['default', 'gravatar', 'file'] = Field(default='default', description="头像类型")
     created_at: datetime = Field(default_factory=lambda: datetime.now(timezone.utc), description="用户创建时间")
     preferred_theme: ThemeModel = Field(default_factory=ThemeModel, description="用户首选主题")
@@ -75,12 +75,12 @@ class UserModel(BaseModel):
     tags: list = Field(default_factory=list, description="用户标签列表")
     
 class SiteConfigModel(ResponseModel):
-    '''
+    """
     站点配置模型
-    '''
+    """
     title: str = Field(default="DiskNext", description="网站标题")
     themes: dict = Field(default_factory=dict, description="网站主题配置")
-    default_theme: str = Field(default="default", description="默认主题RGB色号")
+    default_theme: dict = Field(description="默认主题RGB色号")
     site_notice: str | None = Field(default=None, description="网站公告")
     user: dict = Field(default_factory=dict, description="用户信息")
     logo_light: str | None = Field(default=None, description="网站Logo URL")
@@ -89,16 +89,16 @@ class SiteConfigModel(ResponseModel):
     captcha_key: str | None = Field(default=None, description="验证码密钥")
 
 class AuthnModel(BaseModel):
-    '''
+    """
     WebAuthn模型
-    '''
+    """
     id: str = Field(default=None, description="ID")
     fingerprint: str = Field(default=None, description="指纹")
 
 class UserSettingModel(BaseModel):
-    '''
+    """
     用户设置模型
-    '''
+    """
     authn: Optional[AuthnModel] = Field(default=None, description="认证信息")
     group_expires: datetime | None = Field(default=None, description="用户组过期时间")
     prefer_theme: str = Field(default="#5898d4", description="用户首选主题")

models/user.py

@@ -1,7 +1,10 @@
-from typing import Optional, TYPE_CHECKING
 from datetime import datetime
-from sqlmodel import Field, Relationship, UniqueConstraint
-from .base import TableBase
+from typing import Optional, TYPE_CHECKING
+
+from sqlmodel import Field, Relationship
+from pydantic import BaseModel
+
+from .base import TableBase, SQLModelBase
 
 if TYPE_CHECKING:
     from .group import Group
@@ -15,14 +18,44 @@ if TYPE_CHECKING:
     from .task import Task
     from .webdav import WebDAV
 
+"""
+Option 需求
+- 主题 跟随系统/浅色/深色
+- 颜色方案 参考.response.ThemeModel
+- 语言
+- 时区
+- 切换到不同存储策略是否提醒
+"""
+
+class WebAuthnInfo(BaseModel):
+    """WebAuthn 信息模型"""
+
+    credential_id: str
+    """凭证 ID"""
+
+    credential_public_key: str
+    """凭证公钥"""
+
+    sign_count: int
+    """签名计数器"""
+
+    credential_device_type: bool
+    """是否为平台认证器"""
+
+    credential_backed_up: bool
+    """凭证是否已备份"""
+
+    transports: list[str]
+    """支持的传输方式"""
+
 class User(TableBase, table=True):
     """用户模型"""
 
     username: str = Field(max_length=50, unique=True, index=True)
-    """用户名，唯一"""
+    """用户名，唯一，一经注册不可更改"""
     
     nick: str | None = Field(default=None, max_length=50)
-    """用户昵称"""
+    """用于公开展示的名字，可使用真实姓名或昵称"""
 
     password: str = Field(max_length=255)
     """用户密码（加密后）"""
@@ -30,31 +63,34 @@ class User(TableBase, table=True):
     status: bool = Field(default=True, sa_column_kwargs={"server_default": "true"})
     """用户状态: True=正常, False=封禁"""
 
-    storage: int = Field(default=0, sa_column_kwargs={"server_default": "0"})
+    storage: int = Field(default=0, sa_column_kwargs={"server_default": "0"}, ge=0)
     """已用存储空间（字节）"""
 
-    two_factor: str | None = Field(default=None, max_length=255)
+    two_factor: str | None = Field(default=None, min_length=32, max_length=32)
     """两步验证密钥"""
 
     avatar: str | None = Field(default=None, max_length=255)
     """头像地址"""
 
     options: str | None = Field(default=None)
-    """用户个人设置 (JSON格式)"""
+    """[TODO] 用户个人设置 需要更改，参考上方的需求"""
 
     authn: str | None = Field(default=None)
-    """WebAuthn 凭证"""
+    """[TODO] WebAuthn 凭证，可不存，也可设置一个或多个"""
 
-    open_id: str | None = Field(default=None, max_length=255, unique=True, index=True)
-    """第三方登录OpenID"""
+    github_open_id: str | None = Field(default=None, unique=True, index=True)
+    """Github OpenID"""
 
-    score: int = Field(default=0, sa_column_kwargs={"server_default": "0"})
+    qq_open_id: str | None = Field(default=None, unique=True, index=True)
+    """QQ OpenID"""
+
+    score: int = Field(default=0, sa_column_kwargs={"server_default": "0"}, ge=0)
     """用户积分"""
 
     group_expires: datetime | None = Field(default=None)
     """当前用户组过期时间"""
 
-    phone: str | None = Field(default=None, max_length=255, unique=True, index=True)
+    phone: str | None = Field(default=None, max_length=32, unique=True, index=True)
     """手机号"""
 
     # 外键
@@ -63,6 +99,8 @@ class User(TableBase, table=True):
 
     previous_group_id: int | None = Field(default=None, foreign_key="group.id")
     """之前的用户组ID（用于过期后恢复）"""
+
+    # [TODO] 待考虑：根目录 Object ID
     
     # 关系
     group: "Group" = Relationship(
@@ -87,4 +125,45 @@ class User(TableBase, table=True):
     tags: list["Tag"] = Relationship(back_populates="user")
     tasks: list["Task"] = Relationship(back_populates="user")
     webdavs: list["WebDAV"] = Relationship(back_populates="user")
+
+    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
+    """更新时间"""
     

models/webdav.py

@@ -14,8 +14,8 @@ class WebDAV(TableBase, table=True):
     name: str = Field(max_length=255, description="WebDAV账户名")
     password: str = Field(max_length=255, description="WebDAV密码")
     root: str = Field(default="/", sa_column_kwargs={"server_default": "'/'"}, description="根目录路径")
-    readonly: bool = Field(default=False, sa_column_kwargs={"server_default": text("false")}, description="是否只读")
-    use_proxy: bool = Field(default=False, sa_column_kwargs={"server_default": text("false")}, description="是否使用代理下载")
+    readonly: bool = Field(default=False, description="是否只读")
+    use_proxy: bool = Field(default=False, description="是否使用代理下载")
     
     # 外键
     user_id: int = Field(foreign_key="user.id", index=True, description="所属用户ID")