Files
ss-tools/.ai/MODULE_MAP.md
busya 274510fc38 refactor(semantics): migrate legacy @TIER to @COMPLEXITY annotations
- Replaced @TIER: TRIVIAL with @COMPLEXITY: 1
- Replaced @TIER: STANDARD with @COMPLEXITY: 3
- Replaced @TIER: CRITICAL with @COMPLEXITY: 5
- Manually elevated specific critical/complex components to levels 2 and 4
- Ignored legacy, specs, and node_modules directories
- Updated generated semantic map
2026-03-16 10:06:44 +03:00

90 KiB
Raw Permalink Blame History

Module Map

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

Generated: 2026-03-16T10:03:28.287790

Summary

  • Total Modules: 105
  • Total Entities: 3313

Module Hierarchy

📁 backend/

  • 🏗️ Layers: Utility
  • 📊 Tiers: TRIVIAL: 2
  • 📄 Files: 1
  • 📦 Entities: 2

Key Entities:

  • 📦 backend.delete_running_tasks (Module) [TRIVIAL]
    • Script to delete tasks with RUNNING status from the database...

📁 src/

  • 🏗️ Layers: API, Core, UI (API)
  • 📊 Tiers: CRITICAL: 2, STANDARD: 6, TRIVIAL: 18
  • 📄 Files: 3
  • 📦 Entities: 26

Key Entities:

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

Dependencies:

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

### 📁 `api/`

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

**Key Entities:**

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

  ### 📁 `routes/`

  - 🏗️ **Layers:** API, Infra, UI (API), UI/API
  - 📊 **Tiers:** CRITICAL: 7, STANDARD: 184, TRIVIAL: 111
  - 📄 **Files:** 21
  - 📦 **Entities:** 302

  **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) `[TRIVIAL]`
      - Schema for branch checkout requests.
    -  **BranchCreate** (Class) `[TRIVIAL]`
      - Schema for branch creation requests.
    -  **BranchSchema** (Class) `[TRIVIAL]`
      - Schema for representing a Git branch metadata.
    -  **BuildManifestRequest** (Class) `[TRIVIAL]`
      - Request schema for manifest build endpoint.
    -  **CommitCreate** (Class) `[TRIVIAL]`
      - Schema for staging and committing changes.
    -  **CommitSchema** (Class) `[TRIVIAL]`
      - Schema for representing Git commit details.
    -  **ConfirmationRecord** (Class)
      - In-memory confirmation token model for risky operation dispa...

  **Dependencies:**

    - 🔗 DEPENDS_ON -> backend.src.core.config_manager.ConfigManager
    - 🔗 DEPENDS_ON -> backend.src.core.config_models
    - 🔗 DEPENDS_ON -> backend.src.core.database
    - 🔗 DEPENDS_ON -> backend.src.core.database.get_db
    - 🔗 DEPENDS_ON -> backend.src.core.mapping_service.IdMappingService

    ### 📁 `__tests__/`

    - 🏗️ **Layers:** API, Domain, Domain (Tests), Tests, UI (API Tests), Unknown
    - 📊 **Tiers:** STANDARD: 16, TRIVIAL: 275
    - 📄 **Files:** 18
    - 📦 **Entities:** 291

    **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, Infra
- 📊 **Tiers:** CRITICAL: 9, STANDARD: 66, TRIVIAL: 134
- 📄 **Files:** 14
- 📦 **Entities:** 209

**Key Entities:**

  -  **AuthSessionLocal** (Class) `[TRIVIAL]`
    - A session factory for the authentication database.
  -  **BeliefFormatter** (Class) `[TRIVIAL]`
    - 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) `[TRIVIAL]`
    - A Pydantic model representing a single, structured log entry...
  -  **MigrationEngine** (Class) `[CRITICAL]`
    - Engine for transforming Superset export ZIPs.
  -  **PluginBase** (Class) `[TRIVIAL]`
    - Defines the abstract base class that all plugins must implem...
  -  **PluginConfig** (Class) `[TRIVIAL]`
    - 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 -> backend.src.core.auth.config
  - 🔗 DEPENDS_ON -> backend.src.core.config_models.AppConfig
  - 🔗 DEPENDS_ON -> backend.src.core.config_models.Environment
  - 🔗 DEPENDS_ON -> backend.src.core.database.SessionLocal
  - 🔗 DEPENDS_ON -> backend.src.core.logger

  ### 📁 `__tests__/`

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

  **Key Entities:**

    -  **_RecordingNetworkClient** (Class) `[TRIVIAL]`
      - 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: 17, STANDARD: 2, TRIVIAL: 10
  - 📄 **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)
      - JWT token generation and validation logic.
    - 📦 **backend.src.core.auth.logger** (Module)
      - 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: 1, TRIVIAL: 11
    - 📄 **Files:** 1
    - 📦 **Entities:** 12

    **Key Entities:**

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

  ### 📁 `migration/`

  - 🏗️ **Layers:** Core, Domain
  - 📊 **Tiers:** CRITICAL: 3, STANDARD: 2, TRIVIAL: 16
  - 📄 **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)
      - 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) `[CRITICAL]`
      - Compute deterministic migration risk items and aggregate sco...

  **Dependencies:**

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

  ### 📁 `task_manager/`

  - 🏗️ **Layers:** Core
  - 📊 **Tiers:** CRITICAL: 11, STANDARD: 42, TRIVIAL: 27
  - 📄 **Files:** 7
  - 📦 **Entities:** 80

  **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 store, query, summarize, and delete task...
    -  **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 -> Environment
    - 🔗 DEPENDS_ON -> TaskLogRecord
    - 🔗 DEPENDS_ON -> TaskLogger, USED_BY -> plugins
    - 🔗 DEPENDS_ON -> TaskManager, CALLS -> TaskManager._add_log
    - 🔗 DEPENDS_ON -> TaskManagerModels

    ### 📁 `__tests__/`

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

    **Key Entities:**

      - 📦 **backend.src.core.task_manager.__tests__.test_context** (Module)
        - Verify TaskContext preserves optional background task schedu...
      - 📦 **test_task_logger** (Module) `[TRIVIAL]`
        - Auto-generated module for backend/src/core/task_manager/__te...

  ### 📁 `utils/`

  - 🏗️ **Layers:** Core, Domain, Infra
  - 📊 **Tiers:** CRITICAL: 1, STANDARD: 10, TRIVIAL: 61
  - 📄 **Files:** 6
  - 📦 **Entities:** 72

  **Key Entities:**

    -  **APIClient** (Class)
      - Synchronous Superset API client with process-local auth toke...
    -  **AuthenticationError** (Class) `[TRIVIAL]`
      - Exception raised when authentication fails.
    -  **DashboardNotFoundError** (Class) `[TRIVIAL]`
      - Exception raised when a dashboard cannot be found.
    -  **DatasetMapper** (Class) `[TRIVIAL]`
      - Класс для меппинга и обновления verbose_map в датасетах Supe...
    -  **InvalidZipFormatError** (Class) `[TRIVIAL]`
      - Exception raised when a file is not a valid ZIP archive.
    -  **NetworkError** (Class) `[TRIVIAL]`
      - Exception raised when a network level error occurs.
    -  **PermissionDeniedError** (Class) `[TRIVIAL]`
      - Exception raised when access is denied.
    -  **SupersetAPIError** (Class) `[TRIVIAL]`
      - Base exception for all Superset API related errors.
    -  **backend.src.core.utils.async_network.AsyncAPIClient** (Class)
      - Async Superset API client backed by httpx.AsyncClient with s...
    -  **network.SupersetAuthCache** (Class) `[TRIVIAL]`
      - 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 -> logger
    - 🔗 DEPENDS_ON -> network.SupersetAuthCache

### 📁 `models/`

- 🏗️ **Layers:** Domain, Model
- 📊 **Tiers:** CRITICAL: 17, STANDARD: 13, TRIVIAL: 61
- 📄 **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) `[TRIVIAL]`
    - 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) `[TRIVIAL]`
    - Represents one artifact associated with a release candidate.
  -  **CheckFinalStatus** (Class) `[TRIVIAL]`
    - Backward-compatible final status enum for legacy TUI/orchest...
  -  **CheckStageName** (Class) `[TRIVIAL]`
    - Backward-compatible stage name enum for legacy TUI/orchestra...
  -  **CheckStageResult** (Class) `[TRIVIAL]`
    - 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: 1, TRIVIAL: 39
  - 📄 **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: 2, TRIVIAL: 61
- 📄 **Files:** 7
- 📦 **Entities:** 63

**Key Entities:**

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

**Dependencies:**

  - 🔗 DEPENDS_ON -> IdMappingService
  - 🔗 DEPENDS_ON -> MigrationEngine
  - 🔗 DEPENDS_ON -> SupersetClient
  - 🔗 DEPENDS_ON -> superset_tool.client
  - 🔗 DEPENDS_ON -> superset_tool.utils

  ### 📁 `git/`

  - 🏗️ **Layers:** Unknown
  - 📊 **Tiers:** TRIVIAL: 5
  - 📄 **Files:** 2
  - 📦 **Entities:** 5

  **Key Entities:**

    -  **GitLLMExtension** (Class) `[TRIVIAL]`
      - 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:** TRIVIAL: 67
  - 📄 **Files:** 4
  - 📦 **Entities:** 67

  **Key Entities:**

    -  **DashboardValidationPlugin** (Class) `[TRIVIAL]`
      - Plugin for automated dashboard health analysis using LLMs.
    -  **DetectedIssue** (Class) `[TRIVIAL]`
      - Model for a single issue detected during validation.
    -  **DocumentationPlugin** (Class) `[TRIVIAL]`
      - Plugin for automated dataset documentation using LLMs.
    -  **LLMClient** (Class) `[TRIVIAL]`
      - Wrapper for LLM provider APIs.
    -  **LLMProviderConfig** (Class) `[TRIVIAL]`
      - Configuration for an LLM provider.
    -  **LLMProviderType** (Class) `[TRIVIAL]`
      - Enum for supported LLM providers.
    -  **ScreenshotService** (Class) `[TRIVIAL]`
      - Handles capturing screenshots of Superset dashboards.
    -  **ValidationResult** (Class) `[TRIVIAL]`
      - Model for dashboard validation result.
    -  **ValidationStatus** (Class) `[TRIVIAL]`
      - 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

    ### 📁 `__tests__/`

    - 📊 **Tiers:** STANDARD: 3, TRIVIAL: 53
    - 📄 **Files:** 3
    - 📦 **Entities:** 56

    **Key Entities:**

      - 📦 **backend.src.plugins.llm_analysis.__tests__.test_client_headers** (Module)
        - Verify OpenRouter client initialization includes provider-sp...
      - 📦 **backend.src.plugins.llm_analysis.__tests__.test_screenshot_service** (Module)
        - Protect dashboard screenshot navigation from brittle network...
      - 📦 **backend.src.plugins.llm_analysis.__tests__.test_service** (Module)
        - Verify LLM analysis transport/provider failures do not masqu...

  ### 📁 `storage/`

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

  **Key Entities:**

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

  **Dependencies:**

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

### 📁 `schemas/`

- 🏗️ **Layers:** API, Domain
- 📊 **Tiers:** CRITICAL: 9, STANDARD: 12, TRIVIAL: 11
- 📄 **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) `[TRIVIAL]`
    - Represents the latest health status of a single dashboard.
  -  **HealthSummaryResponse** (Class) `[TRIVIAL]`
    - Aggregated health summary for all dashboards.
  -  **NotificationChannel** (Class) `[TRIVIAL]`
    - 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: 1, TRIVIAL: 3
  - 📄 **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: 1, STANDARD: 6, TRIVIAL: 69
- 📄 **Files:** 9
- 📦 **Entities:** 76

**Key Entities:**

  -  **CleanReleaseTUI** (Class) `[TRIVIAL]`
    - Curses-based application for compliance monitoring.
  -  **TuiFacadeAdapter** (Class) `[TRIVIAL]`
    - 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) `[TRIVIAL]`
    - 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: 5, STANDARD: 47, TRIVIAL: 118
- 📄 **Files:** 10
- 📦 **Entities:** 170

**Key Entities:**

  -  **AuthService** (Class)
    - 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...
  -  **HealthService** (Class)
    - Aggregate latest dashboard validation state and manage persi...
  -  **LLMProviderService** (Class)
    - Service to manage LLM provider lifecycle.
  -  **MappingService** (Class) `[TRIVIAL]`
    - 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...
  -  **backend.src.services.git_service.GitService** (Class)
    - Wrapper for GitPython operations with semantic logging and e...

**Dependencies:**

  - 🔗 DEPENDS_ON -> TaskManagerModels
  - 🔗 DEPENDS_ON -> TaskManagerPackage
  - 🔗 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

  ### 📁 `__tests__/`

  - 🏗️ **Layers:** Domain, Domain Tests, Service, Service Tests, Unknown
  - 📊 **Tiers:** STANDARD: 12, TRIVIAL: 74
  - 📄 **Files:** 7
  - 📦 **Entities:** 86

  **Key Entities:**

    -  **TestEncryptionManager** (Class) `[TRIVIAL]`
      - Validate EncryptionManager encrypt/decrypt roundtrip, unique...
    -  **_DummyLogger** (Class) `[TRIVIAL]`
      - Minimal logger shim for TaskContext-like objects used in tes...
    -  **_FakeDBSession** (Class) `[TRIVIAL]`
      - 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: 13, TRIVIAL: 85
  - 📄 **Files:** 22
  - 📦 **Entities:** 107

  **Key Entities:**

    -  **CleanComplianceOrchestrator** (Class) `[TRIVIAL]`
      - Coordinate clean-release compliance verification stages.
    -  **CleanPolicyEngine** (Class) `[TRIVIAL]`
    -  **CleanReleaseRepository** (Class) `[TRIVIAL]`
      - Data access object for clean release lifecycle.
    -  **ComplianceExecutionResult** (Class) `[TRIVIAL]`
      - Return envelope for compliance execution with run/report and...
    -  **ComplianceExecutionService** (Class) `[TRIVIAL]`
      - 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: 7, TRIVIAL: 43
    - 📄 **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: 6, TRIVIAL: 18
    - 📄 **Files:** 6
    - 📦 **Entities:** 24

    **Key Entities:**

      -  **ComplianceStage** (Class) `[TRIVIAL]`
        - Protocol for pluggable stage implementations.
      -  **ComplianceStageContext** (Class) `[TRIVIAL]`
        - Immutable input envelope passed to each compliance stage.
      -  **DataPurityStage** (Class) `[TRIVIAL]`
        - Validate manifest summary for prohibited artifacts.
      -  **InternalSourcesOnlyStage** (Class) `[TRIVIAL]`
        - Enforce internal-source-only policy from trusted registry sn...
      -  **ManifestConsistencyStage** (Class) `[TRIVIAL]`
        - Validate run/manifest linkage consistency.
      -  **NoExternalEndpointsStage** (Class) `[TRIVIAL]`
        - Validate endpoint references from manifest against trusted r...
      -  **StageExecutionResult** (Class) `[TRIVIAL]`
        - 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, TRIVIAL: 20
  - 📄 **Files:** 3
  - 📦 **Entities:** 22

  **Key Entities:**

    -  **NotificationProvider** (Class) `[TRIVIAL]`
      - Abstract base class for all notification providers.
    -  **NotificationService** (Class) `[TRIVIAL]`
      - Routes validation reports to appropriate users and channels.
    -  **SMTPProvider** (Class) `[TRIVIAL]`
      - Delivers notifications via SMTP.
    -  **SlackProvider** (Class) `[TRIVIAL]`
      - Delivers notifications via Slack Webhooks or API.
    -  **TelegramProvider** (Class) `[TRIVIAL]`
      - 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, TRIVIAL: 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: 11, TRIVIAL: 167
  • 📄 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: 3, TRIVIAL: 49
- 📄 **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: 8, TRIVIAL: 48
  - 📄 **Files:** 8
  - 📦 **Entities:** 56

  **Key Entities:**

    -  **CleanReleaseCompliancePlugin** (Class) `[TRIVIAL]`
      - TaskManager plugin shim that executes clean release complian...
    -  **_PluginLoaderStub** (Class) `[TRIVIAL]`
      - 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: 6, TRIVIAL: 81
- 📄 **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) `[TRIVIAL]`
    - Generates a form dynamically based on a JSON schema.
  - 🧩 **EnvSelector** (Component) `[TRIVIAL]`
    - Provides a UI component for selecting source and target envi...
  - 🧩 **Footer** (Component) `[TRIVIAL]`
    - Displays the application footer with copyright information.
  - 🧩 **MappingTable** (Component) `[TRIVIAL]`
    - Displays and allows editing of database mappings.
  - 🧩 **MissingMappingModal** (Component) `[TRIVIAL]`
    - Prompts the user to provide a database mapping when one is m...
  - 🧩 **Navbar** (Component)
    - Main navigation bar for the application.
  - 🧩 **PasswordPrompt** (Component) `[TRIVIAL]`
    - A modal component to prompt the user for database passwords ...
  - 🧩 **StartupEnvironmentWizard** (Component)
    - Blocking startup wizard for creating the first Superset envi...

**Dependencies:**

  - 🔗 DEPENDS_ON -> frontend/src/lib/stores.js, frontend/src/components/tasks/TaskLogPanel.svelte
  - 🔗 DEPENDS_ON -> frontend/src/lib/toasts.js

  ### 📁 `__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:** STANDARD: 1, TRIVIAL: 2
  - 📄 **Files:** 1
  - 📦 **Entities:** 3

  **Key Entities:**

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

  **Dependencies:**

    - 🔗 DEPENDS_ON -> $lib/auth/permissions.hasPermission

  ### 📁 `git/`

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

  **Key Entities:**

    - 🧩 **BranchSelector** (Component) `[TRIVIAL]`
      - UI для выбора и создания веток Git.
    - 🧩 **CommitHistory** (Component) `[TRIVIAL]`
      - Displays the commit history for a specific dashboard.
    - 🧩 **CommitModal** (Component)
      - Модальное окно для создания коммита с просмотром изменений (...
    - 🧩 **ConflictResolver** (Component) `[TRIVIAL]`
      - UI for resolving merge conflicts (Keep Mine / Keep Theirs).
    - 🧩 **DeploymentModal** (Component) `[TRIVIAL]`
      - Modal for deploying a dashboard to a target environment.
    - 🧩 **GitManager** (Component) `[TRIVIAL]`
      - Центральный 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:** STANDARD: 2, TRIVIAL: 12
  - 📄 **Files:** 3
  - 📦 **Entities:** 14

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

  **Dependencies:**

    - 🔗 DEPENDS_ON -> backend/src/api/routes/llm.py
    - 🔗 DEPENDS_ON -> backend/src/plugins/llm_analysis/plugin.py

    ### 📁 `__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: 2, TRIVIAL: 6
  - 📄 **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.

  **Dependencies:**

    - 🔗 DEPENDS_ON -> storageService

  ### 📁 `tasks/`

  - 🏗️ **Layers:** UI, Unknown
  - 📊 **Tiers:** STANDARD: 3, TRIVIAL: 13
  - 📄 **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:** TRIVIAL: 16
  - 📄 **Files:** 4
  - 📦 **Entities:** 16

  **Key Entities:**

    - 🧩 **ConnectionForm** (Component) `[TRIVIAL]`
      - UI component for creating a new database connection configur...
    - 🧩 **ConnectionList** (Component) `[TRIVIAL]`
      - UI component for listing and deleting saved database connect...
    - 🧩 **DebugTool** (Component) `[TRIVIAL]`
      - UI component for system diagnostics and debugging API respon...
    - 🧩 **MapperTool** (Component) `[TRIVIAL]`
      - 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: 2, TRIVIAL: 27
- 📄 **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) `[TRIVIAL]`
    - Manages toast notifications using a Svelte writable store.

  ### 📁 `api/`

  - 🏗️ **Layers:** Infra, Infra-API
  - 📊 **Tiers:** CRITICAL: 1, STANDARD: 1, TRIVIAL: 10
  - 📄 **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: 1, TRIVIAL: 3
    - 📄 **Files:** 1
    - 📦 **Entities:** 4

    **Key Entities:**

      -  **TestBuildReportQueryString** (Class) `[TRIVIAL]`
        - Validate query string construction from filter options.
      -  **TestGetReportsAsync** (Class) `[TRIVIAL]`
        - Validate getReports and getReportDetail with mocked api.fetc...
      -  **TestNormalizeApiError** (Class) `[TRIVIAL]`
        - 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:** STANDARD: 2, TRIVIAL: 10
  - 📄 **Files:** 2
  - 📦 **Entities:** 12

  **Key Entities:**

    - 📦 **frontend.src.lib.auth.permissions** (Module)
      - Shared frontend RBAC utilities for route guards and menu vis...
    - 🗄️ **authStore** (Store)
      - 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: 1, TRIVIAL: 18
    - 📄 **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, TRIVIAL: 2
      - 📄 **Files:** 2
      - 📦 **Entities:** 5

      **Key Entities:**

        - 📦 **frontend.src.lib.components.assistant.__tests__.assistant_chat_integration** (Module)
          - Contract-level integration checks for assistant chat panel i...
        - 📦 **frontend.src.lib.components.assistant.__tests__.assistant_first_message_integration** (Module)
          - Verify first optimistic user message stays visible while a n...

    ### 📁 `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: 7, TRIVIAL: 54
    - 📄 **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
      - 🔗 DEPENDS_ON -> page store

      ### 📁 `__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: 3, TRIVIAL: 11
    - 📄 **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/components/reports/reportTypeProfiles.js
      - 🔗 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: 1, TRIVIAL: 3
  - 📄 **Files:** 1
  - 📦 **Entities:** 4

  **Key Entities:**

    - 📦 **i18n** (Module)
      - Determines the starting locale.
    - 🗄️ **locale** (Store) `[TRIVIAL]`
      - Holds the current active locale string.
    - 🗄️ **t** (Store) `[TRIVIAL]`
      - 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: 5, TRIVIAL: 32
  - 📄 **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: 7, TRIVIAL: 4
    - 📄 **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: 1, TRIVIAL: 3
      - 📄 **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:** TRIVIAL: 11
- 📄 **Files:** 2
- 📦 **Entities:** 11

**Key Entities:**

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

**Dependencies:**

  - 🔗 DEPENDS_ON -> frontend/src/lib/stores.js

### 📁 `routes/`

- 🏗️ **Layers:** Infra, UI, Unknown
- 📊 **Tiers:** CRITICAL: 1, STANDARD: 2, TRIVIAL: 6
- 📄 **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: 1, TRIVIAL: 5
    - 📄 **Files:** 1
    - 📦 **Entities:** 6

    **Key Entities:**

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

    **Dependencies:**

      - 🔗 DEPENDS_ON -> frontend.src.components.auth.ProtectedRoute
      - 🔗 DEPENDS_ON -> frontend.src.services.adminService

    ### 📁 `settings/`

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

    **Key Entities:**

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

    **Dependencies:**

      - 🔗 DEPENDS_ON -> frontend.src.components.auth.ProtectedRoute
      - 🔗 DEPENDS_ON -> frontend.src.services.adminService

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

    **Key Entities:**

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

    **Dependencies:**

      - 🔗 DEPENDS_ON -> frontend.src.components.auth.ProtectedRoute
      - 🔗 DEPENDS_ON -> frontend.src.services.adminService

  ### 📁 `dashboards/`

  - 🏗️ **Layers:** UI, Unknown
  - 📊 **Tiers:** STANDARD: 1, TRIVIAL: 91
  - 📄 **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
    - 📊 **Tiers:** STANDARD: 1, TRIVIAL: 3
    - 📄 **Files:** 1
    - 📦 **Entities:** 4

    **Key Entities:**

      - 🧩 **HealthCenterPage** (Component)
        - Main page for the Dashboard Health Center.

    **Dependencies:**

      - 🔗 DEPENDS_ON -> frontend.src.lib.components.health.HealthMatrix

      ### 📁 `__tests__/`

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

      **Key Entities:**

        - 📦 **frontend.src.routes.dashboards.health.__tests__.health_page_integration** (Module)
          - Lock dashboard health page contract for slug navigation and ...

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

  **Key Entities:**

    - 🧩 **GitDashboardPage** (Component) `[TRIVIAL]`
      - Dashboard management page for Git integration.

  ### 📁 `login/`

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

  **Key Entities:**

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

  ### 📁 `migration/`

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

  **Key Entities:**

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

    ### 📁 `mappings/`

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

    **Key Entities:**

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

  ### 📁 `profile/`

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

  **Key Entities:**

    - 🧩 **ProfilePage** (Component) `[CRITICAL]`
      - Manage user profile sections for read-only security access, ...
    - 📦 **+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....

  **Dependencies:**

    - 🔗 DEPENDS_ON -> frontend/src/lib/api/reports.js
    - 🔗 DEPENDS_ON -> frontend/src/lib/components/reports/ReportsList.svelte

      ### 📁 `[taskId]/`

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

      **Key Entities:**

        - 📦 **+page** (Module) `[TRIVIAL]`
          - Auto-generated module for frontend/src/routes/reports/llm/[t...
        - 📦 **frontend.src.routes.reports.llm.taskid.report_page_contract_test** (Module)
          - Protect the LLM report page from self-triggering screenshot ...

  ### 📁 `settings/`

  - 🏗️ **Layers:** UI, Unknown
  - 📊 **Tiers:** CRITICAL: 1, TRIVIAL: 34
  - 📄 **Files:** 2
  - 📦 **Entities:** 35

  **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:** TRIVIAL: 2
    - 📄 **Files:** 1
    - 📦 **Entities:** 2

    **Key Entities:**

      - 🧩 **ConnectionsSettingsPage** (Component) `[TRIVIAL]`
        - Page for managing database connection configurations.

    ### 📁 `git/`

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

    **Key Entities:**

      - 🧩 **GitSettingsPage** (Component) `[TRIVIAL]`
        - Manage Git server configurations for dashboard versioning.

      ### 📁 `__tests__/`

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

      **Key Entities:**

        - 📦 **frontend.src.routes.settings.git.__tests__.git_settings_page_ux_test** (Module) `[TRIVIAL]`
          - 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:** TRIVIAL: 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: 1, TRIVIAL: 6
    - 📄 **Files:** 1
    - 📦 **Entities:** 7

    **Key Entities:**

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

    **Dependencies:**

      - 🔗 DEPENDS_ON -> storageService

### 📁 `services/`

- 🏗️ **Layers:** Service
- 📊 **Tiers:** STANDARD: 3, TRIVIAL: 33
- 📄 **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
  - 🔗 DEPENDS_ON -> specs/011-git-integration-dashboard/contracts/api.md

  ### 📁 `__tests__/`

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

  **Key Entities:**

    - 📦 **frontend.src.services.__tests__.gitService_test** (Module) `[TRIVIAL]`
      - 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: 11
  • 📄 Files: 1
  • 📦 Entities: 40

Key Entities:

  • Complexity (Class) [TRIVIAL]
    • Adaptive semantic complexity scale used for validation stric...
  • 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]
    • Legacy tier buckets retained for backward-compatible reporti...
  • 📦 generate_semantic_map (Module)
    • Scans the codebase to generate a Semantic Map, Module Map, a...

Cross-Module Dependencies

graph TD
    src-->|DEPENDS_ON|backend
    src-->|DEPENDS_ON|backend
    api-->|USES|backend
    api-->|USES|backend
    routes-->|DEPENDS_ON|backend
    routes-->|DEPENDS_ON|backend
    routes-->|DEPENDS_ON|backend
    routes-->|CALLS|backend
    routes-->|DISPATCHES|backend
    routes-->|CALLS|backend
    routes-->|DISPATCHES|backend
    routes-->|CALLS|backend
    routes-->|CALLS|backend
    routes-->|USES|backend
    routes-->|USES|backend
    routes-->|USES|backend
    routes-->|CALLS|backend
    routes-->|CALLS|backend
    routes-->|DEPENDS_ON|backend
    routes-->|DEPENDS_ON|backend
    routes-->|DEPENDS_ON|backend
    routes-->|DEPENDS_ON|backend
    routes-->|DEPENDS_ON|backend
    routes-->|DEPENDS_ON|backend
    routes-->|DEPENDS_ON|backend
    routes-->|DEPENDS_ON|backend
    routes-->|DEPENDS_ON|backend
    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|backend
    routes-->|CALLS|backend
    routes-->|CALLS|backend
    routes-->|CALLS|backend
    routes-->|CALLS|root
    routes-->|CALLS|backend
    routes-->|DEPENDS_ON|backend
    routes-->|DEPENDS_ON|backend
    routes-->|DEPENDS_ON|backend
    routes-->|DEPENDS_ON|backend
    routes-->|DEPENDS_ON|backend
    routes-->|DEPENDS_ON|backend
    routes-->|DEPENDS_ON|backend
    routes-->|DEPENDS_ON|backend
    routes-->|DEPENDS_ON|backend
    routes-->|DEPENDS_ON|backend
    routes-->|DEPENDS_ON|backend
    routes-->|DEPENDS_ON|backend
    routes-->|DEPENDS_ON|backend
    routes-->|CALLS|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__-->|VERIFIES|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
    core-->|CALLS|backend
    core-->|CALLS|backend
    core-->|DEPENDS_ON|backend
    core-->|DEPENDS_ON|backend
    core-->|DEPENDS_ON|backend
    core-->|DEPENDS_ON|backend
    core-->|INHERITS|backend
    core-->|DEPENDS_ON|backend
    core-->|CALLS|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
    task_manager-->|USED_BY|backend
    task_manager-->|USED_BY|backend
    task_manager-->|USED_BY|backend
    task_manager-->|DEPENDS_ON|backend
    task_manager-->|DEPENDS_ON|backend
    task_manager-->|DEPENDS_ON|backend
    utils-->|DEPENDS_ON|backend
    utils-->|DEPENDS_ON|backend
    utils-->|CALLS|backend
    utils-->|CALLS|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-->|CALLS|backend
    services-->|CALLS|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-->|CALLS|backend
    services-->|CALLS|backend
    services-->|CALLS|backend
    services-->|CALLS|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-->|USED_BY|backend
    services-->|USED_BY|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
    components-->|USED_BY|routes
    components-->|USES|lib
    components-->|USES|services
    components-->|USES|tasks
    components-->|USED_BY|routes
    components-->|USES|lib
    components-->|USES|lib
    components-->|DEPENDS_ON|lib
    components-->|DEPENDS_ON|lib
    __tests__-->|VERIFIES|components
    git-->|CALLS|services
    __tests__-->|VERIFIES|components
    llm-->|DEPENDS_ON|backend
    llm-->|DEPENDS_ON|backend
    __tests__-->|VERIFIES|components
    tasks-->|USES|components
    tasks-->|USES|components
    tools-->|USES|services
    tools-->|USES|services
    tools-->|USES|services
    tools-->|USES|services
    tools-->|USES|services
    __tests__-->|TESTS|lib
    __tests__-->|VERIFIES|lib
    __tests__-->|VERIFIES|lib
    __tests__-->|TESTS|lib
    reports-->|DEPENDS_ON|lib
    reports-->|DEPENDS_ON|lib
    reports-->|DEPENDS_ON|lib
    reports-->|DEPENDS_ON|lib
    reports-->|DEPENDS_ON|lib
    __tests__-->|TESTS|routes
    __tests__-->|TESTS|routes
    __tests__-->|TESTS|lib
    __tests__-->|TESTS|lib
    __tests__-->|TESTS|lib
    __tests__-->|TESTS|routes
    pages-->|DEPENDS_ON|lib
    llm-->|CALLS|components
    __tests__-->|TESTS|routes
    __tests__-->|VERIFIES|routes
    __tests__-->|TESTS|routes
    __tests__-->|TESTS|routes
    reports-->|DEPENDS_ON|lib
    reports-->|DEPENDS_ON|lib
    [taskId]-->|VERIFIES|routes