首个可运行的版本

backend/app/schemas/__init__.py

@@ -0,0 +1 @@
+"""Pydantic Schema 包"""

backend/app/schemas/admin.py

@@ -0,0 +1,66 @@
+"""管理后台 Schema"""
+
+from datetime import datetime
+
+from pydantic import BaseModel
+
+
+class AdminLoginRequest(BaseModel):
+    password: str
+
+
+class AdminLoginResponse(BaseModel):
+    access_token: str
+    token_type: str = "bearer"
+
+
+class DashboardStats(BaseModel):
+    total_users: int
+    online_users: int
+    total_messages: int
+    today_messages: int
+    total_conversations: int
+    new_users_7d: int
+
+
+class TrendDataPoint(BaseModel):
+    date: str
+    value: int
+
+
+class UserAdminRead(BaseModel):
+    id: str
+    username: str
+    email: str
+    avatar_url: str | None = None
+    status: str
+    is_banned: bool
+    banned_reason: str | None = None
+    last_seen_at: datetime | None = None
+    created_at: datetime
+
+    model_config = {"from_attributes": True}
+
+
+class UserBanRequest(BaseModel):
+    is_banned: bool
+    reason: str | None = None
+
+
+class SystemConfigRead(BaseModel):
+    key: str
+    value: str
+
+    model_config = {"from_attributes": True}
+
+
+class SystemConfigUpdate(BaseModel):
+    configs: dict[str, str]
+
+
+class AdminMessageFilter(BaseModel):
+    user_id: str | None = None
+    conversation_id: str | None = None
+    keyword: str | None = None
+    date_from: str | None = None
+    date_to: str | None = None

backend/app/schemas/auth.py

@@ -0,0 +1,34 @@
+"""认证相关 Schema"""
+
+from pydantic import BaseModel, EmailStr, Field
+
+
+class RegisterRequest(BaseModel):
+    username: str = Field(..., min_length=2, max_length=50)
+    email: EmailStr
+    password: str = Field(..., min_length=6, max_length=100)
+
+
+class LoginRequest(BaseModel):
+    username: str
+    password: str
+
+
+class TokenResponse(BaseModel):
+    access_token: str
+    refresh_token: str
+    token_type: str = "bearer"
+    user: "UserBrief"
+
+
+class RefreshRequest(BaseModel):
+    refresh_token: str
+
+
+class UserBrief(BaseModel):
+    id: str
+    username: str
+    avatar_url: str | None = None
+    is_admin: bool = False
+
+    model_config = {"from_attributes": True}

backend/app/schemas/common.py

@@ -0,0 +1,21 @@
+"""通用 Schema"""
+
+from pydantic import BaseModel
+
+
+class SuccessResponse(BaseModel):
+    success: bool = True
+    message: str = "操作成功"
+
+
+class PageParams(BaseModel):
+    page: int = 1
+    page_size: int = 20
+
+
+class PageResult(BaseModel):
+    items: list
+    total: int
+    page: int
+    page_size: int
+    has_more: bool

backend/app/schemas/conversation.py

@@ -0,0 +1,53 @@
+"""会话相关 Schema"""
+
+from datetime import datetime
+
+from pydantic import BaseModel, Field
+
+
+class ConversationCreate(BaseModel):
+    type: str = Field(..., pattern="^(private|group)$")
+    name: str | None = Field(None, max_length=100)
+    member_ids: list[str] = Field(..., min_length=1)
+
+
+class ConversationRead(BaseModel):
+    id: str
+    type: str
+    name: str | None = None
+    avatar_url: str | None = None
+    description: str | None = None
+    last_message_preview: str | None = None
+    last_message_at: datetime | None = None
+    created_at: datetime
+    unread_count: int = 0
+
+    model_config = {"from_attributes": True}
+
+
+class ConversationDetail(ConversationRead):
+    members: list["MemberRead"] = []
+
+
+class MemberRead(BaseModel):
+    id: str
+    user_id: str
+    username: str
+    nickname: str | None = None
+    avatar_url: str | None = None
+    role: str = "member"
+    joined_at: datetime
+
+    model_config = {"from_attributes": True}
+
+
+class ConversationUpdate(BaseModel):
+    name: str | None = Field(None, max_length=100)
+    description: str | None = Field(None, max_length=500)
+    avatar_url: str | None = None
+
+
+class GroupCreate(BaseModel):
+    name: str = Field(..., min_length=1, max_length=100)
+    description: str | None = Field(None, max_length=500)
+    member_ids: list[str] = Field(..., min_length=1)

backend/app/schemas/friend.py

@@ -0,0 +1,36 @@
+"""好友相关 Schema"""
+
+from datetime import datetime
+
+from pydantic import BaseModel
+
+
+class FriendRequestCreate(BaseModel):
+    to_user_id: str
+    message: str | None = None
+
+
+class FriendRequestRead(BaseModel):
+    id: str
+    from_user_id: str
+    from_username: str | None = None
+    from_avatar: str | None = None
+    to_user_id: str
+    to_username: str | None = None
+    message: str | None = None
+    status: str
+    created_at: datetime
+
+    model_config = {"from_attributes": True}
+
+
+class FriendRead(BaseModel):
+    id: str
+    friend_user_id: str
+    username: str
+    nickname: str | None = None
+    avatar_url: str | None = None
+    remark: str | None = None
+    status: str = "offline"
+
+    model_config = {"from_attributes": True}

backend/app/schemas/message.py

@@ -0,0 +1,37 @@
+"""消息相关 Schema"""
+
+from datetime import datetime
+
+from pydantic import BaseModel, Field
+
+
+class MessageSend(BaseModel):
+    conversation_id: str
+    content: str = Field(..., min_length=1, max_length=5000)
+    type: str = Field(default="text", pattern="^(text|image|file)$")
+    reply_to_id: str | None = None
+
+
+class MessageRead(BaseModel):
+    id: str
+    conversation_id: str
+    sender_id: str
+    sender_name: str | None = None
+    sender_avatar: str | None = None
+    type: str
+    content: str
+    reply_to_id: str | None = None
+    is_deleted: bool = False
+    created_at: datetime
+
+    model_config = {"from_attributes": True}
+
+
+class MessagePage(BaseModel):
+    messages: list[MessageRead]
+    has_more: bool = False
+    next_cursor: str | None = None
+
+
+class MarkReadRequest(BaseModel):
+    message_id: str

backend/app/schemas/user.py

@@ -0,0 +1,49 @@
+"""用户相关 Schema"""
+
+from datetime import datetime
+
+from pydantic import BaseModel, Field
+
+
+class UserRead(BaseModel):
+    id: str
+    username: str
+    email: str
+    avatar_url: str | None = None
+    bio: str | None = None
+    status: str = "offline"
+    created_at: datetime
+
+    model_config = {"from_attributes": True}
+
+
+class UserProfile(BaseModel):
+    """他人可见的公开信息"""
+    id: str
+    username: str
+    avatar_url: str | None = None
+    bio: str | None = None
+    status: str = "offline"
+
+    model_config = {"from_attributes": True}
+
+
+class UserUpdate(BaseModel):
+    username: str | None = Field(None, min_length=2, max_length=50)
+    bio: str | None = Field(None, max_length=200)
+    avatar_url: str | None = None
+
+
+class PasswordChange(BaseModel):
+    old_password: str
+    new_password: str = Field(..., min_length=6, max_length=100)
+
+
+class UserSearchResult(BaseModel):
+    id: str
+    username: str
+    avatar_url: str | None = None
+    bio: str | None = None
+    status: str = "offline"
+
+    model_config = {"from_attributes": True}