claude code

backend/app/models/document.py

@@ -0,0 +1,85 @@
+"""Modèle SQLAlchemy pour les documents attachés aux objets.
+
+Les documents peuvent être des photos, notices d'utilisation, factures, etc.
+Ils sont stockés sur le système de fichiers local.
+"""
+
+from datetime import datetime
+from typing import TYPE_CHECKING
+
+from sqlalchemy import DateTime, Enum, ForeignKey, Integer, String
+from sqlalchemy.orm import Mapped, mapped_column, relationship
+from sqlalchemy.sql import func
+
+from app.core.database import Base
+
+if TYPE_CHECKING:
+    from app.models.item import Item
+
+import enum
+
+
+class DocumentType(str, enum.Enum):
+    """Type de document."""
+
+    PHOTO = "photo"  # Photo de l'objet
+    MANUAL = "manual"  # Notice d'utilisation
+    INVOICE = "invoice"  # Facture d'achat
+    WARRANTY = "warranty"  # Garantie
+    OTHER = "other"  # Autre
+
+
+class Document(Base):
+    """Document attaché à un objet.
+
+    Attributes:
+        id: Identifiant unique auto-incrémenté
+        filename: Nom du fichier sur le disque (UUID + extension)
+        original_name: Nom original du fichier uploadé
+        type: Type de document (photo/manual/invoice/warranty/other)
+        mime_type: Type MIME (ex: "image/jpeg", "application/pdf")
+        size_bytes: Taille du fichier en octets
+        file_path: Chemin relatif du fichier (ex: "uploads/photos/uuid.jpg")
+        description: Description optionnelle
+        item_id: ID de l'objet associé (FK)
+        created_at: Date/heure de création (auto)
+        updated_at: Date/heure de dernière modification (auto)
+        item: Relation vers l'objet
+    """
+
+    __tablename__ = "documents"
+
+    # Colonnes
+    id: Mapped[int] = mapped_column(primary_key=True, autoincrement=True)
+    filename: Mapped[str] = mapped_column(String(255), nullable=False, unique=True)
+    original_name: Mapped[str] = mapped_column(String(255), nullable=False)
+    type: Mapped[DocumentType] = mapped_column(
+        Enum(DocumentType, native_enum=False, length=20), nullable=False
+    )
+    mime_type: Mapped[str] = mapped_column(String(100), nullable=False)
+    size_bytes: Mapped[int] = mapped_column(Integer, nullable=False)
+    file_path: Mapped[str] = mapped_column(String(500), nullable=False)
+    description: Mapped[str | None] = mapped_column(String(500), nullable=True)
+
+    # Foreign Key
+    item_id: Mapped[int] = mapped_column(
+        Integer, ForeignKey("items.id", ondelete="CASCADE"), nullable=False, index=True
+    )
+
+    # Timestamps
+    created_at: Mapped[datetime] = mapped_column(
+        DateTime(timezone=True), server_default=func.now(), nullable=False
+    )
+    updated_at: Mapped[datetime] = mapped_column(
+        DateTime(timezone=True),
+        server_default=func.now(),
+        onupdate=func.now(),
+        nullable=False,
+    )
+
+    # Relations
+    item: Mapped["Item"] = relationship("Item", back_populates="documents")
+
+    def __repr__(self) -> str:
+        """Représentation string du document."""
+        return f"<Document(id={self.id}, type={self.type.value}, filename='{self.filename}')>"