ss-tools/.ai/MODULE_MAP.md

Module Map

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

Generated: 2026-03-01T12:09:39.463912

Summary

• Total Modules: 80
• Total Entities: 2080

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: 3, STANDARD: 205, TRIVIAL: 7
  - 📄 **Files:** 17
  - 📦 **Entities:** 215

  **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:** STANDARD: 61, TRIVIAL: 121
    - 📄 **Files:** 9
    - 📦 **Entities:** 182

    **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: 131, TRIVIAL: 8
- 📄 **Files:** 10
- 📦 **Entities:** 141

**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: 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
  - 📊 **Tiers:** STANDARD: 20, TRIVIAL: 1
  - 📄 **Files:** 4
  - 📦 **Entities:** 21

  **Key Entities:**

    - ℂ **MigrationArchiveParser** (Class)
      - Extract normalized dashboards/charts/datasets metadata from ...
    - ℂ **MigrationDryRunService** (Class)
      - 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)
      - Parse Superset export ZIP archives into normalized object ca...
    - 📦 **backend.src.core.migration.dry_run_orchestrator** (Module)
      - Compute pre-flight migration diff and risk scoring without a...
    - 📦 **backend.src.core.migration.risk_assessor** (Module)
      - Risk evaluation helpers for migration pre-flight reporting.

  **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: 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:** STANDARD: 2, TRIVIAL: 27
  - 📄 **Files:** 2
  - 📦 **Entities:** 29

  **Key Entities:**

    - 📦 **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:** 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: 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
- 📊 **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: 62, TRIVIAL: 6
- 📄 **Files:** 7
- 📦 **Entities:** 69

**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:** STANDARD: 24, TRIVIAL: 7
  - 📄 **Files:** 3
  - 📦 **Entities:** 31

  **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)
      - 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:** STANDARD: 2, TRIVIAL: 19
    - 📄 **Files:** 2
    - 📦 **Entities:** 21

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

📁 tests/

• 🏗️ Layers: Core, Domain (Tests), Test, Unknown
• 📊 Tiers: CRITICAL: 6, STANDARD: 79, TRIVIAL: 85
• 📄 Files: 10
• 📦 Entities: 170

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)
  - 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) `[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_...

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

### 📁 `components/`

- 🏗️ **Layers:** Component, Feature, UI, UI -->, Unknown
- 📊 **Tiers:** CRITICAL: 1, STANDARD: 68, TRIVIAL: 4
- 📄 **Files:** 14
- 📦 **Entities:** 73

**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 ...
  - 🧩 **TaskHistory** (Component)
    - Displays a list of recent tasks with their status and allows...

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

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

**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:** 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: 13, TRIVIAL: 5
    - 📄 **Files:** 1
    - 📦 **Entities:** 19

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

    ### 📁 `layout/`

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

    **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:** STANDARD: 6, TRIVIAL: 4
      - 📄 **Files:** 6
      - 📦 **Entities:** 10

      **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_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: 8, TRIVIAL: 21
  - 📄 **Files:** 5
  - 📦 **Entities:** 30

  **Key Entities:**

    - 📦 **environmentContext** (Module) `[TRIVIAL]`
      - Auto-generated module for frontend/src/lib/stores/environmen...
    - 📦 **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...
    - 🗄️ **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:** 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
- 📊 **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, STANDARD: 23, TRIVIAL: 60
  - 📄 **Files:** 1
  - 📦 **Entities:** 84

  **Key Entities:**

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

    ### 📁 `[id]/`

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

    **Key Entities:**

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

  ### 📁 `datasets/`

  - 🏗️ **Layers:** UI, Unknown
  - 📊 **Tiers:** CRITICAL: 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:** 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: 11
  - 📄 **Files:** 1
  - 📦 **Entities:** 11

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

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

    **Key Entities:**

      - 🧩 **StoragePage** (Component)
        - Main page for unified 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: 12
• 📄 Files: 4
• 📦 Entities: 50

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 ...
• 📦 check_test_data (Module) [TRIVIAL]
  • Auto-generated module for check_test_data.py
• 📦 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

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-->|CALLS|root
    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
    migration-->|DEPENDS_ON|backend
    migration-->|DEPENDS_ON|backend
    migration-->|DEPENDS_ON|backend
    migration-->|DEPENDS_ON|backend
    migration-->|DEPENDS_ON|backend
    migration-->|USED_BY|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
    core-->|VERIFIES|backend
    core-->|VERIFIES|backend
    migration-->|VERIFIES|backend
    migration-->|VERIFIES|backend
    __tests__-->|VERIFIES|components
    __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