refactor

specs/project_map.md

@@ -131,6 +131,47 @@
       - 📝 Clears authentication state and storage.
     - ƒ **setLoading** (`Function`)
       - 📝 Updates the loading state.
+- 📦 **debounce** (`Module`) `[TRIVIAL]`
+  - 📝 Auto-generated module for frontend/src/lib/utils/debounce.js
+  - 🏗️ Layer: Unknown
+  - ƒ **debounce** (`Function`) `[TRIVIAL]`
+    - 📝 Auto-detected function (orphan)
+- 🗄️ **taskDrawer** (`Store`) `[CRITICAL]`
+  - 📝 Manage Task Drawer visibility and resource-to-task mapping
+  - 🏗️ Layer: UI
+  - 🔒 Invariant: resourceTaskMap always reflects current task associations
+- 📦 **taskDrawer** (`Module`) `[TRIVIAL]`
+  - 📝 Auto-generated module for frontend/src/lib/stores/taskDrawer.js
+  - 🏗️ Layer: Unknown
+  - ƒ **openDrawerForTask** (`Function`) `[TRIVIAL]`
+    - 📝 Auto-detected function (orphan)
+  - ƒ **closeDrawer** (`Function`) `[TRIVIAL]`
+    - 📝 Auto-detected function (orphan)
+  - ƒ **updateResourceTask** (`Function`) `[TRIVIAL]`
+    - 📝 Auto-detected function (orphan)
+  - ƒ **getTaskForResource** (`Function`) `[TRIVIAL]`
+    - 📝 Auto-detected function (orphan)
+- 🗄️ **sidebar** (`Store`)
+  - 📝 Manage sidebar visibility and navigation state
+  - 🏗️ Layer: UI
+  - 🔒 Invariant: isExpanded state is always synced with localStorage
+- 📦 **sidebar** (`Module`) `[TRIVIAL]`
+  - 📝 Auto-generated module for frontend/src/lib/stores/sidebar.js
+  - 🏗️ Layer: Unknown
+  - ƒ **toggleSidebar** (`Function`) `[TRIVIAL]`
+    - 📝 Auto-detected function (orphan)
+  - ƒ **setActiveItem** (`Function`) `[TRIVIAL]`
+    - 📝 Auto-detected function (orphan)
+  - ƒ **setMobileOpen** (`Function`) `[TRIVIAL]`
+    - 📝 Auto-detected function (orphan)
+  - ƒ **closeMobile** (`Function`) `[TRIVIAL]`
+    - 📝 Auto-detected function (orphan)
+  - ƒ **toggleMobileSidebar** (`Function`) `[TRIVIAL]`
+    - 📝 Auto-detected function (orphan)
+- 🗄️ **activity** (`Store`)
+  - 📝 Track active task count for navbar indicator
+  - 🏗️ Layer: UI
+  - 🔗 DEPENDS_ON -> `WebSocket connection, taskDrawer store`
 - 🧩 **Select** (`Component`) `[TRIVIAL]`
   - 📝 Standardized dropdown selection component.
   - 🏗️ Layer: Atom
@@ -172,12 +213,95 @@
     - 📝 Holds the current active locale string.
   - 🗄️ **t** (`Store`)
     - 📝 Derived store providing the translation dictionary.
-- ƒ **selectPlugin** (`Function`)
-  - 📝 Handles plugin selection and navigation.
-- ƒ **handleFormSubmit** (`Function`)
-  - 📝 Handles task creation from dynamic form submission.
+  - ƒ **_** (`Function`)
+    - 📝 Get translation by key path.
+- 🧩 **Sidebar** (`Component`) `[CRITICAL]`
+  - 📝 Persistent left sidebar with resource categories navigation
+  - 🏗️ Layer: UI
+  - 🔒 Invariant: Always shows active category and item
+  - ⬅️ READS_FROM `app`
+  - ⬅️ READS_FROM `lib`
+  - ⬅️ READS_FROM `t`
+- 📦 **Sidebar** (`Module`) `[TRIVIAL]`
+  - 📝 Auto-generated module for frontend/src/lib/components/layout/Sidebar.svelte
+  - 🏗️ Layer: Unknown
+  - ƒ **handleItemClick** (`Function`) `[TRIVIAL]`
+    - 📝 Auto-detected function (orphan)
+  - ƒ **handleCategoryToggle** (`Function`) `[TRIVIAL]`
+    - 📝 Auto-detected function (orphan)
+  - ƒ **handleSubItemClick** (`Function`) `[TRIVIAL]`
+    - 📝 Auto-detected function (orphan)
+  - ƒ **handleToggleClick** (`Function`) `[TRIVIAL]`
+    - 📝 Auto-detected function (orphan)
+  - ƒ **handleOverlayClick** (`Function`) `[TRIVIAL]`
+    - 📝 Auto-detected function (orphan)
+- 🧩 **TopNavbar** (`Component`) `[CRITICAL]`
+  - 📝 Unified top navigation bar with Logo, Search, Activity, and User menu
+  - 🏗️ Layer: UI
+  - 🔒 Invariant: Always visible on non-login pages
+  - ⚡ Events: activityClick
+  - ⬅️ READS_FROM `app`
+  - ⬅️ READS_FROM `lib`
+  - ⬅️ READS_FROM `sidebarStore`
+- 📦 **TopNavbar** (`Module`) `[TRIVIAL]`
+  - 📝 Auto-generated module for frontend/src/lib/components/layout/TopNavbar.svelte
+  - 🏗️ Layer: Unknown
+  - ƒ **toggleUserMenu** (`Function`) `[TRIVIAL]`
+    - 📝 Auto-detected function (orphan)
+  - ƒ **closeUserMenu** (`Function`) `[TRIVIAL]`
+    - 📝 Auto-detected function (orphan)
+  - ƒ **handleLogout** (`Function`) `[TRIVIAL]`
+    - 📝 Auto-detected function (orphan)
+  - ƒ **handleActivityClick** (`Function`) `[TRIVIAL]`
+    - 📝 Auto-detected function (orphan)
+  - ƒ **handleSearchFocus** (`Function`) `[TRIVIAL]`
+    - 📝 Auto-detected function (orphan)
+  - ƒ **handleSearchBlur** (`Function`) `[TRIVIAL]`
+    - 📝 Auto-detected function (orphan)
+  - ƒ **handleDocumentClick** (`Function`) `[TRIVIAL]`
+    - 📝 Auto-detected function (orphan)
+  - ƒ **handleHamburgerClick** (`Function`) `[TRIVIAL]`
+    - 📝 Auto-detected function (orphan)
+- 🧩 **Breadcrumbs** (`Component`)
+  - 📝 Display page hierarchy navigation
+  - 🏗️ Layer: UI
+  - 🔒 Invariant: Always shows current page path
+  - 📥 Props: maxVisible: any
+  - ⬅️ READS_FROM `app`
+  - ⬅️ READS_FROM `lib`
+  - ⬅️ READS_FROM `page`
+- 📦 **Breadcrumbs** (`Module`) `[TRIVIAL]`
+  - 📝 Auto-generated module for frontend/src/lib/components/layout/Breadcrumbs.svelte
+  - 🏗️ Layer: Unknown
+  - ƒ **getBreadcrumbs** (`Function`) `[TRIVIAL]`
+    - 📝 Auto-detected function (orphan)
+  - ƒ **formatBreadcrumbLabel** (`Function`) `[TRIVIAL]`
+    - 📝 Auto-detected function (orphan)
+- 🧩 **TaskDrawer** (`Component`) `[CRITICAL]`
+  - 📝 Global task drawer for monitoring background operations
+  - 🏗️ Layer: UI
+  - 🔒 Invariant: Drawer shows logs for active task or remains closed
+  - ⬅️ READS_FROM `lib`
+  - ⬅️ READS_FROM `taskDrawerStore`
+  - ➡️ WRITES_TO `taskDrawerStore`
+- 📦 **TaskDrawer** (`Module`) `[TRIVIAL]`
+  - 📝 Auto-generated module for frontend/src/lib/components/layout/TaskDrawer.svelte
+  - 🏗️ Layer: Unknown
+  - ƒ **handleClose** (`Function`) `[TRIVIAL]`
+    - 📝 Auto-detected function (orphan)
+  - ƒ **handleOverlayClick** (`Function`) `[TRIVIAL]`
+    - 📝 Auto-detected function (orphan)
+  - ƒ **connectWebSocket** (`Function`) `[TRIVIAL]`
+    - 📝 Auto-detected function (orphan)
+  - ƒ **disconnectWebSocket** (`Function`) `[TRIVIAL]`
+    - 📝 Auto-detected function (orphan)
+- 📦 **HomePage** (`Page`) `[CRITICAL]`
+  - 📝 Redirect to Dashboard Hub as per UX requirements
+  - 🏗️ Layer: UI
+  - 🔒 Invariant: Always redirects to /dashboards
 - ƒ **load** (`Function`)
   - 📝 Loads initial plugin data for the dashboard.
+- 📦 **layout** (`Module`)
 - 🧩 **TaskManagementPage** (`Component`)
   - 📝 Page for managing and monitoring tasks.
   - 🏗️ Layer: Page
@@ -192,6 +316,62 @@
     - 📝 Updates the selected task ID when a task is clicked.
   - ƒ **handleRunBackup** (`Function`)
     - 📝 Triggers a manual backup task for the selected environment.
+- 📦 **DatasetHub** (`Page`) `[CRITICAL]`
+  - 📝 Dataset Hub - Dedicated hub for datasets with mapping progress
+  - 🏗️ Layer: UI
+  - 🔒 Invariant: Always shows environment selector and dataset grid
+- 📦 **+page** (`Module`) `[TRIVIAL]`
+  - 📝 Auto-generated module for frontend/src/routes/datasets/+page.svelte
+  - 🏗️ Layer: Unknown
+  - ƒ **loadEnvironments** (`Function`) `[TRIVIAL]`
+    - 📝 Auto-detected function (orphan)
+  - ƒ **loadDatasets** (`Function`) `[TRIVIAL]`
+    - 📝 Auto-detected function (orphan)
+  - ƒ **handleEnvChange** (`Function`) `[TRIVIAL]`
+    - 📝 Auto-detected function (orphan)
+  - ƒ **handleSearch** (`Function`) `[TRIVIAL]`
+    - 📝 Auto-detected function (orphan)
+  - ƒ **handlePageChange** (`Function`) `[TRIVIAL]`
+    - 📝 Auto-detected function (orphan)
+  - ƒ **handlePageSizeChange** (`Function`) `[TRIVIAL]`
+    - 📝 Auto-detected function (orphan)
+  - ƒ **updateSelectionState** (`Function`) `[TRIVIAL]`
+    - 📝 Auto-detected function (orphan)
+  - ƒ **handleCheckboxChange** (`Function`) `[TRIVIAL]`
+    - 📝 Auto-detected function (orphan)
+  - ƒ **handleSelectAll** (`Function`) `[TRIVIAL]`
+    - 📝 Auto-detected function (orphan)
+  - ƒ **handleSelectVisible** (`Function`) `[TRIVIAL]`
+    - 📝 Auto-detected function (orphan)
+  - ƒ **handleAction** (`Function`) `[TRIVIAL]`
+    - 📝 Auto-detected function (orphan)
+  - ƒ **handleBulkMapColumns** (`Function`) `[TRIVIAL]`
+    - 📝 Auto-detected function (orphan)
+  - ƒ **handleBulkGenerateDocs** (`Function`) `[TRIVIAL]`
+    - 📝 Auto-detected function (orphan)
+  - ƒ **handleTaskStatusClick** (`Function`) `[TRIVIAL]`
+    - 📝 Auto-detected function (orphan)
+  - ƒ **getTaskStatusIcon** (`Function`) `[TRIVIAL]`
+    - 📝 Auto-detected function (orphan)
+  - ƒ **getMappingProgressClass** (`Function`) `[TRIVIAL]`
+    - 📝 Auto-detected function (orphan)
+- 📦 **DatasetDetail** (`Page`) `[CRITICAL]`
+  - 📝 Dataset Detail View - Shows detailed dataset information with columns, SQL, and linked dashboards
+  - 🏗️ Layer: UI
+  - 🔒 Invariant: Always shows dataset details when loaded
+- 📦 **+page** (`Module`) `[TRIVIAL]`
+  - 📝 Auto-generated module for frontend/src/routes/datasets/[id]/+page.svelte
+  - 🏗️ Layer: Unknown
+  - ƒ **loadDatasetDetail** (`Function`) `[TRIVIAL]`
+    - 📝 Auto-detected function (orphan)
+  - ƒ **navigateToDashboard** (`Function`) `[TRIVIAL]`
+    - 📝 Auto-detected function (orphan)
+  - ƒ **goBack** (`Function`) `[TRIVIAL]`
+    - 📝 Auto-detected function (orphan)
+  - ƒ **getColumnTypeClass** (`Function`) `[TRIVIAL]`
+    - 📝 Auto-detected function (orphan)
+  - ƒ **getMappingProgress** (`Function`) `[TRIVIAL]`
+    - 📝 Auto-detected function (orphan)
 - 🧩 **LoginPage** (`Component`)
   - 📝 Provides the user interface for local and ADFS authentication.
   - 🏗️ Layer: UI
@@ -202,6 +382,15 @@
     - 📝 Submits the local login form to the backend.
   - ƒ **handleADFSLogin** (`Function`)
     - 📝 Redirects the user to the ADFS login endpoint.
+- 📦 **StorageIndexPage** (`Page`) `[TRIVIAL]`
+  - 📝 Redirect to the backups page as the default storage view.
+  - 🏗️ Layer: Page
+  - 🔒 Invariant: Always redirects to /storage/backups.
+- 📦 **StorageReposPage** (`Page`)
+  - ƒ **fetchEnvironments** (`Function`)
+    - 📝 Fetches the list of available environments.
+  - ƒ **fetchDashboards** (`Function`)
+    - 📝 Fetches dashboards for a specific environment.
 - 🧩 **AdminRolesPage** (`Component`)
   - 📝 UI for managing system roles and their permissions.
   - 🏗️ Layer: Domain
@@ -317,20 +506,31 @@
   - 📝 Page for system diagnostics and debugging.
   - 🏗️ Layer: UI
   - ⬅️ READS_FROM `lib`
-- ƒ **handleSaveGlobal** (`Function`)
-  - 📝 Saves global application settings.
-- ƒ **handleSaveStorage** (`Function`)
-  - 📝 Saves storage-specific settings.
-- ƒ **handleAddOrUpdateEnv** (`Function`)
-  - 📝 Adds a new environment or updates an existing one.
-- ƒ **handleDeleteEnv** (`Function`)
-  - 📝 Deletes a Superset environment.
-- ƒ **handleTestEnv** (`Function`)
-  - 📝 Tests the connection to a Superset environment.
-- ƒ **editEnv** (`Function`)
-  - 📝 Populates the environment form for editing.
-- ƒ **resetEnvForm** (`Function`)
-  - 📝 Resets the environment creation/edit form to default state.
+- 📦 **SettingsPage** (`Page`) `[CRITICAL]`
+  - 📝 Consolidated Settings Page - All settings in one place with tabbed navigation
+  - 🏗️ Layer: UI
+  - 🔒 Invariant: Always shows tabbed interface with all settings categories
+- 📦 **+page** (`Module`) `[TRIVIAL]`
+  - 📝 Auto-generated module for frontend/src/routes/settings/+page.svelte
+  - 🏗️ Layer: Unknown
+  - ƒ **loadSettings** (`Function`) `[TRIVIAL]`
+    - 📝 Auto-detected function (orphan)
+  - ƒ **handleTabChange** (`Function`) `[TRIVIAL]`
+    - 📝 Auto-detected function (orphan)
+  - ƒ **getTabClass** (`Function`) `[TRIVIAL]`
+    - 📝 Auto-detected function (orphan)
+  - ƒ **handleSave** (`Function`) `[TRIVIAL]`
+    - 📝 Auto-detected function (orphan)
+  - ƒ **handleTestEnv** (`Function`) `[TRIVIAL]`
+    - 📝 Auto-detected function (orphan)
+  - ƒ **editEnv** (`Function`) `[TRIVIAL]`
+    - 📝 Auto-detected function (orphan)
+  - ƒ **resetEnvForm** (`Function`) `[TRIVIAL]`
+    - 📝 Auto-detected function (orphan)
+  - ƒ **handleAddOrUpdateEnv** (`Function`) `[TRIVIAL]`
+    - 📝 Auto-detected function (orphan)
+  - ƒ **handleDeleteEnv** (`Function`) `[TRIVIAL]`
+    - 📝 Auto-detected function (orphan)
 - ƒ **load** (`Function`)
   - 📝 Loads application settings and environment list.
 - 🧩 **ConnectionsSettingsPage** (`Component`)
@@ -855,37 +1055,49 @@
     - 📝 Handles application shutdown tasks, such as stopping the scheduler.
   - ƒ **log_requests** (`Function`)
     - 📝 Middleware to log incoming HTTP requests and their response status.
+  - 📦 **api.include_routers** (`Action`)
+    - 📝 Registers all API routers with the FastAPI application.
+    - 🏗️ Layer: API
   - ƒ **websocket_endpoint** (`Function`) `[CRITICAL]`
     - 📝 Provides a WebSocket endpoint for real-time log streaming of a task with server-side filtering.
   - 📦 **StaticFiles** (`Mount`)
     - 📝 Mounts the frontend build directory to serve static assets.
-    - ƒ **serve_spa** (`Function`)
-      - 📝 Serves frontend static files or index.html for SPA routing.
     - ƒ **read_root** (`Function`)
       - 📝 A simple root endpoint to confirm that the API is running when frontend is missing.
   - ƒ **network_error_handler** (`Function`) `[TRIVIAL]`
     - 📝 Auto-detected function (orphan)
   - ƒ **matches_filters** (`Function`) `[TRIVIAL]`
     - 📝 Auto-detected function (orphan)
+  - ƒ **serve_spa** (`Function`) `[TRIVIAL]`
+    - 📝 Auto-detected function (orphan)
 - 📦 **Dependencies** (`Module`)
-  - 📝 Manages the creation and provision of shared application dependencies, such as the PluginLoader and TaskManager, to avoid circular imports.
+  - 📝 Manages creation and provision of shared application dependencies, such as PluginLoader and TaskManager, to avoid circular imports.
   - 🏗️ Layer: Core
   - ƒ **get_config_manager** (`Function`)
-    - 📝 Dependency injector for the ConfigManager.
+    - 📝 Dependency injector for ConfigManager.
   - ƒ **get_plugin_loader** (`Function`)
-    - 📝 Dependency injector for the PluginLoader.
+    - 📝 Dependency injector for PluginLoader.
   - ƒ **get_task_manager** (`Function`)
-    - 📝 Dependency injector for the TaskManager.
+    - 📝 Dependency injector for TaskManager.
   - ƒ **get_scheduler_service** (`Function`)
-    - 📝 Dependency injector for the SchedulerService.
+    - 📝 Dependency injector for SchedulerService.
+  - ƒ **get_resource_service** (`Function`)
+    - 📝 Dependency injector for ResourceService.
+  - ƒ **get_mapping_service** (`Function`)
+    - 📝 Dependency injector for MappingService.
   - 📦 **oauth2_scheme** (`Variable`)
     - 📝 OAuth2 password bearer scheme for token extraction.
   - ƒ **get_current_user** (`Function`)
-    - 📝 Dependency for retrieving the currently authenticated user from a JWT.
+    - 📝 Dependency for retrieving currently authenticated user from a JWT.
   - ƒ **has_permission** (`Function`)
     - 📝 Dependency for checking if the current user has a specific permission.
   - ƒ **permission_checker** (`Function`) `[TRIVIAL]`
     - 📝 Auto-detected function (orphan)
+- 📦 **test_dataset_dashboard_relations** (`Module`) `[TRIVIAL]`
+  - 📝 Auto-generated module for backend/src/scripts/test_dataset_dashboard_relations.py
+  - 🏗️ Layer: Unknown
+  - ƒ **test_dashboard_dataset_relations** (`Function`) `[TRIVIAL]`
+    - 📝 Auto-detected function (orphan)
 - 📦 **backend.src.scripts.seed_permissions** (`Module`)
   - 📝 Populates the auth database with initial system permissions.
   - 🏗️ Layer: Scripts
@@ -959,6 +1171,12 @@
       - 📝 Удаляет дашборд по его ID или slug.
     - ƒ **get_datasets** (`Function`)
       - 📝 Получает полный список датасетов, автоматически обрабатывая пагинацию.
+    - ƒ **get_datasets_summary** (`Function`)
+      - 📝 Fetches dataset metadata optimized for the Dataset Hub grid.
+    - ƒ **get_dataset_detail** (`Function`)
+      - 📝 Fetches detailed dataset information including columns and linked dashboards
+      - 🔗 CALLS -> `self.get_dataset`
+      - 🔗 CALLS -> `self.network.request (for related_objects)`
     - ƒ **get_dataset** (`Function`)
       - 📝 Получает информацию о конкретном датасете по его ID.
     - ƒ **update_dataset** (`Function`)
@@ -1326,6 +1544,8 @@
       - 📝 Получает общее количество элементов для пагинации.
     - ƒ **fetch_paginated_data** (`Function`)
       - 📝 Автоматически собирает данные со всех страниц пагинированного эндпоинта.
+  - ƒ **init_poolmanager** (`Function`) `[TRIVIAL]`
+    - 📝 Auto-detected function (orphan)
 - 📦 **backend.src.core.utils.matching** (`Module`)
   - 📝 Provides utility functions for fuzzy matching database names.
   - 🏗️ Layer: Core
@@ -1551,6 +1771,40 @@
   - 📝 Test connection to an LLM provider.
 - ƒ **test_provider_config** (`Function`)
   - 📝 Test connection with a provided configuration (not yet saved).
+- 📦 **backend.src.api.routes.datasets** (`Module`)
+  - 📝 API endpoints for the Dataset Hub - listing datasets with mapping progress
+  - 🏗️ Layer: API
+  - 🔒 Invariant: All dataset responses include last_task metadata
+  - 🔗 DEPENDS_ON -> `backend.src.dependencies`
+  - 🔗 DEPENDS_ON -> `backend.src.services.resource_service`
+  - 🔗 DEPENDS_ON -> `backend.src.core.superset_client`
+  - 📦 **MappedFields** (`DataClass`)
+  - 📦 **LastTask** (`DataClass`)
+  - 📦 **DatasetItem** (`DataClass`)
+  - 📦 **LinkedDashboard** (`DataClass`)
+  - 📦 **DatasetColumn** (`DataClass`)
+  - 📦 **DatasetDetailResponse** (`DataClass`)
+  - 📦 **DatasetsResponse** (`DataClass`)
+  - 📦 **TaskResponse** (`DataClass`)
+  - ƒ **get_dataset_ids** (`Function`)
+    - 📝 Fetch list of all dataset IDs from a specific environment (without pagination)
+    - 🔗 CALLS -> `ResourceService.get_datasets_with_status`
+  - ƒ **get_datasets** (`Function`)
+    - 📝 Fetch list of datasets from a specific environment with mapping progress
+    - 🔗 CALLS -> `ResourceService.get_datasets_with_status`
+  - 📦 **MapColumnsRequest** (`DataClass`)
+  - ƒ **map_columns** (`Function`)
+    - 📝 Trigger bulk column mapping for datasets
+    - 🔗 DISPATCHES -> `MapperPlugin`
+    - 🔗 CALLS -> `task_manager.create_task`
+  - 📦 **GenerateDocsRequest** (`DataClass`)
+  - ƒ **generate_docs** (`Function`)
+    - 📝 Trigger bulk documentation generation for datasets
+    - 🔗 DISPATCHES -> `LLMAnalysisPlugin`
+    - 🔗 CALLS -> `task_manager.create_task`
+  - ƒ **get_dataset_detail** (`Function`)
+    - 📝 Get detailed dataset information including columns and linked dashboards
+    - 🔗 CALLS -> `SupersetClient.get_dataset_detail`
 - 📦 **backend.src.api.routes.git** (`Module`)
   - 📝 Provides FastAPI endpoints for Git integration operations.
   - 🏗️ Layer: API
@@ -1615,10 +1869,13 @@
   - 📦 **DatabaseResponse** (`DataClass`)
   - ƒ **get_environments** (`Function`)
     - 📝 List all configured environments.
+    - 🏗️ Layer: API
   - ƒ **update_environment_schedule** (`Function`)
     - 📝 Update backup schedule for an environment.
+    - 🏗️ Layer: API
   - ƒ **get_environment_databases** (`Function`)
     - 📝 Fetch the list of databases from a specific environment.
+    - 🏗️ Layer: API
 - 📦 **backend.src.api.routes.migration** (`Module`)
   - 📝 API endpoints for migration operations.
   - 🏗️ Layer: API
@@ -1679,6 +1936,11 @@
     - 📝 Retrieves current logging configuration.
   - ƒ **update_logging_config** (`Function`)
     - 📝 Updates logging configuration.
+  - ℂ **ConsolidatedSettingsResponse** (`Class`)
+  - ƒ **get_consolidated_settings** (`Function`)
+    - 📝 Retrieves all settings categories in a single call
+  - ƒ **update_consolidated_settings** (`Function`)
+    - 📝 Bulk update application settings from the consolidated view.
 - 📦 **backend.src.api.routes.admin** (`Module`)
   - 📝 Admin API endpoints for user and role management.
   - 🏗️ Layer: API
@@ -1781,6 +2043,36 @@
     - 📝 Resume a task that is awaiting input (e.g., passwords).
   - ƒ **clear_tasks** (`Function`)
     - 📝 Clear tasks matching the status filter.
+- 📦 **backend.src.api.routes.dashboards** (`Module`)
+  - 📝 API endpoints for the Dashboard Hub - listing dashboards with Git and task status
+  - 🏗️ Layer: API
+  - 🔒 Invariant: All dashboard responses include git_status and last_task metadata
+  - 🔗 DEPENDS_ON -> `backend.src.dependencies`
+  - 🔗 DEPENDS_ON -> `backend.src.services.resource_service`
+  - 🔗 DEPENDS_ON -> `backend.src.core.superset_client`
+  - 📦 **GitStatus** (`DataClass`)
+  - 📦 **LastTask** (`DataClass`)
+  - 📦 **DashboardItem** (`DataClass`)
+  - 📦 **DashboardsResponse** (`DataClass`)
+  - ƒ **get_dashboards** (`Function`)
+    - 📝 Fetch list of dashboards from a specific environment with Git status and last task status
+    - 🔗 CALLS -> `ResourceService.get_dashboards_with_status`
+  - 📦 **MigrateRequest** (`DataClass`)
+  - 📦 **TaskResponse** (`DataClass`)
+  - ƒ **migrate_dashboards** (`Function`)
+    - 📝 Trigger bulk migration of dashboards from source to target environment
+    - 🔗 DISPATCHES -> `MigrationPlugin`
+    - 🔗 CALLS -> `task_manager.create_task`
+  - 📦 **BackupRequest** (`DataClass`)
+  - ƒ **backup_dashboards** (`Function`)
+    - 📝 Trigger bulk backup of dashboards with optional cron schedule
+    - 🔗 DISPATCHES -> `BackupPlugin`
+    - 🔗 CALLS -> `task_manager.create_task`
+  - 📦 **DatabaseMapping** (`DataClass`)
+  - 📦 **DatabaseMappingsResponse** (`DataClass`)
+  - ƒ **get_database_mappings** (`Function`)
+    - 📝 Get database mapping suggestions between source and target environments
+    - 🔗 CALLS -> `MappingService.get_suggestions`
 - 📦 **backend.src.models.llm** (`Module`)
   - 📝 SQLAlchemy models for LLM provider configuration and validation results.
   - 🏗️ Layer: Domain
@@ -1865,6 +2157,37 @@
   - ℂ **ADGroupMapping** (`Class`)
     - 📝 Maps an Active Directory group to a local System Role.
     - 🔗 DEPENDS_ON -> `Role`
+- 📦 **backend.src.services.resource_service** (`Module`)
+  - 📝 Shared service for fetching resource data with Git status and task status
+  - 🏗️ Layer: Service
+  - 🔒 Invariant: All resources include metadata about their current state
+  - 🔗 DEPENDS_ON -> `backend.src.core.superset_client`
+  - 🔗 DEPENDS_ON -> `backend.src.core.task_manager`
+  - 🔗 DEPENDS_ON -> `backend.src.services.git_service`
+  - ℂ **ResourceService** (`Class`)
+    - 📝 Provides centralized access to resource data with enhanced metadata
+    - ƒ **__init__** (`Function`)
+      - 📝 Initialize the resource service with dependencies
+    - ƒ **get_dashboards_with_status** (`Function`)
+      - 📝 Fetch dashboards from environment with Git status and last task status
+      - 🔗 CALLS -> `SupersetClient.get_dashboards_summary`
+      - 🔗 CALLS -> `self._get_git_status_for_dashboard`
+      - 🔗 CALLS -> `self._get_last_task_for_resource`
+    - ƒ **get_datasets_with_status** (`Function`)
+      - 📝 Fetch datasets from environment with mapping progress and last task status
+      - 🔗 CALLS -> `SupersetClient.get_datasets_summary`
+      - 🔗 CALLS -> `self._get_last_task_for_resource`
+    - ƒ **get_activity_summary** (`Function`)
+      - 📝 Get summary of active and recent tasks for the activity indicator
+    - ƒ **_get_git_status_for_dashboard** (`Function`)
+      - 📝 Get Git sync status for a dashboard
+      - 🔗 CALLS -> `GitService.get_repo`
+    - ƒ **_get_last_task_for_resource** (`Function`)
+      - 📝 Get the most recent task for a specific resource
+    - ƒ **_extract_resource_name_from_task** (`Function`)
+      - 📝 Extract resource name from task params
+    - ƒ **_extract_resource_type_from_task** (`Function`)
+      - 📝 Extract resource type from task params
 - 📦 **backend.src.services.llm_provider** (`Module`)
   - 📝 Service for managing LLM provider configurations with encrypted API keys.
   - 🏗️ Layer: Domain
@@ -1903,6 +2226,9 @@
     - 📝 Auto-detected function (orphan)
   - ƒ **__init__** (`Function`) `[TRIVIAL]`
     - 📝 Auto-detected function (orphan)
+- 📦 **backend.src.services** (`Module`)
+  - 📝 Package initialization for services module
+  - 🏗️ Layer: Core
 - 📦 **backend.src.services.auth_service** (`Module`)
   - 📝 Orchestrates authentication business logic.
   - 🏗️ Layer: Service
@@ -2247,6 +2573,34 @@
     - 📝 Auto-detected function (orphan)
 - ƒ **test_environment_model** (`Function`)
   - 📝 Tests that Environment model correctly stores values.
+- 📦 **backend.tests.test_dashboards_api** (`Module`)
+  - 📝 Contract-driven tests for Dashboard Hub API
+  - 🏗️ Layer: Domain (Tests)
+  - ƒ **test_get_dashboards_success** (`Function`)
+  - ƒ **test_get_dashboards_env_not_found** (`Function`)
+- 📦 **test_dashboards_api** (`Test`)
+  - 📝 Verify GET /api/dashboards contract compliance
+- 📦 **test_datasets_api** (`Test`)
+  - 📝 Verify GET /api/datasets contract compliance
+- 📦 **test_resource_hubs** (`Module`) `[TRIVIAL]`
+  - 📝 Auto-generated module for backend/tests/test_resource_hubs.py
+  - 🏗️ Layer: Unknown
+  - ƒ **mock_deps** (`Function`) `[TRIVIAL]`
+    - 📝 Auto-detected function (orphan)
+  - ƒ **test_get_dashboards_success** (`Function`) `[TRIVIAL]`
+    - 📝 Auto-detected function (orphan)
+  - ƒ **test_get_dashboards_not_found** (`Function`) `[TRIVIAL]`
+    - 📝 Auto-detected function (orphan)
+  - ƒ **test_get_dashboards_search** (`Function`) `[TRIVIAL]`
+    - 📝 Auto-detected function (orphan)
+  - ƒ **test_get_datasets_success** (`Function`) `[TRIVIAL]`
+    - 📝 Auto-detected function (orphan)
+  - ƒ **test_get_datasets_not_found** (`Function`) `[TRIVIAL]`
+    - 📝 Auto-detected function (orphan)
+  - ƒ **test_get_datasets_search** (`Function`) `[TRIVIAL]`
+    - 📝 Auto-detected function (orphan)
+  - ƒ **test_get_datasets_service_failure** (`Function`) `[TRIVIAL]`
+    - 📝 Auto-detected function (orphan)
 - 📦 **test_task_logger** (`Module`)
   - 📝 Unit tests for TaskLogger and TaskContext.
   - 🏗️ Layer: Test
@@ -2298,6 +2652,11 @@
       - 📝 Test sub-context logger uses new source.
     - ƒ **test_multiple_sub_contexts** (`Function`)
       - 📝 Test creating multiple sub-contexts.
+- 📦 **backend.tests.test_resource_service** (`Module`)
+  - 📝 Contract-driven tests for ResourceService
+  - ƒ **test_get_dashboards_with_status** (`Function`)
+  - ƒ **test_get_dashboards_with_status** (`Function`) `[TRIVIAL]`
+    - 📝 Auto-detected function (orphan)
 - ƒ **test_belief_scope_logs_entry_action_exit_at_debug** (`Function`)
   - 📝 Test that belief_scope generates [ID][Entry], [ID][Action], and [ID][Exit] logs at DEBUG level.
 - ƒ **test_belief_scope_error_handling** (`Function`)