generated from gilles/template-webapp
62 lines
2.1 KiB
Python
62 lines
2.1 KiB
Python
"""Modèle SQLAlchemy pour les catégories d'objets.
|
|
|
|
Les catégories permettent de classer les objets par domaine d'utilisation
|
|
(bricolage, informatique, électronique, cuisine, etc.).
|
|
"""
|
|
|
|
from datetime import datetime
|
|
from typing import TYPE_CHECKING
|
|
|
|
from sqlalchemy import DateTime, String, Text
|
|
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
|
|
|
|
|
|
class Category(Base):
|
|
"""Catégorie d'objets.
|
|
|
|
Attributes:
|
|
id: Identifiant unique auto-incrémenté
|
|
name: Nom de la catégorie (ex: "Bricolage", "Informatique")
|
|
description: Description optionnelle de la catégorie
|
|
color: Couleur hexadécimale pour l'affichage (ex: "#3b82f6")
|
|
icon: Nom d'icône optionnel (ex: "wrench", "computer")
|
|
created_at: Date/heure de création (auto)
|
|
updated_at: Date/heure de dernière modification (auto)
|
|
items: Relation vers les objets de cette catégorie
|
|
"""
|
|
|
|
__tablename__ = "categories"
|
|
|
|
# Colonnes
|
|
id: Mapped[int] = mapped_column(primary_key=True, autoincrement=True)
|
|
name: Mapped[str] = mapped_column(String(100), unique=True, nullable=False, index=True)
|
|
description: Mapped[str | None] = mapped_column(Text, nullable=True)
|
|
color: Mapped[str | None] = mapped_column(String(7), nullable=True) # Format: #RRGGBB
|
|
icon: Mapped[str | None] = mapped_column(String(50), nullable=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
|
|
items: Mapped[list["Item"]] = relationship(
|
|
"Item", back_populates="category", cascade="all, delete-orphan"
|
|
)
|
|
|
|
def __repr__(self) -> str:
|
|
"""Représentation string de la catégorie."""
|
|
return f"<Category(id={self.id}, name='{self.name}')>"
|