Add the Annotation.moderation_status column

This column will support the existing feature stored in AnnotationModeration and new features based on the new statuses.

Author: marcospri

h/models/annotation.py

@@ -1,20 +1,32 @@
 import datetime
+from enum import Enum
 from uuid import UUID
 
 import sqlalchemy as sa
 from sqlalchemy.dialects import postgresql as pg
 from sqlalchemy.ext.hybrid import hybrid_property
 from sqlalchemy.ext.mutable import MutableDict, MutableList
+from sqlalchemy.orm import Mapped, relationship
 
 from h.db import Base, types
 from h.models.group import Group
 from h.util import markdown_render, uri
 from h.util.user import split_user
 
 
+class ModerationStatus(Enum):
+    APPROVED = "APPROVED"
+    PENDING = "PENDING"
+    DENIED = "DENIED"
+    SPAM = "SPAM"
+
+
 class Annotation(Base):
     """Model class representing a single annotation."""
 
+    # Expose the ModerationStatus directly here
+    ModerationStatus = ModerationStatus
+
     __tablename__ = "annotation"
     __table_args__ = (
         # Tags are stored in an array-type column, and indexed using a
@@ -68,7 +80,7 @@ class Annotation(Base):
         index=True,
     )
 
-    group = sa.orm.relationship(
+    group = relationship(
         Group,
         primaryjoin=(Group.pubid == groupid),
         foreign_keys=[groupid],
@@ -138,11 +150,15 @@ class Annotation(Base):
         uselist=True,
     )
 
-    mentions = sa.orm.relationship("Mention", back_populates="annotation")
+    mentions = relationship("Mention", back_populates="annotation")
 
-    notifications = sa.orm.relationship(
-        "Notification", back_populates="source_annotation"
-    )
+    notifications = relationship("Notification", back_populates="source_annotation")
+
+    moderation_status: Mapped[ModerationStatus | None]
+    """Current moderation status of the annotation.
+
+    None means the annotation is either "approved" before this column was added  or it's a private annotation.
+    """
 
     @property
     def uuid(self):