feat: add slug-only dashboard profile filter and unify backend imports

backend/src/api/__init__.py

@@ -0,0 +1,3 @@
+# [DEF:src.api:Package]
+# @PURPOSE: Backend API package root.
+# [/DEF:src.api:Package]

backend/src/api/routes/__tests__/test_profile_api.py

@@ -82,6 +82,7 @@ def _build_preference_response(user_id: str = "u-1") -> ProfilePreferenceRespons
             superset_username="John_Doe",
             superset_username_normalized="john_doe",
             show_only_my_dashboards=True,
+            show_only_slug_dashboards=True,
             git_username="ivan.ivanov",
             git_email="ivan@company.local",
             has_git_personal_access_token=True,
@@ -126,6 +127,7 @@ def test_get_profile_preferences_returns_self_payload(profile_route_deps_fixture
     assert payload["preference"]["superset_username_normalized"] == "john_doe"
     assert payload["preference"]["git_username"] == "ivan.ivanov"
     assert payload["preference"]["git_email"] == "ivan@company.local"
+    assert payload["preference"]["show_only_slug_dashboards"] is True
     assert payload["preference"]["has_git_personal_access_token"] is True
     assert payload["preference"]["git_personal_access_token_masked"] == "iv***al"
     assert payload["preference"]["start_page"] == "reports"
@@ -153,6 +155,7 @@ def test_patch_profile_preferences_success(profile_route_deps_fixture):
             json={
                 "superset_username": "John_Doe",
                 "show_only_my_dashboards": True,
+                "show_only_slug_dashboards": True,
                 "git_username": "ivan.ivanov",
                 "git_email": "ivan@company.local",
                 "git_personal_access_token": "ghp_1234567890",
@@ -167,6 +170,7 @@ def test_patch_profile_preferences_success(profile_route_deps_fixture):
     assert payload["status"] == "success"
     assert payload["preference"]["superset_username"] == "John_Doe"
     assert payload["preference"]["show_only_my_dashboards"] is True
+    assert payload["preference"]["show_only_slug_dashboards"] is True
     assert payload["preference"]["git_username"] == "ivan.ivanov"
     assert payload["preference"]["git_email"] == "ivan@company.local"
     assert payload["preference"]["start_page"] == "reports"
@@ -179,6 +183,7 @@ def test_patch_profile_preferences_success(profile_route_deps_fixture):
     assert called_kwargs["payload"].git_username == "ivan.ivanov"
     assert called_kwargs["payload"].git_email == "ivan@company.local"
     assert called_kwargs["payload"].git_personal_access_token == "ghp_1234567890"
+    assert called_kwargs["payload"].show_only_slug_dashboards is True
     assert called_kwargs["payload"].start_page == "reports-logs"
     assert called_kwargs["payload"].auto_open_task_drawer is False
     assert called_kwargs["payload"].dashboards_table_density == "free"
@@ -290,4 +295,4 @@ def test_lookup_superset_accounts_env_not_found(profile_route_deps_fixture):
     assert payload["detail"] == "Environment 'missing-env' not found"
 # [/DEF:test_lookup_superset_accounts_env_not_found:Function]
 
-# [/DEF:backend.src.api.routes.__tests__.test_profile_api:Module]
+# [/DEF:backend.src.api.routes.__tests__.test_profile_api:Module]

backend/src/api/routes/dashboards.py

@@ -98,7 +98,9 @@ class EffectiveProfileFilter(BaseModel):
     source_page: Literal["dashboards_main", "other"] = "dashboards_main"
     override_show_all: bool = False
     username: Optional[str] = None
-    match_logic: Optional[Literal["owners_or_modified_by"]] = None
+    match_logic: Optional[
+        Literal["owners_or_modified_by", "slug_only", "owners_or_modified_by+slug_only"]
+    ] = None
 # [/DEF:EffectiveProfileFilter:DataClass]
 
 # [DEF:DashboardsResponse:DataClass]
@@ -535,6 +537,7 @@ async def get_dashboards(
         profile_service = ProfileService(db=db, config_manager=config_manager)
         bound_username: Optional[str] = None
         can_apply_profile_filter = False
+        can_apply_slug_filter = False
         effective_profile_filter = EffectiveProfileFilter(
             applied=False,
             source_page=page_context,
@@ -560,13 +563,27 @@ async def get_dashboards(
                 and bool(getattr(profile_preference, "show_only_my_dashboards", False))
                 and bool(bound_username)
             )
+            can_apply_slug_filter = (
+                page_context == "dashboards_main"
+                and bool(apply_profile_default)
+                and not bool(override_show_all)
+                and bool(getattr(profile_preference, "show_only_slug_dashboards", True))
+            )
+
+            profile_match_logic = None
+            if can_apply_profile_filter and can_apply_slug_filter:
+                profile_match_logic = "owners_or_modified_by+slug_only"
+            elif can_apply_profile_filter:
+                profile_match_logic = "owners_or_modified_by"
+            elif can_apply_slug_filter:
+                profile_match_logic = "slug_only"
 
             effective_profile_filter = EffectiveProfileFilter(
-                applied=bool(can_apply_profile_filter),
+                applied=bool(can_apply_profile_filter or can_apply_slug_filter),
                 source_page=page_context,
                 override_show_all=bool(override_show_all),
                 username=bound_username if can_apply_profile_filter else None,
-                match_logic="owners_or_modified_by" if can_apply_profile_filter else None,
+                match_logic=profile_match_logic,
             )
         except Exception as profile_error:
             logger.explore(
@@ -589,7 +606,7 @@ async def get_dashboards(
                     actor_filters,
                 )
             )
-            needs_full_scan = has_column_filters or bool(can_apply_profile_filter)
+            needs_full_scan = has_column_filters or bool(can_apply_profile_filter) or bool(can_apply_slug_filter)
 
             if isinstance(resource_service, ResourceService) and not needs_full_scan:
                 try:
@@ -600,6 +617,7 @@ async def get_dashboards(
                         page_size=page_size,
                         search=search,
                         include_git_status=False,
+                        require_slug=bool(can_apply_slug_filter),
                     )
                     paginated_dashboards = page_payload["dashboards"]
                     total = page_payload["total"]
@@ -613,6 +631,7 @@ async def get_dashboards(
                         env,
                         all_tasks,
                         include_git_status=False,
+                        require_slug=bool(can_apply_slug_filter),
                     )
 
                     if search:
@@ -633,6 +652,7 @@ async def get_dashboards(
                     env,
                     all_tasks,
                     include_git_status=bool(git_filters),
+                    require_slug=bool(can_apply_slug_filter),
                 )
 
                 if can_apply_profile_filter and bound_username:
@@ -674,6 +694,13 @@ async def get_dashboards(
                     )
                     dashboards = filtered_dashboards
 
+                if can_apply_slug_filter:
+                    dashboards = [
+                        dashboard
+                        for dashboard in dashboards
+                        if str(dashboard.get("slug") or "").strip()
+                    ]
+
                 if search:
                     search_lower = search.lower()
                     dashboards = [