claude code

backend/app/schemas/category.py

@@ -0,0 +1,48 @@
+"""Schémas Pydantic pour les catégories.
+
+Définit les schémas de validation pour les requêtes et réponses API.
+"""
+
+from datetime import datetime
+
+from pydantic import BaseModel, ConfigDict, Field
+
+
+class CategoryBase(BaseModel):
+    """Schéma de base pour les catégories."""
+
+    name: str = Field(..., min_length=1, max_length=100, description="Nom de la catégorie")
+    description: str | None = Field(None, max_length=1000, description="Description optionnelle")
+    color: str | None = Field(None, pattern=r"^#[0-9A-Fa-f]{6}$", description="Couleur hex (#RRGGBB)")
+    icon: str | None = Field(None, max_length=50, description="Nom de l'icône")
+
+
+class CategoryCreate(CategoryBase):
+    """Schéma pour la création d'une catégorie."""
+
+    pass
+
+
+class CategoryUpdate(BaseModel):
+    """Schéma pour la mise à jour d'une catégorie (tous les champs optionnels)."""
+
+    name: str | None = Field(None, min_length=1, max_length=100)
+    description: str | None = Field(None, max_length=1000)
+    color: str | None = Field(None, pattern=r"^#[0-9A-Fa-f]{6}$")
+    icon: str | None = Field(None, max_length=50)
+
+
+class CategoryResponse(CategoryBase):
+    """Schéma de réponse pour une catégorie."""
+
+    model_config = ConfigDict(from_attributes=True)
+
+    id: int
+    created_at: datetime
+    updated_at: datetime
+
+
+class CategoryWithItemCount(CategoryResponse):
+    """Schéma de réponse avec le nombre d'objets."""
+
+    item_count: int = Field(default=0, description="Nombre d'objets dans cette catégorie")