From 7f0d99d383f84351d2ceb945626407507ab85512 Mon Sep 17 00:00:00 2001
From: Bryan Van Deusen <bryan.vandeusen@fabledsword.com>
Date: Thu, 28 May 2026 19:54:01 -0400
Subject: [PATCH] feat(trash): SoftDeleteMixin applied to the 7 soft-deletable
 models

---
 src/fabledassistant/models/base.py      | 11 ++++++++++-
 src/fabledassistant/models/event.py     |  3 ++-
 src/fabledassistant/models/milestone.py |  4 ++--
 src/fabledassistant/models/note.py      |  4 ++--
 src/fabledassistant/models/project.py   |  4 ++--
 src/fabledassistant/models/rulebook.py  |  7 ++++---
 6 files changed, 22 insertions(+), 11 deletions(-)

diff --git a/src/fabledassistant/models/base.py b/src/fabledassistant/models/base.py
index 76743bd..8715097 100644
--- a/src/fabledassistant/models/base.py
+++ b/src/fabledassistant/models/base.py
@@ -1,9 +1,18 @@
 from datetime import datetime, timezone
 
-from sqlalchemy import DateTime
+from sqlalchemy import DateTime, Text
 from sqlalchemy.orm import Mapped, mapped_column
 
 
+class SoftDeleteMixin:
+    """Recoverable-delete columns. NULL deleted_at = live row. deleted_batch_id
+    groups rows soft-deleted in one operation so a cascade restores as a unit."""
+    deleted_at: Mapped[datetime | None] = mapped_column(
+        DateTime(timezone=True), nullable=True, default=None
+    )
+    deleted_batch_id: Mapped[str | None] = mapped_column(Text, nullable=True, default=None)
+
+
 class TimestampMixin:
     created_at: Mapped[datetime] = mapped_column(
         DateTime(timezone=True), default=lambda: datetime.now(timezone.utc)
diff --git a/src/fabledassistant/models/event.py b/src/fabledassistant/models/event.py
index a357467..e40ba5e 100644
--- a/src/fabledassistant/models/event.py
+++ b/src/fabledassistant/models/event.py
@@ -4,9 +4,10 @@ from sqlalchemy import Boolean, DateTime, ForeignKey, Integer, Text
 from sqlalchemy.orm import Mapped, mapped_column
 
 from fabledassistant.models import Base
+from fabledassistant.models.base import SoftDeleteMixin
 
 
-class Event(Base):
+class Event(Base, SoftDeleteMixin):
     __tablename__ = "events"
 
     id: Mapped[int] = mapped_column(primary_key=True)
diff --git a/src/fabledassistant/models/milestone.py b/src/fabledassistant/models/milestone.py
index 7312ce4..cfe9c5e 100644
--- a/src/fabledassistant/models/milestone.py
+++ b/src/fabledassistant/models/milestone.py
@@ -2,10 +2,10 @@ from sqlalchemy import ForeignKey, Integer, Text
 from sqlalchemy.orm import Mapped, mapped_column
 
 from fabledassistant.models import Base
-from fabledassistant.models.base import TimestampMixin
+from fabledassistant.models.base import TimestampMixin, SoftDeleteMixin
 
 
-class Milestone(Base, TimestampMixin):
+class Milestone(Base, TimestampMixin, SoftDeleteMixin):
     __tablename__ = "milestones"
 
     id: Mapped[int] = mapped_column(primary_key=True)
diff --git a/src/fabledassistant/models/note.py b/src/fabledassistant/models/note.py
index 048a8b0..ef16109 100644
--- a/src/fabledassistant/models/note.py
+++ b/src/fabledassistant/models/note.py
@@ -6,7 +6,7 @@ from sqlalchemy.dialects.postgresql import ARRAY, JSONB
 from sqlalchemy.orm import Mapped, mapped_column
 
 from fabledassistant.models import Base
-from fabledassistant.models.base import TimestampMixin
+from fabledassistant.models.base import TimestampMixin, SoftDeleteMixin
 
 
 class TaskStatus(str, enum.Enum):
@@ -23,7 +23,7 @@ class TaskPriority(str, enum.Enum):
     high = "high"
 
 
-class Note(Base, TimestampMixin):
+class Note(Base, TimestampMixin, SoftDeleteMixin):
     __tablename__ = "notes"
 
     id: Mapped[int] = mapped_column(primary_key=True)
diff --git a/src/fabledassistant/models/project.py b/src/fabledassistant/models/project.py
index 9c61ea8..cfdf900 100644
--- a/src/fabledassistant/models/project.py
+++ b/src/fabledassistant/models/project.py
@@ -3,7 +3,7 @@ from datetime import datetime
 from sqlalchemy import DateTime, ForeignKey, Integer, Text
 from sqlalchemy.orm import Mapped, mapped_column
 from fabledassistant.models import Base
-from fabledassistant.models.base import TimestampMixin
+from fabledassistant.models.base import TimestampMixin, SoftDeleteMixin
 
 
 class ProjectStatus(str, enum.Enum):
@@ -12,7 +12,7 @@ class ProjectStatus(str, enum.Enum):
     archived = "archived"
 
 
-class Project(Base, TimestampMixin):
+class Project(Base, TimestampMixin, SoftDeleteMixin):
     __tablename__ = "projects"
     id: Mapped[int] = mapped_column(primary_key=True)
     user_id: Mapped[int | None] = mapped_column(Integer, ForeignKey("users.id", ondelete="CASCADE"), nullable=True)
diff --git a/src/fabledassistant/models/rulebook.py b/src/fabledassistant/models/rulebook.py
index 3de66ff..16a93b0 100644
--- a/src/fabledassistant/models/rulebook.py
+++ b/src/fabledassistant/models/rulebook.py
@@ -4,9 +4,10 @@ from sqlalchemy import BigInteger, Column, DateTime, ForeignKey, Integer, Table,
 from sqlalchemy.orm import Mapped, mapped_column
 
 from fabledassistant.models import Base
+from fabledassistant.models.base import SoftDeleteMixin
 
 
-class Rulebook(Base):
+class Rulebook(Base, SoftDeleteMixin):
     __tablename__ = "rulebooks"
 
     id: Mapped[int] = mapped_column(BigInteger, primary_key=True)
@@ -35,7 +36,7 @@ class Rulebook(Base):
         }
 
 
-class RulebookTopic(Base):
+class RulebookTopic(Base, SoftDeleteMixin):
     __tablename__ = "rulebook_topics"
     __table_args__ = (
         UniqueConstraint("rulebook_id", "title", name="uq_topic_per_rulebook"),
@@ -69,7 +70,7 @@ class RulebookTopic(Base):
         }
 
 
-class Rule(Base):
+class Rule(Base, SoftDeleteMixin):
     __tablename__ = "rules"
     __table_args__ = (
         UniqueConstraint("topic_id", "title", name="uq_rule_per_topic"),