# Module Map

> High-level module structure for AI Context. Generated automatically.

**Generated:** 2026-02-25T20:19:23.587354

## Summary

- **Total Modules:** 77
- **Total Entities:** 1811

## Module Hierarchy

### 📁 `backend/`

- 🏗️ **Layers:** Unknown, Utility
- 📊 **Tiers:** STANDARD: 2, TRIVIAL: 2
- 📄 **Files:** 2
- 📦 **Entities:** 4

**Key Entities:**

  - 📦 **backend.delete_running_tasks** (Module)
    - Script to delete tasks with RUNNING status from the database...
  - 📦 **test_auth_debug** (Module) `[TRIVIAL]`
    - Auto-generated module for backend/test_auth_debug.py

  ### 📁 `src/`

  - 🏗️ **Layers:** API, Core, UI (API)
  - 📊 **Tiers:** CRITICAL: 2, STANDARD: 19, TRIVIAL: 2
  - 📄 **Files:** 2
  - 📦 **Entities:** 23

  **Key Entities:**

    - 📦 **AppModule** (Module) `[CRITICAL]`
      - The main entry point for the FastAPI application. It initial...
    - 📦 **Dependencies** (Module)
      - Manages creation and provision of shared application depende...

    ### 📁 `api/`

    - 🏗️ **Layers:** API
    - 📊 **Tiers:** STANDARD: 7
    - 📄 **Files:** 1
    - 📦 **Entities:** 7

    **Key Entities:**

      - 📦 **backend.src.api.auth** (Module)
        - Authentication API endpoints.

      ### 📁 `routes/`

      - 🏗️ **Layers:** API, UI (API)
      - 📊 **Tiers:** CRITICAL: 2, STANDARD: 187, TRIVIAL: 5
      - 📄 **Files:** 17
      - 📦 **Entities:** 194

      **Key Entities:**

        - ℂ **AssistantAction** (Class) `[TRIVIAL]`
          - UI action descriptor returned with assistant responses.
        - ℂ **AssistantMessageRequest** (Class) `[TRIVIAL]`
          - Input payload for assistant message endpoint.
        - ℂ **AssistantMessageResponse** (Class)
          - Output payload contract for assistant interaction endpoints.
        - ℂ **BranchCheckout** (Class)
          - Schema for branch checkout requests.
        - ℂ **BranchCreate** (Class)
          - Schema for branch creation requests.
        - ℂ **BranchSchema** (Class)
          - Schema for representing a Git branch metadata.
        - ℂ **CommitCreate** (Class)
          - Schema for staging and committing changes.
        - ℂ **CommitSchema** (Class)
          - Schema for representing Git commit details.
        - ℂ **ConfirmationRecord** (Class)
          - In-memory confirmation token model for risky operation dispa...
        - ℂ **ConflictResolution** (Class)
          - Schema for resolving merge conflicts.

      **Dependencies:**

        - 🔗 DEPENDS_ON -> ConfigManager
        - 🔗 DEPENDS_ON -> ConfigModels
        - 🔗 DEPENDS_ON -> backend.src.core.database
        - 🔗 DEPENDS_ON -> backend.src.core.superset_client
        - 🔗 DEPENDS_ON -> backend.src.core.task_manager

        ### 📁 `__tests__/`

        - 🏗️ **Layers:** API, Domain (Tests), UI (API Tests)
        - 📊 **Tiers:** CRITICAL: 3, STANDARD: 36, TRIVIAL: 98
        - 📄 **Files:** 8
        - 📦 **Entities:** 137

        **Key Entities:**

          - ℂ **_FakeConfigManager** (Class) `[TRIVIAL]`
            - Provide deterministic environment aliases required by intent...
          - ℂ **_FakeConfigManager** (Class) `[TRIVIAL]`
            - Environment config fixture with dev/prod aliases for parser ...
          - ℂ **_FakeDb** (Class) `[TRIVIAL]`
            - In-memory session substitute for assistant route persistence...
          - ℂ **_FakeDb** (Class) `[TRIVIAL]`
            - In-memory fake database implementing subset of Session inter...
          - ℂ **_FakeQuery** (Class) `[TRIVIAL]`
            - Minimal chainable query object for fake DB interactions.
          - ℂ **_FakeQuery** (Class) `[TRIVIAL]`
            - Minimal chainable query object for fake SQLAlchemy-like DB b...
          - ℂ **_FakeTask** (Class) `[TRIVIAL]`
            - Lightweight task model used for assistant authz tests.
          - ℂ **_FakeTask** (Class) `[TRIVIAL]`
            - Lightweight task stub used by assistant API tests.
          - ℂ **_FakeTaskManager** (Class) `[TRIVIAL]`
            - Minimal task manager for deterministic operation creation an...
          - ℂ **_FakeTaskManager** (Class) `[TRIVIAL]`
            - Minimal async-compatible TaskManager fixture for determinist...

        **Dependencies:**

          - 🔗 DEPENDS_ON -> backend.src.api.routes.assistant

    ### 📁 `core/`

    - 🏗️ **Layers:** Core
    - 📊 **Tiers:** CRITICAL: 2, STANDARD: 125, TRIVIAL: 8
    - 📄 **Files:** 10
    - 📦 **Entities:** 135

    **Key Entities:**

      - ℂ **AuthSessionLocal** (Class) `[TRIVIAL]`
        - A session factory for the authentication database.
      - ℂ **BeliefFormatter** (Class)
        - Custom logging formatter that adds belief state prefixes to ...
      - ℂ **ConfigManager** (Class)
        - A class to handle application configuration persistence and ...
      - ℂ **IdMappingService** (Class) `[CRITICAL]`
        - Service handling the cataloging and retrieval of remote Supe...
      - ℂ **LogEntry** (Class)
        - A Pydantic model representing a single, structured log entry...
      - ℂ **MigrationEngine** (Class)
        - Engine for transforming Superset export ZIPs.
      - ℂ **PluginBase** (Class)
        - Defines the abstract base class that all plugins must implem...
      - ℂ **PluginConfig** (Class)
        - A Pydantic model used to represent the validated configurati...
      - ℂ **PluginLoader** (Class)
        - Scans a specified directory for Python modules, dynamically ...
      - ℂ **SchedulerService** (Class)
        - Provides a service to manage scheduled backup tasks.

    **Dependencies:**

      - 🔗 DEPENDS_ON -> AppConfigRecord
      - 🔗 DEPENDS_ON -> ConfigModels
      - 🔗 DEPENDS_ON -> PyYAML
      - 🔗 DEPENDS_ON -> backend.src.core.auth.config
      - 🔗 DEPENDS_ON -> backend.src.core.logger

      ### 📁 `auth/`

      - 🏗️ **Layers:** Core
      - 📊 **Tiers:** STANDARD: 26
      - 📄 **Files:** 6
      - 📦 **Entities:** 26

      **Key Entities:**

        - ℂ **AuthConfig** (Class)
          - Holds authentication-related settings.
        - ℂ **AuthRepository** (Class)
          - Encapsulates database operations for authentication.
        - 📦 **backend.src.core.auth.config** (Module)
          - Centralized configuration for authentication and authorizati...
        - 📦 **backend.src.core.auth.jwt** (Module)
          - JWT token generation and validation logic.
        - 📦 **backend.src.core.auth.logger** (Module)
          - Audit logging for security-related events.
        - 📦 **backend.src.core.auth.oauth** (Module)
          - ADFS OIDC configuration and client using Authlib.
        - 📦 **backend.src.core.auth.repository** (Module)
          - Data access layer for authentication-related entities.
        - 📦 **backend.src.core.auth.security** (Module)
          - Utility for password hashing and verification using Passlib.

      **Dependencies:**

        - 🔗 DEPENDS_ON -> authlib
        - 🔗 DEPENDS_ON -> jose
        - 🔗 DEPENDS_ON -> passlib
        - 🔗 DEPENDS_ON -> pydantic
        - 🔗 DEPENDS_ON -> sqlalchemy

        ### 📁 `__tests__/`

        - 🏗️ **Layers:** Domain
        - 📊 **Tiers:** STANDARD: 1, TRIVIAL: 9
        - 📄 **Files:** 1
        - 📦 **Entities:** 10

        **Key Entities:**

          - 📦 **test_auth** (Module)
            - Unit tests for authentication module

        ### 📁 `__tests__/`

        - 🏗️ **Layers:** Infra
        - 📊 **Tiers:** STANDARD: 11, TRIVIAL: 1
        - 📄 **Files:** 1
        - 📦 **Entities:** 12

        **Key Entities:**

          - 📦 **test_logger** (Module)
            - Unit tests for logger module

      ### 📁 `task_manager/`

      - 🏗️ **Layers:** Core
      - 📊 **Tiers:** CRITICAL: 10, STANDARD: 63, TRIVIAL: 5
      - 📄 **Files:** 7
      - 📦 **Entities:** 78

      **Key Entities:**

        - ℂ **LogEntry** (Class) `[CRITICAL]`
          - A Pydantic model representing a single, structured log entry...
        - ℂ **LogFilter** (Class)
          - Filter parameters for querying task logs.
        - ℂ **LogStats** (Class)
          - Statistics about log entries for a task.
        - ℂ **Task** (Class)
          - A Pydantic model representing a single execution instance of...
        - ℂ **TaskCleanupService** (Class)
          - Provides methods to clean up old task records and their asso...
        - ℂ **TaskContext** (Class) `[CRITICAL]`
          - A container passed to plugin.execute() providing the logger ...
        - ℂ **TaskLog** (Class)
          - A Pydantic model representing a persisted log entry from the...
        - ℂ **TaskLogPersistenceService** (Class) `[CRITICAL]`
          - Provides methods to save and query task logs from the task_l...
        - ℂ **TaskLogger** (Class) `[CRITICAL]`
          - A wrapper around TaskManager._add_log that carries task_id a...
        - ℂ **TaskManager** (Class) `[CRITICAL]`
          - Manages the lifecycle of tasks, including their creation, ex...

      **Dependencies:**

        - 🔗 DEPENDS_ON -> TaskLogRecord
        - 🔗 DEPENDS_ON -> TaskLogger, USED_BY -> plugins
        - 🔗 DEPENDS_ON -> TaskManager, CALLS -> TaskManager._add_log

      ### 📁 `utils/`

      - 🏗️ **Layers:** Core, Domain, Infra
      - 📊 **Tiers:** STANDARD: 48, TRIVIAL: 1
      - 📄 **Files:** 4
      - 📦 **Entities:** 49

      **Key Entities:**

        - ℂ **APIClient** (Class)
          - Инкапсулирует HTTP-логику для работы с API, включая сессии, ...
        - ℂ **AuthenticationError** (Class)
          - Exception raised when authentication fails.
        - ℂ **DashboardNotFoundError** (Class)
          - Exception raised when a dashboard cannot be found.
        - ℂ **DatasetMapper** (Class)
          - Класс для меппинга и обновления verbose_map в датасетах Supe...
        - ℂ **InvalidZipFormatError** (Class)
          - Exception raised when a file is not a valid ZIP archive.
        - ℂ **NetworkError** (Class)
          - Exception raised when a network level error occurs.
        - ℂ **PermissionDeniedError** (Class)
          - Exception raised when access is denied.
        - ℂ **SupersetAPIError** (Class)
          - Base exception for all Superset API related errors.
        - 📦 **backend.core.utils.dataset_mapper** (Module)
          - Этот модуль отвечает за обновление метаданных (verbose_map) ...
        - 📦 **backend.core.utils.fileio** (Module)
          - Предоставляет набор утилит для управления файловыми операция...

      **Dependencies:**

        - 🔗 DEPENDS_ON -> backend.core.superset_client
        - 🔗 DEPENDS_ON -> backend.src.core.logger
        - 🔗 DEPENDS_ON -> pandas
        - 🔗 DEPENDS_ON -> psycopg2
        - 🔗 DEPENDS_ON -> pyyaml

    ### 📁 `models/`

    - 🏗️ **Layers:** Domain, Model
    - 📊 **Tiers:** CRITICAL: 9, STANDARD: 22, TRIVIAL: 22
    - 📄 **Files:** 11
    - 📦 **Entities:** 53

    **Key Entities:**

      - ℂ **ADGroupMapping** (Class)
        - Maps an Active Directory group to a local System Role.
      - ℂ **AppConfigRecord** (Class)
        - Stores the single source of truth for application configurat...
      - ℂ **AssistantAuditRecord** (Class)
        - Store audit decisions and outcomes produced by assistant com...
      - ℂ **AssistantConfirmationRecord** (Class)
        - Persist risky operation confirmation tokens with lifecycle s...
      - ℂ **AssistantMessageRecord** (Class)
        - Persist chat history entries for assistant conversations.
      - ℂ **ConnectionConfig** (Class) `[TRIVIAL]`
        - Stores credentials for external databases used for column ma...
      - ℂ **DashboardMetadata** (Class) `[TRIVIAL]`
        - Represents a dashboard available for migration.
      - ℂ **DashboardSelection** (Class) `[TRIVIAL]`
        - Represents the user's selection of dashboards to migrate.
      - ℂ **DatabaseMapping** (Class)
        - Represents a mapping between source and target databases.
      - ℂ **DeploymentEnvironment** (Class) `[TRIVIAL]`
        - Target Superset environments for dashboard deployment.

    **Dependencies:**

      - 🔗 DEPENDS_ON -> Role
      - 🔗 DEPENDS_ON -> TaskRecord
      - 🔗 DEPENDS_ON -> backend.src.core.task_manager.models
      - 🔗 DEPENDS_ON -> backend.src.models.mapping
      - 🔗 DEPENDS_ON -> sqlalchemy

      ### 📁 `__tests__/`

      - 🏗️ **Layers:** Domain
      - 📊 **Tiers:** CRITICAL: 1, STANDARD: 1, TRIVIAL: 27
      - 📄 **Files:** 2
      - 📦 **Entities:** 29

      **Key Entities:**

        - 📦 **test_models** (Module) `[TRIVIAL]`
          - Unit tests for data models
        - 📦 **test_report_models** (Module) `[CRITICAL]`
          - Unit tests for report Pydantic models and their validators

    ### 📁 `plugins/`

    - 🏗️ **Layers:** App, Plugin, Plugins
    - 📊 **Tiers:** STANDARD: 63
    - 📄 **Files:** 6
    - 📦 **Entities:** 63

    **Key Entities:**

      - ℂ **BackupPlugin** (Class)
        - Implementation of the backup plugin logic.
      - ℂ **DebugPlugin** (Class)
        - Plugin for system diagnostics and debugging.
      - ℂ **GitPlugin** (Class)
        - Реализация плагина Git Integration для управления версиями д...
      - ℂ **MapperPlugin** (Class)
        - Plugin for mapping dataset columns verbose names.
      - ℂ **MigrationPlugin** (Class)
        - Implementation of the migration plugin logic.
      - ℂ **SearchPlugin** (Class)
        - Plugin for searching text patterns in Superset datasets.
      - 📦 **BackupPlugin** (Module)
        - A plugin that provides functionality to back up Superset das...
      - 📦 **DebugPluginModule** (Module)
        - Implements a plugin for system diagnostics and debugging Sup...
      - 📦 **MapperPluginModule** (Module)
        - Implements a plugin for mapping dataset columns using extern...
      - 📦 **MigrationPlugin** (Module)
        - A plugin that provides functionality to migrate Superset das...

    **Dependencies:**

      - 🔗 DEPENDS_ON -> superset_tool.client
      - 🔗 DEPENDS_ON -> superset_tool.utils
      - 🔗 IMPLEMENTS -> PluginBase

      ### 📁 `git/`

      - 🏗️ **Layers:** Unknown
      - 📊 **Tiers:** STANDARD: 2, TRIVIAL: 2
      - 📄 **Files:** 1
      - 📦 **Entities:** 4

      **Key Entities:**

        - ℂ **GitLLMExtension** (Class)
          - Provides LLM capabilities to the Git plugin.
        - 📦 **llm_extension** (Module) `[TRIVIAL]`
          - Auto-generated module for backend/src/plugins/git/llm_extens...

      ### 📁 `llm_analysis/`

      - 🏗️ **Layers:** Unknown
      - 📊 **Tiers:** STANDARD: 19, TRIVIAL: 24
      - 📄 **Files:** 4
      - 📦 **Entities:** 43

      **Key Entities:**

        - ℂ **DashboardValidationPlugin** (Class)
          - Plugin for automated dashboard health analysis using LLMs.
        - ℂ **DetectedIssue** (Class)
          - Model for a single issue detected during validation.
        - ℂ **DocumentationPlugin** (Class)
          - Plugin for automated dataset documentation using LLMs.
        - ℂ **LLMClient** (Class)
          - Wrapper for LLM provider APIs.
        - ℂ **LLMProviderConfig** (Class)
          - Configuration for an LLM provider.
        - ℂ **LLMProviderType** (Class)
          - Enum for supported LLM providers.
        - ℂ **ScreenshotService** (Class)
          - Handles capturing screenshots of Superset dashboards.
        - ℂ **ValidationResult** (Class)
          - Model for dashboard validation result.
        - ℂ **ValidationStatus** (Class)
          - Enum for dashboard validation status.
        - 📦 **plugin** (Module) `[TRIVIAL]`
          - Auto-generated module for backend/src/plugins/llm_analysis/p...

      **Dependencies:**

        - 🔗 IMPLEMENTS -> backend.src.core.plugin_base.PluginBase

      ### 📁 `storage/`

      - 🏗️ **Layers:** App
      - 📊 **Tiers:** STANDARD: 18
      - 📄 **Files:** 1
      - 📦 **Entities:** 18

      **Key Entities:**

        - ℂ **StoragePlugin** (Class)
          - Implementation of the storage management plugin.
        - 📦 **StoragePlugin** (Module)
          - Provides core filesystem operations for managing backups and...

      **Dependencies:**

        - 🔗 DEPENDS_ON -> backend.src.models.storage
        - 🔗 IMPLEMENTS -> PluginBase

    ### 📁 `schemas/`

    - 🏗️ **Layers:** API
    - 📊 **Tiers:** STANDARD: 10, TRIVIAL: 3
    - 📄 **Files:** 1
    - 📦 **Entities:** 13

    **Key Entities:**

      - ℂ **ADGroupMappingCreate** (Class)
        - Schema for creating an AD Group mapping.
      - ℂ **ADGroupMappingSchema** (Class)
        - Represents an AD Group to Role mapping in API responses.
      - ℂ **PermissionSchema** (Class) `[TRIVIAL]`
        - Represents a permission in API responses.
      - ℂ **RoleCreate** (Class)
        - Schema for creating a new role.
      - ℂ **RoleSchema** (Class)
        - Represents a role in API responses.
      - ℂ **RoleUpdate** (Class)
        - Schema for updating an existing role.
      - ℂ **Token** (Class) `[TRIVIAL]`
        - Represents a JWT access token response.
      - ℂ **TokenData** (Class) `[TRIVIAL]`
        - Represents the data encoded in a JWT token.
      - ℂ **User** (Class)
        - Schema for user data in API responses.
      - ℂ **UserBase** (Class)
        - Base schema for user data.

    **Dependencies:**

      - 🔗 DEPENDS_ON -> pydantic

    ### 📁 `scripts/`

    - 🏗️ **Layers:** Scripts, Unknown
    - 📊 **Tiers:** STANDARD: 26, TRIVIAL: 2
    - 📄 **Files:** 6
    - 📦 **Entities:** 28

    **Key Entities:**

      - 📦 **backend.src.scripts.create_admin** (Module)
        - CLI tool for creating the initial admin user.
      - 📦 **backend.src.scripts.init_auth_db** (Module)
        - Initializes the auth database and creates the necessary tabl...
      - 📦 **backend.src.scripts.migrate_sqlite_to_postgres** (Module)
        - Migrates legacy config and task history from SQLite/file sto...
      - 📦 **backend.src.scripts.seed_permissions** (Module)
        - Populates the auth database with initial system permissions.
      - 📦 **backend.src.scripts.seed_superset_load_test** (Module)
        - Creates randomized load-test data in Superset by cloning cha...
      - 📦 **test_dataset_dashboard_relations** (Module) `[TRIVIAL]`
        - Auto-generated module for backend/src/scripts/test_dataset_d...

    ### 📁 `services/`

    - 🏗️ **Layers:** Core, Domain, Service
    - 📊 **Tiers:** CRITICAL: 1, STANDARD: 58, TRIVIAL: 5
    - 📄 **Files:** 7
    - 📦 **Entities:** 64

    **Key Entities:**

      - ℂ **AuthService** (Class)
        - Provides high-level authentication services.
      - ℂ **EncryptionManager** (Class) `[CRITICAL]`
        - Handles encryption and decryption of sensitive data like API...
      - ℂ **GitService** (Class)
        - Wrapper for GitPython operations with semantic logging and e...
      - ℂ **LLMProviderService** (Class)
        - Service to manage LLM provider lifecycle.
      - ℂ **MappingService** (Class)
        - Service for handling database mapping logic.
      - ℂ **ResourceService** (Class)
        - Provides centralized access to resource data with enhanced m...
      - 📦 **backend.src.services** (Module)
        - Package initialization for services module
      - 📦 **backend.src.services.auth_service** (Module)
        - Orchestrates authentication business logic.
      - 📦 **backend.src.services.git_service** (Module)
        - Core Git logic using GitPython to manage dashboard repositor...
      - 📦 **backend.src.services.llm_prompt_templates** (Module)
        - Provide default LLM prompt templates and normalization helpe...

    **Dependencies:**

      - 🔗 DEPENDS_ON -> backend.src.core.config_manager
      - 🔗 DEPENDS_ON -> backend.src.core.database
      - 🔗 DEPENDS_ON -> backend.src.core.superset_client
      - 🔗 DEPENDS_ON -> backend.src.core.task_manager
      - 🔗 DEPENDS_ON -> backend.src.core.utils.matching

      ### 📁 `__tests__/`

      - 🏗️ **Layers:** Domain, Domain Tests, Service
      - 📊 **Tiers:** CRITICAL: 1, STANDARD: 21, TRIVIAL: 7
      - 📄 **Files:** 3
      - 📦 **Entities:** 29

      **Key Entities:**

        - ℂ **TestEncryptionManager** (Class)
          - Validate EncryptionManager encrypt/decrypt roundtrip, unique...
        - 📦 **backend.src.services.__tests__.test_llm_prompt_templates** (Module)
          - Validate normalization and rendering behavior for configurab...
        - 📦 **backend.src.services.__tests__.test_resource_service** (Module)
          - Unit tests for ResourceService
        - 📦 **test_encryption_manager** (Module) `[CRITICAL]`
          - Unit tests for EncryptionManager encrypt/decrypt functionali...

      **Dependencies:**

        - 🔗 DEPENDS_ON -> backend.src.services.llm_prompt_templates

      ### 📁 `reports/`

      - 🏗️ **Layers:** Domain
      - 📊 **Tiers:** CRITICAL: 5, STANDARD: 15
      - 📄 **Files:** 3
      - 📦 **Entities:** 20

      **Key Entities:**

        - ℂ **ReportsService** (Class) `[CRITICAL]`
          - Service layer for list/detail report retrieval and normaliza...
        - 📦 **backend.src.services.reports.normalizer** (Module) `[CRITICAL]`
          - Convert task manager task objects into canonical unified Tas...
        - 📦 **backend.src.services.reports.report_service** (Module) `[CRITICAL]`
          - Aggregate, normalize, filter, and paginate task reports for ...
        - 📦 **backend.src.services.reports.type_profiles** (Module) `[CRITICAL]`
          - Deterministic mapping of plugin/task identifiers to canonica...

      **Dependencies:**

        - 🔗 DEPENDS_ON -> backend.src.core.task_manager.manager.TaskManager
        - 🔗 DEPENDS_ON -> backend.src.core.task_manager.models.Task
        - 🔗 DEPENDS_ON -> backend.src.models.report
        - 🔗 DEPENDS_ON -> backend.src.models.report.TaskType
        - 🔗 DEPENDS_ON -> backend.src.services.reports.normalizer

        ### 📁 `__tests__/`

        - 🏗️ **Layers:** Domain, Domain (Tests)
        - 📊 **Tiers:** CRITICAL: 2, TRIVIAL: 19
        - 📄 **Files:** 2
        - 📦 **Entities:** 21

        **Key Entities:**

          - 📦 **backend.tests.test_report_normalizer** (Module) `[CRITICAL]`
            - Validate unknown task type fallback and partial payload norm...
          - 📦 **test_report_service** (Module) `[CRITICAL]`
            - Unit tests for ReportsService list/detail operations

  ### 📁 `tests/`

  - 🏗️ **Layers:** Core, Domain (Tests), Test, Unknown
  - 📊 **Tiers:** CRITICAL: 6, STANDARD: 80, TRIVIAL: 57
  - 📄 **Files:** 10
  - 📦 **Entities:** 143

  **Key Entities:**

    - ℂ **TestLogPersistence** (Class) `[CRITICAL]`
      - Test suite for TaskLogPersistenceService.
    - ℂ **TestTaskContext** (Class)
      - Test suite for TaskContext.
    - ℂ **TestTaskLogger** (Class)
      - Test suite for TaskLogger.
    - ℂ **TestTaskPersistenceHelpers** (Class) `[CRITICAL]`
      - Test suite for TaskPersistenceService static helper methods.
    - ℂ **TestTaskPersistenceService** (Class) `[CRITICAL]`
      - Test suite for TaskPersistenceService CRUD operations.
    - 📦 **backend.tests.test_dashboards_api** (Module)
      - Contract-driven tests for Dashboard Hub API
    - 📦 **test_auth** (Module) `[TRIVIAL]`
      - Auto-generated module for backend/tests/test_auth.py
    - 📦 **test_log_persistence** (Module) `[CRITICAL]`
      - Unit tests for TaskLogPersistenceService.
    - 📦 **test_resource_hubs** (Module) `[TRIVIAL]`
      - Auto-generated module for backend/tests/test_resource_hubs.p...
    - 📦 **test_smoke_plugins** (Module) `[TRIVIAL]`
      - Auto-generated module for backend/tests/test_smoke_plugins.p...

    ### 📁 `core/`

    - 🏗️ **Layers:** Domain, Unknown
    - 📊 **Tiers:** STANDARD: 2, TRIVIAL: 31
    - 📄 **Files:** 3
    - 📦 **Entities:** 33

    **Key Entities:**

      - 📦 **backend.tests.core.test_mapping_service** (Module)
        - Unit tests for the IdMappingService matching UUIDs to intege...
      - 📦 **backend.tests.core.test_migration_engine** (Module)
        - Unit tests for MigrationEngine's cross-filter patching algor...
      - 📦 **test_defensive_guards** (Module) `[TRIVIAL]`
        - Auto-generated module for backend/tests/core/test_defensive_...

    ### 📁 `components/`

    - 🏗️ **Layers:** Component, Feature, UI, UI -->, Unknown
    - 📊 **Tiers:** CRITICAL: 1, STANDARD: 49, TRIVIAL: 4
    - 📄 **Files:** 13
    - 📦 **Entities:** 54

    **Key Entities:**

      - 🧩 **DashboardGrid** (Component)
        - Displays a grid of dashboards with selection and pagination.
      - 🧩 **DynamicForm** (Component)
        - Generates a form dynamically based on a JSON schema.
      - 🧩 **EnvSelector** (Component)
        - Provides a UI component for selecting source and target envi...
      - 🧩 **Footer** (Component) `[TRIVIAL]`
        - Displays the application footer with copyright information.
      - 🧩 **MappingTable** (Component)
        - Displays and allows editing of database mappings.
      - 🧩 **MissingMappingModal** (Component)
        - Prompts the user to provide a database mapping when one is m...
      - 🧩 **Navbar** (Component)
        - Main navigation bar for the application.
      - 🧩 **PasswordPrompt** (Component)
        - A modal component to prompt the user for database passwords ...
      - 🧩 **TaskHistory** (Component)
        - Displays a list of recent tasks with their status and allows...
      - 🧩 **TaskList** (Component)
        - Displays a list of tasks with their status and execution det...

      ### 📁 `__tests__/`

      - 🏗️ **Layers:** UI (Tests)
      - 📊 **Tiers:** CRITICAL: 1
      - 📄 **Files:** 1
      - 📦 **Entities:** 1

      **Key Entities:**

        - 📦 **frontend.src.components.__tests__.task_log_viewer** (Module) `[CRITICAL]`
          - Unit tests for TaskLogViewer component by mounting it and ob...

      ### 📁 `auth/`

      - 🏗️ **Layers:** Component
      - 📊 **Tiers:** TRIVIAL: 1
      - 📄 **Files:** 1
      - 📦 **Entities:** 1

      **Key Entities:**

        - 🧩 **ProtectedRoute** (Component) `[TRIVIAL]`
          - Wraps content to ensure only authenticated users can access ...

      ### 📁 `git/`

      - 🏗️ **Layers:** Component
      - 📊 **Tiers:** STANDARD: 26
      - 📄 **Files:** 6
      - 📦 **Entities:** 26

      **Key Entities:**

        - 🧩 **BranchSelector** (Component)
          - UI для выбора и создания веток Git.
        - 🧩 **CommitHistory** (Component)
          - Displays the commit history for a specific dashboard.
        - 🧩 **CommitModal** (Component)
          - Модальное окно для создания коммита с просмотром изменений (...
        - 🧩 **ConflictResolver** (Component)
          - UI for resolving merge conflicts (Keep Mine / Keep Theirs).
        - 🧩 **DeploymentModal** (Component)
          - Modal for deploying a dashboard to a target environment.
        - 🧩 **GitManager** (Component)
          - Центральный компонент для управления Git-операциями конкретн...

      ### 📁 `llm/`

      - 🏗️ **Layers:** UI, Unknown
      - 📊 **Tiers:** STANDARD: 2, TRIVIAL: 11
      - 📄 **Files:** 3
      - 📦 **Entities:** 13

      **Key Entities:**

        - 🧩 **DocPreview** (Component)
          - UI component for previewing generated dataset documentation ...
        - 🧩 **ProviderConfig** (Component)
          - UI form for managing LLM provider configurations.
        - 📦 **DocPreview** (Module) `[TRIVIAL]`
          - Auto-generated module for frontend/src/components/llm/DocPre...
        - 📦 **ProviderConfig** (Module) `[TRIVIAL]`
          - Auto-generated module for frontend/src/components/llm/Provid...
        - 📦 **ValidationReport** (Module) `[TRIVIAL]`
          - Auto-generated module for frontend/src/components/llm/Valida...

        ### 📁 `__tests__/`

        - 🏗️ **Layers:** UI Tests
        - 📊 **Tiers:** STANDARD: 2
        - 📄 **Files:** 1
        - 📦 **Entities:** 2

        **Key Entities:**

          - 📦 **frontend.src.components.llm.__tests__.provider_config_integration** (Module)
            - Protect edit-button interaction contract in LLM provider set...

      ### 📁 `storage/`

      - 🏗️ **Layers:** UI
      - 📊 **Tiers:** STANDARD: 7
      - 📄 **Files:** 2
      - 📦 **Entities:** 7

      **Key Entities:**

        - 🧩 **FileList** (Component)
          - Displays a table of files with metadata and actions.
        - 🧩 **FileUpload** (Component)
          - Provides a form for uploading files to a specific category.

      ### 📁 `tasks/`

      - 🏗️ **Layers:** UI, Unknown
      - 📊 **Tiers:** STANDARD: 4, TRIVIAL: 12
      - 📄 **Files:** 4
      - 📦 **Entities:** 16

      **Key Entities:**

        - 🧩 **LogEntryRow** (Component)
          - Renders a single log entry with stacked layout optimized for...
        - 🧩 **LogFilterBar** (Component)
          - Compact filter toolbar for logs — level, source, and text se...
        - 🧩 **TaskLogPanel** (Component)
          - Combines log filtering and display into a single cohesive da...
        - 📦 **LogFilterBar** (Module) `[TRIVIAL]`
          - Auto-generated module for frontend/src/components/tasks/LogF...
        - 📦 **TaskLogPanel** (Module) `[TRIVIAL]`
          - Auto-generated module for frontend/src/components/tasks/Task...
        - 📦 **TaskResultPanel** (Module) `[TRIVIAL]`
          - Auto-generated module for frontend/src/components/tasks/Task...

      ### 📁 `tools/`

      - 🏗️ **Layers:** UI, Unknown
      - 📊 **Tiers:** STANDARD: 14, TRIVIAL: 2
      - 📄 **Files:** 4
      - 📦 **Entities:** 16

      **Key Entities:**

        - 🧩 **ConnectionForm** (Component)
          - UI component for creating a new database connection configur...
        - 🧩 **ConnectionList** (Component)
          - UI component for listing and deleting saved database connect...
        - 🧩 **DebugTool** (Component)
          - UI component for system diagnostics and debugging API respon...
        - 🧩 **MapperTool** (Component)
          - UI component for mapping dataset column verbose names using ...
        - 📦 **MapperTool** (Module) `[TRIVIAL]`
          - Auto-generated module for frontend/src/components/tools/Mapp...

    ### 📁 `lib/`

    - 🏗️ **Layers:** Infra, Infra-API, UI, UI-State
    - 📊 **Tiers:** STANDARD: 20, TRIVIAL: 3
    - 📄 **Files:** 5
    - 📦 **Entities:** 23

    **Key Entities:**

      - 🧩 **Counter** (Component) `[TRIVIAL]`
        - Simple counter demo component
      - 📦 **Utils** (Module) `[TRIVIAL]`
        - General utility functions (class merging)
      - 📦 **api_module** (Module)
        - Handles all communication with the backend API.
      - 📦 **stores_module** (Module)
        - Global state management using Svelte stores.
      - 📦 **toasts_module** (Module)
        - Manages toast notifications using a Svelte writable store.

      ### 📁 `api/`

      - 🏗️ **Layers:** Infra, Infra-API
      - 📊 **Tiers:** CRITICAL: 1, STANDARD: 10
      - 📄 **Files:** 2
      - 📦 **Entities:** 11

      **Key Entities:**

        - 📦 **frontend.src.lib.api.assistant** (Module)
          - API client wrapper for assistant chat, confirmation actions,...
        - 📦 **frontend.src.lib.api.reports** (Module) `[CRITICAL]`
          - Wrapper-based reports API client for list/detail retrieval w...

      **Dependencies:**

        - 🔗 DEPENDS_ON -> [DEF:api_module]
        - 🔗 DEPENDS_ON -> frontend.src.lib.api.api_module

        ### 📁 `__tests__/`

        - 🏗️ **Layers:** Infra (Tests)
        - 📊 **Tiers:** CRITICAL: 1, STANDARD: 3
        - 📄 **Files:** 1
        - 📦 **Entities:** 4

        **Key Entities:**

          - ℂ **TestBuildReportQueryString** (Class)
            - Validate query string construction from filter options.
          - ℂ **TestGetReportsAsync** (Class)
            - Validate getReports and getReportDetail with mocked api.fetc...
          - ℂ **TestNormalizeApiError** (Class)
            - Validate error normalization for UI-state mapping.
          - 📦 **frontend.src.lib.api.__tests__.reports_api** (Module) `[CRITICAL]`
            - Unit tests for reports API client functions: query string bu...

      ### 📁 `auth/`

      - 🏗️ **Layers:** Feature
      - 📊 **Tiers:** STANDARD: 7
      - 📄 **Files:** 1
      - 📦 **Entities:** 7

      **Key Entities:**

        - 🗄️ **authStore** (Store)
          - Manages the global authentication state on the frontend.

        ### 📁 `assistant/`

        - 🏗️ **Layers:** UI, Unknown
        - 📊 **Tiers:** CRITICAL: 1, STANDARD: 12, TRIVIAL: 4
        - 📄 **Files:** 1
        - 📦 **Entities:** 17

        **Key Entities:**

          - 🧩 **AssistantChatPanel** (Component) `[CRITICAL]`
            - Slide-out assistant chat panel for natural language command ...
          - 📦 **AssistantChatPanel** (Module) `[TRIVIAL]`
            - Auto-generated module for frontend/src/lib/components/assist...

          ### 📁 `__tests__/`

          - 🏗️ **Layers:** UI Tests
          - 📊 **Tiers:** STANDARD: 5
          - 📄 **Files:** 2
          - 📦 **Entities:** 5

          **Key Entities:**

            - 📦 **frontend.src.lib.components.assistant.__tests__.assistant_chat_integration** (Module)
              - Contract-level integration checks for assistant chat panel i...
            - 📦 **frontend.src.lib.components.assistant.__tests__.assistant_confirmation_integration** (Module)
              - Validate confirm/cancel UX contract bindings in assistant ch...

        ### 📁 `layout/`

        - 🏗️ **Layers:** UI, Unknown
        - 📊 **Tiers:** CRITICAL: 3, STANDARD: 5, TRIVIAL: 26
        - 📄 **Files:** 4
        - 📦 **Entities:** 34

        **Key Entities:**

          - 🧩 **Breadcrumbs** (Component)
            - Display page hierarchy navigation
          - 🧩 **Sidebar** (Component) `[CRITICAL]`
            - Persistent left sidebar with resource categories navigation
          - 🧩 **TaskDrawer** (Component) `[CRITICAL]`
            - Global task drawer for monitoring background operations
          - 🧩 **TopNavbar** (Component) `[CRITICAL]`
            - Unified top navigation bar with Logo, Search, Activity, and ...
          - 📦 **Breadcrumbs** (Module) `[TRIVIAL]`
            - Auto-generated module for frontend/src/lib/components/layout...
          - 📦 **Sidebar** (Module) `[TRIVIAL]`
            - Auto-generated module for frontend/src/lib/components/layout...
          - 📦 **TaskDrawer** (Module) `[TRIVIAL]`
            - Auto-generated module for frontend/src/lib/components/layout...
          - 📦 **TopNavbar** (Module) `[TRIVIAL]`
            - Auto-generated module for frontend/src/lib/components/layout...

          ### 📁 `__tests__/`

          - 🏗️ **Layers:** Unknown
          - 📊 **Tiers:** TRIVIAL: 3
          - 📄 **Files:** 1
          - 📦 **Entities:** 3

          **Key Entities:**

            - 📦 **test_breadcrumbs.svelte** (Module) `[TRIVIAL]`
              - Auto-generated module for frontend/src/lib/components/layout...

        ### 📁 `reports/`

        - 🏗️ **Layers:** UI, Unknown
        - 📊 **Tiers:** CRITICAL: 4, STANDARD: 1, TRIVIAL: 10
        - 📄 **Files:** 4
        - 📦 **Entities:** 15

        **Key Entities:**

          - 🧩 **ReportCard** (Component) `[CRITICAL]`
            - Render one report with explicit textual type label and profi...
          - 🧩 **ReportDetailPanel** (Component) `[CRITICAL]`
            - Display detailed report context with diagnostics and actiona...
          - 🧩 **ReportsList** (Component) `[CRITICAL]`
            - Render unified list of normalized reports with canonical min...
          - 📦 **ReportCard** (Module) `[TRIVIAL]`
            - Auto-generated module for frontend/src/lib/components/report...
          - 📦 **ReportDetailPanel** (Module) `[TRIVIAL]`
            - Auto-generated module for frontend/src/lib/components/report...
          - 📦 **ReportsList** (Module) `[TRIVIAL]`
            - Auto-generated module for frontend/src/lib/components/report...
          - 📦 **frontend.src.lib.components.reports.reportTypeProfiles** (Module) `[CRITICAL]`
            - Deterministic mapping from report task_type to visual profil...

        **Dependencies:**

          - 🔗 DEPENDS_ON -> frontend/src/lib/i18n/index.ts

          ### 📁 `__tests__/`

          - 🏗️ **Layers:** UI, UI (Tests)
          - 📊 **Tiers:** CRITICAL: 5, STANDARD: 1, TRIVIAL: 4
          - 📄 **Files:** 6
          - 📦 **Entities:** 10

          **Key Entities:**

            - 📦 **frontend.src.lib.components.reports.__tests__.report_card.ux** (Module) `[CRITICAL]`
              - Test UX states and transitions for ReportCard component
            - 📦 **frontend.src.lib.components.reports.__tests__.report_detail.integration** (Module) `[CRITICAL]`
              - Validate detail-panel behavior for failed reports and recove...
            - 📦 **frontend.src.lib.components.reports.__tests__.report_detail.ux** (Module) `[CRITICAL]`
              - Test UX states and recovery for ReportDetailPanel component
            - 📦 **frontend.src.lib.components.reports.__tests__.report_type_profiles** (Module) `[CRITICAL]`
              - Validate report type profile mapping and unknown fallback be...
            - 📦 **frontend.src.lib.components.reports.__tests__.reports_filter_performance** (Module)
              - Guard test for report filter responsiveness on moderate in-m...
            - 📦 **frontend.src.lib.components.reports.__tests__.reports_page.integration** (Module) `[CRITICAL]`
              - Integration-style checks for unified mixed-type reports rend...

            ### 📁 `fixtures/`

            - 🏗️ **Layers:** UI
            - 📊 **Tiers:** STANDARD: 1
            - 📄 **Files:** 1
            - 📦 **Entities:** 1

            **Key Entities:**

              - 📦 **reports.fixtures** (Module)
                - Shared frontend fixtures for unified reports states.

      ### 📁 `i18n/`

      - 🏗️ **Layers:** Infra
      - 📊 **Tiers:** STANDARD: 4
      - 📄 **Files:** 1
      - 📦 **Entities:** 4

      **Key Entities:**

        - 📦 **i18n** (Module)
          - Determines the starting locale.
        - 🗄️ **locale** (Store)
          - Holds the current active locale string.
        - 🗄️ **t** (Store)
          - Derived store providing the translation dictionary.

      **Dependencies:**

        - 🔗 DEPENDS_ON -> locales/en.json
        - 🔗 DEPENDS_ON -> locales/ru.json

      ### 📁 `stores/`

      - 🏗️ **Layers:** UI, Unknown
      - 📊 **Tiers:** CRITICAL: 1, STANDARD: 7, TRIVIAL: 12
      - 📄 **Files:** 4
      - 📦 **Entities:** 20

      **Key Entities:**

        - 📦 **sidebar** (Module) `[TRIVIAL]`
          - Auto-generated module for frontend/src/lib/stores/sidebar.js
        - 📦 **taskDrawer** (Module) `[TRIVIAL]`
          - Auto-generated module for frontend/src/lib/stores/taskDrawer...
        - 🗄️ **activity** (Store)
          - Track active task count for navbar indicator
        - 🗄️ **assistantChat** (Store)
          - Control assistant chat panel visibility and active conversat...
        - 🗄️ **sidebar** (Store)
          - Manage sidebar visibility and navigation state
        - 🗄️ **taskDrawer** (Store) `[CRITICAL]`
          - Manage Task Drawer visibility and resource-to-task mapping

      **Dependencies:**

        - 🔗 DEPENDS_ON -> WebSocket connection, taskDrawer store

        ### 📁 `__tests__/`

        - 🏗️ **Layers:** Domain (Tests), UI, UI Tests
        - 📊 **Tiers:** CRITICAL: 1, STANDARD: 10
        - 📄 **Files:** 6
        - 📦 **Entities:** 11

        **Key Entities:**

          - 📦 **frontend.src.lib.stores.__tests__.assistantChat** (Module)
            - Validate assistant chat store visibility and conversation bi...
          - 📦 **frontend.src.lib.stores.__tests__.sidebar** (Module)
            - Unit tests for sidebar store
          - 📦 **frontend.src.lib.stores.__tests__.test_activity** (Module)
            - Unit tests for activity store
          - 📦 **frontend.src.lib.stores.__tests__.test_sidebar** (Module)
            - Unit tests for sidebar store
          - 📦 **frontend.src.lib.stores.__tests__.test_taskDrawer** (Module) `[CRITICAL]`
            - Unit tests for task drawer store
          - 📦 **setupTests** (Module)
            - Global test setup with mocks for SvelteKit modules

        **Dependencies:**

          - 🔗 DEPENDS_ON -> assistantChatStore
          - 🔗 DEPENDS_ON -> frontend.src.lib.stores.taskDrawer

          ### 📁 `mocks/`

          - 🏗️ **Layers:** UI (Tests)
          - 📊 **Tiers:** STANDARD: 4
          - 📄 **Files:** 4
          - 📦 **Entities:** 4

          **Key Entities:**

            - 📦 **mock_env_public** (Module)
              - Mock for $env/static/public SvelteKit module in vitest

      ### 📁 `ui/`

      - 🏗️ **Layers:** Atom
      - 📊 **Tiers:** TRIVIAL: 7
      - 📄 **Files:** 7
      - 📦 **Entities:** 7

      **Key Entities:**

        - 🧩 **Button** (Component) `[TRIVIAL]`
          - Define component interface and default values (Svelte 5 Rune...
        - 🧩 **Card** (Component) `[TRIVIAL]`
          - Standardized container with padding and elevation.
        - 🧩 **Input** (Component) `[TRIVIAL]`
          - Standardized text input component with label and error handl...
        - 🧩 **LanguageSwitcher** (Component) `[TRIVIAL]`
          - Dropdown component to switch between supported languages.
        - 🧩 **PageHeader** (Component) `[TRIVIAL]`
          - Standardized page header with title and action area.
        - 🧩 **Select** (Component) `[TRIVIAL]`
          - Standardized dropdown selection component.
        - 📦 **ui** (Module) `[TRIVIAL]`
          - Central export point for standardized UI components.

      ### 📁 `utils/`

      - 🏗️ **Layers:** Infra
      - 📊 **Tiers:** TRIVIAL: 2
      - 📄 **Files:** 1
      - 📦 **Entities:** 2

      **Key Entities:**

        - 📦 **Debounce** (Module) `[TRIVIAL]`
          - Debounce utility for limiting function execution rate

    ### 📁 `pages/`

    - 🏗️ **Layers:** UI
    - 📊 **Tiers:** STANDARD: 11
    - 📄 **Files:** 2
    - 📦 **Entities:** 11

    **Key Entities:**

      - 🧩 **Dashboard** (Component)
        - Displays the list of available plugins and allows selecting ...
      - 🧩 **Settings** (Component)
        - The main settings page for the application, allowing managem...

    ### 📁 `routes/`

    - 🏗️ **Layers:** Infra, UI
    - 📊 **Tiers:** CRITICAL: 1, STANDARD: 3, TRIVIAL: 1
    - 📄 **Files:** 5
    - 📦 **Entities:** 5

    **Key Entities:**

      - 📦 **RootLayoutConfig** (Module) `[TRIVIAL]`
        - Root layout configuration (SPA mode)
      - 📦 **layout** (Module)
        - Bind global layout shell and conditional login/full-app rend...

        ### 📁 `roles/`

        - 🏗️ **Layers:** Domain
        - 📊 **Tiers:** STANDARD: 6
        - 📄 **Files:** 1
        - 📦 **Entities:** 6

        **Key Entities:**

          - 🧩 **AdminRolesPage** (Component)
            - UI for managing system roles and their permissions.

        ### 📁 `settings/`

        - 🏗️ **Layers:** Feature
        - 📊 **Tiers:** STANDARD: 5
        - 📄 **Files:** 1
        - 📦 **Entities:** 5

        **Key Entities:**

          - 🧩 **AdminSettingsPage** (Component)
            - UI for configuring Active Directory Group to local Role mapp...

          ### 📁 `llm/`

          - 🏗️ **Layers:** UI, Unknown
          - 📊 **Tiers:** STANDARD: 1, TRIVIAL: 5
          - 📄 **Files:** 1
          - 📦 **Entities:** 6

          **Key Entities:**

            - 🧩 **LLMSettingsPage** (Component)
              - Admin settings page for LLM provider configuration.
            - 📦 **+page** (Module) `[TRIVIAL]`
              - Auto-generated module for frontend/src/routes/admin/settings...

        ### 📁 `users/`

        - 🏗️ **Layers:** Feature
        - 📊 **Tiers:** STANDARD: 6
        - 📄 **Files:** 1
        - 📦 **Entities:** 6

        **Key Entities:**

          - 🧩 **AdminUsersPage** (Component)
            - UI for managing system users and their roles.

      ### 📁 `dashboards/`

      - 🏗️ **Layers:** UI, Unknown
      - 📊 **Tiers:** CRITICAL: 1, TRIVIAL: 37
      - 📄 **Files:** 1
      - 📦 **Entities:** 38

      **Key Entities:**

        - 📦 **+page** (Module) `[TRIVIAL]`
          - Auto-generated module for frontend/src/routes/dashboards/+pa...

        ### 📁 `[id]/`

        - 🏗️ **Layers:** UI, Unknown
        - 📊 **Tiers:** CRITICAL: 1, TRIVIAL: 5
        - 📄 **Files:** 1
        - 📦 **Entities:** 6

        **Key Entities:**

          - 📦 **+page** (Module) `[TRIVIAL]`
            - Auto-generated module for frontend/src/routes/dashboards/[id...

      ### 📁 `datasets/`

      - 🏗️ **Layers:** UI, Unknown
      - 📊 **Tiers:** CRITICAL: 1, TRIVIAL: 17
      - 📄 **Files:** 1
      - 📦 **Entities:** 18

      **Key Entities:**

        - 📦 **+page** (Module) `[TRIVIAL]`
          - Auto-generated module for frontend/src/routes/datasets/+page...

        ### 📁 `[id]/`

        - 🏗️ **Layers:** UI, Unknown
        - 📊 **Tiers:** CRITICAL: 1, TRIVIAL: 6
        - 📄 **Files:** 1
        - 📦 **Entities:** 7

        **Key Entities:**

          - 📦 **+page** (Module) `[TRIVIAL]`
            - Auto-generated module for frontend/src/routes/datasets/[id]/...

      ### 📁 `git/`

      - 🏗️ **Layers:** Page
      - 📊 **Tiers:** STANDARD: 3
      - 📄 **Files:** 1
      - 📦 **Entities:** 3

      **Key Entities:**

        - 🧩 **GitDashboardPage** (Component)
          - Dashboard management page for Git integration.

      ### 📁 `login/`

      - 🏗️ **Layers:** UI
      - 📊 **Tiers:** STANDARD: 3
      - 📄 **Files:** 1
      - 📦 **Entities:** 3

      **Key Entities:**

        - 🧩 **LoginPage** (Component)
          - Provides the user interface for local and ADFS authenticatio...

      ### 📁 `migration/`

      - 🏗️ **Layers:** Page
      - 📊 **Tiers:** STANDARD: 10
      - 📄 **Files:** 1
      - 📦 **Entities:** 10

      **Key Entities:**

        - 🧩 **DashboardSelectionSection** (Component)
        - 🧩 **MigrationDashboard** (Component)
          - Main dashboard for configuring and starting migrations.

        ### 📁 `mappings/`

        - 🏗️ **Layers:** Page
        - 📊 **Tiers:** STANDARD: 4
        - 📄 **Files:** 1
        - 📦 **Entities:** 4

        **Key Entities:**

          - 🧩 **MappingManagement** (Component)
            - Page for managing database mappings between environments.

      ### 📁 `reports/`

      - 🏗️ **Layers:** UI, Unknown
      - 📊 **Tiers:** CRITICAL: 1, TRIVIAL: 7
      - 📄 **Files:** 1
      - 📦 **Entities:** 8

      **Key Entities:**

        - 🧩 **UnifiedReportsPage** (Component) `[CRITICAL]`
          - Unified reports page with filtering and resilient UX states ...
        - 📦 **+page** (Module) `[TRIVIAL]`
          - Auto-generated module for frontend/src/routes/reports/+page....

      ### 📁 `settings/`

      - 🏗️ **Layers:** UI, Unknown
      - 📊 **Tiers:** CRITICAL: 1, STANDARD: 1, TRIVIAL: 23
      - 📄 **Files:** 2
      - 📦 **Entities:** 25

      **Key Entities:**

        - 📦 **+page** (Module) `[TRIVIAL]`
          - Auto-generated module for frontend/src/routes/settings/+page...

        ### 📁 `connections/`

        - 🏗️ **Layers:** UI
        - 📊 **Tiers:** STANDARD: 2
        - 📄 **Files:** 1
        - 📦 **Entities:** 2

        **Key Entities:**

          - 🧩 **ConnectionsSettingsPage** (Component)
            - Page for managing database connection configurations.

        ### 📁 `git/`

        - 🏗️ **Layers:** Page
        - 📊 **Tiers:** STANDARD: 5
        - 📄 **Files:** 1
        - 📦 **Entities:** 5

        **Key Entities:**

          - 🧩 **GitSettingsPage** (Component)
            - Manage Git server configurations for dashboard versioning.

      ### 📁 `storage/`

      - 🏗️ **Layers:** Page
      - 📊 **Tiers:** TRIVIAL: 1
      - 📄 **Files:** 1
      - 📦 **Entities:** 1

        ### 📁 `repos/`

        - 📊 **Tiers:** STANDARD: 3
        - 📄 **Files:** 1
        - 📦 **Entities:** 3

        ### 📁 `debug/`

        - 🏗️ **Layers:** UI
        - 📊 **Tiers:** TRIVIAL: 1
        - 📄 **Files:** 1
        - 📦 **Entities:** 1

        **Key Entities:**

          - 🧩 **DebugPage** (Component) `[TRIVIAL]`
            - Page for system diagnostics and debugging.

        ### 📁 `mapper/`

        - 🏗️ **Layers:** UI
        - 📊 **Tiers:** TRIVIAL: 1
        - 📄 **Files:** 1
        - 📦 **Entities:** 1

        **Key Entities:**

          - 🧩 **MapperPage** (Component) `[TRIVIAL]`
            - Page for the dataset column mapper tool.

        ### 📁 `storage/`

        - 🏗️ **Layers:** UI
        - 📊 **Tiers:** STANDARD: 5
        - 📄 **Files:** 1
        - 📦 **Entities:** 5

        **Key Entities:**

          - 🧩 **StoragePage** (Component)
            - Main page for file storage management.

    ### 📁 `services/`

    - 🏗️ **Layers:** Service
    - 📊 **Tiers:** STANDARD: 33
    - 📄 **Files:** 6
    - 📦 **Entities:** 33

    **Key Entities:**

      - 📦 **GitServiceClient** (Module)
        - API client for Git operations, managing the communication be...
      - 📦 **adminService** (Module)
        - Service for Admin-related API calls (User and Role managemen...
      - 📦 **storageService** (Module)
        - Frontend API client for file storage management.

    **Dependencies:**

      - 🔗 DEPENDS_ON -> frontend.src.lib.api

    ### 📁 `types/`

    - 🏗️ **Layers:** Domain
    - 📊 **Tiers:** TRIVIAL: 1
    - 📄 **Files:** 1
    - 📦 **Entities:** 1

    **Key Entities:**

      - 📦 **DashboardTypes** (Module) `[TRIVIAL]`
        - TypeScript interfaces for Dashboard entities

### 📁 `root/`

- 🏗️ **Layers:** DevOps/Tooling, Domain, Unknown
- 📊 **Tiers:** CRITICAL: 14, STANDARD: 24, TRIVIAL: 10
- 📄 **Files:** 3
- 📦 **Entities:** 48

**Key Entities:**

  - ℂ **ComplianceIssue** (Class) `[TRIVIAL]`
    - Represents a single compliance issue with severity.
  - ℂ **ReportsService** (Class) `[CRITICAL]`
    - Service layer for list/detail report retrieval and normaliza...
  - ℂ **SemanticEntity** (Class) `[CRITICAL]`
    - Represents a code entity (Module, Function, Component) found...
  - ℂ **SemanticMapGenerator** (Class) `[CRITICAL]`
    - Orchestrates the mapping process with tier-based validation.
  - ℂ **Severity** (Class) `[TRIVIAL]`
    - Severity levels for compliance issues.
  - ℂ **Tier** (Class) `[TRIVIAL]`
    - Enumeration of semantic tiers defining validation strictness...
  - 📦 **backend.src.services.reports.report_service** (Module) `[CRITICAL]`
    - Aggregate, normalize, filter, and paginate task reports for ...
  - 📦 **generate_semantic_map** (Module)
    - Scans the codebase to generate a Semantic Map, Module Map, a...
  - 📦 **test_analyze** (Module) `[TRIVIAL]`
    - Auto-generated module for test_analyze.py

**Dependencies:**

  - 🔗 DEPENDS_ON -> backend.src.core.task_manager.manager.TaskManager
  - 🔗 DEPENDS_ON -> backend.src.models.report
  - 🔗 DEPENDS_ON -> backend.src.services.reports.normalizer

## Cross-Module Dependencies

```mermaid
graph TD
    api-->|USES|backend
    api-->|USES|backend
    routes-->|DEPENDS_ON|backend
    routes-->|DEPENDS_ON|backend
    routes-->|DEPENDS_ON|backend
    routes-->|DEPENDS_ON|backend
    routes-->|DEPENDS_ON|backend
    routes-->|DEPENDS_ON|backend
    routes-->|DEPENDS_ON|backend
    routes-->|DEPENDS_ON|backend
    routes-->|DEPENDS_ON|backend
    routes-->|DEPENDS_ON|backend
    routes-->|USES|backend
    routes-->|USES|backend
    routes-->|CALLS|backend
    routes-->|CALLS|backend
    routes-->|CALLS|backend
    routes-->|CALLS|backend
    routes-->|CALLS|backend
    routes-->|DEPENDS_ON|backend
    routes-->|DEPENDS_ON|backend
    routes-->|DEPENDS_ON|backend
    routes-->|DEPENDS_ON|backend
    routes-->|DEPENDS_ON|backend
    routes-->|DEPENDS_ON|backend
    routes-->|DEPENDS_ON|backend
    routes-->|DEPENDS_ON|backend
    routes-->|DEPENDS_ON|backend
    __tests__-->|TESTS|backend
    __tests__-->|TESTS|backend
    __tests__-->|TESTS|backend
    __tests__-->|TESTS|backend
    __tests__-->|DEPENDS_ON|backend
    __tests__-->|DEPENDS_ON|backend
    __tests__-->|VERIFIES|backend
    core-->|USES|backend
    core-->|USES|backend
    core-->|DEPENDS_ON|backend
    core-->|DEPENDS_ON|backend
    core-->|DEPENDS_ON|backend
    core-->|DEPENDS_ON|backend
    auth-->|USES|backend
    auth-->|USES|backend
    auth-->|USES|backend
    auth-->|USES|backend
    utils-->|DEPENDS_ON|backend
    utils-->|DEPENDS_ON|backend
    utils-->|DEPENDS_ON|backend
    models-->|INHERITS_FROM|backend
    models-->|DEPENDS_ON|backend
    models-->|DEPENDS_ON|backend
    models-->|USED_BY|backend
    models-->|INHERITS_FROM|backend
    __tests__-->|TESTS|backend
    llm_analysis-->|IMPLEMENTS|backend
    llm_analysis-->|IMPLEMENTS|backend
    storage-->|DEPENDS_ON|backend
    scripts-->|USES|backend
    scripts-->|USES|backend
    scripts-->|READS_FROM|backend
    scripts-->|READS_FROM|backend
    scripts-->|USES|backend
    scripts-->|USES|backend
    scripts-->|CALLS|backend
    scripts-->|USES|backend
    scripts-->|USES|backend
    scripts-->|USES|backend
    services-->|DEPENDS_ON|backend
    services-->|DEPENDS_ON|backend
    services-->|DEPENDS_ON|backend
    services-->|DEPENDS_ON|backend
    services-->|DEPENDS_ON|backend
    services-->|DEPENDS_ON|backend
    services-->|USES|backend
    services-->|USES|backend
    services-->|USES|backend
    services-->|DEPENDS_ON|backend
    services-->|DEPENDS_ON|backend
    __tests__-->|TESTS|backend
    __tests__-->|DEPENDS_ON|backend
    __tests__-->|TESTS|backend
    reports-->|DEPENDS_ON|backend
    reports-->|DEPENDS_ON|backend
    reports-->|DEPENDS_ON|backend
    reports-->|DEPENDS_ON|backend
    reports-->|DEPENDS_ON|backend
    reports-->|DEPENDS_ON|backend
    reports-->|DEPENDS_ON|backend
    __tests__-->|TESTS|backend
    __tests__-->|TESTS|backend
    tests-->|TESTS|backend
    tests-->|TESTS|backend
    core-->|VERIFIES|backend
    core-->|VERIFIES|backend
    __tests__-->|VERIFIES|components
    __tests__-->|VERIFIES|lib
    __tests__-->|VERIFIES|lib
    reports-->|DEPENDS_ON|lib
    __tests__-->|TESTS|routes
    __tests__-->|TESTS|routes
    __tests__-->|TESTS|lib
    __tests__-->|TESTS|lib
    __tests__-->|TESTS|lib
    __tests__-->|TESTS|routes
    root-->|DEPENDS_ON|backend
    root-->|DEPENDS_ON|backend
    root-->|DEPENDS_ON|backend
```
