Pre_Seg_Server/backend/models.py

"""SQLAlchemy ORM models."""

from sqlalchemy import (
    Column,
    Integer,
    String,
    Text,
    DateTime,
    ForeignKey,
    JSON,
    Float,
)
from sqlalchemy.orm import relationship
from sqlalchemy.sql import func

from database import Base
from statuses import PROJECT_STATUS_PENDING


class User(Base):
    """Application user used for authentication and data ownership."""

    __tablename__ = "users"

    id = Column(Integer, primary_key=True, index=True)
    username = Column(String(150), unique=True, index=True, nullable=False)
    password_hash = Column(String(255), nullable=False)
    role = Column(String(50), default="annotator", nullable=False)
    is_active = Column(Integer, default=1, nullable=False)
    created_at = Column(DateTime(timezone=True), server_default=func.now())
    updated_at = Column(
        DateTime(timezone=True), server_default=func.now(), onupdate=func.now()
    )

    projects = relationship("Project", back_populates="owner")
    templates = relationship("Template", back_populates="owner")


class Project(Base):
    """Project model representing a segmentation project."""

    __tablename__ = "projects"

    id = Column(Integer, primary_key=True, index=True)
    name = Column(String(255), nullable=False)
    description = Column(Text, nullable=True)
    video_path = Column(String(512), nullable=True)
    thumbnail_url = Column(String(512), nullable=True)
    status = Column(String(50), default=PROJECT_STATUS_PENDING, nullable=False)
    source_type = Column(String(20), default="video", nullable=False)  # video | dicom
    original_fps = Column(Float, nullable=True)
    parse_fps = Column(Float, default=30.0, nullable=False)
    owner_user_id = Column(Integer, ForeignKey("users.id", ondelete="SET NULL"), nullable=True)
    created_at = Column(DateTime(timezone=True), server_default=func.now())
    updated_at = Column(
        DateTime(timezone=True), server_default=func.now(), onupdate=func.now()
    )

    owner = relationship("User", back_populates="projects")
    frames = relationship("Frame", back_populates="project", cascade="all, delete-orphan")
    annotations = relationship(
        "Annotation", back_populates="project", cascade="all, delete-orphan"
    )
    tasks = relationship(
        "ProcessingTask", back_populates="project", cascade="all, delete-orphan"
    )


class Frame(Base):
    """Frame model representing an extracted video frame."""

    __tablename__ = "frames"

    id = Column(Integer, primary_key=True, index=True)
    project_id = Column(Integer, ForeignKey("projects.id", ondelete="CASCADE"), nullable=False)
    frame_index = Column(Integer, nullable=False)
    image_url = Column(String(512), nullable=False)
    width = Column(Integer, nullable=True)
    height = Column(Integer, nullable=True)
    timestamp_ms = Column(Float, nullable=True)
    source_frame_number = Column(Integer, nullable=True)
    created_at = Column(DateTime(timezone=True), server_default=func.now())

    project = relationship("Project", back_populates="frames")
    annotations = relationship(
        "Annotation", back_populates="frame", cascade="all, delete-orphan"
    )


class Template(Base):
    """Template (Ontology) model for segmentation classes."""

    __tablename__ = "templates"

    id = Column(Integer, primary_key=True, index=True)
    name = Column(String(255), nullable=False)
    description = Column(Text, nullable=True)
    color = Column(String(50), nullable=False)
    z_index = Column(Integer, default=0, nullable=False)
    mapping_rules = Column(JSON, nullable=True)
    owner_user_id = Column(Integer, ForeignKey("users.id", ondelete="SET NULL"), nullable=True)
    created_at = Column(DateTime(timezone=True), server_default=func.now())

    owner = relationship("User", back_populates="templates")
    annotations = relationship(
        "Annotation", back_populates="template", cascade="all, delete-orphan"
    )


class Annotation(Base):
    """Annotation model for segmentation masks and prompts."""

    __tablename__ = "annotations"

    id = Column(Integer, primary_key=True, index=True)
    project_id = Column(
        Integer, ForeignKey("projects.id", ondelete="CASCADE"), nullable=False
    )
    frame_id = Column(
        Integer, ForeignKey("frames.id", ondelete="CASCADE"), nullable=True
    )
    template_id = Column(
        Integer, ForeignKey("templates.id", ondelete="SET NULL"), nullable=True
    )
    mask_data = Column(JSON, nullable=True)
    points = Column(JSON, nullable=True)
    bbox = Column(JSON, nullable=True)
    created_at = Column(DateTime(timezone=True), server_default=func.now())
    updated_at = Column(
        DateTime(timezone=True), server_default=func.now(), onupdate=func.now()
    )

    project = relationship("Project", back_populates="annotations")
    frame = relationship("Frame", back_populates="annotations")
    template = relationship("Template", back_populates="annotations")
    masks = relationship("Mask", back_populates="annotation", cascade="all, delete-orphan")


class Mask(Base):
    """Mask model for exported/derived mask files."""

    __tablename__ = "masks"

    id = Column(Integer, primary_key=True, index=True)
    annotation_id = Column(
        Integer, ForeignKey("annotations.id", ondelete="CASCADE"), nullable=False
    )
    mask_url = Column(String(512), nullable=False)
    format = Column(String(50), default="png", nullable=False)  # png / rle / json
    created_at = Column(DateTime(timezone=True), server_default=func.now())

    annotation = relationship("Annotation", back_populates="masks")


class AuditLog(Base):
    """Audit trail for security and administrative actions."""

    __tablename__ = "audit_logs"

    id = Column(Integer, primary_key=True, index=True)
    actor_user_id = Column(Integer, ForeignKey("users.id", ondelete="SET NULL"), nullable=True)
    action = Column(String(120), nullable=False)
    target_type = Column(String(80), nullable=True)
    target_id = Column(String(120), nullable=True)
    detail = Column(JSON, nullable=True)
    created_at = Column(DateTime(timezone=True), server_default=func.now())

    actor = relationship("User")


class ProcessingTask(Base):
    """Background task state persisted for dashboard and polling."""

    __tablename__ = "processing_tasks"

    id = Column(Integer, primary_key=True, index=True)
    task_type = Column(String(80), nullable=False)
    status = Column(String(40), default="queued", nullable=False)
    progress = Column(Integer, default=0, nullable=False)
    message = Column(Text, nullable=True)
    project_id = Column(
        Integer, ForeignKey("projects.id", ondelete="CASCADE"), nullable=True
    )
    celery_task_id = Column(String(255), nullable=True)
    payload = Column(JSON, nullable=True)
    result = Column(JSON, nullable=True)
    error = Column(Text, nullable=True)
    created_at = Column(DateTime(timezone=True), server_default=func.now())
    started_at = Column(DateTime(timezone=True), nullable=True)
    finished_at = Column(DateTime(timezone=True), nullable=True)
    updated_at = Column(
        DateTime(timezone=True), server_default=func.now(), onupdate=func.now()
    )

    project = relationship("Project", back_populates="tasks")