68 lines
4.1 KiB
Python
68 lines
4.1 KiB
Python
|
"""Wiki plugin routes — articles CRUD, categories, versioning."""
|
||
|
|
from __future__ import annotations
|
||
|
|
import uuid
|
||
|
|
from fastapi import APIRouter, Depends, HTTPException, Query, status
|
||
|
|
from sqlalchemy.ext.asyncio import AsyncSession
|
||
|
|
from app.core.db import get_db
|
||
|
|
from app.deps import get_current_user, require_permission
|
||
|
|
from app.plugins.builtins.wiki import services
|
||
|
|
from app.plugins.builtins.wiki.schemas import ArticleCreate, ArticleUpdate, CategoryCreate, CategoryUpdate
|
||
|
|
|
||
|
|
router = APIRouter(prefix="/api/v1/wiki", tags=["wiki"])
|
||
|
|
|
||
|
|
|
||
|
|
@router.get("/articles")
|
||
|
|
async def list_articles(page: int = Query(1, ge=1), page_size: int = Query(20, ge=1, le=100), category_id: str | None = None, status: str | None = None, search: str | None = None, db: AsyncSession = Depends(get_db), current_user: dict = Depends(require_permission("wiki:read"))):
|
||
|
|
return await services.list_articles(uuid.UUID(current_user["tenant_id"]), page=page, page_size=page_size, category_id=category_id, status=status, search=search)
|
||
|
|
|
||
|
|
|
||
|
|
@router.post("/articles", status_code=status.HTTP_201_CREATED)
|
||
|
|
async def create_article(body: ArticleCreate, db: AsyncSession = Depends(get_db), current_user: dict = Depends(require_permission("wiki:write"))):
|
||
|
|
return await services.create_article(uuid.UUID(current_user["tenant_id"]), uuid.UUID(current_user["user_id"]), body.model_dump())
|
||
|
|
|
||
|
|
|
||
|
|
@router.get("/articles/{article_id}")
|
||
|
|
async def get_article(article_id: str, db: AsyncSession = Depends(get_db), current_user: dict = Depends(require_permission("wiki:read"))):
|
||
|
|
result = await services.get_article(uuid.UUID(current_user["tenant_id"]), uuid.UUID(article_id))
|
||
|
|
if result is None:
|
||
|
|
raise HTTPException(status_code=404, detail={"detail": "Article not found", "code": "not_found"})
|
||
|
|
return result
|
||
|
|
|
||
|
|
|
||
|
|
@router.patch("/articles/{article_id}")
|
||
|
|
async def update_article(article_id: str, body: ArticleUpdate, db: AsyncSession = Depends(get_db), current_user: dict = Depends(require_permission("wiki:write"))):
|
||
|
|
result = await services.update_article(uuid.UUID(current_user["tenant_id"]), uuid.UUID(current_user["user_id"]), uuid.UUID(article_id), body.model_dump(exclude_unset=True))
|
||
|
|
if result is None:
|
||
|
|
raise HTTPException(status_code=404, detail={"detail": "Article not found", "code": "not_found"})
|
||
|
|
return result
|
||
|
|
|
||
|
|
|
||
|
|
@router.delete("/articles/{article_id}", status_code=status.HTTP_204_NO_CONTENT)
|
||
|
|
async def delete_article(article_id: str, db: AsyncSession = Depends(get_db), current_user: dict = Depends(require_permission("wiki:delete"))):
|
||
|
|
ok = await services.delete_article(uuid.UUID(current_user["tenant_id"]), uuid.UUID(article_id))
|
||
|
|
if not ok:
|
||
|
|
raise HTTPException(status_code=404, detail={"detail": "Article not found", "code": "not_found"})
|
||
|
|
|
||
|
|
|
||
|
|
@router.get("/articles/{article_id}/versions")
|
||
|
|
async def list_versions(article_id: str, db: AsyncSession = Depends(get_db), current_user: dict = Depends(require_permission("wiki:read"))):
|
||
|
|
return {"items": await services.list_versions(uuid.UUID(current_user["tenant_id"]), uuid.UUID(article_id))}
|
||
|
|
|
||
|
|
|
||
|
|
@router.post("/articles/{article_id}/versions/{version}/restore")
|
||
|
|
async def restore_version(article_id: str, version: int, db: AsyncSession = Depends(get_db), current_user: dict = Depends(require_permission("wiki:write"))):
|
||
|
|
result = await services.restore_version(uuid.UUID(current_user["tenant_id"]), uuid.UUID(current_user["user_id"]), uuid.UUID(article_id), version)
|
||
|
|
if result is None:
|
||
|
|
raise HTTPException(status_code=404, detail={"detail": "Version not found", "code": "not_found"})
|
||
|
|
return result
|
||
|
|
|
||
|
|
|
||
|
|
@router.get("/categories")
|
||
|
|
async def list_categories(db: AsyncSession = Depends(get_db), current_user: dict = Depends(require_permission("wiki:read"))):
|
||
|
|
return {"items": await services.list_categories(uuid.UUID(current_user["tenant_id"]))}
|
||
|
|
|
||
|
|
|
||
|
|
@router.post("/categories", status_code=status.HTTP_201_CREATED)
|
||
|
|
async def create_category(body: CategoryCreate, db: AsyncSession = Depends(get_db), current_user: dict = Depends(require_permission("wiki:write"))):
|
||
|
|
return await services.create_category(uuid.UUID(current_user["tenant_id"]), uuid.UUID(current_user["user_id"]), body.model_dump())
|