"""trust & safety: reports, moderation_actions, appeals + user role/ban/suspend Revision ID: 0003_trust_safety Revises: 0002_add_date_of_birth_to_users Create Date: 2025-01-01 00:00:00.000000 """ from typing import Sequence, Union from alembic import op import sqlalchemy as sa from sqlalchemy.dialects import postgresql # revision identifiers, used by Alembic. revision: str = "0003_trust_safety" down_revision: Union[str, None] = "0002_add_date_of_birth_to_users" branch_labels: Union[str, Sequence[str], None] = None depends_on: Union[str, Sequence[str], None] = None def upgrade() -> None: """Create trust & safety tables and extend users table.""" bind = op.get_bind() # ── ENUM types ────────────────────────────────────────────────────── # user_role user_role = postgresql.ENUM("user", "moderator", "admin", name="user_role") user_role.create(bind, checkfirst=True) # report_target_type report_target_type = postgresql.ENUM( "user", "world", "asset", "chat_message", name="report_target_type" ) report_target_type.create(bind, checkfirst=True) # reason_category reason_category = postgresql.ENUM( "harassment", "hate_speech", "sexual_content", "violence", "spam", "self_harm", "other", name="reason_category", ) reason_category.create(bind, checkfirst=True) # report_status report_status = postgresql.ENUM( "open", "in_review", "resolved", "dismissed", name="report_status" ) report_status.create(bind, checkfirst=True) # resolution resolution_enum = postgresql.ENUM( "action_taken", "no_action", "false_positive", name="resolution" ) resolution_enum.create(bind, checkfirst=True) # moderation_action_type moderation_action_type = postgresql.ENUM( "warn", "suspend", "ban", "restrict", "remove", "restore", name="moderation_action_type", ) moderation_action_type.create(bind, checkfirst=True) # moderation_target_type moderation_target_type = postgresql.ENUM( "user", "world", "asset", "chat_message", name="moderation_target_type" ) moderation_target_type.create(bind, checkfirst=True) # appeal_status appeal_status = postgresql.ENUM( "pending", "approved", "rejected", name="appeal_status" ) appeal_status.create(bind, checkfirst=True) # ── Extend users table ────────────────────────────────────────────── op.add_column( "users", sa.Column( "role", postgresql.ENUM("user", "moderator", "admin", name="user_role"), nullable=False, server_default="user", ), ) op.add_column( "users", sa.Column("banned_until", sa.DateTime(timezone=True), nullable=True), ) op.add_column( "users", sa.Column("suspended_until", sa.DateTime(timezone=True), nullable=True), ) # ── reports table ─────────────────────────────────────────────────── op.create_table( "reports", sa.Column("id", sa.BigInteger(), primary_key=True, autoincrement=True), sa.Column("reporter_id", sa.Integer(), nullable=False), sa.Column( "target_type", postgresql.ENUM( "user", "world", "asset", "chat_message", name="report_target_type" ), nullable=False, ), sa.Column("target_id", sa.String(length=64), nullable=False), sa.Column( "reason_category", postgresql.ENUM( "harassment", "hate_speech", "sexual_content", "violence", "spam", "self_harm", "other", name="reason_category", ), nullable=False, ), sa.Column( "details", sa.Text(), nullable=True, ), sa.Column( "status", postgresql.ENUM( "open", "in_review", "resolved", "dismissed", name="report_status" ), nullable=False, server_default="open", ), sa.Column("resolved_by", sa.Integer(), nullable=True), sa.Column( "resolution", postgresql.ENUM( "action_taken", "no_action", "false_positive", name="resolution" ), nullable=True, ), sa.Column("resolved_at", sa.DateTime(timezone=True), nullable=True), sa.Column( "created_at", sa.DateTime(timezone=True), server_default=sa.func.now(), nullable=False, ), sa.Column( "updated_at", sa.DateTime(timezone=True), onupdate=sa.func.now(), nullable=True, ), sa.ForeignKeyConstraint(["reporter_id"], ["users.id"], ondelete="CASCADE"), sa.ForeignKeyConstraint(["resolved_by"], ["users.id"], ondelete="SET NULL"), sa.UniqueConstraint( "reporter_id", "target_type", "target_id", name="uq_reporter_target", ), ) op.create_index(op.f("ix_reports_id"), "reports", ["id"], unique=False) op.create_index( op.f("ix_reports_reporter_id"), "reports", ["reporter_id"], unique=False ) op.create_index( op.f("ix_reports_status"), "reports", ["status"], unique=False ) # ── moderation_actions table ──────────────────────────────────────── op.create_table( "moderation_actions", sa.Column("id", sa.BigInteger(), primary_key=True, autoincrement=True), sa.Column("moderator_id", sa.Integer(), nullable=False), sa.Column("target_user_id", sa.Integer(), nullable=True), sa.Column( "target_type", postgresql.ENUM( "user", "world", "asset", "chat_message", name="moderation_target_type", ), nullable=False, ), sa.Column("target_id", sa.String(length=64), nullable=True), sa.Column( "action", postgresql.ENUM( "warn", "suspend", "ban", "restrict", "remove", "restore", name="moderation_action_type", ), nullable=False, ), sa.Column("reason", sa.Text(), nullable=True), sa.Column("report_id", sa.Integer(), nullable=True), sa.Column("expires_at", sa.DateTime(timezone=True), nullable=True), sa.Column("revoked_at", sa.DateTime(timezone=True), nullable=True), sa.Column( "created_at", sa.DateTime(timezone=True), server_default=sa.func.now(), nullable=False, ), sa.ForeignKeyConstraint(["moderator_id"], ["users.id"], ondelete="CASCADE"), sa.ForeignKeyConstraint( ["target_user_id"], ["users.id"], ondelete="CASCADE" ), sa.ForeignKeyConstraint(["report_id"], ["reports.id"], ondelete="SET NULL"), ) op.create_index( op.f("ix_moderation_actions_id"), "moderation_actions", ["id"], unique=False, ) op.create_index( op.f("ix_moderation_actions_moderator_id"), "moderation_actions", ["moderator_id"], unique=False, ) op.create_index( op.f("ix_moderation_actions_target_user_id"), "moderation_actions", ["target_user_id"], unique=False, ) op.create_index( op.f("ix_moderation_actions_report_id"), "moderation_actions", ["report_id"], unique=False, ) # ── appeals table ─────────────────────────────────────────────────── op.create_table( "appeals", sa.Column("id", sa.BigInteger(), primary_key=True, autoincrement=True), sa.Column( "moderation_action_id", sa.Integer(), nullable=False ), sa.Column("user_id", sa.Integer(), nullable=False), sa.Column("reason", sa.Text(), nullable=False), sa.Column( "status", postgresql.ENUM( "pending", "approved", "rejected", name="appeal_status" ), nullable=False, server_default="pending", ), sa.Column("reviewed_by", sa.Integer(), nullable=True), sa.Column("reviewed_at", sa.DateTime(timezone=True), nullable=True), sa.Column( "created_at", sa.DateTime(timezone=True), server_default=sa.func.now(), nullable=False, ), sa.ForeignKeyConstraint( ["moderation_action_id"], ["moderation_actions.id"], ondelete="CASCADE", ), sa.ForeignKeyConstraint(["user_id"], ["users.id"], ondelete="CASCADE"), sa.ForeignKeyConstraint( ["reviewed_by"], ["users.id"], ondelete="SET NULL" ), ) op.create_index(op.f("ix_appeals_id"), "appeals", ["id"], unique=False) op.create_index( op.f("ix_appeals_moderation_action_id"), "appeals", ["moderation_action_id"], unique=False, ) op.create_index( op.f("ix_appeals_user_id"), "appeals", ["user_id"], unique=False, ) op.create_index( op.f("ix_appeals_status"), "appeals", ["status"], unique=False, ) def downgrade() -> None: """Remove trust & safety tables and revert users table.""" op.drop_index(op.f("ix_appeals_status"), table_name="appeals") op.drop_index(op.f("ix_appeals_user_id"), table_name="appeals") op.drop_index(op.f("ix_appeals_moderation_action_id"), table_name="appeals") op.drop_index(op.f("ix_appeals_id"), table_name="appeals") op.drop_table("appeals") op.drop_index(op.f("ix_moderation_actions_report_id"), table_name="moderation_actions") op.drop_index(op.f("ix_moderation_actions_target_user_id"), table_name="moderation_actions") op.drop_index(op.f("ix_moderation_actions_moderator_id"), table_name="moderation_actions") op.drop_index(op.f("ix_moderation_actions_id"), table_name="moderation_actions") op.drop_table("moderation_actions") op.drop_index(op.f("ix_reports_status"), table_name="reports") op.drop_index(op.f("ix_reports_reporter_id"), table_name="reports") op.drop_index(op.f("ix_reports_id"), table_name="reports") op.drop_table("reports") op.drop_column("users", "suspended_until") op.drop_column("users", "banned_until") op.drop_column("users", "role") # Drop ENUM types postgresql.ENUM(name="appeal_status").drop(bind, checkfirst=True) postgresql.ENUM(name="moderation_target_type").drop(bind, checkfirst=True) postgresql.ENUM(name="moderation_action_type").drop(bind, checkfirst=True) postgresql.ENUM(name="resolution").drop(bind, checkfirst=True) postgresql.ENUM(name="report_status").drop(bind, checkfirst=True) postgresql.ENUM(name="reason_category").drop(bind, checkfirst=True) postgresql.ENUM(name="report_target_type").drop(bind, checkfirst=True) postgresql.ENUM(name="user_role").drop(bind, checkfirst=True)