feat. 添加文章列表分页接口

article/schema.py

@@ -0,0 +1,62 @@
+from datetime import datetime
+from typing import Optional, List, Generic, T
+
+from ninja import Schema
+from pydantic import Field
+
+
+# --- 假设的关联模型 Schema ---
+class AuthorSchema(Schema):
+    id: int
+    username: str
+
+
+class SectionSchema(Schema):
+    id: int
+    title: str  # 假设 MainMenu 有 name 字段
+
+
+class AttachmentSchema(Schema):
+    id: int
+    file: str  # 返回文件 URL 路径，如 "articles/attachments/2026/04/03/file.pdf"
+
+
+class PaginatedResponseSchema(Schema, Generic[T]):
+    items: List[T]
+    total: int
+    page: int
+    per_page: int
+    total_pages: int
+
+
+# --- Article 主 Schema ---
+class ArticleSchema(Schema):
+    id: int
+    title: str
+    content: str
+    cover: Optional[str] = None  # 图片 URL 路径
+    is_contribution: bool
+    is_published: bool
+    created_at: datetime
+    updated_at: datetime
+
+    # 关联字段
+    author: Optional[AuthorSchema] = None
+    section: Optional[SectionSchema] = None
+    attachments: List[AttachmentSchema] = Field(default_factory=list)
+
+
+# --- 创建文章用的 Schema (不含只读字段) ---
+class ArticleCreateSchema(Schema):
+    title: str
+    section_id: Optional[int] = None  # 外键通过 ID 传递
+    content: str
+    cover: Optional[str] = None  # 注意：文件上传通常需单独处理，此处仅为文本路径示例
+    is_contribution: bool = False
+    is_published: bool = True
+
+
+# --- 更新文章用的 Schema ---
+class ArticleUpdateSchema(ArticleCreateSchema):
+    title: Optional[str] = None
+    content: Optional[str] = None

article/views.py

@@ -1,10 +1,10 @@
-from django.http import HttpResponseForbidden
-from django.shortcuts import render
-
-from article.models import Article
-from utils.permission import user_has_permission
+from typing import List
 
 from ninja import Router
+from ninja.pagination import paginate, PageNumberPagination
+
+from article.models import Article
+from article.schema import ArticleSchema, ArticleCreateSchema
 
 # Create your views here.
 
@@ -12,9 +12,23 @@ from ninja import Router
 router = Router(tags=['content'])
 
 
-@router.get('/article', description="获取文章列表")
-def article_details(request):
-    if not user_has_permission(request.user, 'article', 'view'):
-        return HttpResponseForbidden("无权访问")
-    articles = Article.objects.all()
-    return render(request, 'articles/list.html', {'articles': articles})
+@router.get("/article", response=List[ArticleSchema], description="获取文章列表")
+@paginate(PageNumberPagination, page_size=50)
+def list_articles(request, ):
+    # 安全校验 per_page（防止过大
+    queryset = Article.objects.prefetch_related('attachments').select_related('author', 'section')
+    return queryset
+
+
+@router.post("/article", response=ArticleSchema)
+def create_article(request, payload: ArticleCreateSchema):
+    # 注意：文件上传需额外处理（此处简化）
+    article = Article.objects.create(
+        title=payload.title,
+        section_id=payload.section_id,
+        author=request.auth,  # 假设认证用户是作者
+        content=payload.content,
+        is_contribution=payload.is_contribution,
+        is_published=payload.is_published,
+    )
+    return article