[Issue #6951] Create table for capturing ignored legacy org user (#7051)

## Summary

<!-- Use "Fixes" to automatically close issue upon PR merge. Use "Work
for" when UAT is required. -->
Fixes  for #6951  

## Changes proposed
Model and factory created for  table `ignored_legacy_organization_user` 
Migration file created

Author: babebe

api/src/db/migrations/versions/2025_11_13_add_ignored_legacy_organization_user_.py

@@ -0,0 +1,90 @@
+"""add_ignored_legacy_organization_user_table
+
+Revision ID: 19e80334aaae
+Revises: df81941231ad
+Create Date: 2025-11-13 21:16:33.936592
+
+"""
+
+import sqlalchemy as sa
+from alembic import op
+
+# revision identifiers, used by Alembic.
+revision = "19e80334aaae"
+down_revision = "df81941231ad"
+branch_labels = None
+depends_on = None
+
+
+def upgrade():
+    # ### commands auto generated by Alembic - please adjust! ###
+    op.create_table(
+        "ignored_legacy_organization_user",
+        sa.Column("ignored_legacy_organization_user_id", sa.UUID(), nullable=False),
+        sa.Column("organization_id", sa.UUID(), nullable=False),
+        sa.Column("email", sa.Text(), nullable=False),
+        sa.Column("ignored_by_user_id", sa.UUID(), nullable=False),
+        sa.Column(
+            "created_at",
+            sa.TIMESTAMP(timezone=True),
+            server_default=sa.text("now()"),
+            nullable=False,
+        ),
+        sa.Column(
+            "updated_at",
+            sa.TIMESTAMP(timezone=True),
+            server_default=sa.text("now()"),
+            nullable=False,
+        ),
+        sa.ForeignKeyConstraint(
+            ["ignored_by_user_id"],
+            ["api.user.user_id"],
+            name=op.f("ignored_legacy_organization_user_ignored_by_user_id_user_fkey"),
+        ),
+        sa.ForeignKeyConstraint(
+            ["organization_id"],
+            ["api.organization.organization_id"],
+            name=op.f("ignored_legacy_organization_user_organization_id_organization_fkey"),
+        ),
+        sa.PrimaryKeyConstraint(
+            "ignored_legacy_organization_user_id",
+            name=op.f("ignored_legacy_organization_user_pkey"),
+        ),
+        sa.UniqueConstraint(
+            "organization_id",
+            "email",
+            name=op.f("ignored_legacy_organization_user_organization_id_uniq"),
+        ),
+        schema="api",
+    )
+    op.create_index(
+        op.f("ignored_legacy_organization_user_email_idx"),
+        "ignored_legacy_organization_user",
+        ["email"],
+        unique=False,
+        schema="api",
+    )
+    op.create_index(
+        op.f("ignored_legacy_organization_user_ignored_by_user_id_idx"),
+        "ignored_legacy_organization_user",
+        ["ignored_by_user_id"],
+        unique=False,
+        schema="api",
+    )
+    # ### end Alembic commands ###
+
+
+def downgrade():
+    # ### commands auto generated by Alembic - please adjust! ###
+    op.drop_index(
+        op.f("ignored_legacy_organization_user_ignored_by_user_id_idx"),
+        table_name="ignored_legacy_organization_user",
+        schema="api",
+    )
+    op.drop_index(
+        op.f("ignored_legacy_organization_user_email_idx"),
+        table_name="ignored_legacy_organization_user",
+        schema="api",
+    )
+    op.drop_table("ignored_legacy_organization_user", schema="api")
+    # ### end Alembic commands ###

api/src/db/models/entity_models.py

@@ -2,7 +2,7 @@
 from datetime import date, datetime
 from typing import TYPE_CHECKING
 
-from sqlalchemy import ForeignKey
+from sqlalchemy import ForeignKey, UniqueConstraint
 from sqlalchemy.dialects.postgresql import UUID
 from sqlalchemy.orm import Mapped, mapped_column, relationship
 
@@ -172,3 +172,23 @@ class LinkOrganizationInvitationToRole(ApiSchemaTable, TimestampMixin):
         ForeignKey(OrganizationInvitation.organization_invitation_id), primary_key=True
     )
     organization_invitation: Mapped[OrganizationInvitation] = relationship(OrganizationInvitation)
+
+
+class IgnoredLegacyOrganizationUser(ApiSchemaTable, TimestampMixin):
+    __tablename__ = "ignored_legacy_organization_user"
+    __table_args__ = (
+        # We want a unique constraint to prevent duplicate hide records for an organization
+        UniqueConstraint("organization_id", "email"),
+        # Need to define the table args like this to inherit whatever we set on the super table
+        # otherwise we end up overwriting things and Alembic remakes the whole table
+        ApiSchemaTable.__table_args__,
+    )
+
+    ignored_legacy_organization_user_id: Mapped[uuid.UUID] = mapped_column(primary_key=True)
+    organization_id: Mapped[uuid.UUID] = mapped_column(ForeignKey(Organization.organization_id))
+    organization: Mapped["Organization"] = relationship(Organization)
+    email: Mapped[str] = mapped_column(index=True)
+    ignored_by_user_id: Mapped[uuid.UUID] = mapped_column(
+        ForeignKey("api.user.user_id"), index=True
+    )
+    user: Mapped["User"] = relationship("User")

api/tests/src/db/models/factories.py

@@ -3091,6 +3091,18 @@ class Meta:
     )
 
 
+class IgnoredLegacyOrganizationUserFactory(BaseFactory):
+    class Meta:
+        model = entity_models.IgnoredLegacyOrganizationUser
+
+    ignored_legacy_organization_user_id = Generators.UuidObj
+    organization = factory.SubFactory(OrganizationFactory)
+    organization_id = factory.LazyAttribute(lambda o: o.organization.organization_id)
+    email = factory.Faker("email")
+    user = factory.SubFactory(UserFactory)
+    ignored_by_user_id = factory.LazyAttribute(lambda o: o.user.user_id)
+
+
 class SuppressedEmailFactory(BaseFactory):
     class Meta:
         model = user_models.SuppressedEmail