diff --git a/backend/alembic/versions/0003_trust_safety.py b/backend/alembic/versions/0003_trust_safety.py new file mode 100644 index 0000000..584da13 --- /dev/null +++ b/backend/alembic/versions/0003_trust_safety.py @@ -0,0 +1,287 @@ +"""trust & safety schema + +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.""" + # ── ENUM types ────────────────────────────────────────────── + + # role enum for users table + user_role = postgresql.ENUM( + "user", "moderator", "admin", name="user_role", create_type=True + ) + user_role.create(op.get_bind(), checkfirst=True) + + # report target_type enum + report_target_type = postgresql.ENUM( + "user", "world", "asset", "chat_message", + name="report_target_type", create_type=True, + ) + report_target_type.create(op.get_bind(), checkfirst=True) + + # reason_category enum + reason_category = postgresql.ENUM( + "harassment", "hate_speech", "sexual_content", "violence", + "spam", "self_harm", "other", + name="reason_category", create_type=True, + ) + reason_category.create(op.get_bind(), checkfirst=True) + + # report status enum + report_status = postgresql.ENUM( + "open", "in_review", "resolved", "dismissed", + name="report_status", create_type=True, + ) + report_status.create(op.get_bind(), checkfirst=True) + + # resolution enum + resolution_enum = postgresql.ENUM( + "action_taken", "no_action", "false_positive", + name="resolution", create_type=True, + ) + resolution_enum.create(op.get_bind(), checkfirst=True) + + # moderation action enum + moderation_action = postgresql.ENUM( + "warn", "suspend", "ban", "restrict", "remove", "restore", + name="moderation_action", create_type=True, + ) + moderation_action.create(op.get_bind(), checkfirst=True) + + # moderation target_type enum + mod_target_type = postgresql.ENUM( + "user", "world", "asset", "chat_message", + name="moderation_target_type", create_type=True, + ) + mod_target_type.create(op.get_bind(), checkfirst=True) + + # appeal status enum + appeal_status = postgresql.ENUM( + "pending", "approved", "rejected", + name="appeal_status", create_type=True, + ) + appeal_status.create(op.get_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(), sa.ForeignKey("users.id"), 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(), sa.ForeignKey("users.id"), 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.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(), sa.ForeignKey("users.id"), nullable=False), + sa.Column("target_user_id", sa.Integer(), sa.ForeignKey("users.id"), 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", + ), + nullable=False, + ), + sa.Column("reason", sa.Text(), nullable=True), + sa.Column("report_id", sa.Integer(), sa.ForeignKey("reports.id"), 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, + ), + ) + 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(), + sa.ForeignKey("moderation_actions.id"), + nullable=False, + ), + sa.Column("user_id", sa.Integer(), sa.ForeignKey("users.id"), 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(), sa.ForeignKey("users.id"), 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, + ), + ) + 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: + """Drop trust & safety tables and revert users table.""" + # Drop indexes first + 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") + + # Remove columns from users table + 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(op.get_bind(), checkfirst=True) + postgresql.ENUM(name="moderation_target_type").drop(op.get_bind(), checkfirst=True) + postgresql.ENUM(name="moderation_action").drop(op.get_bind(), checkfirst=True) + postgresql.ENUM(name="resolution").drop(op.get_bind(), checkfirst=True) + postgresql.ENUM(name="report_status").drop(op.get_bind(), checkfirst=True) + postgresql.ENUM(name="reason_category").drop(op.get_bind(), checkfirst=True) + postgresql.ENUM(name="report_target_type").drop(op.get_bind(), checkfirst=True) + postgresql.ENUM(name="user_role").drop(op.get_bind(), checkfirst=True)