# Module Map

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

**Generated:** 2026-03-14T09:20:50.362415

## Summary

- **Total Modules:** 103
- **Total Entities:** 3134

## Module Hierarchy

### 📁 `backend/`

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

**Key Entities:**

  - 📦 **backend.delete_running_tasks** (Module)
    - Script to delete tasks with RUNNING status from the database...

  ### 📁 `src/`

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

  **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:** CRITICAL: 7, STANDARD: 1
    - 📄 **Files:** 2
    - 📦 **Entities:** 8

    **Key Entities:**

      - 📦 **backend.src.api.auth** (Module) `[CRITICAL]`
        - Authentication API endpoints.

      ### 📁 `routes/`

      - 🏗️ **Layers:** API, Infra, UI (API), UI/API
      - 📊 **Tiers:** CRITICAL: 12, STANDARD: 272, TRIVIAL: 16
      - 📄 **Files:** 21
      - 📦 **Entities:** 300

      **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.
        - ℂ **BuildManifestRequest** (Class)
          - Request schema for manifest build endpoint.
        - ℂ **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...

      **Dependencies:**

        - 🔗 DEPENDS_ON -> ConfigManager
        - 🔗 DEPENDS_ON -> ConfigModels
        - 🔗 DEPENDS_ON -> backend.src.core.database
        - 🔗 DEPENDS_ON -> backend.src.core.database.get_db
        - 🔗 DEPENDS_ON -> backend.src.core.mapping_service

        ### 📁 `__tests__/`

        - 🏗️ **Layers:** API, Domain, Domain (Tests), Tests, UI (API Tests), Unknown
        - 📊 **Tiers:** STANDARD: 92, TRIVIAL: 195
        - 📄 **Files:** 17
        - 📦 **Entities:** 287

        **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
          - 🔗 IMPLEMENTS -> clean_release_v2_release_api_contracts

    ### 📁 `core/`

    - 🏗️ **Layers:** Core, Domain
    - 📊 **Tiers:** CRITICAL: 55, STANDARD: 103, TRIVIAL: 9
    - 📄 **Files:** 13
    - 📦 **Entities:** 167

    **Key Entities:**

      - ℂ **AsyncSupersetClient** (Class)
        - Async sibling of SupersetClient for dashboard read paths.
      - ℂ **AuthSessionLocal** (Class) `[TRIVIAL]`
        - A session factory for the authentication database.
      - ℂ **BeliefFormatter** (Class)
        - Custom logging formatter that adds belief state prefixes to ...
      - ℂ **ConfigManager** (Class) `[CRITICAL]`
        - Handles application configuration load, validation, mutation...
      - ℂ **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) `[CRITICAL]`
        - 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 ...

    **Dependencies:**

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

      ### 📁 `__tests__/`

      - 🏗️ **Layers:** Domain
      - 📊 **Tiers:** STANDARD: 11, TRIVIAL: 7
      - 📄 **Files:** 3
      - 📦 **Entities:** 18

      **Key Entities:**

        - ℂ **_RecordingNetworkClient** (Class)
          - Records request payloads and returns scripted responses for ...
        - 📦 **backend.src.core.__tests__.test_config_manager_compat** (Module)
          - Verifies ConfigManager compatibility wrappers preserve legac...
        - 📦 **backend.src.core.__tests__.test_superset_profile_lookup** (Module)
          - Verifies Superset profile lookup adapter payload normalizati...
        - 📦 **test_throttled_scheduler** (Module)
          - Unit tests for ThrottledSchedulerConfigurator distribution l...

      ### 📁 `auth/`

      - 🏗️ **Layers:** Core, Domain
      - 📊 **Tiers:** CRITICAL: 29
      - 📄 **Files:** 7
      - 📦 **Entities:** 29

      **Key Entities:**

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

      **Dependencies:**

        - 🔗 DEPENDS_ON -> authlib
        - 🔗 DEPENDS_ON -> backend.src.core.logger.belief_scope
        - 🔗 DEPENDS_ON -> backend.src.models.auth
        - 🔗 DEPENDS_ON -> backend.src.models.profile
        - 🔗 DEPENDS_ON -> jose

        ### 📁 `__tests__/`

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

        **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

      ### 📁 `migration/`

      - 🏗️ **Layers:** Core, Domain
      - 📊 **Tiers:** CRITICAL: 20, TRIVIAL: 1
      - 📄 **Files:** 4
      - 📦 **Entities:** 21

      **Key Entities:**

        - ℂ **MigrationArchiveParser** (Class) `[CRITICAL]`
          - Extract normalized dashboards/charts/datasets metadata from ...
        - ℂ **MigrationDryRunService** (Class) `[CRITICAL]`
          - Build deterministic diff/risk payload for migration pre-flig...
        - 📦 **backend.src.core.migration.__init__** (Module) `[TRIVIAL]`
          - Namespace package for migration pre-flight orchestration com...
        - 📦 **backend.src.core.migration.archive_parser** (Module) `[CRITICAL]`
          - Parse Superset export ZIP archives into normalized object ca...
        - 📦 **backend.src.core.migration.dry_run_orchestrator** (Module) `[CRITICAL]`
          - Compute pre-flight migration diff and risk scoring without a...
        - 📦 **backend.src.core.migration.risk_assessor** (Module) `[CRITICAL]`
          - Compute deterministic migration risk items and aggregate sco...

      **Dependencies:**

        - 🔗 DEPENDS_ON -> backend.src.core.logger
        - 🔗 DEPENDS_ON -> backend.src.core.migration.archive_parser
        - 🔗 DEPENDS_ON -> backend.src.core.migration.risk_assessor
        - 🔗 DEPENDS_ON -> backend.src.core.migration_engine
        - 🔗 DEPENDS_ON -> backend.src.core.superset_client

      ### 📁 `task_manager/`

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

      **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

        ### 📁 `__tests__/`

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

        **Key Entities:**

          - 📦 **test_task_logger** (Module) `[TRIVIAL]`
            - Auto-generated module for backend/src/core/task_manager/__te...

      ### 📁 `utils/`

      - 🏗️ **Layers:** Core, Domain, Infra
      - 📊 **Tiers:** CRITICAL: 1, STANDARD: 63, TRIVIAL: 5
      - 📄 **Files:** 6
      - 📦 **Entities:** 69

      **Key Entities:**

        - ℂ **APIClient** (Class)
          - Инкапсулирует HTTP-логику для работы с API, включая сессии, ...
        - ℂ **AsyncAPIClient** (Class)
          - Async Superset API client backed by httpx.AsyncClient with s...
        - ℂ **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.
        - ℂ **SupersetAuthCache** (Class)
          - Process-local cache for Superset access/csrf tokens keyed by...

      **Dependencies:**

        - 🔗 DEPENDS_ON -> backend.core.superset_client
        - 🔗 DEPENDS_ON -> backend.src.core.logger
        - 🔗 DEPENDS_ON -> backend.src.core.utils.network.SupersetAuthCache
        - 🔗 DEPENDS_ON -> pandas
        - 🔗 DEPENDS_ON -> psycopg2

    ### 📁 `models/`

    - 🏗️ **Layers:** Domain, Model
    - 📊 **Tiers:** CRITICAL: 21, STANDARD: 41, TRIVIAL: 29
    - 📄 **Files:** 14
    - 📦 **Entities:** 91

    **Key Entities:**

      - ℂ **ADGroupMapping** (Class) `[CRITICAL]`
        - Maps an Active Directory group to a local System Role.
      - ℂ **AppConfigRecord** (Class) `[CRITICAL]`
        - Stores persisted application configuration as a single autho...
      - ℂ **ApprovalDecision** (Class)
        - Approval or rejection bound to a candidate and report.
      - ℂ **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.
      - ℂ **CandidateArtifact** (Class)
        - Represents one artifact associated with a release candidate.
      - ℂ **CheckFinalStatus** (Class)
        - Backward-compatible final status enum for legacy TUI/orchest...
      - ℂ **CheckStageName** (Class)
        - Backward-compatible stage name enum for legacy TUI/orchestra...
      - ℂ **CheckStageResult** (Class)
        - Backward-compatible stage result container for legacy TUI/or...

    **Dependencies:**

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

      ### 📁 `__tests__/`

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

      **Key Entities:**

        - 📦 **test_clean_release** (Module) `[TRIVIAL]`
          - Auto-generated module for backend/src/models/__tests__/test_...
        - 📦 **test_models** (Module) `[TRIVIAL]`
          - Unit tests for data models
        - 📦 **test_report_models** (Module)
          - Unit tests for report Pydantic models and their validators

    ### 📁 `plugins/`

    - 🏗️ **Layers:** App, Plugin, Plugins
    - 📊 **Tiers:** CRITICAL: 10, STANDARD: 54
    - 📄 **Files:** 7
    - 📦 **Entities:** 64

    **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) `[CRITICAL]`
        - 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) `[CRITICAL]`
        - 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: 3, TRIVIAL: 2
      - 📄 **Files:** 2
      - 📦 **Entities:** 5

      **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: 21, TRIVIAL: 24
      - 📄 **Files:** 4
      - 📦 **Entities:** 45

      **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, Domain
    - 📊 **Tiers:** CRITICAL: 10, STANDARD: 19, TRIVIAL: 3
    - 📄 **Files:** 5
    - 📦 **Entities:** 32

    **Key Entities:**

      - ℂ **ADGroupMappingCreate** (Class) `[CRITICAL]`
        - Schema for creating an AD Group mapping.
      - ℂ **ADGroupMappingSchema** (Class) `[CRITICAL]`
        - Represents an AD Group to Role mapping in API responses.
      - ℂ **DashboardHealthItem** (Class)
        - Represents the latest health status of a single dashboard.
      - ℂ **HealthSummaryResponse** (Class)
        - Aggregated health summary for all dashboards.
      - ℂ **NotificationChannel** (Class)
        - Structured notification channel definition for policy-level ...
      - ℂ **PermissionSchema** (Class) `[TRIVIAL]`
        - Represents a permission in API responses.
      - ℂ **ProfilePermissionState** (Class)
        - Represents one permission badge state for profile read-only ...
      - ℂ **ProfilePreference** (Class)
        - Represents persisted profile preference for a single authent...
      - ℂ **ProfilePreferenceResponse** (Class)
        - Response envelope for profile preference read/update endpoin...
      - ℂ **ProfilePreferenceUpdateRequest** (Class)
        - Request payload for updating current user's profile settings...

    **Dependencies:**

      - 🔗 DEPENDS_ON -> pydantic

      ### 📁 `__tests__/`

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

      **Key Entities:**

        - 📦 **backend.src.schemas.__tests__.test_settings_and_health_schemas** (Module)
          - Regression tests for settings and health schema contracts up...

    ### 📁 `scripts/`

    - 🏗️ **Layers:** Scripts, UI, Unknown
    - 📊 **Tiers:** CRITICAL: 3, STANDARD: 44, TRIVIAL: 30
    - 📄 **Files:** 9
    - 📦 **Entities:** 77

    **Key Entities:**

      - ℂ **CleanReleaseTUI** (Class)
        - Curses-based application for compliance monitoring.
      - ℂ **TuiFacadeAdapter** (Class)
        - Thin TUI adapter that routes business mutations through appl...
      - 📦 **backend.src.scripts.clean_release_cli** (Module)
        - Provide headless CLI commands for candidate registration, ar...
      - 📦 **backend.src.scripts.clean_release_tui** (Module)
        - Interactive terminal interface for Enterprise Clean Release ...
      - 📦 **backend.src.scripts.create_admin** (Module)
        - CLI tool for creating the initial admin user.
      - 📦 **backend.src.scripts.init_auth_db** (Module) `[CRITICAL]`
        - 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...

    **Dependencies:**

      - 🔗 DEPENDS_ON -> backend.src.services.clean_release.compliance_orchestrator
      - 🔗 DEPENDS_ON -> backend.src.services.clean_release.repository

    ### 📁 `services/`

    - 🏗️ **Layers:** Core, Domain, Domain/Service, Service
    - 📊 **Tiers:** CRITICAL: 10, STANDARD: 120, TRIVIAL: 17
    - 📄 **Files:** 10
    - 📦 **Entities:** 147

    **Key Entities:**

      - ℂ **AuthService** (Class) `[CRITICAL]`
        - Provides high-level authentication services.
      - ℂ **EncryptionManager** (Class) `[CRITICAL]`
        - Handles encryption and decryption of sensitive data like API...
      - ℂ **EnvironmentNotFoundError** (Class)
        - Raised when environment_id from lookup request is unknown in...
      - ℂ **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.
      - ℂ **ProfileAuthorizationError** (Class)
        - Raised when caller attempts cross-user preference mutation.
      - ℂ **ProfileService** (Class) `[CRITICAL]`
        - Implements profile preference read/update flow and Superset ...
      - ℂ **ProfileValidationError** (Class)
        - Domain validation error for profile preference update reques...
      - ℂ **ResourceService** (Class)
        - Provides centralized access to resource data with enhanced m...

    **Dependencies:**

      - 🔗 DEPENDS_ON -> ValidationRecord
      - 🔗 DEPENDS_ON -> backend.src.core.auth.jwt.create_access_token
      - 🔗 DEPENDS_ON -> backend.src.core.auth.repository
      - 🔗 DEPENDS_ON -> backend.src.core.auth.repository.AuthRepository
      - 🔗 DEPENDS_ON -> backend.src.core.auth.security.verify_password

      ### 📁 `__tests__/`

      - 🏗️ **Layers:** Domain, Domain Tests, Service, Service Tests, Unknown
      - 📊 **Tiers:** STANDARD: 37, TRIVIAL: 40
      - 📄 **Files:** 7
      - 📦 **Entities:** 77

      **Key Entities:**

        - ℂ **TestEncryptionManager** (Class)
          - Validate EncryptionManager encrypt/decrypt roundtrip, unique...
        - ℂ **_DummyLogger** (Class)
          - Minimal logger shim for TaskContext-like objects used in tes...
        - ℂ **_FakeDBSession** (Class)
          - Captures persisted records for assertion and mimics SQLAlche...
        - 📦 **backend.src.services.__tests__.test_llm_plugin_persistence** (Module)
          - Regression test for ValidationRecord persistence fields popu...
        - 📦 **backend.src.services.__tests__.test_llm_prompt_templates** (Module)
          - Validate normalization and rendering behavior for configurab...
        - 📦 **backend.src.services.__tests__.test_rbac_permission_catalog** (Module)
          - Verifies RBAC permission catalog discovery and idempotent sy...
        - 📦 **backend.src.services.__tests__.test_resource_service** (Module)
          - Unit tests for ResourceService
        - 📦 **test_encryption_manager** (Module)
          - Unit tests for EncryptionManager encrypt/decrypt functionali...
        - 📦 **test_health_service** (Module)
          - Unit tests for HealthService aggregation logic.
        - 📦 **test_llm_provider** (Module) `[TRIVIAL]`
          - Auto-generated module for backend/src/services/__tests__/tes...

      **Dependencies:**

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

      ### 📁 `clean_release/`

      - 🏗️ **Layers:** Application, Domain, Infra
      - 📊 **Tiers:** CRITICAL: 9, STANDARD: 48, TRIVIAL: 50
      - 📄 **Files:** 22
      - 📦 **Entities:** 107

      **Key Entities:**

        - ℂ **CleanComplianceOrchestrator** (Class)
          - Coordinate clean-release compliance verification stages.
        - ℂ **CleanPolicyEngine** (Class)
        - ℂ **CleanReleaseRepository** (Class)
          - Data access object for clean release lifecycle.
        - ℂ **ComplianceExecutionResult** (Class)
          - Return envelope for compliance execution with run/report and...
        - ℂ **ComplianceExecutionService** (Class)
          - Execute clean-release compliance lifecycle over trusted snap...
        - 📦 **backend.src.services.clean_release.approval_service** (Module) `[CRITICAL]`
          - Enforce approval/rejection gates over immutable compliance r...
        - 📦 **backend.src.services.clean_release.artifact_catalog_loader** (Module)
          - Load bootstrap artifact catalogs for clean release real-mode...
        - 📦 **backend.src.services.clean_release.audit_service** (Module)
          - Provide lightweight audit hooks for clean release preparatio...
        - 📦 **backend.src.services.clean_release.candidate_service** (Module) `[CRITICAL]`
          - Register release candidates with validated artifacts and adv...
        - 📦 **backend.src.services.clean_release.compliance_execution_service** (Module) `[CRITICAL]`
          - Create and execute compliance runs with trusted snapshots, d...

      **Dependencies:**

        - 🔗 DEPENDS_ON -> backend.src.core.config_manager
        - 🔗 DEPENDS_ON -> backend.src.core.logger
        - 🔗 DEPENDS_ON -> backend.src.models.clean_release
        - 🔗 DEPENDS_ON -> backend.src.models.clean_release.CandidateArtifact
        - 🔗 DEPENDS_ON -> backend.src.models.clean_release.CleanProfilePolicy

        ### 📁 `__tests__/`

        - 🏗️ **Layers:** Domain, Infra, Unknown
        - 📊 **Tiers:** STANDARD: 25, TRIVIAL: 25
        - 📄 **Files:** 8
        - 📦 **Entities:** 50

        **Key Entities:**

          - 📦 **backend.tests.services.clean_release.test_audit_service** (Module)
            - Validate audit hooks emit expected log patterns for clean re...
          - 📦 **backend.tests.services.clean_release.test_compliance_orchestrator** (Module)
            - Validate compliance orchestrator stage transitions and final...
          - 📦 **backend.tests.services.clean_release.test_manifest_builder** (Module)
            - Validate deterministic manifest generation behavior for US1.
          - 📦 **backend.tests.services.clean_release.test_preparation_service** (Module)
            - Validate release candidate preparation flow, including polic...
          - 📦 **backend.tests.services.clean_release.test_report_builder** (Module)
            - Validate compliance report builder counter integrity and blo...
          - 📦 **backend.tests.services.clean_release.test_source_isolation** (Module)
            - Verify internal source registry validation behavior.
          - 📦 **backend.tests.services.clean_release.test_stages** (Module)
            - Validate final status derivation logic from stage results.
          - 📦 **test_policy_engine** (Module) `[TRIVIAL]`
            - Auto-generated module for backend/src/services/clean_release...

        **Dependencies:**

          - 🔗 DEPENDS_ON -> backend.src.services.clean_release.preparation_service:Module

        ### 📁 `repositories/`

        - 🏗️ **Layers:** Infra
        - 📊 **Tiers:** STANDARD: 10, TRIVIAL: 46
        - 📄 **Files:** 10
        - 📦 **Entities:** 56

        **Key Entities:**

          - 📦 **approval_repository** (Module)
            - Persist and query approval decisions.
          - 📦 **artifact_repository** (Module)
            - Persist and query candidate artifacts.
          - 📦 **audit_repository** (Module)
            - Persist and query audit logs for clean release operations.
          - 📦 **candidate_repository** (Module)
            - Persist and query release candidates.
          - 📦 **clean_release_repositories** (Module)
            - Export all clean release repositories.
          - 📦 **compliance_repository** (Module)
            - Persist and query compliance runs, stage runs, and violation...
          - 📦 **manifest_repository** (Module)
            - Persist and query distribution manifests.
          - 📦 **policy_repository** (Module)
            - Persist and query policy and registry snapshots.
          - 📦 **publication_repository** (Module)
            - Persist and query publication records.
          - 📦 **report_repository** (Module)
            - Persist and query compliance reports.

        ### 📁 `stages/`

        - 🏗️ **Layers:** Domain
        - 📊 **Tiers:** STANDARD: 19, TRIVIAL: 5
        - 📄 **Files:** 6
        - 📦 **Entities:** 24

        **Key Entities:**

          - ℂ **ComplianceStage** (Class)
            - Protocol for pluggable stage implementations.
          - ℂ **ComplianceStageContext** (Class)
            - Immutable input envelope passed to each compliance stage.
          - ℂ **DataPurityStage** (Class)
            - Validate manifest summary for prohibited artifacts.
          - ℂ **InternalSourcesOnlyStage** (Class)
            - Enforce internal-source-only policy from trusted registry sn...
          - ℂ **ManifestConsistencyStage** (Class)
            - Validate run/manifest linkage consistency.
          - ℂ **NoExternalEndpointsStage** (Class)
            - Validate endpoint references from manifest against trusted r...
          - ℂ **StageExecutionResult** (Class)
            - Structured stage output containing decision, details and vio...
          - 📦 **backend.src.services.clean_release.stages** (Module)
            - Define compliance stage order and helper functions for deter...
          - 📦 **backend.src.services.clean_release.stages.base** (Module)
            - Define shared contracts and helpers for pluggable clean-rele...
          - 📦 **backend.src.services.clean_release.stages.data_purity** (Module)
            - Evaluate manifest purity counters and emit blocking violatio...

        **Dependencies:**

          - 🔗 DEPENDS_ON -> backend.src.models.clean_release
          - 🔗 DEPENDS_ON -> backend.src.services.clean_release.stages.base
          - 🔗 IMPLEMENTS -> backend.src.services.clean_release.stages.base.ComplianceStage

      ### 📁 `notifications/`

      - 🏗️ **Layers:** Domain, Infra
      - 📊 **Tiers:** CRITICAL: 2, STANDARD: 6, TRIVIAL: 14
      - 📄 **Files:** 3
      - 📦 **Entities:** 22

      **Key Entities:**

        - ℂ **NotificationProvider** (Class)
          - Abstract base class for all notification providers.
        - ℂ **NotificationService** (Class)
          - Routes validation reports to appropriate users and channels.
        - ℂ **SMTPProvider** (Class)
          - Delivers notifications via SMTP.
        - ℂ **SlackProvider** (Class)
          - Delivers notifications via Slack Webhooks or API.
        - ℂ **TelegramProvider** (Class)
          - Delivers notifications via Telegram Bot API.
        - 📦 **backend.src.services.notifications.providers** (Module) `[CRITICAL]`
          - Defines abstract base and concrete implementations for exter...
        - 📦 **backend.src.services.notifications.service** (Module) `[CRITICAL]`
          - Orchestrates notification routing based on user preferences ...

      **Dependencies:**

        - 🔗 DEPENDS_ON -> backend.src.models.llm
        - 🔗 DEPENDS_ON -> backend.src.services.notifications.providers
        - 🔗 DEPENDS_ON -> backend.src.services.profile_service

        ### 📁 `__tests__/`

        - 📊 **Tiers:** STANDARD: 1, TRIVIAL: 9
        - 📄 **Files:** 1
        - 📦 **Entities:** 10

        **Key Entities:**

          - 📦 **backend.src.services.notifications.__tests__.test_notification_service** (Module)
            - Unit tests for NotificationService routing and dispatch logi...

      ### 📁 `reports/`

      - 🏗️ **Layers:** Domain
      - 📊 **Tiers:** CRITICAL: 5, STANDARD: 16
      - 📄 **Files:** 4
      - 📦 **Entities:** 21

      **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), Unknown
        - 📊 **Tiers:** STANDARD: 2, TRIVIAL: 25
        - 📄 **Files:** 3
        - 📦 **Entities:** 27

        **Key Entities:**

          - 📦 **backend.tests.test_report_normalizer** (Module)
            - Validate unknown task type fallback and partial payload norm...
          - 📦 **test_report_service** (Module)
            - Unit tests for ReportsService list/detail operations
          - 📦 **test_type_profiles** (Module) `[TRIVIAL]`
            - Auto-generated module for backend/src/services/reports/__tes...

  ### 📁 `tests/`

  - 🏗️ **Layers:** Core, Domain (Tests), Logging (Tests), Test, Unknown
  - 📊 **Tiers:** STANDARD: 87, TRIVIAL: 91
  - 📄 **Files:** 10
  - 📦 **Entities:** 178

  **Key Entities:**

    - ℂ **TestLogPersistence** (Class)
      - Test suite for TaskLogPersistenceService.
    - ℂ **TestTaskContext** (Class)
      - Test suite for TaskContext.
    - ℂ **TestTaskLogger** (Class)
      - Test suite for TaskLogger.
    - ℂ **TestTaskPersistenceHelpers** (Class)
      - Test suite for TaskPersistenceService static helper methods.
    - ℂ **TestTaskPersistenceService** (Class)
      - Test suite for TaskPersistenceService CRUD operations.
    - 📦 **backend.tests.test_dashboards_api** (Module)
      - Comprehensive contract-driven tests for Dashboard Hub API
    - 📦 **test_auth** (Module) `[TRIVIAL]`
      - Auto-generated module for backend/tests/test_auth.py
    - 📦 **test_log_persistence** (Module)
      - 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: 6, TRIVIAL: 46
    - 📄 **Files:** 4
    - 📦 **Entities:** 52

    **Key Entities:**

      - 📦 **backend.tests.core.test_git_service_gitea_pr** (Module)
        - Validate Gitea PR creation fallback behavior when configured...
      - 📦 **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_...

      ### 📁 `migration/`

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

      **Key Entities:**

        - 📦 **backend.tests.core.migration.test_archive_parser** (Module)
          - Unit tests for MigrationArchiveParser ZIP extraction contrac...
        - 📦 **backend.tests.core.migration.test_dry_run_orchestrator** (Module)
          - Unit tests for MigrationDryRunService diff and risk computat...

    ### 📁 `scripts/`

    - 🏗️ **Layers:** Domain, Scripts
    - 📊 **Tiers:** STANDARD: 3, TRIVIAL: 18
    - 📄 **Files:** 3
    - 📦 **Entities:** 21

    **Key Entities:**

      - 📦 **backend.tests.scripts.test_clean_release_tui** (Module)
        - Unit tests for the interactive curses TUI of the clean relea...
      - 📦 **test_clean_release_cli** (Module)
        - Smoke tests for the redesigned clean release CLI.
      - 📦 **test_clean_release_tui_v2** (Module)
        - Smoke tests for thin-client TUI action dispatch and blocked ...

      ### 📁 `clean_release/`

      - 🏗️ **Layers:** Tests
      - 📊 **Tiers:** STANDARD: 40, TRIVIAL: 16
      - 📄 **Files:** 8
      - 📦 **Entities:** 56

      **Key Entities:**

        - ℂ **CleanReleaseCompliancePlugin** (Class)
          - TaskManager plugin shim that executes clean release complian...
        - ℂ **_PluginLoaderStub** (Class)
          - Provide minimal plugin loader contract used by TaskManager i...
        - 📦 **backend.tests.services.clean_release.test_approval_service** (Module)
          - Define approval gate contracts for approve/reject operations...
        - 📦 **backend.tests.services.clean_release.test_compliance_execution_service** (Module)
          - Validate stage pipeline and run finalization contracts for c...
        - 📦 **backend.tests.services.clean_release.test_compliance_task_integration** (Module)
          - Verify clean release compliance runs execute through TaskMan...
        - 📦 **backend.tests.services.clean_release.test_demo_mode_isolation** (Module)
          - Verify demo and real mode namespace isolation contracts befo...
        - 📦 **backend.tests.services.clean_release.test_policy_resolution_service** (Module)
          - Verify trusted policy snapshot resolution contract and error...
        - 📦 **backend.tests.services.clean_release.test_publication_service** (Module)
          - Define publication gate contracts over approved candidates a...
        - 📦 **backend.tests.services.clean_release.test_report_audit_immutability** (Module)
          - Validate report snapshot immutability expectations and appen...
        - 📦 **test_candidate_manifest_services** (Module)
          - Test lifecycle and manifest versioning for release candidate...

      **Dependencies:**

        - 🔗 DEPENDS_ON -> backend.src.services.clean_release.demo_data_service
        - 🔗 DEPENDS_ON -> backend.src.services.clean_release.exceptions
        - 🔗 DEPENDS_ON -> backend.src.services.clean_release.policy_resolution_service
        - 🔗 DEPENDS_ON -> backend.src.services.clean_release.repository

    ### 📁 `components/`

    - 🏗️ **Layers:** Component, Feature, UI, UI -->, Unknown
    - 📊 **Tiers:** STANDARD: 74, TRIVIAL: 13
    - 📄 **Files:** 15
    - 📦 **Entities:** 87

    **Key Entities:**

      - 🧩 **DashboardGrid** (Component)
        - Displays a grid of dashboards with selection and pagination.
      - 🧩 **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 ...
      - 🧩 **StartupEnvironmentWizard** (Component)
        - Blocking startup wizard for creating the first Superset envi...

      ### 📁 `__tests__/`

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

      **Key Entities:**

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

      ### 📁 `auth/`

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

      **Key Entities:**

        - 🧩 **ProtectedRoute** (Component) `[CRITICAL]`
          - Wraps protected slot content with session and permission ver...
        - 📦 **ProtectedRoute.svelte** (Module)
          - Enforces authenticated and authorized access before protecte...

      ### 📁 `git/`

      - 🏗️ **Layers:** Component, Unknown
      - 📊 **Tiers:** STANDARD: 47, TRIVIAL: 12
      - 📄 **Files:** 6
      - 📦 **Entities:** 59

      **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)
          - Центральный UI управления Git с фокусом на рабочий поток ана...
        - 📦 **GitManager** (Module) `[TRIVIAL]`
          - Auto-generated module for frontend/src/components/git/GitMan...

        ### 📁 `__tests__/`

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

        **Key Entities:**

          - 📦 **frontend.src.components.git.__tests__.git_manager_unfinished_merge_integration** (Module)
            - Protect unresolved-merge dialog contract in GitManager pull ...

      ### 📁 `llm/`

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

      **Key Entities:**

        - 🧩 **DocPreview** (Component)
          - UI component for previewing generated dataset documentation ...
        - 🧩 **ProviderConfig** (Component) `[CRITICAL]`
          - 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 and delete interaction contracts in LLM provide...

      ### 📁 `storage/`

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

      **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: 24, TRIVIAL: 5
    - 📄 **Files:** 5
    - 📦 **Entities:** 29

    **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: 11
      - 📄 **Files:** 2
      - 📦 **Entities:** 12

      **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:** STANDARD: 4
        - 📄 **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)
            - Unit tests for reports API client functions: query string bu...

      ### 📁 `auth/`

      - 🏗️ **Layers:** Domain, Feature
      - 📊 **Tiers:** CRITICAL: 11, TRIVIAL: 1
      - 📄 **Files:** 2
      - 📦 **Entities:** 12

      **Key Entities:**

        - 📦 **frontend.src.lib.auth.permissions** (Module) `[CRITICAL]`
          - Shared frontend RBAC utilities for route guards and menu vis...
        - 🗄️ **authStore** (Store) `[CRITICAL]`
          - Manages the global authentication state on the frontend.

        ### 📁 `__tests__/`

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

        **Key Entities:**

          - 📦 **frontend.src.lib.auth.__tests__.permissions** (Module)
            - Verifies frontend RBAC permission parsing and access checks.

        ### 📁 `assistant/`

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

        **Key Entities:**

          - 🧩 **AssistantChatPanel** (Component)
            - 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: 3
          - 📄 **Files:** 1
          - 📦 **Entities:** 3

          **Key Entities:**

            - 📦 **frontend.src.lib.components.assistant.__tests__.assistant_chat_integration** (Module)
              - Contract-level integration checks for assistant chat panel i...

        ### 📁 `health/`

        - 🏗️ **Layers:** UI/Component, Unknown
        - 📊 **Tiers:** STANDARD: 2, TRIVIAL: 6
        - 📄 **Files:** 2
        - 📦 **Entities:** 8

        **Key Entities:**

          - 🧩 **HealthMatrix** (Component)
            - Visual grid/matrix representing the health status of dashboa...
          - 🧩 **PolicyForm** (Component)
            - Form for creating and editing validation policies.
          - 📦 **PolicyForm** (Module) `[TRIVIAL]`
            - Auto-generated module for frontend/src/lib/components/health...

        ### 📁 `layout/`

        - 🏗️ **Layers:** UI, Unknown
        - 📊 **Tiers:** STANDARD: 11, TRIVIAL: 50
        - 📄 **Files:** 5
        - 📦 **Entities:** 61

        **Key Entities:**

          - 🧩 **Breadcrumbs** (Component)
            - Display page hierarchy navigation
          - 🧩 **Sidebar** (Component)
            - Persistent left sidebar with resource categories navigation
          - 🧩 **TaskDrawer** (Component)
            - Global task drawer for monitoring background operations
          - 🧩 **TopNavbar** (Component)
            - 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...
          - 📦 **frontend.src.lib.components.layout.sidebarNavigation** (Module)
            - Build sidebar navigation categories filtered by current user...

        **Dependencies:**

          - 🔗 DEPENDS_ON -> frontend.src.lib.auth.permissions.hasPermission

          ### 📁 `__tests__/`

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

          **Key Entities:**

            - 📦 **frontend.src.lib.components.layout.__tests__.sidebarNavigation** (Module)
              - Verifies RBAC-based sidebar category and subitem visibility.
            - 📦 **test_breadcrumbs.svelte** (Module) `[TRIVIAL]`
              - Auto-generated module for frontend/src/lib/components/layout...

        ### 📁 `reports/`

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

        **Key Entities:**

          - 🧩 **ReportCard** (Component)
            - Render one report with explicit textual type label and profi...
          - 🧩 **ReportDetailPanel** (Component)
            - Display detailed report context with diagnostics and actiona...
          - 🧩 **ReportsList** (Component)
            - 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:** STANDARD: 7, TRIVIAL: 4
          - 📄 **Files:** 7
          - 📦 **Entities:** 11

          **Key Entities:**

            - 📦 **frontend.src.lib.components.reports.__tests__.report_card.ux** (Module)
              - Test UX states and transitions for ReportCard component
            - 📦 **frontend.src.lib.components.reports.__tests__.report_detail.integration** (Module)
              - Validate detail-panel behavior for failed reports and recove...
            - 📦 **frontend.src.lib.components.reports.__tests__.report_detail.ux** (Module)
              - Test UX states and recovery for ReportDetailPanel component
            - 📦 **frontend.src.lib.components.reports.__tests__.report_type_profiles** (Module)
              - 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_list.ux** (Module)
              - Test ReportsList component iteration and event forwarding.
            - 📦 **frontend.src.lib.components.reports.__tests__.reports_page.integration** (Module)
              - 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, UI-State, Unknown
      - 📊 **Tiers:** CRITICAL: 1, STANDARD: 9, TRIVIAL: 28
      - 📄 **Files:** 6
      - 📦 **Entities:** 38

      **Key Entities:**

        - 📦 **environmentContext** (Module) `[TRIVIAL]`
          - Auto-generated module for frontend/src/lib/stores/environmen...
        - 📦 **health** (Module) `[TRIVIAL]`
          - Auto-generated module for frontend/src/lib/stores/health.js
        - 📦 **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...
        - 🗄️ **environmentContext** (Store)
          - Global selected environment context for navigation and safet...
        - 🗄️ **health_store** (Store)
          - Manage dashboard health summary state and failing counts for...
        - 🗄️ **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
        - 🔗 DEPENDS_ON -> api.getHealthSummary

        ### 📁 `__tests__/`

        - 🏗️ **Layers:** Domain (Tests), UI, UI Tests
        - 📊 **Tiers:** STANDARD: 11
        - 📄 **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)
            - 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, Unknown
    - 📊 **Tiers:** CRITICAL: 1, STANDARD: 3, TRIVIAL: 5
    - 📄 **Files:** 5
    - 📦 **Entities:** 9

    **Key Entities:**

      - 📦 **+page** (Module) `[TRIVIAL]`
        - Auto-generated module for frontend/src/routes/+page.svelte
      - 📦 **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:** STANDARD: 26, TRIVIAL: 66
      - 📄 **Files:** 1
      - 📦 **Entities:** 92

      **Key Entities:**

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

        ### 📁 `[id]/`

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

        **Key Entities:**

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

        ### 📁 `__tests__/`

        - 🏗️ **Layers:** UI (Tests)
        - 📊 **Tiers:** STANDARD: 1, TRIVIAL: 2
        - 📄 **Files:** 1
        - 📦 **Entities:** 3

        **Key Entities:**

          - 📦 **frontend.src.routes.dashboards.__tests__.dashboard_profile_override_integration** (Module)
            - Verifies temporary show-all override and restore-on-return b...

        ### 📁 `health/`

        - 🏗️ **Layers:** UI/Page, Unknown
        - 📊 **Tiers:** STANDARD: 1, TRIVIAL: 3
        - 📄 **Files:** 1
        - 📦 **Entities:** 4

        **Key Entities:**

          - 🧩 **HealthCenterPage** (Component)
            - Main page for the Dashboard Health Center.
          - 📦 **+page** (Module) `[TRIVIAL]`
            - Auto-generated module for frontend/src/routes/dashboards/hea...

      ### 📁 `datasets/`

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

      **Key Entities:**

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

        ### 📁 `[id]/`

        - 🏗️ **Layers:** UI, Unknown
        - 📊 **Tiers:** STANDARD: 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/`

      - 📊 **Tiers:** CRITICAL: 21
      - 📄 **Files:** 1
      - 📦 **Entities:** 21

      **Key Entities:**

        - 🧩 **DashboardSelectionSection** (Component) `[CRITICAL]`
        - 🧩 **MigrationDashboard** (Component) `[CRITICAL]`
          - Orchestrate migration UI workflow and route user actions to ...

        ### 📁 `mappings/`

        - 📊 **Tiers:** CRITICAL: 8
        - 📄 **Files:** 1
        - 📦 **Entities:** 8

        **Key Entities:**

          - 🗄️ **UiState** (Store) `[CRITICAL]`
            - Maintain local page state for environments, fetched database...

      ### 📁 `profile/`

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

      **Key Entities:**

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

        ### 📁 `__tests__/`

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

        **Key Entities:**

          - 📦 **frontend.src.routes.profile.__tests__.profile_preferences_integration** (Module)
            - Verifies profile binding happy path and degraded lookup manu...
          - 📦 **frontend.src.routes.profile.__tests__.profile_settings_state_integration** (Module)
            - Verifies profile settings preload, cancel without persistenc...

          ### 📁 `fixtures/`

          - 📊 **Tiers:** TRIVIAL: 1
          - 📄 **Files:** 1
          - 📦 **Entities:** 1

          **Key Entities:**

            - 📦 **frontend.src.routes.profile.__tests__.fixtures.profile_fixtures** (Module) `[TRIVIAL]`
              - Shared fixture placeholders for profile page integration tes...

      ### 📁 `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....

          ### 📁 `[taskId]/`

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

          **Key Entities:**

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

      ### 📁 `settings/`

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

      **Key Entities:**

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

        ### 📁 `automation/`

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

        **Key Entities:**

          - 🧩 **AutomationSettingsPage** (Component)
            - Settings page for managing validation policies.
          - 📦 **+page** (Module) `[TRIVIAL]`
            - Auto-generated module for frontend/src/routes/settings/autom...

        ### 📁 `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: 10
        - 📄 **Files:** 1
        - 📦 **Entities:** 10

        **Key Entities:**

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

          ### 📁 `__tests__/`

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

          **Key Entities:**

            - 📦 **frontend.src.routes.settings.git.__tests__.git_settings_page_ux_test** (Module)
              - Test UX states and transitions for the Git Settings page

        ### 📁 `notifications/`

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

        **Key Entities:**

          - 🧩 **NotificationSettingsPage** (Component)
            - Manage global notification provider configurations (SMTP, Te...
          - 📦 **+page** (Module) `[TRIVIAL]`
            - Auto-generated module for frontend/src/routes/settings/notif...

      ### 📁 `storage/`

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

        ### 📁 `repos/`

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

        ### 📁 `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: 7
        - 📄 **Files:** 1
        - 📦 **Entities:** 7

        **Key Entities:**

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

    ### 📁 `services/`

    - 🏗️ **Layers:** Service
    - 📊 **Tiers:** STANDARD: 35, TRIVIAL: 1
    - 📄 **Files:** 6
    - 📦 **Entities:** 36

    **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

      ### 📁 `__tests__/`

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

      **Key Entities:**

        - 📦 **frontend.src.services.__tests__.gitService_test** (Module)
          - API client tests ensuring correct endpoints are called per c...

    ### 📁 `types/`

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

    **Key Entities:**

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

### 📁 `root/`

- 🏗️ **Layers:** DevOps/Tooling
- 📊 **Tiers:** CRITICAL: 11, STANDARD: 18, TRIVIAL: 8
- 📄 **Files:** 1
- 📦 **Entities:** 37

**Key Entities:**

  - ℂ **ComplianceIssue** (Class) `[TRIVIAL]`
    - Represents a single compliance issue with severity.
  - ℂ **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...
  - 📦 **generate_semantic_map** (Module)
    - Scans the codebase to generate a Semantic Map, Module Map, a...

## 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-->|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-->|CALLS|root
    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
    __tests__-->|TESTS|backend
    __tests__-->|TESTS|backend
    __tests__-->|TESTS|backend
    __tests__-->|TESTS|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-->|DEPENDS_ON|backend
    core-->|DEPENDS_ON|backend
    core-->|USES|backend
    core-->|USES|backend
    core-->|DEPENDS_ON|backend
    core-->|DEPENDS_ON|backend
    core-->|DEPENDS_ON|backend
    core-->|DEPENDS_ON|backend
    core-->|DEPENDS_ON|backend
    core-->|DEPENDS_ON|backend
    __tests__-->|TESTS|backend
    auth-->|USES|backend
    auth-->|USES|backend
    auth-->|USES|backend
    auth-->|DEPENDS_ON|backend
    auth-->|DEPENDS_ON|backend
    auth-->|DEPENDS_ON|backend
    migration-->|DEPENDS_ON|backend
    migration-->|DEPENDS_ON|backend
    migration-->|DEPENDS_ON|backend
    migration-->|DEPENDS_ON|backend
    migration-->|DEPENDS_ON|backend
    migration-->|DEPENDS_ON|backend
    migration-->|DISPATCHES|backend
    utils-->|DEPENDS_ON|backend
    utils-->|DEPENDS_ON|backend
    utils-->|DEPENDS_ON|backend
    utils-->|DEPENDS_ON|backend
    models-->|DEPENDS_ON|backend
    models-->|INHERITS_FROM|backend
    models-->|DEPENDS_ON|backend
    models-->|DEPENDS_ON|backend
    models-->|USED_BY|backend
    models-->|INHERITS_FROM|backend
    models-->|DEPENDS_ON|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-->|DEPENDS_ON|backend
    scripts-->|DEPENDS_ON|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-->|DEPENDS_ON|backend
    services-->|DEPENDS_ON|backend
    services-->|DEPENDS_ON|backend
    services-->|DEPENDS_ON|backend
    services-->|DEPENDS_ON|backend
    services-->|CALLS|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-->|DEPENDS_ON|backend
    services-->|DEPENDS_ON|backend
    __tests__-->|TESTS|backend
    __tests__-->|DEPENDS_ON|backend
    __tests__-->|TESTS|backend
    __tests__-->|TESTS|backend
    clean_release-->|DEPENDS_ON|backend
    clean_release-->|DEPENDS_ON|backend
    clean_release-->|DEPENDS_ON|backend
    clean_release-->|DEPENDS_ON|backend
    clean_release-->|DEPENDS_ON|backend
    clean_release-->|DEPENDS_ON|backend
    clean_release-->|DEPENDS_ON|backend
    clean_release-->|DEPENDS_ON|backend
    clean_release-->|DEPENDS_ON|backend
    clean_release-->|DEPENDS_ON|backend
    clean_release-->|DEPENDS_ON|backend
    clean_release-->|DEPENDS_ON|backend
    clean_release-->|DEPENDS_ON|backend
    clean_release-->|DEPENDS_ON|backend
    clean_release-->|DEPENDS_ON|backend
    clean_release-->|DEPENDS_ON|backend
    clean_release-->|DEPENDS_ON|backend
    clean_release-->|DEPENDS_ON|backend
    clean_release-->|DEPENDS_ON|backend
    clean_release-->|DEPENDS_ON|backend
    clean_release-->|DEPENDS_ON|backend
    clean_release-->|DEPENDS_ON|backend
    clean_release-->|DEPENDS_ON|backend
    clean_release-->|DEPENDS_ON|backend
    clean_release-->|DEPENDS_ON|backend
    clean_release-->|DEPENDS_ON|backend
    clean_release-->|DEPENDS_ON|backend
    clean_release-->|DEPENDS_ON|backend
    clean_release-->|DEPENDS_ON|backend
    clean_release-->|DEPENDS_ON|backend
    clean_release-->|DEPENDS_ON|backend
    clean_release-->|DEPENDS_ON|backend
    clean_release-->|DEPENDS_ON|backend
    clean_release-->|DEPENDS_ON|backend
    clean_release-->|DEPENDS_ON|backend
    __tests__-->|TESTS|backend
    __tests__-->|TESTS|backend
    __tests__-->|TESTS|backend
    __tests__-->|VERIFIES|backend
    __tests__-->|TESTS|backend
    __tests__-->|TESTS|backend
    __tests__-->|DEPENDS_ON|backend
    stages-->|IMPLEMENTS|backend
    stages-->|DEPENDS_ON|backend
    stages-->|IMPLEMENTS|backend
    stages-->|DEPENDS_ON|backend
    stages-->|IMPLEMENTS|backend
    stages-->|DEPENDS_ON|backend
    stages-->|CALLED_BY|backend
    stages-->|DEPENDS_ON|backend
    stages-->|IMPLEMENTS|backend
    stages-->|DEPENDS_ON|backend
    stages-->|DEPENDS_ON|backend
    notifications-->|DEPENDS_ON|backend
    notifications-->|DEPENDS_ON|backend
    notifications-->|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
    reports-->|DEPENDS_ON|backend
    __tests__-->|TESTS|backend
    __tests__-->|TESTS|backend
    tests-->|TESTS|backend
    core-->|TESTS|backend
    core-->|VERIFIES|backend
    core-->|VERIFIES|backend
    migration-->|VERIFIES|backend
    migration-->|VERIFIES|backend
    scripts-->|TESTS|backend
    scripts-->|TESTS|backend
    clean_release-->|TESTS|backend
    clean_release-->|TESTS|backend
    clean_release-->|DEPENDS_ON|backend
    clean_release-->|DEPENDS_ON|backend
    clean_release-->|DEPENDS_ON|backend
    clean_release-->|DEPENDS_ON|backend
    clean_release-->|TESTS|backend
    clean_release-->|TESTS|backend
    __tests__-->|VERIFIES|components
    __tests__-->|VERIFIES|components
    __tests__-->|VERIFIES|components
    __tests__-->|TESTS|lib
    __tests__-->|VERIFIES|lib
    __tests__-->|TESTS|lib
    reports-->|DEPENDS_ON|lib
    __tests__-->|TESTS|routes
    __tests__-->|TESTS|routes
    __tests__-->|TESTS|lib
    __tests__-->|TESTS|lib
    __tests__-->|TESTS|lib
    __tests__-->|TESTS|routes
    __tests__-->|TESTS|routes
    __tests__-->|TESTS|routes
    __tests__-->|TESTS|routes
```
