102 lines
3.6 KiB
Python
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])
|