feat(dashboards): Add model for storing visit information (#95361)

Adds a model that will be created for a singular visit by a user to a
particular dashboard. This is to move us away from a generic global
"last visited" timestamp on dashboards and something more focused on the
user themselves.

Closes DAIN-731

Author: narsaynorath

migrations_lockfile.txt

@@ -27,7 +27,7 @@ preprod: 0010_actual_drop_preprod_artifact_analysis_file_id_col
 
 replays: 0006_add_bulk_delete_job
 
-sentry: 0946_add_has_mcp_insights_flag
+sentry: 0947_add_dashboard_last_visited_model
 
 social_auth: 0003_social_auth_json_field
 

src/sentry/backup/comparators.py

@@ -798,6 +798,9 @@ def get_default_comparators() -> dict[str, list[JSONScrubbingComparator]]:
             "sentry.dashboardfavoriteuser": [
                 DateUpdatedComparator("date_added", "date_updated"),
             ],
+            "sentry.dashboardlastvisited": [
+                DateUpdatedComparator("last_visited", "date_added", "date_updated"),
+            ],
             "sentry.groupsearchview": [DateUpdatedComparator("date_updated")],
             "sentry.groupsearchviewlastvisited": [
                 DateUpdatedComparator("last_visited", "date_added", "date_updated")

src/sentry/migrations/0947_add_dashboard_last_visited_model.py

@@ -0,0 +1,67 @@
+# Generated by Django 5.2.1 on 2025-07-14 14:23
+
+import django.db.models.deletion
+import django.utils.timezone
+from django.db import migrations, models
+
+import sentry.db.models.fields.bounded
+import sentry.db.models.fields.foreignkey
+from sentry.new_migrations.migrations import CheckedMigration
+
+
+class Migration(CheckedMigration):
+    # This flag is used to mark that a migration shouldn't be automatically run in production.
+    # This should only be used for operations where it's safe to run the migration after your
+    # code has deployed. So this should not be used for most operations that alter the schema
+    # of a table.
+    # Here are some things that make sense to mark as post deployment:
+    # - Large data migrations. Typically we want these to be run manually so that they can be
+    #   monitored and not block the deploy for a long period of time while they run.
+    # - Adding indexes to large tables. Since this can take a long time, we'd generally prefer to
+    #   run this outside deployments so that we don't block them. Note that while adding an index
+    #   is a schema change, it's completely safe to run the operation after the code has deployed.
+    # Once deployed, run these manually via: https://develop.sentry.dev/database-migrations/#migration-deployment
+
+    is_post_deployment = False
+
+    dependencies = [
+        ("sentry", "0946_add_has_mcp_insights_flag"),
+    ]
+
+    operations = [
+        migrations.CreateModel(
+            name="DashboardLastVisited",
+            fields=[
+                (
+                    "id",
+                    sentry.db.models.fields.bounded.BoundedBigAutoField(
+                        primary_key=True, serialize=False
+                    ),
+                ),
+                ("date_updated", models.DateTimeField(auto_now=True)),
+                ("date_added", models.DateTimeField(auto_now_add=True)),
+                ("last_visited", models.DateTimeField(default=django.utils.timezone.now)),
+                (
+                    "dashboard",
+                    sentry.db.models.fields.foreignkey.FlexibleForeignKey(
+                        on_delete=django.db.models.deletion.CASCADE, to="sentry.dashboard"
+                    ),
+                ),
+                (
+                    "member",
+                    sentry.db.models.fields.foreignkey.FlexibleForeignKey(
+                        on_delete=django.db.models.deletion.CASCADE, to="sentry.organizationmember"
+                    ),
+                ),
+            ],
+            options={
+                "db_table": "sentry_dashboardlastvisited",
+                "constraints": [
+                    models.UniqueConstraint(
+                        fields=("member_id", "dashboard_id"),
+                        name="sentry_dashboardlastvisited_unique_last_visited_per_org_member",
+                    )
+                ],
+            },
+        ),
+    ]

src/sentry/models/dashboard.py

@@ -360,6 +360,26 @@ class Meta:
     __repr__ = sane_repr("organization", "slug")
 
 
+@region_silo_model
+class DashboardLastVisited(DefaultFieldsModel):
+    __relocation_scope__ = RelocationScope.Organization
+
+    dashboard = FlexibleForeignKey("sentry.Dashboard", on_delete=models.CASCADE)
+    member = FlexibleForeignKey("sentry.OrganizationMember", on_delete=models.CASCADE)
+
+    last_visited = models.DateTimeField(null=False, default=timezone.now)
+
+    class Meta:
+        app_label = "sentry"
+        db_table = "sentry_dashboardlastvisited"
+        constraints = [
+            UniqueConstraint(
+                fields=["member_id", "dashboard_id"],
+                name="sentry_dashboardlastvisited_unique_last_visited_per_org_member",
+            )
+        ]
+
+
 # Prebuilt dashboards are added to API responses for all accounts that have
 # not added a tombstone for the id value. If you change the id of a prebuilt dashboard
 # it will invalidate all the tombstone records that already exist.

src/sentry/testutils/helpers/backups.py

@@ -59,7 +59,12 @@
 from sentry.models.authidentity import AuthIdentity
 from sentry.models.authprovider import AuthProvider
 from sentry.models.counter import Counter
-from sentry.models.dashboard import Dashboard, DashboardFavoriteUser, DashboardTombstone
+from sentry.models.dashboard import (
+    Dashboard,
+    DashboardFavoriteUser,
+    DashboardLastVisited,
+    DashboardTombstone,
+)
 from sentry.models.dashboard_permissions import DashboardPermissions
 from sentry.models.dashboard_widget import (
     DashboardWidget,
@@ -567,6 +572,11 @@ def create_exhaustive_organization(
             user_id=owner_id,
             organization=org,
         )
+        DashboardLastVisited.objects.create(
+            dashboard=dashboard,
+            member=invited,
+            last_visited=timezone.now(),
+        )
         permissions = DashboardPermissions.objects.create(
             is_editable_by_everyone=True, dashboard=dashboard
         )