22

app/schemas/admin_card_key.py

@@ -0,0 +1,64 @@
+from datetime import datetime
+from typing import Literal
+
+from pydantic import BaseModel, ConfigDict, Field, field_validator, model_validator
+
+
+class CardKeyOut(BaseModel):
+    model_config = ConfigDict(from_attributes=True)
+
+    id: int
+    serial_number: str
+    duration_days: int
+    created_at: datetime
+    activated_at: datetime | None = None
+    user_id: int | None = None
+    username: str | None = None
+    remark: str | None = None
+
+
+class CardKeyCreate(BaseModel):
+    duration_days: int = Field(ge=1, le=3650, description="有效天数")
+    remark: str | None = Field(default=None, max_length=255)
+    count: int = Field(default=1, ge=1, le=100, description="批量生成数量")
+    serial_number: str | None = Field(default=None, max_length=64)
+
+    @field_validator("remark")
+    @classmethod
+    def normalize_remark(cls, value: str | None) -> str | None:
+        if value is None:
+            return None
+        stripped = value.strip()
+        return stripped or None
+
+    @field_validator("serial_number")
+    @classmethod
+    def normalize_serial(cls, value: str | None) -> str | None:
+        if value is None:
+            return None
+        stripped = value.strip().upper()
+        return stripped or None
+
+    @model_validator(mode="after")
+    def serial_only_for_single(self) -> "CardKeyCreate":
+        if self.serial_number and self.count != 1:
+            raise ValueError("指定序列号时仅可生成 1 张卡密")
+        return self
+
+
+class CardKeyUpdate(BaseModel):
+    duration_days: int | None = Field(default=None, ge=1, le=3650)
+    remark: str | None = Field(default=None, max_length=255)
+
+    @field_validator("remark")
+    @classmethod
+    def normalize_remark(cls, value: str | None) -> str | None:
+        if value is None:
+            return None
+        stripped = value.strip()
+        return stripped or None
+
+
+class CardKeyBatchCreateResult(BaseModel):
+    items: list[CardKeyOut]
+    created_count: int

app/schemas/admin_desktop_config.py

@@ -0,0 +1,54 @@
+from datetime import datetime
+
+from pydantic import BaseModel, ConfigDict, Field, field_validator
+
+
+class DesktopConfigOut(BaseModel):
+    model_config = ConfigDict(from_attributes=True)
+
+    id: int
+    name: str
+    value: str
+    mark: str | None = None
+    created_at: datetime
+    updated_at: datetime
+
+
+class DesktopConfigCreate(BaseModel):
+    name: str = Field(min_length=1, max_length=64)
+    value: str = Field(min_length=0)
+    mark: str | None = Field(default=None, max_length=255)
+
+    @field_validator("name")
+    @classmethod
+    def strip_name(cls, value: str) -> str:
+        return value.strip()
+
+    @field_validator("mark")
+    @classmethod
+    def normalize_mark(cls, value: str | None) -> str | None:
+        if value is None:
+            return None
+        stripped = value.strip()
+        return stripped or None
+
+
+class DesktopConfigUpdate(BaseModel):
+    name: str | None = Field(default=None, min_length=1, max_length=64)
+    value: str | None = None
+    mark: str | None = Field(default=None, max_length=255)
+
+    @field_validator("name")
+    @classmethod
+    def strip_name(cls, value: str | None) -> str | None:
+        if value is None:
+            return None
+        return value.strip()
+
+    @field_validator("mark")
+    @classmethod
+    def normalize_mark(cls, value: str | None) -> str | None:
+        if value is None:
+            return None
+        stripped = value.strip()
+        return stripped or None

app/schemas/admin_user.py

@@ -0,0 +1,60 @@
+from datetime import datetime
+
+from pydantic import BaseModel, ConfigDict, Field, field_validator
+
+
+class AdminUserOut(BaseModel):
+    model_config = ConfigDict(from_attributes=True)
+
+    id: int
+    username: str
+    phone: str | None = None
+    role_id: int
+    vip_end_time: datetime | None = None
+    created_at: datetime
+    updated_at: datetime
+
+
+class AdminUserCreate(BaseModel):
+    username: str = Field(min_length=1, max_length=64)
+    password: str = Field(min_length=6, max_length=128)
+    phone: str | None = Field(default=None, max_length=64)
+    role_id: int = Field(default=0, ge=0, le=2)
+    vip_end_time: datetime | None = None
+
+    @field_validator("username")
+    @classmethod
+    def strip_username(cls, value: str) -> str:
+        return value.strip()
+
+    @field_validator("phone")
+    @classmethod
+    def normalize_phone(cls, value: str | None) -> str | None:
+        if value is None:
+            return None
+        stripped = value.strip()
+        return stripped or None
+
+
+class AdminUserUpdate(BaseModel):
+    username: str | None = Field(default=None, min_length=1, max_length=64)
+    password: str | None = Field(default=None, min_length=6, max_length=128)
+    phone: str | None = Field(default=None, max_length=64)
+    role_id: int | None = Field(default=None, ge=0, le=2)
+    vip_end_time: datetime | None = None
+    clear_vip_end_time: bool = False
+
+    @field_validator("username")
+    @classmethod
+    def strip_username(cls, value: str | None) -> str | None:
+        if value is None:
+            return None
+        return value.strip()
+
+    @field_validator("phone")
+    @classmethod
+    def normalize_phone(cls, value: str | None) -> str | None:
+        if value is None:
+            return None
+        stripped = value.strip()
+        return stripped or None

app/schemas/app_config.py

@@ -0,0 +1,6 @@
+"""桌面端应用配置：name -> value 字典。"""
+
+from typing import Dict
+
+# GET /api/v1/appConfig 的 data 载荷类型
+AppConfigMap = Dict[str, str]

app/schemas/auth.py

@@ -37,6 +37,7 @@ class UserPublic(BaseModel):
 
     id: int
     username: str
+    role_id: int
 
 
 class TokenResponse(BaseModel):

app/schemas/common.py

@@ -13,3 +13,31 @@ class ApiResponse(BaseModel, Generic[T]):
     ok: bool
     message: str = ""
     data: T | None = None
+
+
+class PaginatedData(BaseModel, Generic[T]):
+    """分页列表载荷。"""
+
+    items: list[T]
+    total: int
+    page: int
+    page_size: int
+    total_pages: int
+
+    @classmethod
+    def build(
+        cls,
+        items: list[T],
+        *,
+        total: int,
+        page: int,
+        page_size: int,
+    ) -> "PaginatedData[T]":
+        total_pages = (total + page_size - 1) // page_size if total > 0 else 0
+        return cls(
+            items=items,
+            total=total,
+            page=page,
+            page_size=page_size,
+            total_pages=total_pages,
+        )