76 lines
1.9 KiB
Python
76 lines
1.9 KiB
Python
|
from typing import List, Optional
|
|||
|
|
|
|||
|
|
from pydantic import BaseModel, Field
|
|||
|
|
|
|||
|
|
from app.models.domain.articles import Article
|
|||
|
|
from app.models.schemas.rwschema import RWSchema
|
|||
|
|
|
|||
|
|
DEFAULT_ARTICLES_LIMIT = 20
|
|||
|
|
DEFAULT_ARTICLES_OFFSET = 0
|
|||
|
|
|
|||
|
|
|
|||
|
|
class ArticleForResponse(RWSchema, Article):
|
|||
|
|
"""
|
|||
|
|
返回给前端的文章结构：
|
|||
|
|
- 继承 Article（包含 cover、tags、author 等）
|
|||
|
|
- tags 字段通过 alias 暴露为 tagList，兼容前端
|
|||
|
|
"""
|
|||
|
|
tags: List[str] = Field(..., alias="tagList")
|
|||
|
|
|
|||
|
|
|
|||
|
|
class ArticleInResponse(RWSchema):
|
|||
|
|
article: ArticleForResponse
|
|||
|
|
|
|||
|
|
|
|||
|
|
class ArticleInCreate(RWSchema):
|
|||
|
|
"""
|
|||
|
|
创建文章时请求体：
|
|||
|
|
{
|
|||
|
|
"article": {
|
|||
|
|
"title": "...",
|
|||
|
|
"description": "...",
|
|||
|
|
"body": "...",
|
|||
|
|
"tagList": ["..."],
|
|||
|
|
"cover": "可选封面URL"
|
|||
|
|
}
|
|||
|
|
}
|
|||
|
|
"""
|
|||
|
|
title: str
|
|||
|
|
description: str
|
|||
|
|
body: str
|
|||
|
|
tags: List[str] = Field([], alias="tagList")
|
|||
|
|
cover: Optional[str] = None
|
|||
|
|
|
|||
|
|
|
|||
|
|
class ArticleInUpdate(RWSchema):
|
|||
|
|
"""
|
|||
|
|
更新文章时请求体（全部可选）：
|
|||
|
|
- 不传的字段不改
|
|||
|
|
- cover:
|
|||
|
|
- 不传：不改
|
|||
|
|
- 传 null / ""：清空封面（配合 repo 的 cover_provided 使用）
|
|||
|
|
- 传字符串：更新为新封面
|
|||
|
|
"""
|
|||
|
|
title: Optional[str] = None
|
|||
|
|
description: Optional[str] = None
|
|||
|
|
body: Optional[str] = None
|
|||
|
|
cover: Optional[str] = None
|
|||
|
|
is_top: Optional[bool] = None
|
|||
|
|
is_featured: Optional[bool] = None
|
|||
|
|
sort_weight: Optional[int] = None
|
|||
|
|
|
|||
|
|
|
|||
|
|
class ListOfArticlesInResponse(RWSchema):
|
|||
|
|
articles: List[ArticleForResponse]
|
|||
|
|
articles_count: int
|
|||
|
|
|
|||
|
|
|
|||
|
|
class ArticlesFilters(BaseModel):
|
|||
|
|
tag: Optional[str] = None
|
|||
|
|
tags: Optional[List[str]] = None
|
|||
|
|
author: Optional[str] = None
|
|||
|
|
favorited: Optional[str] = None
|
|||
|
|
search: Optional[str] = None
|
|||
|
|
limit: int = Field(DEFAULT_ARTICLES_LIMIT, ge=1)
|
|||
|
|
offset: int = Field(DEFAULT_ARTICLES_OFFSET, ge=0)
|