"""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])