Files

102 lines
3.6 KiB
Python

"""CRUD API for recommended questions."""
from __future__ import annotations
import logging
from datetime import datetime
from uuid import uuid4
from fastapi import APIRouter, HTTPException, Request
from pydantic import BaseModel, Field
logger = logging.getLogger(__name__)
router = APIRouter(prefix="/api", tags=["recommended-questions"])
class RecommendedQuestionResponse(BaseModel):
id: str
title: str
content: str
sort_order: int = 0
created_at: datetime | str | None = None
updated_at: datetime | str | None = None
class RecommendedQuestionsListResponse(BaseModel):
questions: list[RecommendedQuestionResponse]
class RecommendedQuestionCreateRequest(BaseModel):
title: str = Field(..., min_length=1, max_length=256)
content: str = Field(..., min_length=1)
sort_order: int = Field(default=0)
class RecommendedQuestionUpdateRequest(BaseModel):
title: str | None = Field(default=None, max_length=256)
content: str | None = None
sort_order: int | None = None
class ReorderRequest(BaseModel):
ids: list[str] = Field(..., description="Question IDs in the desired order")
def _get_store(request: Request):
store = getattr(request.app.state, "recommended_question_store", None)
if store is None:
raise HTTPException(status_code=503, detail="Recommended question store not available")
return store
@router.get("/recommended-questions", response_model=RecommendedQuestionsListResponse)
async def list_recommended_questions(request: Request) -> RecommendedQuestionsListResponse:
store = _get_store(request)
rows = await store.list_all()
return RecommendedQuestionsListResponse(questions=[RecommendedQuestionResponse(**r) for r in rows])
@router.post("/recommended-questions", response_model=RecommendedQuestionResponse, status_code=201)
async def create_recommended_question(request: Request, body: RecommendedQuestionCreateRequest) -> RecommendedQuestionResponse:
store = _get_store(request)
data = {
"id": str(uuid4()),
"title": body.title.strip(),
"content": body.content.strip(),
"sort_order": body.sort_order,
}
row = await store.create(data)
return RecommendedQuestionResponse(**row)
@router.put("/recommended-questions/{question_id}", response_model=RecommendedQuestionResponse)
async def update_recommended_question(request: Request, question_id: str, body: RecommendedQuestionUpdateRequest) -> RecommendedQuestionResponse:
store = _get_store(request)
data: dict = {}
if body.title is not None:
data["title"] = body.title.strip()
if body.content is not None:
data["content"] = body.content.strip()
if body.sort_order is not None:
data["sort_order"] = body.sort_order
row = await store.update(question_id, data)
if row is None:
raise HTTPException(status_code=404, detail="Question not found")
return RecommendedQuestionResponse(**row)
@router.delete("/recommended-questions/{question_id}", status_code=204)
async def delete_recommended_question(request: Request, question_id: str) -> None:
store = _get_store(request)
deleted = await store.delete(question_id)
if not deleted:
raise HTTPException(status_code=404, detail="Question not found")
@router.put("/recommended-questions-reorder", response_model=RecommendedQuestionsListResponse)
async def reorder_recommended_questions(request: Request, body: ReorderRequest) -> RecommendedQuestionsListResponse:
store = _get_store(request)
rows = await store.reorder(body.ids)
return RecommendedQuestionsListResponse(questions=[RecommendedQuestionResponse(**r) for r in rows])