feat: initial MVP - FastAPI backend + Vue3 frontend + docker-compose

- backend: FastAPI + SQLAlchemy 2.0(async) + asyncpg + Alembic
- 7 API routes: auth/me/articles/sources/bookmarks/subscriptions/admin
- models: User/Source/Article/Bookmark/Subscription/ApiToken
- services: RSS fetcher (feedparser) + Tencent TMT translator with quota + cache + local NLLB fallback
- workers: APScheduler + asyncio pipeline (fetch -> dedupe -> insert -> translate)
- seed scripts: create_user, seed_sources (5 RSS: Reuters/BBC/Al Jazeera/NHK/DW)
- frontend: Vue 3 + Vite + Naive UI + Pinia + vue-router
- pages: Login, Feed (24h), ArticleDetail, Sources, Bookmarks, AdminSources
- deploy: docker-compose (postgres/redis/api/worker/frontend/caddy)
- docs: README, DEPLOY, architecture, acceptance

backend/app/schemas/__init__.py

@@ -0,0 +1 @@
+"""Pydantic schemas for API I/O."""

backend/app/schemas/article.py

@@ -0,0 +1,83 @@
+"""Article schemas."""
+from __future__ import annotations
+
+from datetime import datetime
+
+from pydantic import BaseModel, ConfigDict, Field
+
+
+class SourceBrief(BaseModel):
+    model_config = ConfigDict(from_attributes=True)
+
+    id: int
+    name: str
+    slug: str
+    region: str | None = None
+
+
+class ArticleListItem(BaseModel):
+    """列表项:精简字段。"""
+
+    model_config = ConfigDict(from_attributes=True)
+
+    id: int
+    source: SourceBrief
+    title: str
+    title_zh: str | None = None
+    summary_zh: str | None = None
+    lang_src: str | None = None
+    translation_status: str
+    category: str | None = None
+    published_at: datetime | None = None
+    fetched_at: datetime
+    image_url: str | None = None
+    is_starred: bool = False
+
+
+class ArticleDetail(BaseModel):
+    model_config = ConfigDict(from_attributes=True)
+
+    id: int
+    source: SourceBrief
+    url: str
+    title: str
+    body_html: str | None = None
+    body_text: str
+    title_zh: str | None = None
+    body_zh_html: str | None = None
+    body_zh_text: str | None = None
+    summary_zh: str | None = None
+    lang_src: str | None = None
+    author: str | None = None
+    image_url: str | None = None
+    translation_status: str
+    translation_engine: str | None = None
+    translated_at: datetime | None = None
+    category: str | None = None
+    commentary: str | None = None
+    entities: dict | None = None
+    sentiment: float | None = None
+    duplicate_of: int | None = None
+    published_at: datetime | None = None
+    fetched_at: datetime
+    is_starred: bool = False
+
+
+class ArticleListResponse(BaseModel):
+    items: list[ArticleListItem]
+    next_cursor: str | None = None
+    total: int | None = None
+
+
+class ArticleQuery(BaseModel):
+    """用作 ?query= 解析参考(实际 FastAPI 直接用 Query)。"""
+
+    since: datetime | None = None
+    until: datetime | None = None
+    source: str | None = None  # 逗号分隔 slug
+    category: str | None = None
+    q: str | None = None
+    lang: str = Field(default="both", pattern=r"^(src|zh|both)$")
+    limit: int = Field(default=50, ge=1, le=200)
+    cursor: str | None = None
+    starred_only: bool = False

backend/app/schemas/auth.py

@@ -0,0 +1,20 @@
+"""Auth schemas."""
+from __future__ import annotations
+
+from pydantic import BaseModel, Field
+
+
+class LoginRequest(BaseModel):
+    username: str = Field(min_length=1, max_length=64)
+    password: str = Field(min_length=6, max_length=128)
+
+
+class TokenPair(BaseModel):
+    access_token: str
+    refresh_token: str
+    token_type: str = "bearer"
+    expires_in: int  # seconds
+
+
+class RefreshRequest(BaseModel):
+    refresh_token: str

backend/app/schemas/misc.py

@@ -0,0 +1,43 @@
+"""Bookmark / Subscription schemas."""
+from __future__ import annotations
+
+from datetime import datetime
+
+from pydantic import BaseModel, ConfigDict, Field
+
+from app.models.subscription import SubscriptionMatch
+
+
+class BookmarkIn(BaseModel):
+    article_id: int
+    note: str | None = None
+
+
+class BookmarkOut(BaseModel):
+    model_config = ConfigDict(from_attributes=True)
+
+    id: int
+    user_id: int
+    article_id: int
+    note: str | None = None
+    created_at: datetime
+
+
+class SubscriptionIn(BaseModel):
+    keyword: str = Field(min_length=1, max_length=255)
+    match_in: SubscriptionMatch = SubscriptionMatch.ANY
+    channel: str = "telegram"
+    target: str | None = None
+
+
+class SubscriptionOut(BaseModel):
+    model_config = ConfigDict(from_attributes=True)
+
+    id: int
+    keyword: str
+    match_in: SubscriptionMatch
+    channel: str
+    target: str | None = None
+    enabled: bool
+    last_hit_at: datetime | None = None
+    created_at: datetime

backend/app/schemas/source.py

@@ -0,0 +1,51 @@
+"""Source schemas."""
+from __future__ import annotations
+
+from datetime import datetime
+
+from pydantic import BaseModel, ConfigDict, Field, HttpUrl
+
+from app.models.source import SourceKind
+
+
+class SourceOut(BaseModel):
+    model_config = ConfigDict(from_attributes=True)
+
+    id: int
+    name: str
+    slug: str
+    kind: SourceKind
+    url: str
+    enabled: bool
+    region: str | None = None
+    language_src: str | None = None
+    priority: int
+    fetch_interval_min: int
+    translate_to: str
+    last_fetched_at: datetime | None = None
+    last_status: str | None = None
+    consecutive_failures: int = 0
+
+
+class SourceIn(BaseModel):
+    name: str = Field(min_length=1, max_length=128)
+    slug: str = Field(min_length=1, max_length=128, pattern=r"^[a-z0-9-]+$")
+    kind: SourceKind = SourceKind.RSS
+    url: HttpUrl
+    region: str | None = None
+    language_src: str | None = None
+    priority: int = Field(default=50, ge=1, le=100)
+    fetch_interval_min: int = Field(default=60, ge=5, le=1440)
+    translate_to: str = "zh"
+    enabled: bool = True
+    detail_selector: dict | None = None
+    headers_json: dict | None = None
+
+
+class SourceUpdate(BaseModel):
+    name: str | None = None
+    enabled: bool | None = None
+    priority: int | None = Field(default=None, ge=1, le=100)
+    fetch_interval_min: int | None = Field(default=None, ge=5, le=1440)
+    region: str | None = None
+    translate_to: str | None = None