from pydantic import BaseModel, Field from typing import Optional, List class RecommendRequest(BaseModel): query: str = Field(..., min_length=1, max_length=500, description="Free-text product query") budget_max: Optional[float] = Field(None, ge=0, description="Maximum budget in USD") category: Optional[str] = Field(None, description="electronics|fashion|home|health|entertainment|grocery") limit: Optional[int] = Field(10, ge=1, le=20, description="Max products to return") class QuestionnaireResponse(BaseModel): question_id: str answer_index: Optional[int] = None answer_text: Optional[str] = None skipped: bool = False class FullRecommendRequest(BaseModel): responses: List[QuestionnaireResponse] lang: Optional[str] = Field("en", description="Language: en | pt") limit: Optional[int] = Field(10, ge=1, le=20)