resolutionflow/backend/app/models/category.py

import uuid
from datetime import datetime, timezone
from typing import Optional, TYPE_CHECKING
from sqlalchemy import String, Text, DateTime, ForeignKey, Boolean, Integer, UniqueConstraint
from sqlalchemy.orm import Mapped, mapped_column, relationship
from sqlalchemy.dialects.postgresql import UUID
from app.core.database import Base

if TYPE_CHECKING:
    from app.models.tree import Tree
    from app.models.team import Team
    from app.models.account import Account
    from app.models.user import User


class TreeCategory(Base):
    """Admin-managed categories for organizing trees.

    Categories can be:
    - Global (team_id=NULL): Created by ResolutionFlow admins, visible to all
    - Team-specific (team_id set): Created by team admins, visible to team members
    """
    __tablename__ = "tree_categories"
    __table_args__ = (
        UniqueConstraint('slug', 'team_id', name='uq_tree_categories_slug_team'),
    )

    id: Mapped[uuid.UUID] = mapped_column(
        UUID(as_uuid=True),
        primary_key=True,
        default=uuid.uuid4
    )
    name: Mapped[str] = mapped_column(String(100), nullable=False)
    slug: Mapped[str] = mapped_column(String(100), nullable=False, index=True)
    description: Mapped[Optional[str]] = mapped_column(Text, nullable=True)
    team_id: Mapped[Optional[uuid.UUID]] = mapped_column(
        UUID(as_uuid=True),
        ForeignKey("teams.id", ondelete="CASCADE"),
        nullable=True,
        index=True
    )
    account_id: Mapped[Optional[uuid.UUID]] = mapped_column(
        UUID(as_uuid=True),
        ForeignKey("accounts.id", ondelete="CASCADE"),
        nullable=True,
        index=True
    )
    display_order: Mapped[int] = mapped_column(Integer, nullable=False, default=0, index=True)
    is_active: Mapped[bool] = mapped_column(Boolean, nullable=False, default=True)
    color: Mapped[Optional[str]] = mapped_column(
        String(7), nullable=True, default='#3b82f6',
        comment="Hex color for category dot indicator"
    )
    created_by: Mapped[Optional[uuid.UUID]] = mapped_column(
        UUID(as_uuid=True),
        ForeignKey("users.id", ondelete="SET NULL"),
        nullable=True
    )
    created_at: Mapped[datetime] = mapped_column(
        DateTime(timezone=True),
        default=lambda: datetime.now(timezone.utc)
    )
    updated_at: Mapped[datetime] = mapped_column(
        DateTime(timezone=True),
        default=lambda: datetime.now(timezone.utc),
        onupdate=lambda: datetime.now(timezone.utc)
    )

    # Relationships
    team: Mapped[Optional["Team"]] = relationship("Team", back_populates="categories")
    account: Mapped[Optional["Account"]] = relationship("Account", foreign_keys=[account_id], back_populates="categories")
    creator: Mapped[Optional["User"]] = relationship("User", foreign_keys=[created_by])
    trees: Mapped[list["Tree"]] = relationship("Tree", back_populates="category_rel")

    @property
    def is_global(self) -> bool:
        """Returns True if this is a global category (not team or account-specific)."""
        return self.team_id is None and self.account_id is None