first commit

Co-Authored-By: Claude <noreply@anthropic.com>
This commit is contained in:
kunkunxiaomaoandClaude committed 2026-11-16 20:45:22 +08:00
commit 9c5fef1a4d
412 files changed
+94582

No files matched your search

+38
View File
@@ -0,0 +1,38 @@
"""Pydantic schemas."""
from sakura_cloud.schemas.follow import (
CreatorFollowBulkUpsert,
CreatorFollowBulkUpsertResult,
CreatorFollowOut,
CreatorFollowUpsert,
UpdateAlertCreate,
UpdateAlertOut,
UpdateAlertReadUpdate,
)
from sakura_cloud.schemas.gallery import ArtworkCreate, ArtworkOut, ArtworkUpdate, ArtworkViewUpdate, TagsUpdate
from sakura_cloud.schemas.novel import (
BookmarkUpdate,
NovelOut,
NovelSeriesGroup,
NovelViewUpdate,
ReadingProgressUpdate,
)
__all__ = [
"ArtworkCreate",
"ArtworkOut",
"ArtworkUpdate",
"ArtworkViewUpdate",
"BookmarkUpdate",
"CreatorFollowOut",
"CreatorFollowBulkUpsert",
"CreatorFollowBulkUpsertResult",
"CreatorFollowUpsert",
"NovelOut",
"NovelSeriesGroup",
"NovelViewUpdate",
"ReadingProgressUpdate",
"TagsUpdate",
"UpdateAlertCreate",
"UpdateAlertOut",
"UpdateAlertReadUpdate",
]
+201
View File
@@ -0,0 +1,201 @@
from __future__ import annotations
from datetime import datetime
from typing import Generic, TypeVar
from pydantic import BaseModel, ConfigDict, Field
T = TypeVar("T")
class AdminPage(BaseModel):
page: int
limit: int
total: int
class AdminListResponse(BaseModel, Generic[T]):
items: list[T]
pagination: AdminPage
class AdminUserOut(BaseModel):
id: str
username: str
email: str
role: str
is_active: bool
disabled_at: datetime | None = None
disabled_reason: str | None = None
storage_used: int
storage_limit: int
created_at: datetime
updated_at: datetime
model_config = ConfigDict(from_attributes=True)
class AdminUserStatusUpdate(BaseModel):
is_active: bool
reason: str | None = Field(default=None, max_length=300)
class AdminUserRoleUpdate(BaseModel):
role: str = Field(pattern="^(user|admin|super_admin)$")
class AdminUserPasswordReset(BaseModel):
new_password: str = Field(min_length=8, max_length=128)
class AdminLoginRequest(BaseModel):
username_or_email: str = Field(min_length=1, max_length=100)
password: str = Field(min_length=1, max_length=128)
class AdminAuditLogOut(BaseModel):
id: str
admin_user_id: str | None
action: str
target_type: str | None
target_id: str | None
ip_address: str | None
user_agent: str | None
detail_json: dict
created_at: datetime
model_config = ConfigDict(from_attributes=True)
class AdminStatsOut(BaseModel):
users: int
active_users: int
artworks: int
novels: int
files: int
storage_used: int
uploads_pending: int
ocr_pending: int
ocr_failed: int
push_devices: int
follows: int
alerts: int
class AdminFileStatOut(BaseModel):
files: int
bytes: int
mime_type: str | None
class AdminFileOut(BaseModel):
id: str
user_id: str
original_name: str
sha256_prefix: str
file_size: int
mime_type: str | None
uploaded_at: datetime
class AdminArtworkOut(BaseModel):
id: str
user_id: str
source_platform: str
content_type: str
title: str
author: str | None
file_size: int
is_favorite: bool
created_at: datetime
updated_at: datetime
model_config = ConfigDict(from_attributes=True)
class AdminNovelOut(BaseModel):
id: str
user_id: str
source_platform: str
title: str
author: str | None
series_id: str | None
series_title: str | None
file_size: int
updated_at: datetime
model_config = ConfigDict(from_attributes=True)
class AdminTaskOut(BaseModel):
id: str
user_id: str
status: str
file_name: str | None = None
resource_type: str | None = None
file_size: int | None = None
updated_at: datetime | None = None
class AdminOcrTaskOut(BaseModel):
id: str
user_id: str
artwork_id: str
status: str
language: str
confidence: float | None
engine: str
attempts: int
error: str | None
text_length: int
updated_at: datetime
class AdminPushDeviceOut(BaseModel):
id: str
user_id: str
device_id: str
platform: str
token_tail: str
is_active: bool
last_seen_at: datetime | None
updated_at: datetime
model_config = ConfigDict(from_attributes=True)
class AdminAlertStatOut(BaseModel):
platform: str
alerts: int
unread: int
class AdminAlertOut(BaseModel):
id: str
user_id: str
platform: str
creator_id: str
title: str
content_type: str | None
is_read: bool
created_at: datetime
model_config = ConfigDict(from_attributes=True)
class AdminHealthOut(BaseModel):
ok: bool
debug: bool
auto_migrate_on_startup: bool
database: str
storage_root: str
log_dir: str
app_version: str
class AdminLogLineOut(BaseModel):
line_no: int
text: str
class AdminMigrationOut(BaseModel):
version: str | None
+39
View File
@@ -0,0 +1,39 @@
from __future__ import annotations
from pydantic import BaseModel, EmailStr, Field, field_validator
class RegisterRequest(BaseModel):
username: str = Field(min_length=3, max_length=50)
email: EmailStr
password: str = Field(min_length=8, max_length=128)
@field_validator("username", mode="before")
@classmethod
def normalize_username(cls, value: str) -> str:
return value.strip() if isinstance(value, str) else value
@field_validator("email", mode="before")
@classmethod
def normalize_email(cls, value: object) -> object:
return value.strip().lower() if isinstance(value, str) else value
class LoginRequest(BaseModel):
username_or_email: str
password: str
@field_validator("username_or_email", mode="before")
@classmethod
def normalize_login_id(cls, value: str) -> str:
return value.strip() if isinstance(value, str) else value
class RefreshRequest(BaseModel):
refresh_token: str
class TokenPair(BaseModel):
access_token: str
refresh_token: str
token_type: str = "bearer"
+28
View File
@@ -0,0 +1,28 @@
from __future__ import annotations
from datetime import datetime, timezone
from typing import Generic, TypeVar
from pydantic import BaseModel, Field
T = TypeVar("T")
class ApiResponse(BaseModel, Generic[T]):
code: int = 200
message: str = "success"
data: T | None = None
timestamp: datetime = Field(default_factory=lambda: datetime.now(timezone.utc))
class Pagination(BaseModel):
page: int
limit: int
total: int
pages: int
class PageResponse(BaseModel, Generic[T]):
items: list[T]
pagination: Pagination
+29
View File
@@ -0,0 +1,29 @@
from __future__ import annotations
from datetime import datetime
from pydantic import BaseModel, ConfigDict, Field
class DeviceOut(BaseModel):
id: str
device_name: str
device_type: str
device_token: str | None
last_active_at: datetime | None
last_sync_at: datetime | None
created_at: datetime
updated_at: datetime
model_config = ConfigDict(from_attributes=True)
class DeviceRegister(BaseModel):
device_name: str = Field(min_length=1, max_length=100)
device_type: str = Field(min_length=1, max_length=20)
device_token: str | None = Field(default=None, max_length=255)
class DeviceUpdate(BaseModel):
device_name: str | None = Field(default=None, min_length=1, max_length=100)
device_token: str | None = Field(default=None, max_length=255)
+101
View File
@@ -0,0 +1,101 @@
from __future__ import annotations
from datetime import datetime
from pydantic import BaseModel, ConfigDict, Field
class CreatorFollowOut(BaseModel):
id: str
platform: str
creator_id: str
creator_name: str | None
creator_handle: str | None
profile_url: str | None
avatar_url: str | None
enabled: bool
last_checked_at: datetime | None
latest_published_at: datetime | None
metadata_json: dict = Field(default_factory=dict, serialization_alias="metadata")
created_at: datetime
updated_at: datetime
model_config = ConfigDict(from_attributes=True, populate_by_name=True)
@classmethod
def from_row(cls, row: object) -> "CreatorFollowOut":
return cls.model_validate(
{
"id": row.id,
"platform": row.platform,
"creator_id": row.creator_id,
"creator_name": row.creator_name,
"creator_handle": row.creator_handle,
"profile_url": row.profile_url,
"avatar_url": row.avatar_url,
"enabled": row.enabled,
"last_checked_at": row.last_checked_at,
"latest_published_at": row.latest_published_at,
"metadata_json": row.metadata_json or {},
"created_at": row.created_at,
"updated_at": row.updated_at,
}
)
class CreatorFollowUpsert(BaseModel):
platform: str = Field(max_length=20)
creator_id: str = Field(max_length=100)
creator_name: str | None = Field(default=None, max_length=200)
creator_handle: str | None = Field(default=None, max_length=200)
profile_url: str | None = None
avatar_url: str | None = None
enabled: bool = True
last_checked_at: datetime | None = None
latest_published_at: datetime | None = None
metadata: dict = Field(default_factory=dict)
class CreatorFollowBulkUpsert(BaseModel):
items: list[CreatorFollowUpsert] = Field(default_factory=list, max_length=1000)
class CreatorFollowBulkUpsertResult(BaseModel):
created: int = 0
updated: int = 0
skipped: int = 0
items: list[CreatorFollowOut] = Field(default_factory=list)
class UpdateAlertOut(BaseModel):
id: str
follow_id: str | None
platform: str
creator_id: str
title: str
body: str | None
content_type: str | None
target_url: str | None
cover_url: str | None
is_read: bool
payload_json: dict = Field(default_factory=dict, serialization_alias="payload")
created_at: datetime
updated_at: datetime
model_config = ConfigDict(from_attributes=True, populate_by_name=True)
class UpdateAlertCreate(BaseModel):
platform: str = Field(max_length=20)
creator_id: str = Field(max_length=100)
title: str = Field(max_length=500)
body: str | None = None
content_type: str | None = Field(default=None, max_length=20)
target_url: str | None = None
cover_url: str | None = None
created_at: datetime | None = None
payload: dict = Field(default_factory=dict)
class UpdateAlertReadUpdate(BaseModel):
is_read: bool = True
+64
View File
@@ -0,0 +1,64 @@
from __future__ import annotations
from datetime import datetime
from pydantic import BaseModel, ConfigDict, Field
class ArtworkOut(BaseModel):
id: str
source_id: str | None
source_platform: str
content_type: str
title: str
author: str | None
author_id: str | None
page_count: int
file_path: str
file_size: int
thumbnail_path: str | None
image_url: str | None = None
thumbnail_url: str | None = None
mime_type: str | None
width: int | None
height: int | None
tags: list[str]
is_favorite: bool
artwork_metadata: dict
last_viewed_at: datetime | None
created_at: datetime
updated_at: datetime
matched_by: str | None = None
model_config = ConfigDict(from_attributes=True)
class ArtworkCreate(BaseModel):
source_id: str | None = None
source_platform: str = Field(max_length=20)
content_type: str = Field(default="illust", max_length=20)
title: str = Field(max_length=500)
author: str | None = Field(default=None, max_length=200)
author_id: str | None = Field(default=None, max_length=50)
page_count: int = 1
file_path: str
file_size: int = 0
thumbnail_path: str | None = None
mime_type: str | None = None
width: int | None = None
height: int | None = None
tags: list[str] = Field(default_factory=list)
metadata: dict = Field(default_factory=dict)
class ArtworkViewUpdate(BaseModel):
viewed: bool = True
class TagsUpdate(BaseModel):
tags: list[str] = Field(default_factory=list)
class ArtworkUpdate(BaseModel):
title: str = Field(min_length=1, max_length=500)
tags: list[str] = Field(default_factory=list)
+56
View File
@@ -0,0 +1,56 @@
from __future__ import annotations
from datetime import datetime
from pydantic import BaseModel, ConfigDict, Field
class NovelOut(BaseModel):
id: str
source_id: str | None
source_platform: str
title: str
author: str | None
series_id: str | None
series_title: str | None
chapter_title: str | None
chapter_order: int
description: str | None
file_path: str
file_size: int
content_url: str | None = None
cover_path: str | None
word_count: int
current_page: int
bookmark: str | None
tags: list[str]
is_favorite: bool
last_read_at: datetime | None
last_viewed_at: datetime | None
created_at: datetime
updated_at: datetime
model_config = ConfigDict(from_attributes=True)
class ReadingProgressUpdate(BaseModel):
current_page: int = Field(ge=0)
class BookmarkUpdate(BaseModel):
bookmark: str
class NovelViewUpdate(BaseModel):
viewed: bool = True
class NovelSeriesGroup(BaseModel):
series_id: str
series_title: str
author: str | None = None
chapter_count: int
cover_path: str | None = None
last_read_at: datetime | None = None
last_viewed_at: datetime | None = None
chapters: list[NovelOut]
+24
View File
@@ -0,0 +1,24 @@
from __future__ import annotations
from datetime import datetime
from pydantic import BaseModel, ConfigDict
class ArtworkOcrTextOut(BaseModel):
id: str
artwork_id: str
file_id: str | None
source_platform: str | None
source_id: str | None
language: str
ocr_text: str
confidence: float | None
engine: str
status: str
attempts: int
error: str | None
created_at: datetime
updated_at: datetime
model_config = ConfigDict(from_attributes=True)
+64
View File
@@ -0,0 +1,64 @@
from __future__ import annotations
import re
from datetime import datetime
from pydantic import BaseModel, ConfigDict, Field, field_validator
_DEVICE_ID_RE = re.compile(r"^[A-Za-z0-9_.:\-]{4,128}$")
_FCM_TOKEN_RE = re.compile(r"^[A-Za-z0-9_.:\-]+$")
class PushTokenRegister(BaseModel):
device_id: str = Field(min_length=4, max_length=128)
platform: str = Field(default="android", min_length=2, max_length=20)
fcm_token: str = Field(min_length=20, max_length=4096)
@field_validator("device_id")
@classmethod
def validate_device_id(cls, value: str) -> str:
cleaned = value.strip()
if not _DEVICE_ID_RE.fullmatch(cleaned):
raise ValueError("Invalid device_id format")
return cleaned
@field_validator("platform")
@classmethod
def validate_platform(cls, value: str) -> str:
cleaned = value.strip().lower()
if cleaned not in {"android"}:
raise ValueError("Unsupported push platform")
return cleaned
@field_validator("fcm_token")
@classmethod
def validate_fcm_token(cls, value: str) -> str:
cleaned = value.strip()
if not _FCM_TOKEN_RE.fullmatch(cleaned):
raise ValueError("Invalid fcm_token format")
return cleaned
class PushTokenUnregister(BaseModel):
device_id: str = Field(min_length=4, max_length=128)
@field_validator("device_id")
@classmethod
def validate_device_id(cls, value: str) -> str:
cleaned = value.strip()
if not _DEVICE_ID_RE.fullmatch(cleaned):
raise ValueError("Invalid device_id format")
return cleaned
class PushDeviceTokenOut(BaseModel):
id: str
device_id: str
platform: str
is_active: bool
created_at: datetime
updated_at: datetime
last_seen_at: datetime | None
model_config = ConfigDict(from_attributes=True)
+39
View File
@@ -0,0 +1,39 @@
from __future__ import annotations
from pydantic import BaseModel, Field
class UploadInitRequest(BaseModel):
sha256: str = Field(min_length=64, max_length=64)
file_name: str = Field(min_length=1, max_length=255)
file_size: int = Field(ge=0)
mime_type: str | None = Field(default=None, max_length=50)
resource_type: str = Field(default="image", max_length=20)
class UploadInitResponse(BaseModel):
upload_id: str
exists: bool
chunk_size: int
received_size: int
file_id: str | None = None
class UploadStatusResponse(BaseModel):
upload_id: str
sha256: str
file_name: str
file_size: int
received_size: int
status: str
class UploadCompleteRequest(BaseModel):
upload_id: str
class UploadCompleteResponse(BaseModel):
file_id: str
sha256: str
storage_path: str
file_size: int
+42
View File
@@ -0,0 +1,42 @@
from __future__ import annotations
from datetime import datetime
from pydantic import BaseModel, ConfigDict, EmailStr, Field
class UserOut(BaseModel):
id: str
username: str
email: EmailStr
avatar: str | None
storage_used: int
storage_limit: int
role: str
is_active: bool
disabled_at: datetime | None = None
disabled_reason: str | None = None
reminder_enabled: bool
reminder_hour: int
reminder_minute: int
reminder_timezone: str
last_reminder_sent_at: datetime | None
created_at: datetime
updated_at: datetime
model_config = ConfigDict(from_attributes=True)
class UserUpdate(BaseModel):
username: str | None = Field(default=None, min_length=3, max_length=50)
email: EmailStr | None = None
avatar: str | None = None
reminder_enabled: bool | None = None
reminder_hour: int | None = Field(default=None, ge=0, le=23)
reminder_minute: int | None = Field(default=None, ge=0, le=59)
reminder_timezone: str | None = Field(default=None, min_length=1, max_length=64)
class PasswordChangeRequest(BaseModel):
old_password: str
new_password: str = Field(min_length=8, max_length=128)