Files
ss-tools/.ai/MODULE_MAP.md
2026-03-15 20:29:11 +03:00

2346 lines
86 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# Module Map
> High-level module structure for AI Context. Generated automatically.
**Generated:** 2026-03-15T16:48:04.692685
## Summary
- **Total Modules:** 105
- **Total Entities:** 3256
## Module Hierarchy
### 📁 `backend/`
- 🏗️ **Layers:** Utility
- 📊 **Tiers:** STANDARD: 2
- 📄 **Files:** 1
- 📦 **Entities:** 2
**Key Entities:**
- 📦 **backend.delete_running_tasks** (Module)
- Script to delete tasks with RUNNING status from the database...
### 📁 `src/`
- 🏗️ **Layers:** API, Core, UI (API)
- 📊 **Tiers:** CRITICAL: 2, STANDARD: 22, TRIVIAL: 2
- 📄 **Files:** 3
- 📦 **Entities:** 26
**Key Entities:**
- 📦 **AppModule** (Module) `[CRITICAL]`
- The main entry point for the FastAPI application. It initial...
- 📦 **Dependencies** (Module)
- Manages creation and provision of shared application depende...
### 📁 `api/`
- 🏗️ **Layers:** API
- 📊 **Tiers:** CRITICAL: 1, STANDARD: 7
- 📄 **Files:** 2
- 📦 **Entities:** 8
**Key Entities:**
- 📦 **backend.src.api.auth** (Module) `[CRITICAL]`
- Authentication API endpoints.
### 📁 `routes/`
- 🏗️ **Layers:** API, Infra, UI (API), UI/API
- 📊 **Tiers:** CRITICAL: 5, STANDARD: 282, TRIVIAL: 15
- 📄 **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)
- Schema for branch checkout requests.
- **BranchCreate** (Class)
- Schema for branch creation requests.
- **BranchSchema** (Class)
- Schema for representing a Git branch metadata.
- **BuildManifestRequest** (Class)
- Request schema for manifest build endpoint.
- **CommitCreate** (Class)
- Schema for staging and committing changes.
- **CommitSchema** (Class)
- Schema for representing Git commit details.
- **ConfirmationRecord** (Class)
- In-memory confirmation token model for risky operation dispa...
**Dependencies:**
- 🔗 DEPENDS_ON -> ConfigManager
- 🔗 DEPENDS_ON -> ConfigModels
- 🔗 DEPENDS_ON -> backend.src.core.database
- 🔗 DEPENDS_ON -> backend.src.core.database.get_db
- 🔗 DEPENDS_ON -> backend.src.core.mapping_service
### 📁 `__tests__/`
- 🏗️ **Layers:** API, Domain, Domain (Tests), Tests, UI (API Tests), Unknown
- 📊 **Tiers:** STANDARD: 93, TRIVIAL: 198
- 📄 **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: 11, STANDARD: 150, TRIVIAL: 9
- 📄 **Files:** 14
- 📦 **Entities:** 170
**Key Entities:**
- **AsyncSupersetClient** (Class)
- Async sibling of SupersetClient for dashboard read paths.
- **AuthSessionLocal** (Class) `[TRIVIAL]`
- A session factory for the authentication database.
- **BeliefFormatter** (Class)
- Custom logging formatter that adds belief state prefixes to ...
- **ConfigManager** (Class) `[CRITICAL]`
- Handles application configuration load, validation, mutation...
- **IdMappingService** (Class) `[CRITICAL]`
- Service handling the cataloging and retrieval of remote Supe...
- **LogEntry** (Class)
- A Pydantic model representing a single, structured log entry...
- **MigrationEngine** (Class) `[CRITICAL]`
- Engine for transforming Superset export ZIPs.
- **PluginBase** (Class)
- Defines the abstract base class that all plugins must implem...
- **PluginConfig** (Class)
- A Pydantic model used to represent the validated configurati...
- **PluginLoader** (Class)
- Scans a specified directory for Python modules, dynamically ...
**Dependencies:**
- 🔗 DEPENDS_ON -> AppConfigRecord
- 🔗 DEPENDS_ON -> ConfigModels
- 🔗 DEPENDS_ON -> SessionLocal
- 🔗 DEPENDS_ON -> backend.src.core.auth.config
- 🔗 DEPENDS_ON -> backend.src.core.logger
### 📁 `__tests__/`
- 🏗️ **Layers:** Domain
- 📊 **Tiers:** STANDARD: 11, TRIVIAL: 7
- 📄 **Files:** 3
- 📦 **Entities:** 18
**Key Entities:**
- **_RecordingNetworkClient** (Class)
- Records request payloads and returns scripted responses for ...
- 📦 **backend.src.core.__tests__.test_config_manager_compat** (Module)
- Verifies ConfigManager compatibility wrappers preserve legac...
- 📦 **backend.src.core.__tests__.test_superset_profile_lookup** (Module)
- Verifies Superset profile lookup adapter payload normalizati...
- 📦 **test_throttled_scheduler** (Module)
- Unit tests for ThrottledSchedulerConfigurator distribution l...
### 📁 `auth/`
- 🏗️ **Layers:** Core, Domain
- 📊 **Tiers:** CRITICAL: 8, STANDARD: 21
- 📄 **Files:** 7
- 📦 **Entities:** 29
**Key Entities:**
- **AuthConfig** (Class) `[CRITICAL]`
- Holds authentication-related settings.
- **AuthRepository** (Class) `[CRITICAL]`
- Encapsulates database operations for authentication-related ...
- 📦 **backend.src.core.auth.config** (Module) `[CRITICAL]`
- Centralized configuration for authentication and authorizati...
- 📦 **backend.src.core.auth.jwt** (Module) `[CRITICAL]`
- JWT token generation and validation logic.
- 📦 **backend.src.core.auth.logger** (Module) `[CRITICAL]`
- Audit logging for security-related events.
- 📦 **backend.src.core.auth.oauth** (Module) `[CRITICAL]`
- ADFS OIDC configuration and client using Authlib.
- 📦 **backend.src.core.auth.repository** (Module) `[CRITICAL]`
- Data access layer for authentication and user preference ent...
- 📦 **backend.src.core.auth.security** (Module) `[CRITICAL]`
- Utility for password hashing and verification using Passlib.
**Dependencies:**
- 🔗 DEPENDS_ON -> authlib
- 🔗 DEPENDS_ON -> backend.src.core.logger.belief_scope
- 🔗 DEPENDS_ON -> backend.src.models.auth
- 🔗 DEPENDS_ON -> backend.src.models.profile
- 🔗 DEPENDS_ON -> jose
### 📁 `__tests__/`
- 🏗️ **Layers:** Domain
- 📊 **Tiers:** STANDARD: 1, TRIVIAL: 14
- 📄 **Files:** 1
- 📦 **Entities:** 15
**Key Entities:**
- 📦 **test_auth** (Module)
- Unit tests for authentication module
### 📁 `__tests__/`
- 🏗️ **Layers:** Infra
- 📊 **Tiers:** STANDARD: 11, TRIVIAL: 1
- 📄 **Files:** 1
- 📦 **Entities:** 12
**Key Entities:**
- 📦 **test_logger** (Module)
- Unit tests for logger module
### 📁 `migration/`
- 🏗️ **Layers:** Core, Domain
- 📊 **Tiers:** CRITICAL: 5, STANDARD: 15, TRIVIAL: 1
- 📄 **Files:** 4
- 📦 **Entities:** 21
**Key Entities:**
- **MigrationArchiveParser** (Class) `[CRITICAL]`
- Extract normalized dashboards/charts/datasets metadata from ...
- **MigrationDryRunService** (Class) `[CRITICAL]`
- Build deterministic diff/risk payload for migration pre-flig...
- 📦 **backend.src.core.migration.__init__** (Module) `[TRIVIAL]`
- Namespace package for migration pre-flight orchestration com...
- 📦 **backend.src.core.migration.archive_parser** (Module) `[CRITICAL]`
- Parse Superset export ZIP archives into normalized object ca...
- 📦 **backend.src.core.migration.dry_run_orchestrator** (Module) `[CRITICAL]`
- Compute pre-flight migration diff and risk scoring without a...
- 📦 **backend.src.core.migration.risk_assessor** (Module) `[CRITICAL]`
- Compute deterministic migration risk items and aggregate sco...
**Dependencies:**
- 🔗 DEPENDS_ON -> backend.src.core.logger
- 🔗 DEPENDS_ON -> backend.src.core.migration.archive_parser
- 🔗 DEPENDS_ON -> backend.src.core.migration.risk_assessor
- 🔗 DEPENDS_ON -> backend.src.core.migration_engine
- 🔗 DEPENDS_ON -> backend.src.core.superset_client
### 📁 `task_manager/`
- 🏗️ **Layers:** Core
- 📊 **Tiers:** CRITICAL: 10, STANDARD: 64, TRIVIAL: 6
- 📄 **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 save and query task logs from the task_l...
- **TaskLogger** (Class) `[CRITICAL]`
- A wrapper around TaskManager._add_log that carries task_id a...
- **TaskManager** (Class) `[CRITICAL]`
- Manages the lifecycle of tasks, including their creation, ex...
**Dependencies:**
- 🔗 DEPENDS_ON -> TaskLogRecord
- 🔗 DEPENDS_ON -> TaskLogger, USED_BY -> plugins
- 🔗 DEPENDS_ON -> TaskManager, CALLS -> TaskManager._add_log
### 📁 `__tests__/`
- 🏗️ **Layers:** Unknown
- 📊 **Tiers:** STANDARD: 2, TRIVIAL: 9
- 📄 **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: 63, TRIVIAL: 5
- 📄 **Files:** 6
- 📦 **Entities:** 69
**Key Entities:**
- **APIClient** (Class)
- Инкапсулирует HTTP-логику для работы с API, включая сессии, ...
- **AsyncAPIClient** (Class)
- Async Superset API client backed by httpx.AsyncClient with s...
- **AuthenticationError** (Class)
- Exception raised when authentication fails.
- **DashboardNotFoundError** (Class)
- Exception raised when a dashboard cannot be found.
- **DatasetMapper** (Class)
- Класс для меппинга и обновления verbose_map в датасетах Supe...
- **InvalidZipFormatError** (Class)
- Exception raised when a file is not a valid ZIP archive.
- **NetworkError** (Class)
- Exception raised when a network level error occurs.
- **PermissionDeniedError** (Class)
- Exception raised when access is denied.
- **SupersetAPIError** (Class)
- Base exception for all Superset API related errors.
- **SupersetAuthCache** (Class)
- Process-local cache for Superset access/csrf tokens keyed by...
**Dependencies:**
- 🔗 DEPENDS_ON -> backend.core.superset_client
- 🔗 DEPENDS_ON -> backend.src.core.logger
- 🔗 DEPENDS_ON -> backend.src.core.utils.network.SupersetAuthCache
- 🔗 DEPENDS_ON -> pandas
- 🔗 DEPENDS_ON -> psycopg2
### 📁 `models/`
- 🏗️ **Layers:** Domain, Model
- 📊 **Tiers:** CRITICAL: 18, STANDARD: 44, TRIVIAL: 29
- 📄 **Files:** 14
- 📦 **Entities:** 91
**Key Entities:**
- **ADGroupMapping** (Class) `[CRITICAL]`
- Maps an Active Directory group to a local System Role.
- **AppConfigRecord** (Class) `[CRITICAL]`
- Stores persisted application configuration as a single autho...
- **ApprovalDecision** (Class)
- Approval or rejection bound to a candidate and report.
- **AssistantAuditRecord** (Class)
- Store audit decisions and outcomes produced by assistant com...
- **AssistantConfirmationRecord** (Class)
- Persist risky operation confirmation tokens with lifecycle s...
- **AssistantMessageRecord** (Class)
- Persist chat history entries for assistant conversations.
- **CandidateArtifact** (Class)
- Represents one artifact associated with a release candidate.
- **CheckFinalStatus** (Class)
- Backward-compatible final status enum for legacy TUI/orchest...
- **CheckStageName** (Class)
- Backward-compatible stage name enum for legacy TUI/orchestra...
- **CheckStageResult** (Class)
- Backward-compatible stage result container for legacy TUI/or...
**Dependencies:**
- 🔗 DEPENDS_ON -> Role
- 🔗 DEPENDS_ON -> TaskRecord
- 🔗 DEPENDS_ON -> backend.src.core.task_manager.models
- 🔗 DEPENDS_ON -> backend.src.models.auth
- 🔗 DEPENDS_ON -> backend.src.models.mapping
### 📁 `__tests__/`
- 🏗️ **Layers:** Domain, Unknown
- 📊 **Tiers:** STANDARD: 2, TRIVIAL: 38
- 📄 **Files:** 3
- 📦 **Entities:** 40
**Key Entities:**
- 📦 **test_clean_release** (Module) `[TRIVIAL]`
- Auto-generated module for backend/src/models/__tests__/test_...
- 📦 **test_models** (Module) `[TRIVIAL]`
- Unit tests for data models
- 📦 **test_report_models** (Module)
- Unit tests for report Pydantic models and their validators
### 📁 `plugins/`
- 🏗️ **Layers:** App, Plugin, Plugins
- 📊 **Tiers:** CRITICAL: 2, STANDARD: 61
- 📄 **Files:** 7
- 📦 **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) `[CRITICAL]`
- Implementation of the migration plugin workflow and transfor...
- **SearchPlugin** (Class)
- Plugin for searching text patterns in Superset datasets.
- 📦 **BackupPlugin** (Module)
- A plugin that provides functionality to back up Superset das...
- 📦 **DebugPluginModule** (Module)
- Implements a plugin for system diagnostics and debugging Sup...
- 📦 **MapperPluginModule** (Module)
- Implements a plugin for mapping dataset columns using extern...
- 📦 **MigrationPlugin** (Module) `[CRITICAL]`
- 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:** STANDARD: 3, TRIVIAL: 2
- 📄 **Files:** 2
- 📦 **Entities:** 5
**Key Entities:**
- **GitLLMExtension** (Class)
- Provides LLM capabilities to the Git plugin.
- 📦 **llm_extension** (Module) `[TRIVIAL]`
- Auto-generated module for backend/src/plugins/git/llm_extens...
### 📁 `llm_analysis/`
- 🏗️ **Layers:** Unknown
- 📊 **Tiers:** STANDARD: 32, TRIVIAL: 35
- 📄 **Files:** 4
- 📦 **Entities:** 67
**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
### 📁 `__tests__/`
- 📊 **Tiers:** STANDARD: 13, TRIVIAL: 43
- 📄 **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:** STANDARD: 18
- 📄 **Files:** 1
- 📦 **Entities:** 18
**Key Entities:**
- **StoragePlugin** (Class)
- Implementation of the storage management plugin.
- 📦 **StoragePlugin** (Module)
- Provides core filesystem operations for managing backups and...
**Dependencies:**
- 🔗 DEPENDS_ON -> backend.src.models.storage
- 🔗 IMPLEMENTS -> PluginBase
### 📁 `schemas/`
- 🏗️ **Layers:** API, Domain
- 📊 **Tiers:** CRITICAL: 10, STANDARD: 19, TRIVIAL: 3
- 📄 **Files:** 5
- 📦 **Entities:** 32
**Key Entities:**
- **ADGroupMappingCreate** (Class) `[CRITICAL]`
- Schema for creating an AD Group mapping.
- **ADGroupMappingSchema** (Class) `[CRITICAL]`
- Represents an AD Group to Role mapping in API responses.
- **DashboardHealthItem** (Class)
- Represents the latest health status of a single dashboard.
- **HealthSummaryResponse** (Class)
- Aggregated health summary for all dashboards.
- **NotificationChannel** (Class)
- Structured notification channel definition for policy-level ...
- **PermissionSchema** (Class) `[TRIVIAL]`
- Represents a permission in API responses.
- **ProfilePermissionState** (Class)
- Represents one permission badge state for profile read-only ...
- **ProfilePreference** (Class)
- Represents persisted profile preference for a single authent...
- **ProfilePreferenceResponse** (Class)
- Response envelope for profile preference read/update endpoin...
- **ProfilePreferenceUpdateRequest** (Class)
- Request payload for updating current user's profile settings...
**Dependencies:**
- 🔗 DEPENDS_ON -> pydantic
### 📁 `__tests__/`
- 📊 **Tiers:** STANDARD: 4
- 📄 **Files:** 1
- 📦 **Entities:** 4
**Key Entities:**
- 📦 **backend.src.schemas.__tests__.test_settings_and_health_schemas** (Module)
- Regression tests for settings and health schema contracts up...
### 📁 `scripts/`
- 🏗️ **Layers:** Scripts, UI, Unknown
- 📊 **Tiers:** CRITICAL: 1, STANDARD: 45, TRIVIAL: 30
- 📄 **Files:** 9
- 📦 **Entities:** 76
**Key Entities:**
- **CleanReleaseTUI** (Class)
- Curses-based application for compliance monitoring.
- **TuiFacadeAdapter** (Class)
- Thin TUI adapter that routes business mutations through appl...
- 📦 **backend.src.scripts.clean_release_cli** (Module)
- Provide headless CLI commands for candidate registration, ar...
- 📦 **backend.src.scripts.clean_release_tui** (Module)
- Interactive terminal interface for Enterprise Clean Release ...
- 📦 **backend.src.scripts.create_admin** (Module)
- CLI tool for creating the initial admin user.
- 📦 **backend.src.scripts.init_auth_db** (Module) `[CRITICAL]`
- Initializes the auth database and creates the necessary tabl...
- 📦 **backend.src.scripts.migrate_sqlite_to_postgres** (Module)
- Migrates legacy config and task history from SQLite/file sto...
- 📦 **backend.src.scripts.seed_permissions** (Module)
- Populates the auth database with initial system permissions.
- 📦 **backend.src.scripts.seed_superset_load_test** (Module)
- Creates randomized load-test data in Superset by cloning cha...
- 📦 **test_dataset_dashboard_relations** (Module) `[TRIVIAL]`
- Auto-generated module for backend/src/scripts/test_dataset_d...
**Dependencies:**
- 🔗 DEPENDS_ON -> backend.src.services.clean_release.compliance_orchestrator
- 🔗 DEPENDS_ON -> backend.src.services.clean_release.repository
### 📁 `services/`
- 🏗️ **Layers:** Core, Domain, Domain/Service, Service
- 📊 **Tiers:** CRITICAL: 6, STANDARD: 133, TRIVIAL: 20
- 📄 **Files:** 10
- 📦 **Entities:** 159
**Key Entities:**
- **AuthService** (Class) `[CRITICAL]`
- Provides high-level authentication services.
- **EncryptionManager** (Class) `[CRITICAL]`
- Handles encryption and decryption of sensitive data like API...
- **EnvironmentNotFoundError** (Class)
- Raised when environment_id from lookup request is unknown in...
- **GitService** (Class)
- Wrapper for GitPython operations with semantic logging and e...
- **HealthService** (Class)
- Aggregate latest dashboard validation state and manage persi...
- **LLMProviderService** (Class)
- Service to manage LLM provider lifecycle.
- **MappingService** (Class)
- Service for handling database mapping logic.
- **ProfileAuthorizationError** (Class)
- Raised when caller attempts cross-user preference mutation.
- **ProfileService** (Class) `[CRITICAL]`
- Implements profile preference read/update flow and Superset ...
- **ProfileValidationError** (Class)
- Domain validation error for profile preference update reques...
**Dependencies:**
- 🔗 DEPENDS_ON -> ValidationRecord
- 🔗 DEPENDS_ON -> backend.src.core.auth.jwt.create_access_token
- 🔗 DEPENDS_ON -> backend.src.core.auth.repository
- 🔗 DEPENDS_ON -> backend.src.core.auth.repository.AuthRepository
- 🔗 DEPENDS_ON -> backend.src.core.auth.security.verify_password
### 📁 `__tests__/`
- 🏗️ **Layers:** Domain, Domain Tests, Service, Service Tests, Unknown
- 📊 **Tiers:** STANDARD: 40, TRIVIAL: 46
- 📄 **Files:** 7
- 📦 **Entities:** 86
**Key Entities:**
- **TestEncryptionManager** (Class)
- Validate EncryptionManager encrypt/decrypt roundtrip, unique...
- **_DummyLogger** (Class)
- Minimal logger shim for TaskContext-like objects used in tes...
- **_FakeDBSession** (Class)
- Captures persisted records for assertion and mimics SQLAlche...
- 📦 **backend.src.services.__tests__.test_llm_plugin_persistence** (Module)
- Regression test for ValidationRecord persistence fields popu...
- 📦 **backend.src.services.__tests__.test_llm_prompt_templates** (Module)
- Validate normalization and rendering behavior for configurab...
- 📦 **backend.src.services.__tests__.test_rbac_permission_catalog** (Module)
- Verifies RBAC permission catalog discovery and idempotent sy...
- 📦 **backend.src.services.__tests__.test_resource_service** (Module)
- Unit tests for ResourceService
- 📦 **test_encryption_manager** (Module)
- Unit tests for EncryptionManager encrypt/decrypt functionali...
- 📦 **test_health_service** (Module)
- Unit tests for HealthService aggregation logic.
- 📦 **test_llm_provider** (Module) `[TRIVIAL]`
- Auto-generated module for backend/src/services/__tests__/tes...
**Dependencies:**
- 🔗 DEPENDS_ON -> backend.src.services.llm_prompt_templates
### 📁 `clean_release/`
- 🏗️ **Layers:** Application, Domain, Infra
- 📊 **Tiers:** CRITICAL: 9, STANDARD: 48, TRIVIAL: 50
- 📄 **Files:** 22
- 📦 **Entities:** 107
**Key Entities:**
- **CleanComplianceOrchestrator** (Class)
- Coordinate clean-release compliance verification stages.
- **CleanPolicyEngine** (Class)
- **CleanReleaseRepository** (Class)
- Data access object for clean release lifecycle.
- **ComplianceExecutionResult** (Class)
- Return envelope for compliance execution with run/report and...
- **ComplianceExecutionService** (Class)
- Execute clean-release compliance lifecycle over trusted snap...
- 📦 **backend.src.services.clean_release.approval_service** (Module) `[CRITICAL]`
- Enforce approval/rejection gates over immutable compliance r...
- 📦 **backend.src.services.clean_release.artifact_catalog_loader** (Module)
- Load bootstrap artifact catalogs for clean release real-mode...
- 📦 **backend.src.services.clean_release.audit_service** (Module)
- Provide lightweight audit hooks for clean release preparatio...
- 📦 **backend.src.services.clean_release.candidate_service** (Module) `[CRITICAL]`
- Register release candidates with validated artifacts and adv...
- 📦 **backend.src.services.clean_release.compliance_execution_service** (Module) `[CRITICAL]`
- Create and execute compliance runs with trusted snapshots, d...
**Dependencies:**
- 🔗 DEPENDS_ON -> backend.src.core.config_manager
- 🔗 DEPENDS_ON -> backend.src.core.logger
- 🔗 DEPENDS_ON -> backend.src.models.clean_release
- 🔗 DEPENDS_ON -> backend.src.models.clean_release.CandidateArtifact
- 🔗 DEPENDS_ON -> backend.src.models.clean_release.CleanProfilePolicy
### 📁 `__tests__/`
- 🏗️ **Layers:** Domain, Infra, Unknown
- 📊 **Tiers:** STANDARD: 25, TRIVIAL: 25
- 📄 **Files:** 8
- 📦 **Entities:** 50
**Key Entities:**
- 📦 **backend.tests.services.clean_release.test_audit_service** (Module)
- Validate audit hooks emit expected log patterns for clean re...
- 📦 **backend.tests.services.clean_release.test_compliance_orchestrator** (Module)
- Validate compliance orchestrator stage transitions and final...
- 📦 **backend.tests.services.clean_release.test_manifest_builder** (Module)
- Validate deterministic manifest generation behavior for US1.
- 📦 **backend.tests.services.clean_release.test_preparation_service** (Module)
- Validate release candidate preparation flow, including polic...
- 📦 **backend.tests.services.clean_release.test_report_builder** (Module)
- Validate compliance report builder counter integrity and blo...
- 📦 **backend.tests.services.clean_release.test_source_isolation** (Module)
- Verify internal source registry validation behavior.
- 📦 **backend.tests.services.clean_release.test_stages** (Module)
- Validate final status derivation logic from stage results.
- 📦 **test_policy_engine** (Module) `[TRIVIAL]`
- Auto-generated module for backend/src/services/clean_release...
**Dependencies:**
- 🔗 DEPENDS_ON -> backend.src.services.clean_release.preparation_service:Module
### 📁 `repositories/`
- 🏗️ **Layers:** Infra
- 📊 **Tiers:** STANDARD: 10, TRIVIAL: 46
- 📄 **Files:** 10
- 📦 **Entities:** 56
**Key Entities:**
- 📦 **approval_repository** (Module)
- Persist and query approval decisions.
- 📦 **artifact_repository** (Module)
- Persist and query candidate artifacts.
- 📦 **audit_repository** (Module)
- Persist and query audit logs for clean release operations.
- 📦 **candidate_repository** (Module)
- Persist and query release candidates.
- 📦 **clean_release_repositories** (Module)
- Export all clean release repositories.
- 📦 **compliance_repository** (Module)
- Persist and query compliance runs, stage runs, and violation...
- 📦 **manifest_repository** (Module)
- Persist and query distribution manifests.
- 📦 **policy_repository** (Module)
- Persist and query policy and registry snapshots.
- 📦 **publication_repository** (Module)
- Persist and query publication records.
- 📦 **report_repository** (Module)
- Persist and query compliance reports.
### 📁 `stages/`
- 🏗️ **Layers:** Domain
- 📊 **Tiers:** STANDARD: 19, TRIVIAL: 5
- 📄 **Files:** 6
- 📦 **Entities:** 24
**Key Entities:**
- **ComplianceStage** (Class)
- Protocol for pluggable stage implementations.
- **ComplianceStageContext** (Class)
- Immutable input envelope passed to each compliance stage.
- **DataPurityStage** (Class)
- Validate manifest summary for prohibited artifacts.
- **InternalSourcesOnlyStage** (Class)
- Enforce internal-source-only policy from trusted registry sn...
- **ManifestConsistencyStage** (Class)
- Validate run/manifest linkage consistency.
- **NoExternalEndpointsStage** (Class)
- Validate endpoint references from manifest against trusted r...
- **StageExecutionResult** (Class)
- Structured stage output containing decision, details and vio...
- 📦 **backend.src.services.clean_release.stages** (Module)
- Define compliance stage order and helper functions for deter...
- 📦 **backend.src.services.clean_release.stages.base** (Module)
- Define shared contracts and helpers for pluggable clean-rele...
- 📦 **backend.src.services.clean_release.stages.data_purity** (Module)
- Evaluate manifest purity counters and emit blocking violatio...
**Dependencies:**
- 🔗 DEPENDS_ON -> backend.src.models.clean_release
- 🔗 DEPENDS_ON -> backend.src.services.clean_release.stages.base
- 🔗 IMPLEMENTS -> backend.src.services.clean_release.stages.base.ComplianceStage
### 📁 `notifications/`
- 🏗️ **Layers:** Domain, Infra
- 📊 **Tiers:** CRITICAL: 2, STANDARD: 6, TRIVIAL: 14
- 📄 **Files:** 3
- 📦 **Entities:** 22
**Key Entities:**
- **NotificationProvider** (Class)
- Abstract base class for all notification providers.
- **NotificationService** (Class)
- Routes validation reports to appropriate users and channels.
- **SMTPProvider** (Class)
- Delivers notifications via SMTP.
- **SlackProvider** (Class)
- Delivers notifications via Slack Webhooks or API.
- **TelegramProvider** (Class)
- Delivers notifications via Telegram Bot API.
- 📦 **backend.src.services.notifications.providers** (Module) `[CRITICAL]`
- Defines abstract base and concrete implementations for exter...
- 📦 **backend.src.services.notifications.service** (Module) `[CRITICAL]`
- Orchestrates notification routing based on user preferences ...
**Dependencies:**
- 🔗 DEPENDS_ON -> backend.src.models.llm
- 🔗 DEPENDS_ON -> backend.src.services.notifications.providers
- 🔗 DEPENDS_ON -> backend.src.services.profile_service
### 📁 `__tests__/`
- 📊 **Tiers:** STANDARD: 1, TRIVIAL: 9
- 📄 **Files:** 1
- 📦 **Entities:** 10
**Key Entities:**
- 📦 **backend.src.services.notifications.__tests__.test_notification_service** (Module)
- Unit tests for NotificationService routing and dispatch logi...
### 📁 `reports/`
- 🏗️ **Layers:** Domain
- 📊 **Tiers:** CRITICAL: 5, STANDARD: 16
- 📄 **Files:** 4
- 📦 **Entities:** 21
**Key Entities:**
- **ReportsService** (Class) `[CRITICAL]`
- Service layer for list/detail report retrieval and normaliza...
- 📦 **backend.src.services.reports.normalizer** (Module) `[CRITICAL]`
- Convert task manager task objects into canonical unified Tas...
- 📦 **backend.src.services.reports.report_service** (Module) `[CRITICAL]`
- Aggregate, normalize, filter, and paginate task reports for ...
- 📦 **backend.src.services.reports.type_profiles** (Module) `[CRITICAL]`
- Deterministic mapping of plugin/task identifiers to canonica...
**Dependencies:**
- 🔗 DEPENDS_ON -> backend.src.core.task_manager.manager.TaskManager
- 🔗 DEPENDS_ON -> backend.src.core.task_manager.models.Task
- 🔗 DEPENDS_ON -> backend.src.models.report
- 🔗 DEPENDS_ON -> backend.src.models.report.TaskType
- 🔗 DEPENDS_ON -> backend.src.services.reports.normalizer
### 📁 `__tests__/`
- 🏗️ **Layers:** Domain, Domain (Tests), Unknown
- 📊 **Tiers:** STANDARD: 2, TRIVIAL: 25
- 📄 **Files:** 3
- 📦 **Entities:** 27
**Key Entities:**
- 📦 **backend.tests.test_report_normalizer** (Module)
- Validate unknown task type fallback and partial payload norm...
- 📦 **test_report_service** (Module)
- Unit tests for ReportsService list/detail operations
- 📦 **test_type_profiles** (Module) `[TRIVIAL]`
- Auto-generated module for backend/src/services/reports/__tes...
### 📁 `tests/`
- 🏗️ **Layers:** Core, Domain (Tests), Logging (Tests), Test, Unknown
- 📊 **Tiers:** STANDARD: 87, TRIVIAL: 91
- 📄 **Files:** 10
- 📦 **Entities:** 178
**Key Entities:**
- **TestLogPersistence** (Class)
- Test suite for TaskLogPersistenceService.
- **TestTaskContext** (Class)
- Test suite for TaskContext.
- **TestTaskLogger** (Class)
- Test suite for TaskLogger.
- **TestTaskPersistenceHelpers** (Class)
- Test suite for TaskPersistenceService static helper methods.
- **TestTaskPersistenceService** (Class)
- Test suite for TaskPersistenceService CRUD operations.
- 📦 **backend.tests.test_dashboards_api** (Module)
- Comprehensive contract-driven tests for Dashboard Hub API
- 📦 **test_auth** (Module) `[TRIVIAL]`
- Auto-generated module for backend/tests/test_auth.py
- 📦 **test_log_persistence** (Module)
- Unit tests for TaskLogPersistenceService.
- 📦 **test_resource_hubs** (Module) `[TRIVIAL]`
- Auto-generated module for backend/tests/test_resource_hubs.p...
- 📦 **test_smoke_plugins** (Module) `[TRIVIAL]`
- Auto-generated module for backend/tests/test_smoke_plugins.p...
### 📁 `core/`
- 🏗️ **Layers:** Domain, Unknown
- 📊 **Tiers:** STANDARD: 6, TRIVIAL: 46
- 📄 **Files:** 4
- 📦 **Entities:** 52
**Key Entities:**
- 📦 **backend.tests.core.test_git_service_gitea_pr** (Module)
- Validate Gitea PR creation fallback behavior when configured...
- 📦 **backend.tests.core.test_mapping_service** (Module)
- Unit tests for the IdMappingService matching UUIDs to intege...
- 📦 **backend.tests.core.test_migration_engine** (Module)
- Unit tests for MigrationEngine's cross-filter patching algor...
- 📦 **test_defensive_guards** (Module) `[TRIVIAL]`
- Auto-generated module for backend/tests/core/test_defensive_...
### 📁 `migration/`
- 🏗️ **Layers:** Domain
- 📊 **Tiers:** STANDARD: 2, TRIVIAL: 4
- 📄 **Files:** 2
- 📦 **Entities:** 6
**Key Entities:**
- 📦 **backend.tests.core.migration.test_archive_parser** (Module)
- Unit tests for MigrationArchiveParser ZIP extraction contrac...
- 📦 **backend.tests.core.migration.test_dry_run_orchestrator** (Module)
- Unit tests for MigrationDryRunService diff and risk computat...
### 📁 `scripts/`
- 🏗️ **Layers:** Domain, Scripts
- 📊 **Tiers:** STANDARD: 3, TRIVIAL: 18
- 📄 **Files:** 3
- 📦 **Entities:** 21
**Key Entities:**
- 📦 **backend.tests.scripts.test_clean_release_tui** (Module)
- Unit tests for the interactive curses TUI of the clean relea...
- 📦 **test_clean_release_cli** (Module)
- Smoke tests for the redesigned clean release CLI.
- 📦 **test_clean_release_tui_v2** (Module)
- Smoke tests for thin-client TUI action dispatch and blocked ...
### 📁 `clean_release/`
- 🏗️ **Layers:** Tests
- 📊 **Tiers:** STANDARD: 40, TRIVIAL: 16
- 📄 **Files:** 8
- 📦 **Entities:** 56
**Key Entities:**
- **CleanReleaseCompliancePlugin** (Class)
- TaskManager plugin shim that executes clean release complian...
- **_PluginLoaderStub** (Class)
- Provide minimal plugin loader contract used by TaskManager i...
- 📦 **backend.tests.services.clean_release.test_approval_service** (Module)
- Define approval gate contracts for approve/reject operations...
- 📦 **backend.tests.services.clean_release.test_compliance_execution_service** (Module)
- Validate stage pipeline and run finalization contracts for c...
- 📦 **backend.tests.services.clean_release.test_compliance_task_integration** (Module)
- Verify clean release compliance runs execute through TaskMan...
- 📦 **backend.tests.services.clean_release.test_demo_mode_isolation** (Module)
- Verify demo and real mode namespace isolation contracts befo...
- 📦 **backend.tests.services.clean_release.test_policy_resolution_service** (Module)
- Verify trusted policy snapshot resolution contract and error...
- 📦 **backend.tests.services.clean_release.test_publication_service** (Module)
- Define publication gate contracts over approved candidates a...
- 📦 **backend.tests.services.clean_release.test_report_audit_immutability** (Module)
- Validate report snapshot immutability expectations and appen...
- 📦 **test_candidate_manifest_services** (Module)
- Test lifecycle and manifest versioning for release candidate...
**Dependencies:**
- 🔗 DEPENDS_ON -> backend.src.services.clean_release.demo_data_service
- 🔗 DEPENDS_ON -> backend.src.services.clean_release.exceptions
- 🔗 DEPENDS_ON -> backend.src.services.clean_release.policy_resolution_service
- 🔗 DEPENDS_ON -> backend.src.services.clean_release.repository
### 📁 `components/`
- 🏗️ **Layers:** Component, Feature, UI, UI -->, Unknown
- 📊 **Tiers:** STANDARD: 74, TRIVIAL: 13
- 📄 **Files:** 15
- 📦 **Entities:** 87
**Key Entities:**
- 🧩 **DashboardGrid** (Component)
- Displays a grid of dashboards with selection and pagination.
- 🧩 **DashboardGrid** (Component)
- Displays a grid of dashboards with selection and pagination.
- 🧩 **DynamicForm** (Component)
- Generates a form dynamically based on a JSON schema.
- 🧩 **EnvSelector** (Component)
- Provides a UI component for selecting source and target envi...
- 🧩 **Footer** (Component) `[TRIVIAL]`
- Displays the application footer with copyright information.
- 🧩 **MappingTable** (Component)
- Displays and allows editing of database mappings.
- 🧩 **MissingMappingModal** (Component)
- Prompts the user to provide a database mapping when one is m...
- 🧩 **Navbar** (Component)
- Main navigation bar for the application.
- 🧩 **PasswordPrompt** (Component)
- A modal component to prompt the user for database passwords ...
- 🧩 **StartupEnvironmentWizard** (Component)
- Blocking startup wizard for creating the first Superset envi...
**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: 3
- 📄 **Files:** 1
- 📦 **Entities:** 3
**Key Entities:**
- 🧩 **ProtectedRoute** (Component)
- 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: 47, TRIVIAL: 12
- 📄 **Files:** 6
- 📦 **Entities:** 59
**Key Entities:**
- 🧩 **BranchSelector** (Component)
- UI для выбора и создания веток Git.
- 🧩 **CommitHistory** (Component)
- Displays the commit history for a specific dashboard.
- 🧩 **CommitModal** (Component)
- Модальное окно для создания коммита с просмотром изменений (...
- 🧩 **ConflictResolver** (Component)
- UI for resolving merge conflicts (Keep Mine / Keep Theirs).
- 🧩 **DeploymentModal** (Component)
- Modal for deploying a dashboard to a target environment.
- 🧩 **GitManager** (Component)
- Центральный UI управления Git с фокусом на рабочий поток ана...
- 📦 **GitManager** (Module) `[TRIVIAL]`
- Auto-generated module for frontend/src/components/git/GitMan...
### 📁 `__tests__/`
- 🏗️ **Layers:** UI Tests
- 📊 **Tiers:** STANDARD: 1
- 📄 **Files:** 1
- 📦 **Entities:** 1
**Key Entities:**
- 📦 **frontend.src.components.git.__tests__.git_manager_unfinished_merge_integration** (Module)
- Protect unresolved-merge dialog contract in GitManager pull ...
### 📁 `llm/`
- 🏗️ **Layers:** UI, Unknown
- 📊 **Tiers:** 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: 8
- 📄 **Files:** 2
- 📦 **Entities:** 8
**Key Entities:**
- 🧩 **FileList** (Component)
- Displays a table of files with metadata and actions.
- 🧩 **FileUpload** (Component)
- Provides a form for uploading files to a specific category.
**Dependencies:**
- 🔗 DEPENDS_ON -> storageService
### 📁 `tasks/`
- 🏗️ **Layers:** UI, Unknown
- 📊 **Tiers:** STANDARD: 4, TRIVIAL: 12
- 📄 **Files:** 4
- 📦 **Entities:** 16
**Key Entities:**
- 🧩 **LogEntryRow** (Component)
- Renders a single log entry with stacked layout optimized for...
- 🧩 **LogFilterBar** (Component)
- Compact filter toolbar for logs — level, source, and text se...
- 🧩 **TaskLogPanel** (Component)
- Combines log filtering and display into a single cohesive da...
- 📦 **LogFilterBar** (Module) `[TRIVIAL]`
- Auto-generated module for frontend/src/components/tasks/LogF...
- 📦 **TaskLogPanel** (Module) `[TRIVIAL]`
- Auto-generated module for frontend/src/components/tasks/Task...
- 📦 **TaskResultPanel** (Module) `[TRIVIAL]`
- Auto-generated module for frontend/src/components/tasks/Task...
### 📁 `tools/`
- 🏗️ **Layers:** UI, Unknown
- 📊 **Tiers:** STANDARD: 14, TRIVIAL: 2
- 📄 **Files:** 4
- 📦 **Entities:** 16
**Key Entities:**
- 🧩 **ConnectionForm** (Component)
- UI component for creating a new database connection configur...
- 🧩 **ConnectionList** (Component)
- UI component for listing and deleting saved database connect...
- 🧩 **DebugTool** (Component)
- UI component for system diagnostics and debugging API respon...
- 🧩 **MapperTool** (Component)
- UI component for mapping dataset column verbose names using ...
- 📦 **MapperTool** (Module) `[TRIVIAL]`
- Auto-generated module for frontend/src/components/tools/Mapp...
### 📁 `lib/`
- 🏗️ **Layers:** Infra, Infra-API, UI, UI-State
- 📊 **Tiers:** STANDARD: 24, TRIVIAL: 5
- 📄 **Files:** 5
- 📦 **Entities:** 29
**Key Entities:**
- 🧩 **Counter** (Component) `[TRIVIAL]`
- Simple counter demo component
- 📦 **Utils** (Module) `[TRIVIAL]`
- General utility functions (class merging)
- 📦 **api_module** (Module)
- Handles all communication with the backend API.
- 📦 **stores_module** (Module)
- Global state management using Svelte stores.
- 📦 **toasts_module** (Module)
- Manages toast notifications using a Svelte writable store.
### 📁 `api/`
- 🏗️ **Layers:** Infra, Infra-API
- 📊 **Tiers:** CRITICAL: 1, STANDARD: 11
- 📄 **Files:** 2
- 📦 **Entities:** 12
**Key Entities:**
- 📦 **frontend.src.lib.api.assistant** (Module)
- API client wrapper for assistant chat, confirmation actions,...
- 📦 **frontend.src.lib.api.reports** (Module) `[CRITICAL]`
- Wrapper-based reports API client for list/detail retrieval w...
**Dependencies:**
- 🔗 DEPENDS_ON -> DEF:api_module
- 🔗 DEPENDS_ON -> frontend.src.lib.api.api_module
### 📁 `__tests__/`
- 🏗️ **Layers:** Infra (Tests)
- 📊 **Tiers:** STANDARD: 4
- 📄 **Files:** 1
- 📦 **Entities:** 4
**Key Entities:**
- **TestBuildReportQueryString** (Class)
- Validate query string construction from filter options.
- **TestGetReportsAsync** (Class)
- Validate getReports and getReportDetail with mocked api.fetc...
- **TestNormalizeApiError** (Class)
- Validate error normalization for UI-state mapping.
- 📦 **frontend.src.lib.api.__tests__.reports_api** (Module)
- Unit tests for reports API client functions: query string bu...
### 📁 `auth/`
- 🏗️ **Layers:** Domain, Feature
- 📊 **Tiers:** CRITICAL: 2, STANDARD: 9, TRIVIAL: 1
- 📄 **Files:** 2
- 📦 **Entities:** 12
**Key Entities:**
- 📦 **frontend.src.lib.auth.permissions** (Module) `[CRITICAL]`
- Shared frontend RBAC utilities for route guards and menu vis...
- 🗄️ **authStore** (Store) `[CRITICAL]`
- Manages the global authentication state on the frontend.
### 📁 `__tests__/`
- 🏗️ **Layers:** UI (Tests)
- 📊 **Tiers:** STANDARD: 1
- 📄 **Files:** 1
- 📦 **Entities:** 1
**Key Entities:**
- 📦 **frontend.src.lib.auth.__tests__.permissions** (Module)
- Verifies frontend RBAC permission parsing and access checks.
### 📁 `assistant/`
- 🏗️ **Layers:** UI, Unknown
- 📊 **Tiers:** STANDARD: 14, TRIVIAL: 5
- 📄 **Files:** 1
- 📦 **Entities:** 19
**Key Entities:**
- 🧩 **AssistantChatPanel** (Component)
- Slide-out assistant chat panel for natural language command ...
- 📦 **AssistantChatPanel** (Module) `[TRIVIAL]`
- Auto-generated module for frontend/src/lib/components/assist...
### 📁 `__tests__/`
- 🏗️ **Layers:** UI Tests
- 📊 **Tiers:** STANDARD: 5
- 📄 **Files:** 2
- 📦 **Entities:** 5
**Key Entities:**
- 📦 **frontend.src.lib.components.assistant.__tests__.assistant_chat_integration** (Module)
- Contract-level integration checks for assistant chat panel i...
- 📦 **frontend.src.lib.components.assistant.__tests__.assistant_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: 11, TRIVIAL: 50
- 📄 **Files:** 5
- 📦 **Entities:** 61
**Key Entities:**
- 🧩 **Breadcrumbs** (Component)
- Display page hierarchy navigation
- 🧩 **Sidebar** (Component)
- Persistent left sidebar with resource categories navigation
- 🧩 **TaskDrawer** (Component)
- Global task drawer for monitoring background operations
- 🧩 **TopNavbar** (Component)
- Unified top navigation bar with Logo, Search, Activity, and ...
- 📦 **Breadcrumbs** (Module) `[TRIVIAL]`
- Auto-generated module for frontend/src/lib/components/layout...
- 📦 **Sidebar** (Module) `[TRIVIAL]`
- Auto-generated module for frontend/src/lib/components/layout...
- 📦 **TaskDrawer** (Module) `[TRIVIAL]`
- Auto-generated module for frontend/src/lib/components/layout...
- 📦 **TopNavbar** (Module) `[TRIVIAL]`
- Auto-generated module for frontend/src/lib/components/layout...
- 📦 **frontend.src.lib.components.layout.sidebarNavigation** (Module)
- Build sidebar navigation categories filtered by current user...
**Dependencies:**
- 🔗 DEPENDS_ON -> frontend.src.lib.auth.permissions.hasPermission
- 🔗 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: 4, TRIVIAL: 10
- 📄 **Files:** 4
- 📦 **Entities:** 15
**Key Entities:**
- 🧩 **ReportCard** (Component)
- Render one report with explicit textual type label and profi...
- 🧩 **ReportDetailPanel** (Component)
- Display detailed report context with diagnostics and actiona...
- 🧩 **ReportsList** (Component)
- Render unified list of normalized reports with canonical min...
- 📦 **ReportCard** (Module) `[TRIVIAL]`
- Auto-generated module for frontend/src/lib/components/report...
- 📦 **ReportDetailPanel** (Module) `[TRIVIAL]`
- Auto-generated module for frontend/src/lib/components/report...
- 📦 **ReportsList** (Module) `[TRIVIAL]`
- Auto-generated module for frontend/src/lib/components/report...
- 📦 **frontend.src.lib.components.reports.reportTypeProfiles** (Module) `[CRITICAL]`
- Deterministic mapping from report task_type to visual profil...
**Dependencies:**
- 🔗 DEPENDS_ON -> frontend/src/lib/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: 4
- 📄 **Files:** 1
- 📦 **Entities:** 4
**Key Entities:**
- 📦 **i18n** (Module)
- Determines the starting locale.
- 🗄️ **locale** (Store)
- Holds the current active locale string.
- 🗄️ **t** (Store)
- Derived store providing the translation dictionary.
**Dependencies:**
- 🔗 DEPENDS_ON -> locales/en.json
- 🔗 DEPENDS_ON -> locales/ru.json
### 📁 `stores/`
- 🏗️ **Layers:** UI, UI-State, Unknown
- 📊 **Tiers:** CRITICAL: 1, STANDARD: 9, TRIVIAL: 28
- 📄 **Files:** 6
- 📦 **Entities:** 38
**Key Entities:**
- 📦 **environmentContext** (Module) `[TRIVIAL]`
- Auto-generated module for frontend/src/lib/stores/environmen...
- 📦 **health** (Module) `[TRIVIAL]`
- Auto-generated module for frontend/src/lib/stores/health.js
- 📦 **sidebar** (Module) `[TRIVIAL]`
- Auto-generated module for frontend/src/lib/stores/sidebar.js
- 📦 **taskDrawer** (Module) `[TRIVIAL]`
- Auto-generated module for frontend/src/lib/stores/taskDrawer...
- 🗄️ **activity** (Store)
- Track active task count for navbar indicator
- 🗄️ **assistantChat** (Store)
- Control assistant chat panel visibility and active conversat...
- 🗄️ **environmentContext** (Store)
- Global selected environment context for navigation and safet...
- 🗄️ **health_store** (Store)
- Manage dashboard health summary state and failing counts for...
- 🗄️ **sidebar** (Store)
- Manage sidebar visibility and navigation state
- 🗄️ **taskDrawer** (Store) `[CRITICAL]`
- Manage Task Drawer visibility and resource-to-task mapping
**Dependencies:**
- 🔗 DEPENDS_ON -> WebSocket connection, taskDrawer store
- 🔗 DEPENDS_ON -> api.getHealthSummary
### 📁 `__tests__/`
- 🏗️ **Layers:** Domain (Tests), UI, UI Tests
- 📊 **Tiers:** STANDARD: 11
- 📄 **Files:** 6
- 📦 **Entities:** 11
**Key Entities:**
- 📦 **frontend.src.lib.stores.__tests__.assistantChat** (Module)
- Validate assistant chat store visibility and conversation bi...
- 📦 **frontend.src.lib.stores.__tests__.sidebar** (Module)
- Unit tests for sidebar store
- 📦 **frontend.src.lib.stores.__tests__.test_activity** (Module)
- Unit tests for activity store
- 📦 **frontend.src.lib.stores.__tests__.test_sidebar** (Module)
- Unit tests for sidebar store
- 📦 **frontend.src.lib.stores.__tests__.test_taskDrawer** (Module)
- Unit tests for task drawer store
- 📦 **setupTests** (Module)
- Global test setup with mocks for SvelteKit modules
**Dependencies:**
- 🔗 DEPENDS_ON -> assistantChatStore
- 🔗 DEPENDS_ON -> frontend.src.lib.stores.taskDrawer
### 📁 `mocks/`
- 🏗️ **Layers:** UI (Tests)
- 📊 **Tiers:** STANDARD: 4
- 📄 **Files:** 4
- 📦 **Entities:** 4
**Key Entities:**
- 📦 **mock_env_public** (Module)
- Mock for $env/static/public SvelteKit module in vitest
### 📁 `ui/`
- 🏗️ **Layers:** Atom
- 📊 **Tiers:** TRIVIAL: 7
- 📄 **Files:** 7
- 📦 **Entities:** 7
**Key Entities:**
- 🧩 **Button** (Component) `[TRIVIAL]`
- Define component interface and default values (Svelte 5 Rune...
- 🧩 **Card** (Component) `[TRIVIAL]`
- Standardized container with padding and elevation.
- 🧩 **Input** (Component) `[TRIVIAL]`
- Standardized text input component with label and error handl...
- 🧩 **LanguageSwitcher** (Component) `[TRIVIAL]`
- Dropdown component to switch between supported languages.
- 🧩 **PageHeader** (Component) `[TRIVIAL]`
- Standardized page header with title and action area.
- 🧩 **Select** (Component) `[TRIVIAL]`
- Standardized dropdown selection component.
- 📦 **ui** (Module) `[TRIVIAL]`
- Central export point for standardized UI components.
### 📁 `utils/`
- 🏗️ **Layers:** Infra
- 📊 **Tiers:** TRIVIAL: 2
- 📄 **Files:** 1
- 📦 **Entities:** 2
**Key Entities:**
- 📦 **Debounce** (Module) `[TRIVIAL]`
- Debounce utility for limiting function execution rate
### 📁 `pages/`
- 🏗️ **Layers:** UI
- 📊 **Tiers:** STANDARD: 11
- 📄 **Files:** 2
- 📦 **Entities:** 11
**Key Entities:**
- 🧩 **Dashboard** (Component)
- Displays the list of available plugins and allows selecting ...
- 🧩 **Settings** (Component)
- The main settings page for the application, allowing managem...
**Dependencies:**
- 🔗 DEPENDS_ON -> frontend/src/lib/stores.js
### 📁 `routes/`
- 🏗️ **Layers:** Infra, UI, Unknown
- 📊 **Tiers:** CRITICAL: 1, STANDARD: 3, TRIVIAL: 5
- 📄 **Files:** 5
- 📦 **Entities:** 9
**Key Entities:**
- 📦 **+page** (Module) `[TRIVIAL]`
- Auto-generated module for frontend/src/routes/+page.svelte
- 📦 **RootLayoutConfig** (Module) `[TRIVIAL]`
- Root layout configuration (SPA mode)
- 📦 **layout** (Module)
- Bind global layout shell and conditional login/full-app rend...
### 📁 `roles/`
- 🏗️ **Layers:** Domain
- 📊 **Tiers:** STANDARD: 6
- 📄 **Files:** 1
- 📦 **Entities:** 6
**Key Entities:**
- 🧩 **AdminRolesPage** (Component)
- UI for managing system roles and their permissions.
**Dependencies:**
- 🔗 DEPENDS_ON -> frontend.src.components.auth.ProtectedRoute
- 🔗 DEPENDS_ON -> frontend.src.services.adminService
### 📁 `settings/`
- 🏗️ **Layers:** Feature
- 📊 **Tiers:** STANDARD: 5
- 📄 **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:** STANDARD: 6
- 📄 **Files:** 1
- 📦 **Entities:** 6
**Key Entities:**
- 🧩 **AdminUsersPage** (Component)
- 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: 26, TRIVIAL: 66
- 📄 **Files:** 1
- 📦 **Entities:** 92
**Key Entities:**
- 📦 **+page** (Module) `[TRIVIAL]`
- Auto-generated module for frontend/src/routes/dashboards/+pa...
### 📁 `[id]/`
- 🏗️ **Layers:** UI, Unknown
- 📊 **Tiers:** STANDARD: 1, TRIVIAL: 28
- 📄 **Files:** 1
- 📦 **Entities:** 29
**Key Entities:**
- 📦 **+page** (Module) `[TRIVIAL]`
- Auto-generated module for frontend/src/routes/dashboards/[id...
### 📁 `__tests__/`
- 🏗️ **Layers:** UI (Tests)
- 📊 **Tiers:** STANDARD: 1, TRIVIAL: 2
- 📄 **Files:** 1
- 📦 **Entities:** 3
**Key Entities:**
- 📦 **frontend.src.routes.dashboards.__tests__.dashboard_profile_override_integration** (Module)
- Verifies temporary show-all override and restore-on-return b...
### 📁 `health/`
- 🏗️ **Layers:** UI/Page
- 📊 **Tiers:** STANDARD: 4
- 📄 **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:** STANDARD: 3
- 📄 **Files:** 1
- 📦 **Entities:** 3
**Key Entities:**
- 🧩 **GitDashboardPage** (Component)
- Dashboard management page for Git integration.
### 📁 `login/`
- 🏗️ **Layers:** UI
- 📊 **Tiers:** STANDARD: 3
- 📄 **Files:** 1
- 📦 **Entities:** 3
**Key Entities:**
- 🧩 **LoginPage** (Component)
- Provides the user interface for local and ADFS authenticatio...
### 📁 `migration/`
- 📊 **Tiers:** STANDARD: 21
- 📄 **Files:** 1
- 📦 **Entities:** 21
**Key Entities:**
- 🧩 **DashboardSelectionSection** (Component)
- 🧩 **MigrationDashboard** (Component)
- Orchestrate migration UI workflow and route user actions to ...
### 📁 `mappings/`
- 📊 **Tiers:** CRITICAL: 1, STANDARD: 7
- 📄 **Files:** 1
- 📦 **Entities:** 8
**Key Entities:**
- 🗄️ **UiState** (Store) `[CRITICAL]`
- Maintain local page state for environments, fetched database...
### 📁 `profile/`
- 🏗️ **Layers:** Unknown
- 📊 **Tiers:** TRIVIAL: 16
- 📄 **Files:** 1
- 📦 **Entities:** 16
**Key Entities:**
- 📦 **+page** (Module) `[TRIVIAL]`
- Auto-generated module for frontend/src/routes/profile/+page....
### 📁 `__tests__/`
- 🏗️ **Layers:** UI (Tests)
- 📊 **Tiers:** STANDARD: 2
- 📄 **Files:** 2
- 📦 **Entities:** 2
**Key Entities:**
- 📦 **frontend.src.routes.profile.__tests__.profile_preferences_integration** (Module)
- Verifies profile binding happy path and degraded lookup manu...
- 📦 **frontend.src.routes.profile.__tests__.profile_settings_state_integration** (Module)
- Verifies profile settings preload, cancel without persistenc...
### 📁 `fixtures/`
- 📊 **Tiers:** TRIVIAL: 1
- 📄 **Files:** 1
- 📦 **Entities:** 1
**Key Entities:**
- 📦 **frontend.src.routes.profile.__tests__.fixtures.profile_fixtures** (Module) `[TRIVIAL]`
- Shared fixture placeholders for profile page integration tes...
### 📁 `reports/`
- 🏗️ **Layers:** UI, Unknown
- 📊 **Tiers:** CRITICAL: 1, TRIVIAL: 7
- 📄 **Files:** 1
- 📦 **Entities:** 8
**Key Entities:**
- 🧩 **UnifiedReportsPage** (Component) `[CRITICAL]`
- Unified reports page with filtering and resilient UX states ...
- 📦 **+page** (Module) `[TRIVIAL]`
- Auto-generated module for frontend/src/routes/reports/+page....
**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, STANDARD: 1, TRIVIAL: 33
- 📄 **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:** STANDARD: 2
- 📄 **Files:** 1
- 📦 **Entities:** 2
**Key Entities:**
- 🧩 **ConnectionsSettingsPage** (Component)
- Page for managing database connection configurations.
### 📁 `git/`
- 🏗️ **Layers:** Page
- 📊 **Tiers:** STANDARD: 10
- 📄 **Files:** 1
- 📦 **Entities:** 10
**Key Entities:**
- 🧩 **GitSettingsPage** (Component)
- Manage Git server configurations for dashboard versioning.
### 📁 `__tests__/`
- 📊 **Tiers:** STANDARD: 1
- 📄 **Files:** 1
- 📦 **Entities:** 1
**Key Entities:**
- 📦 **frontend.src.routes.settings.git.__tests__.git_settings_page_ux_test** (Module)
- Test UX states and transitions for the Git Settings page
### 📁 `notifications/`
- 🏗️ **Layers:** UI, Unknown
- 📊 **Tiers:** STANDARD: 1, TRIVIAL: 3
- 📄 **Files:** 1
- 📦 **Entities:** 4
**Key Entities:**
- 🧩 **NotificationSettingsPage** (Component)
- Manage global notification provider configurations (SMTP, Te...
- 📦 **+page** (Module) `[TRIVIAL]`
- Auto-generated module for frontend/src/routes/settings/notif...
### 📁 `storage/`
- 🏗️ **Layers:** Page
- 📊 **Tiers:** TRIVIAL: 1
- 📄 **Files:** 1
- 📦 **Entities:** 1
### 📁 `repos/`
- 📊 **Tiers:** STANDARD: 4
- 📄 **Files:** 1
- 📦 **Entities:** 4
### 📁 `debug/`
- 🏗️ **Layers:** UI
- 📊 **Tiers:** TRIVIAL: 1
- 📄 **Files:** 1
- 📦 **Entities:** 1
**Key Entities:**
- 🧩 **DebugPage** (Component) `[TRIVIAL]`
- Page for system diagnostics and debugging.
### 📁 `mapper/`
- 🏗️ **Layers:** UI
- 📊 **Tiers:** TRIVIAL: 1
- 📄 **Files:** 1
- 📦 **Entities:** 1
**Key Entities:**
- 🧩 **MapperPage** (Component) `[TRIVIAL]`
- Page for the dataset column mapper tool.
### 📁 `storage/`
- 🏗️ **Layers:** UI
- 📊 **Tiers:** STANDARD: 7
- 📄 **Files:** 1
- 📦 **Entities:** 7
**Key Entities:**
- 🧩 **StoragePage** (Component)
- Main page for unified file storage management.
**Dependencies:**
- 🔗 DEPENDS_ON -> storageService
### 📁 `services/`
- 🏗️ **Layers:** Service
- 📊 **Tiers:** STANDARD: 35, TRIVIAL: 1
- 📄 **Files:** 6
- 📦 **Entities:** 36
**Key Entities:**
- 📦 **GitServiceClient** (Module)
- API client for Git operations, managing the communication be...
- 📦 **adminService** (Module)
- Service for Admin-related API calls (User and Role managemen...
- 📦 **storageService** (Module)
- Frontend API client for file storage management.
**Dependencies:**
- 🔗 DEPENDS_ON -> frontend.src.lib.api
- 🔗 DEPENDS_ON -> specs/011-git-integration-dashboard/contracts/api.md
### 📁 `__tests__/`
- 📊 **Tiers:** STANDARD: 1
- 📄 **Files:** 1
- 📦 **Entities:** 1
**Key Entities:**
- 📦 **frontend.src.services.__tests__.gitService_test** (Module)
- API client tests ensuring correct endpoints are called per c...
### 📁 `types/`
- 🏗️ **Layers:** Domain
- 📊 **Tiers:** TRIVIAL: 1
- 📄 **Files:** 1
- 📦 **Entities:** 1
**Key Entities:**
- 📦 **DashboardTypes** (Module) `[TRIVIAL]`
- TypeScript interfaces for Dashboard entities
### 📁 `root/`
- 🏗️ **Layers:** DevOps/Tooling
- 📊 **Tiers:** CRITICAL: 11, STANDARD: 18, TRIVIAL: 8
- 📄 **Files:** 1
- 📦 **Entities:** 37
**Key Entities:**
- **ComplianceIssue** (Class) `[TRIVIAL]`
- Represents a single compliance issue with severity.
- **SemanticEntity** (Class) `[CRITICAL]`
- Represents a code entity (Module, Function, Component) found...
- **SemanticMapGenerator** (Class) `[CRITICAL]`
- Orchestrates the mapping process with tier-based validation.
- **Severity** (Class) `[TRIVIAL]`
- Severity levels for compliance issues.
- **Tier** (Class) `[TRIVIAL]`
- Enumeration of semantic tiers defining validation strictness...
- 📦 **generate_semantic_map** (Module)
- Scans the codebase to generate a Semantic Map, Module Map, a...
## Cross-Module Dependencies
```mermaid
graph TD
api-->|USES|backend
api-->|USES|backend
routes-->|DEPENDS_ON|backend
routes-->|DEPENDS_ON|backend
routes-->|DEPENDS_ON|backend
routes-->|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-->|USES|backend
routes-->|USES|backend
routes-->|CALLS|backend
routes-->|CALLS|backend
routes-->|CALLS|backend
routes-->|CALLS|backend
routes-->|CALLS|backend
routes-->|DEPENDS_ON|backend
routes-->|DEPENDS_ON|backend
routes-->|DEPENDS_ON|backend
routes-->|DEPENDS_ON|backend
routes-->|CALLS|root
routes-->|DEPENDS_ON|backend
routes-->|DEPENDS_ON|backend
routes-->|DEPENDS_ON|backend
routes-->|DEPENDS_ON|backend
routes-->|DEPENDS_ON|backend
routes-->|DEPENDS_ON|backend
routes-->|DEPENDS_ON|backend
routes-->|DEPENDS_ON|backend
routes-->|DEPENDS_ON|backend
routes-->|DEPENDS_ON|backend
__tests__-->|TESTS|backend
__tests__-->|TESTS|backend
__tests__-->|TESTS|backend
__tests__-->|TESTS|backend
__tests__-->|TESTS|backend
__tests__-->|TESTS|backend
__tests__-->|TESTS|backend
__tests__-->|TESTS|backend
__tests__-->|DEPENDS_ON|backend
__tests__-->|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-->|DEPENDS_ON|backend
__tests__-->|TESTS|backend
auth-->|USES|backend
auth-->|USES|backend
auth-->|USES|backend
auth-->|DEPENDS_ON|backend
auth-->|DEPENDS_ON|backend
auth-->|DEPENDS_ON|backend
migration-->|DEPENDS_ON|backend
migration-->|DEPENDS_ON|backend
migration-->|DEPENDS_ON|backend
migration-->|DEPENDS_ON|backend
migration-->|DEPENDS_ON|backend
migration-->|DEPENDS_ON|backend
migration-->|DISPATCHES|backend
utils-->|DEPENDS_ON|backend
utils-->|DEPENDS_ON|backend
utils-->|DEPENDS_ON|backend
utils-->|DEPENDS_ON|backend
models-->|DEPENDS_ON|backend
models-->|INHERITS_FROM|backend
models-->|DEPENDS_ON|backend
models-->|DEPENDS_ON|backend
models-->|USED_BY|backend
models-->|INHERITS_FROM|backend
models-->|DEPENDS_ON|backend
models-->|INHERITS_FROM|backend
__tests__-->|TESTS|backend
llm_analysis-->|IMPLEMENTS|backend
llm_analysis-->|IMPLEMENTS|backend
storage-->|DEPENDS_ON|backend
scripts-->|USES|backend
scripts-->|USES|backend
scripts-->|DEPENDS_ON|backend
scripts-->|DEPENDS_ON|backend
scripts-->|READS_FROM|backend
scripts-->|READS_FROM|backend
scripts-->|USES|backend
scripts-->|USES|backend
scripts-->|CALLS|backend
scripts-->|USES|backend
scripts-->|USES|backend
scripts-->|USES|backend
services-->|DEPENDS_ON|backend
services-->|DEPENDS_ON|backend
services-->|DEPENDS_ON|backend
services-->|DEPENDS_ON|backend
services-->|DEPENDS_ON|backend
services-->|DEPENDS_ON|backend
services-->|DEPENDS_ON|backend
services-->|DEPENDS_ON|backend
services-->|DEPENDS_ON|backend
services-->|DEPENDS_ON|backend
services-->|DEPENDS_ON|backend
services-->|CALLS|backend
services-->|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-->|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
```