Add CarPass gamification scoring foundation

alembic/versions/202605120006_gamification_scores.py

@@ -0,0 +1,157 @@
+"""gamification scores
+
+Revision ID: 202605120006
+Revises: 202605120005
+Create Date: 2026-05-12 20:10:00.000000
+"""
+
+from collections.abc import Sequence
+
+import sqlalchemy as sa
+from alembic import op
+from sqlalchemy.dialects import postgresql
+
+revision: str = "202605120006"
+down_revision: str | None = "202605120005"
+branch_labels: str | Sequence[str] | None = None
+depends_on: str | Sequence[str] | None = None
+
+
+def upgrade() -> None:
+    op.create_table(
+        "achievements",
+        sa.Column("id", sa.Integer(), nullable=False),
+        sa.Column("code", sa.String(length=80), nullable=False),
+        sa.Column("scope", sa.String(length=24), server_default="user", nullable=False),
+        sa.Column("title", sa.String(length=120), nullable=False),
+        sa.Column("description", sa.String(length=260), nullable=False),
+        sa.Column("icon", sa.String(length=40), nullable=True),
+        sa.Column("category", sa.String(length=40), nullable=True),
+        sa.Column("is_active", sa.Boolean(), server_default=sa.text("true"), nullable=False),
+        sa.Column("created_at", sa.DateTime(timezone=True), server_default=sa.func.now(), nullable=False),
+        sa.PrimaryKeyConstraint("id"),
+    )
+    op.create_index("ix_achievements_category", "achievements", ["category"])
+    op.create_index("ix_achievements_code", "achievements", ["code"], unique=True)
+    op.create_index("ix_achievements_is_active", "achievements", ["is_active"])
+    op.create_index("ix_achievements_scope", "achievements", ["scope"])
+
+    op.create_table(
+        "vehicle_scores",
+        sa.Column("id", sa.Integer(), nullable=False),
+        sa.Column("vehicle_id", sa.Integer(), nullable=False),
+        sa.Column("completeness_score", sa.Integer(), server_default="0", nullable=False),
+        sa.Column("verified_history_score", sa.Integer(), server_default="0", nullable=False),
+        sa.Column("maintenance_health_score", sa.Integer(), server_default="100", nullable=False),
+        sa.Column("maintenance_status", sa.String(length=24), server_default="unknown", nullable=False),
+        sa.Column("profile_quality", sa.String(length=40), server_default="basic", nullable=False),
+        sa.Column("verified_history_status", sa.String(length=40), server_default="self_reported", nullable=False),
+        sa.Column("missing_items", postgresql.JSON(astext_type=sa.Text()), nullable=True),
+        sa.Column("computed_at", sa.DateTime(timezone=True), server_default=sa.func.now(), nullable=False),
+        sa.ForeignKeyConstraint(["vehicle_id"], ["cars.id"], ondelete="CASCADE"),
+        sa.PrimaryKeyConstraint("id"),
+    )
+    op.create_index("ix_vehicle_scores_maintenance_status", "vehicle_scores", ["maintenance_status"])
+    op.create_index("ix_vehicle_scores_profile_quality", "vehicle_scores", ["profile_quality"])
+    op.create_index("ix_vehicle_scores_vehicle_id", "vehicle_scores", ["vehicle_id"], unique=True)
+    op.create_index("ix_vehicle_scores_verified_history_status", "vehicle_scores", ["verified_history_status"])
+
+    op.create_table(
+        "service_center_scores",
+        sa.Column("id", sa.Integer(), nullable=False),
+        sa.Column("service_center_id", sa.Integer(), nullable=False),
+        sa.Column("trust_score", sa.Integer(), server_default="0", nullable=False),
+        sa.Column("trust_level", sa.String(length=40), server_default="new_service", nullable=False),
+        sa.Column("confirmed_visits_count", sa.Integer(), server_default="0", nullable=False),
+        sa.Column("confirmation_rate", sa.Numeric(5, 2), server_default="0", nullable=False),
+        sa.Column("dispute_rate", sa.Numeric(5, 2), server_default="0", nullable=False),
+        sa.Column("computed_at", sa.DateTime(timezone=True), server_default=sa.func.now(), nullable=False),
+        sa.ForeignKeyConstraint(["service_center_id"], ["service_centers.id"], ondelete="CASCADE"),
+        sa.PrimaryKeyConstraint("id"),
+    )
+    op.create_index("ix_service_center_scores_service_center_id", "service_center_scores", ["service_center_id"], unique=True)
+    op.create_index("ix_service_center_scores_trust_level", "service_center_scores", ["trust_level"])
+
+    op.create_table(
+        "user_achievements",
+        sa.Column("id", sa.Integer(), nullable=False),
+        sa.Column("user_id", sa.Integer(), nullable=False),
+        sa.Column("achievement_id", sa.Integer(), nullable=False),
+        sa.Column("vehicle_id", sa.Integer(), nullable=True),
+        sa.Column("service_center_id", sa.Integer(), nullable=True),
+        sa.Column("unlocked_at", sa.DateTime(timezone=True), server_default=sa.func.now(), nullable=False),
+        sa.Column("metadata_json", postgresql.JSON(astext_type=sa.Text()), nullable=True),
+        sa.ForeignKeyConstraint(["achievement_id"], ["achievements.id"], ondelete="CASCADE"),
+        sa.ForeignKeyConstraint(["service_center_id"], ["service_centers.id"], ondelete="CASCADE"),
+        sa.ForeignKeyConstraint(["user_id"], ["users.id"], ondelete="CASCADE"),
+        sa.ForeignKeyConstraint(["vehicle_id"], ["cars.id"], ondelete="CASCADE"),
+        sa.PrimaryKeyConstraint("id"),
+        sa.UniqueConstraint(
+            "user_id",
+            "achievement_id",
+            "vehicle_id",
+            "service_center_id",
+            name="uq_user_achievement_scope",
+        ),
+    )
+    op.create_index("ix_user_achievements_achievement_id", "user_achievements", ["achievement_id"])
+    op.create_index("ix_user_achievements_service_center_id", "user_achievements", ["service_center_id"])
+    op.create_index("ix_user_achievements_unlocked_at", "user_achievements", ["unlocked_at"])
+    op.create_index("ix_user_achievements_user_id", "user_achievements", ["user_id"])
+    op.create_index("ix_user_achievements_vehicle_id", "user_achievements", ["vehicle_id"])
+
+    op.create_table(
+        "engagement_events",
+        sa.Column("id", sa.Integer(), nullable=False),
+        sa.Column("user_id", sa.Integer(), nullable=True),
+        sa.Column("vehicle_id", sa.Integer(), nullable=True),
+        sa.Column("service_center_id", sa.Integer(), nullable=True),
+        sa.Column("event_type", sa.String(length=80), nullable=False),
+        sa.Column("metadata_json", postgresql.JSON(astext_type=sa.Text()), nullable=True),
+        sa.Column("created_at", sa.DateTime(timezone=True), server_default=sa.func.now(), nullable=False),
+        sa.ForeignKeyConstraint(["service_center_id"], ["service_centers.id"], ondelete="CASCADE"),
+        sa.ForeignKeyConstraint(["user_id"], ["users.id"], ondelete="SET NULL"),
+        sa.ForeignKeyConstraint(["vehicle_id"], ["cars.id"], ondelete="CASCADE"),
+        sa.PrimaryKeyConstraint("id"),
+    )
+    op.create_index("ix_engagement_events_created_at", "engagement_events", ["created_at"])
+    op.create_index("ix_engagement_events_event_type", "engagement_events", ["event_type"])
+    op.create_index("ix_engagement_events_service_center_id", "engagement_events", ["service_center_id"])
+    op.create_index("ix_engagement_events_user_id", "engagement_events", ["user_id"])
+    op.create_index("ix_engagement_events_vehicle_id", "engagement_events", ["vehicle_id"])
+    op.create_index("ix_engagement_events_user_type_created", "engagement_events", ["user_id", "event_type", "created_at"])
+    op.create_index("ix_engagement_events_vehicle_type_created", "engagement_events", ["vehicle_id", "event_type", "created_at"])
+
+
+def downgrade() -> None:
+    op.drop_index("ix_engagement_events_vehicle_type_created", table_name="engagement_events")
+    op.drop_index("ix_engagement_events_user_type_created", table_name="engagement_events")
+    op.drop_index("ix_engagement_events_vehicle_id", table_name="engagement_events")
+    op.drop_index("ix_engagement_events_user_id", table_name="engagement_events")
+    op.drop_index("ix_engagement_events_service_center_id", table_name="engagement_events")
+    op.drop_index("ix_engagement_events_event_type", table_name="engagement_events")
+    op.drop_index("ix_engagement_events_created_at", table_name="engagement_events")
+    op.drop_table("engagement_events")
+
+    op.drop_index("ix_user_achievements_vehicle_id", table_name="user_achievements")
+    op.drop_index("ix_user_achievements_user_id", table_name="user_achievements")
+    op.drop_index("ix_user_achievements_unlocked_at", table_name="user_achievements")
+    op.drop_index("ix_user_achievements_service_center_id", table_name="user_achievements")
+    op.drop_index("ix_user_achievements_achievement_id", table_name="user_achievements")
+    op.drop_table("user_achievements")
+
+    op.drop_index("ix_service_center_scores_trust_level", table_name="service_center_scores")
+    op.drop_index("ix_service_center_scores_service_center_id", table_name="service_center_scores")
+    op.drop_table("service_center_scores")
+
+    op.drop_index("ix_vehicle_scores_verified_history_status", table_name="vehicle_scores")
+    op.drop_index("ix_vehicle_scores_vehicle_id", table_name="vehicle_scores")
+    op.drop_index("ix_vehicle_scores_profile_quality", table_name="vehicle_scores")
+    op.drop_index("ix_vehicle_scores_maintenance_status", table_name="vehicle_scores")
+    op.drop_table("vehicle_scores")
+
+    op.drop_index("ix_achievements_scope", table_name="achievements")
+    op.drop_index("ix_achievements_is_active", table_name="achievements")
+    op.drop_index("ix_achievements_code", table_name="achievements")
+    op.drop_index("ix_achievements_category", table_name="achievements")
+    op.drop_table("achievements")