kanban-app/backend/app/models/board.py

from datetime import UTC, datetime

from sqlalchemy.dialects.postgresql import JSONB

from app import db
from app.models.base import SoftDeleteMixin


class Board(db.Model, SoftDeleteMixin):
    """Board model for Kanban boards"""

    __tablename__ = "boards"

    id = db.Column(db.Integer, primary_key=True)
    name = db.Column(db.String(200), nullable=False, index=True)
    description = db.Column(db.Text)
    closed = db.Column(db.Boolean, default=False, index=True)
    url = db.Column(db.String(500))
    short_link = db.Column(db.String(10), unique=True)
    short_url = db.Column(db.String(500))

    # Foreign keys
    user_id = db.Column(
        db.Integer,
        db.ForeignKey("users.id", ondelete="CASCADE"),
        nullable=False,
        index=True,
    )

    # Timestamps
    date_last_activity = db.Column(db.DateTime)
    date_last_view = db.Column(db.DateTime)
    created_at = db.Column(db.DateTime, default=lambda: datetime.now(UTC))
    updated_at = db.Column(
        db.DateTime,
        default=lambda: datetime.now(UTC),
        onupdate=lambda: datetime.now(UTC),
    )

    # JSON fields for complex data
    prefs = db.Column(JSONB)  # board preferences
    label_names = db.Column(JSONB)  # label color mappings
    limits = db.Column(JSONB)  # various limits

    # Relationships - only active records
    lists = db.relationship(
        "List",
        backref="board",
        cascade="all, delete-orphan",
        lazy="dynamic",
        primaryjoin="and_(Board.id == List.board_id, List.status == 'active')",
    )
    cards = db.relationship(
        "Card",
        backref="board",
        cascade="all, delete-orphan",
        lazy="dynamic",
        primaryjoin="and_(Board.id == Card.board_id, Card.status == 'active')",
    )
    labels = db.relationship(
        "Label",
        backref="board",
        cascade="all, delete-orphan",
        lazy="dynamic",
        primaryjoin="and_(Board.id == Label.board_id, Label.status == 'active')",
    )

    def to_dict(self):
        """Convert board to dictionary"""
        return {
            "id": self.id,
            "name": self.name,
            "description": self.description,
            "closed": self.closed,
            "url": self.url,
            "short_link": self.short_link,
            "short_url": self.short_url,
            "user_id": self.user_id,
            "date_last_activity": self.date_last_activity.isoformat()
            if self.date_last_activity
            else None,
            "date_last_view": self.date_last_view.isoformat()
            if self.date_last_view
            else None,
            "created_at": self.created_at.isoformat() if self.created_at else None,
            "updated_at": self.updated_at.isoformat() if self.updated_at else None,
            "prefs": self.prefs,
            "label_names": self.label_names,
            "limits": self.limits,
            "status": self.status,
            "deleted_at": self.deleted_at.isoformat() if self.deleted_at else None,
        }

    def __repr__(self):
        return f"<Board {self.name}>"