claude code

backend/app/schemas/common.py

@@ -0,0 +1,60 @@
+"""Schémas Pydantic communs.
+
+Définit les schémas réutilisables (pagination, erreurs, etc.).
+"""
+
+from typing import Generic, TypeVar
+
+from pydantic import BaseModel, Field
+
+T = TypeVar("T")
+
+
+class PaginationParams(BaseModel):
+    """Paramètres de pagination."""
+
+    page: int = Field(default=1, ge=1, description="Numéro de page (commence à 1)")
+    page_size: int = Field(default=20, ge=1, le=100, description="Nombre d'éléments par page")
+
+    @property
+    def offset(self) -> int:
+        """Calcule l'offset pour la requête SQL."""
+        return (self.page - 1) * self.page_size
+
+
+class PaginatedResponse(BaseModel, Generic[T]):
+    """Réponse paginée générique."""
+
+    items: list[T]
+    total: int = Field(..., description="Nombre total d'éléments")
+    page: int = Field(..., description="Page actuelle")
+    page_size: int = Field(..., description="Taille de la page")
+    pages: int = Field(..., description="Nombre total de pages")
+
+    @classmethod
+    def create(
+        cls, items: list[T], total: int, page: int, page_size: int
+    ) -> "PaginatedResponse[T]":
+        """Crée une réponse paginée."""
+        pages = (total + page_size - 1) // page_size if page_size > 0 else 0
+        return cls(
+            items=items,
+            total=total,
+            page=page,
+            page_size=page_size,
+            pages=pages,
+        )
+
+
+class ErrorResponse(BaseModel):
+    """Schéma de réponse d'erreur."""
+
+    detail: str = Field(..., description="Message d'erreur")
+    type: str = Field(..., description="Type d'erreur")
+
+
+class SuccessResponse(BaseModel):
+    """Schéma de réponse de succès."""
+
+    message: str = Field(..., description="Message de succès")
+    id: int | None = Field(None, description="ID de l'élément concerné")