Files
ss-tools/.ai/MODULE_MAP.md

1416 lines
48 KiB
Markdown
Raw Permalink 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-02-23T14:44:08.540853
## Summary
- **Total Modules:** 70
- **Total Entities:** 1337
## Module Hierarchy
### 📁 `shots/`
- 🏗️ **Layers:** Domain (Business Logic), Domain (Core), Interface (API), UI (Presentation)
- 📊 **Tiers:** CRITICAL: 2, STANDARD: 7, TRIVIAL: 1
- 📄 **Files:** 4
- 📦 **Entities:** 10
**Key Entities:**
- 🧩 **FrontendComponentShot** (Component) `[CRITICAL]`
- Action button to spawn a new task with full UX feedback cycl...
- 📦 **BackendRouteShot** (Module)
- Reference implementation of a task-based route using GRACE-P...
- 📦 **PluginExampleShot** (Module)
- Reference implementation of a plugin following GRACE standar...
- 📦 **TransactionCore** (Module) `[CRITICAL]`
- Core banking transaction processor with ACID guarantees.
**Dependencies:**
- 🔗 DEPENDS_ON -> [DEF:Infra:AuditLog]
- 🔗 DEPENDS_ON -> [DEF:Infra:PostgresDB]
- 🔗 IMPLEMENTS -> [DEF:Std:API_FastAPI]
- 🔗 INHERITS -> PluginBase
### 📁 `backend/`
- 🏗️ **Layers:** Unknown, Utility
- 📊 **Tiers:** STANDARD: 2, TRIVIAL: 2
- 📄 **Files:** 2
- 📦 **Entities:** 4
**Key Entities:**
- 📦 **backend.delete_running_tasks** (Module)
- Script to delete tasks with RUNNING status from the database...
- 📦 **test_auth_debug** (Module) `[TRIVIAL]`
- Auto-generated module for backend/test_auth_debug.py
### 📁 `src/`
- 🏗️ **Layers:** API, Core, UI (API)
- 📊 **Tiers:** CRITICAL: 2, STANDARD: 18, TRIVIAL: 3
- 📄 **Files:** 2
- 📦 **Entities:** 23
**Key Entities:**
- 📦 **AppModule** (Module) `[CRITICAL]`
- The main entry point for the FastAPI application. It initial...
- 📦 **Dependencies** (Module)
- Manages creation and provision of shared application depende...
### 📁 `api/`
- 🏗️ **Layers:** API
- 📊 **Tiers:** STANDARD: 7
- 📄 **Files:** 1
- 📦 **Entities:** 7
**Key Entities:**
- 📦 **backend.src.api.auth** (Module)
- Authentication API endpoints.
### 📁 `routes/`
- 🏗️ **Layers:** API, UI (API), Unknown
- 📊 **Tiers:** CRITICAL: 2, STANDARD: 140, TRIVIAL: 3
- 📄 **Files:** 16
- 📦 **Entities:** 145
**Key Entities:**
- **BranchCheckout** (Class)
- Schema for branch checkout requests.
- **BranchCreate** (Class)
- Schema for branch creation requests.
- **BranchSchema** (Class)
- Schema for representing a Git branch metadata.
- **CommitCreate** (Class)
- Schema for staging and committing changes.
- **CommitSchema** (Class)
- Schema for representing Git commit details.
- **ConflictResolution** (Class)
- Schema for resolving merge conflicts.
- **ConnectionCreate** (Class)
- Pydantic model for creating a connection.
- **ConnectionSchema** (Class)
- Pydantic model for connection response.
- **ConsolidatedSettingsResponse** (Class)
- **DeployRequest** (Class)
- Schema for dashboard deployment requests.
**Dependencies:**
- 🔗 DEPENDS_ON -> ConfigManager
- 🔗 DEPENDS_ON -> ConfigModels
- 🔗 DEPENDS_ON -> backend.src.core.database
- 🔗 DEPENDS_ON -> backend.src.core.superset_client
- 🔗 DEPENDS_ON -> backend.src.dependencies
### 📁 `__tests__/`
- 🏗️ **Layers:** API, Domain (Tests)
- 📊 **Tiers:** CRITICAL: 3, STANDARD: 16, TRIVIAL: 22
- 📄 **Files:** 5
- 📦 **Entities:** 41
**Key Entities:**
- 📦 **backend.src.api.routes.__tests__.test_dashboards** (Module)
- Unit tests for Dashboards API endpoints
- 📦 **backend.src.api.routes.__tests__.test_datasets** (Module)
- Unit tests for Datasets API endpoints
- 📦 **backend.tests.test_reports_api** (Module) `[CRITICAL]`
- Contract tests for GET /api/reports defaults, pagination, an...
- 📦 **backend.tests.test_reports_detail_api** (Module) `[CRITICAL]`
- Contract tests for GET /api/reports/{report_id} detail endpo...
- 📦 **backend.tests.test_reports_openapi_conformance** (Module) `[CRITICAL]`
- Validate implemented reports payload shape against OpenAPI-r...
### 📁 `core/`
- 🏗️ **Layers:** Core
- 📊 **Tiers:** STANDARD: 112, TRIVIAL: 1
- 📄 **Files:** 9
- 📦 **Entities:** 113
**Key Entities:**
- **AuthSessionLocal** (Class)
- A session factory for the authentication database.
- **BeliefFormatter** (Class)
- Custom logging formatter that adds belief state prefixes to ...
- **ConfigManager** (Class)
- A class to handle application configuration persistence and ...
- **LogEntry** (Class)
- A Pydantic model representing a single, structured log entry...
- **MigrationEngine** (Class)
- Engine for transforming Superset export ZIPs.
- **PluginBase** (Class)
- Defines the abstract base class that all plugins must implem...
- **PluginConfig** (Class)
- A Pydantic model used to represent the validated configurati...
- **PluginLoader** (Class)
- Scans a specified directory for Python modules, dynamically ...
- **SchedulerService** (Class)
- Provides a service to manage scheduled backup tasks.
- **SessionLocal** (Class)
- A session factory for the main mappings database.
**Dependencies:**
- 🔗 DEPENDS_ON -> AppConfigRecord
- 🔗 DEPENDS_ON -> ConfigModels
- 🔗 DEPENDS_ON -> PyYAML
- 🔗 DEPENDS_ON -> sqlalchemy
### 📁 `auth/`
- 🏗️ **Layers:** Core
- 📊 **Tiers:** STANDARD: 26
- 📄 **Files:** 6
- 📦 **Entities:** 26
**Key Entities:**
- **AuthConfig** (Class)
- Holds authentication-related settings.
- **AuthRepository** (Class)
- Encapsulates database operations for authentication.
- 📦 **backend.src.core.auth.config** (Module)
- Centralized configuration for authentication and authorizati...
- 📦 **backend.src.core.auth.jwt** (Module)
- JWT token generation and validation logic.
- 📦 **backend.src.core.auth.logger** (Module)
- Audit logging for security-related events.
- 📦 **backend.src.core.auth.oauth** (Module)
- ADFS OIDC configuration and client using Authlib.
- 📦 **backend.src.core.auth.repository** (Module)
- Data access layer for authentication-related entities.
- 📦 **backend.src.core.auth.security** (Module)
- Utility for password hashing and verification using Passlib.
**Dependencies:**
- 🔗 DEPENDS_ON -> authlib
- 🔗 DEPENDS_ON -> jose
- 🔗 DEPENDS_ON -> passlib
- 🔗 DEPENDS_ON -> pydantic
- 🔗 DEPENDS_ON -> sqlalchemy
### 📁 `__tests__/`
- 🏗️ **Layers:** Domain
- 📊 **Tiers:** STANDARD: 1, TRIVIAL: 9
- 📄 **Files:** 1
- 📦 **Entities:** 10
**Key Entities:**
- 📦 **test_auth** (Module)
- Unit tests for authentication module
### 📁 `__tests__/`
- 🏗️ **Layers:** Infra
- 📊 **Tiers:** STANDARD: 9
- 📄 **Files:** 1
- 📦 **Entities:** 9
**Key Entities:**
- 📦 **test_logger** (Module)
- Unit tests for logger module
### 📁 `task_manager/`
- 🏗️ **Layers:** Core
- 📊 **Tiers:** CRITICAL: 7, STANDARD: 63, TRIVIAL: 8
- 📄 **Files:** 7
- 📦 **Entities:** 78
**Key Entities:**
- **LogEntry** (Class) `[CRITICAL]`
- A Pydantic model representing a single, structured log entry...
- **LogFilter** (Class)
- Filter parameters for querying task logs.
- **LogStats** (Class)
- Statistics about log entries for a task.
- **Task** (Class)
- A Pydantic model representing a single execution instance of...
- **TaskCleanupService** (Class)
- Provides methods to clean up old task records and their asso...
- **TaskContext** (Class) `[CRITICAL]`
- A container passed to plugin.execute() providing the logger ...
- **TaskLog** (Class)
- A Pydantic model representing a persisted log entry from the...
- **TaskLogPersistenceService** (Class) `[CRITICAL]`
- Provides methods to save and query task logs from the task_l...
- **TaskLogger** (Class) `[CRITICAL]`
- A wrapper around TaskManager._add_log that carries task_id a...
- **TaskManager** (Class) `[CRITICAL]`
- Manages the lifecycle of tasks, including their creation, ex...
**Dependencies:**
- 🔗 DEPENDS_ON -> TaskLogRecord
- 🔗 DEPENDS_ON -> TaskLogger, USED_BY -> plugins
- 🔗 DEPENDS_ON -> TaskManager, CALLS -> TaskManager._add_log
### 📁 `utils/`
- 🏗️ **Layers:** Core, Domain, Infra
- 📊 **Tiers:** STANDARD: 48, TRIVIAL: 1
- 📄 **Files:** 4
- 📦 **Entities:** 49
**Key Entities:**
- **APIClient** (Class)
- Инкапсулирует HTTP-логику для работы с API, включая сессии, ...
- **AuthenticationError** (Class)
- Exception raised when authentication fails.
- **DashboardNotFoundError** (Class)
- Exception raised when a dashboard cannot be found.
- **DatasetMapper** (Class)
- Класс для меппинга и обновления verbose_map в датасетах Supe...
- **InvalidZipFormatError** (Class)
- Exception raised when a file is not a valid ZIP archive.
- **NetworkError** (Class)
- Exception raised when a network level error occurs.
- **PermissionDeniedError** (Class)
- Exception raised when access is denied.
- **SupersetAPIError** (Class)
- Base exception for all Superset API related errors.
- 📦 **backend.core.utils.dataset_mapper** (Module)
- Этот модуль отвечает за обновление метаданных (verbose_map) ...
- 📦 **backend.core.utils.fileio** (Module)
- Предоставляет набор утилит для управления файловыми операция...
**Dependencies:**
- 🔗 DEPENDS_ON -> backend.core.superset_client
- 🔗 DEPENDS_ON -> backend.src.core.logger
- 🔗 DEPENDS_ON -> pandas
- 🔗 DEPENDS_ON -> psycopg2
- 🔗 DEPENDS_ON -> pyyaml
### 📁 `models/`
- 🏗️ **Layers:** Domain, Model
- 📊 **Tiers:** CRITICAL: 2, STANDARD: 24, TRIVIAL: 21
- 📄 **Files:** 10
- 📦 **Entities:** 47
**Key Entities:**
- **ADGroupMapping** (Class)
- Maps an Active Directory group to a local System Role.
- **AppConfigRecord** (Class)
- Stores the single source of truth for application configurat...
- **ConnectionConfig** (Class) `[TRIVIAL]`
- Stores credentials for external databases used for column ma...
- **DashboardMetadata** (Class) `[TRIVIAL]`
- Represents a dashboard available for migration.
- **DashboardSelection** (Class) `[TRIVIAL]`
- Represents the user's selection of dashboards to migrate.
- **DatabaseMapping** (Class)
- Represents a mapping between source and target databases.
- **DeploymentEnvironment** (Class) `[TRIVIAL]`
- Target Superset environments for dashboard deployment.
- **Environment** (Class)
- Represents a Superset instance environment.
- **ErrorContext** (Class)
- Error and recovery context for failed/partial reports.
- **FileCategory** (Class) `[TRIVIAL]`
- Enumeration of supported file categories in the storage syst...
**Dependencies:**
- 🔗 DEPENDS_ON -> Role
- 🔗 DEPENDS_ON -> TaskRecord
- 🔗 DEPENDS_ON -> backend.src.core.task_manager.models
- 🔗 DEPENDS_ON -> sqlalchemy
### 📁 `__tests__/`
- 🏗️ **Layers:** Domain
- 📊 **Tiers:** STANDARD: 1, TRIVIAL: 1
- 📄 **Files:** 1
- 📦 **Entities:** 2
**Key Entities:**
- 📦 **test_models** (Module) `[TRIVIAL]`
- Unit tests for data models
### 📁 `plugins/`
- 🏗️ **Layers:** App, Plugin, Plugins
- 📊 **Tiers:** STANDARD: 63
- 📄 **Files:** 6
- 📦 **Entities:** 63
**Key Entities:**
- **BackupPlugin** (Class)
- Implementation of the backup plugin logic.
- **DebugPlugin** (Class)
- Plugin for system diagnostics and debugging.
- **GitPlugin** (Class)
- Реализация плагина Git Integration для управления версиями д...
- **MapperPlugin** (Class)
- Plugin for mapping dataset columns verbose names.
- **MigrationPlugin** (Class)
- Implementation of the migration plugin logic.
- **SearchPlugin** (Class)
- Plugin for searching text patterns in Superset datasets.
- 📦 **BackupPlugin** (Module)
- A plugin that provides functionality to back up Superset das...
- 📦 **DebugPluginModule** (Module)
- Implements a plugin for system diagnostics and debugging Sup...
- 📦 **MapperPluginModule** (Module)
- Implements a plugin for mapping dataset columns using extern...
- 📦 **MigrationPlugin** (Module)
- A plugin that provides functionality to migrate Superset das...
**Dependencies:**
- 🔗 DEPENDS_ON -> superset_tool.client
- 🔗 DEPENDS_ON -> superset_tool.utils
- 🔗 IMPLEMENTS -> PluginBase
### 📁 `git/`
- 🏗️ **Layers:** Unknown
- 📊 **Tiers:** STANDARD: 2, TRIVIAL: 2
- 📄 **Files:** 1
- 📦 **Entities:** 4
**Key Entities:**
- **GitLLMExtension** (Class)
- Provides LLM capabilities to the Git plugin.
- 📦 **llm_extension** (Module) `[TRIVIAL]`
- Auto-generated module for backend/src/plugins/git/llm_extens...
### 📁 `llm_analysis/`
- 🏗️ **Layers:** Unknown
- 📊 **Tiers:** STANDARD: 18, TRIVIAL: 23
- 📄 **Files:** 4
- 📦 **Entities:** 41
**Key Entities:**
- **DashboardValidationPlugin** (Class)
- Plugin for automated dashboard health analysis using LLMs.
- **DetectedIssue** (Class)
- Model for a single issue detected during validation.
- **DocumentationPlugin** (Class)
- Plugin for automated dataset documentation using LLMs.
- **LLMClient** (Class)
- Wrapper for LLM provider APIs.
- **LLMProviderConfig** (Class)
- Configuration for an LLM provider.
- **LLMProviderType** (Class)
- Enum for supported LLM providers.
- **ScreenshotService** (Class)
- Handles capturing screenshots of Superset dashboards.
- **ValidationResult** (Class)
- Model for dashboard validation result.
- **ValidationStatus** (Class)
- Enum for dashboard validation status.
- 📦 **plugin** (Module) `[TRIVIAL]`
- Auto-generated module for backend/src/plugins/llm_analysis/p...
**Dependencies:**
- 🔗 IMPLEMENTS -> backend.src.core.plugin_base.PluginBase
### 📁 `storage/`
- 🏗️ **Layers:** App
- 📊 **Tiers:** STANDARD: 18
- 📄 **Files:** 1
- 📦 **Entities:** 18
**Key Entities:**
- **StoragePlugin** (Class)
- Implementation of the storage management plugin.
- 📦 **StoragePlugin** (Module)
- Provides core filesystem operations for managing backups and...
**Dependencies:**
- 🔗 DEPENDS_ON -> backend.src.models.storage
- 🔗 IMPLEMENTS -> PluginBase
### 📁 `schemas/`
- 🏗️ **Layers:** API
- 📊 **Tiers:** STANDARD: 10, TRIVIAL: 3
- 📄 **Files:** 1
- 📦 **Entities:** 13
**Key Entities:**
- **ADGroupMappingCreate** (Class)
- Schema for creating an AD Group mapping.
- **ADGroupMappingSchema** (Class)
- Represents an AD Group to Role mapping in API responses.
- **PermissionSchema** (Class) `[TRIVIAL]`
- Represents a permission in API responses.
- **RoleCreate** (Class)
- Schema for creating a new role.
- **RoleSchema** (Class)
- Represents a role in API responses.
- **RoleUpdate** (Class)
- Schema for updating an existing role.
- **Token** (Class) `[TRIVIAL]`
- Represents a JWT access token response.
- **TokenData** (Class) `[TRIVIAL]`
- Represents the data encoded in a JWT token.
- **User** (Class)
- Schema for user data in API responses.
- **UserBase** (Class)
- Base schema for user data.
**Dependencies:**
- 🔗 DEPENDS_ON -> pydantic
### 📁 `scripts/`
- 🏗️ **Layers:** Scripts, Unknown
- 📊 **Tiers:** STANDARD: 17, TRIVIAL: 2
- 📄 **Files:** 5
- 📦 **Entities:** 19
**Key Entities:**
- 📦 **backend.src.scripts.create_admin** (Module)
- CLI tool for creating the initial admin user.
- 📦 **backend.src.scripts.init_auth_db** (Module)
- Initializes the auth database and creates the necessary tabl...
- 📦 **backend.src.scripts.migrate_sqlite_to_postgres** (Module)
- Migrates legacy config and task history from SQLite/file sto...
- 📦 **backend.src.scripts.seed_permissions** (Module)
- Populates the auth database with initial system permissions.
- 📦 **test_dataset_dashboard_relations** (Module) `[TRIVIAL]`
- Auto-generated module for backend/src/scripts/test_dataset_d...
### 📁 `services/`
- 🏗️ **Layers:** Core, Domain, Service
- 📊 **Tiers:** CRITICAL: 1, STANDARD: 50, TRIVIAL: 5
- 📄 **Files:** 6
- 📦 **Entities:** 56
**Key Entities:**
- **AuthService** (Class)
- Provides high-level authentication services.
- **EncryptionManager** (Class) `[CRITICAL]`
- Handles encryption and decryption of sensitive data like API...
- **GitService** (Class)
- Wrapper for GitPython operations with semantic logging and e...
- **LLMProviderService** (Class)
- Service to manage LLM provider lifecycle.
- **MappingService** (Class)
- Service for handling database mapping logic.
- **ResourceService** (Class)
- Provides centralized access to resource data with enhanced m...
- 📦 **backend.src.services** (Module)
- Package initialization for services module
- 📦 **backend.src.services.auth_service** (Module)
- Orchestrates authentication business logic.
- 📦 **backend.src.services.git_service** (Module)
- Core Git logic using GitPython to manage dashboard repositor...
- 📦 **backend.src.services.llm_provider** (Module)
- Service for managing LLM provider configurations with encryp...
**Dependencies:**
- 🔗 DEPENDS_ON -> backend.src.core.database
- 🔗 DEPENDS_ON -> backend.src.core.superset_client
- 🔗 DEPENDS_ON -> backend.src.core.task_manager
- 🔗 DEPENDS_ON -> backend.src.core.utils.matching
- 🔗 DEPENDS_ON -> backend.src.models.llm
### 📁 `__tests__/`
- 🏗️ **Layers:** Service
- 📊 **Tiers:** STANDARD: 7
- 📄 **Files:** 1
- 📦 **Entities:** 7
**Key Entities:**
- 📦 **backend.src.services.__tests__.test_resource_service** (Module)
- Unit tests for ResourceService
### 📁 `reports/`
- 🏗️ **Layers:** Domain
- 📊 **Tiers:** CRITICAL: 5, STANDARD: 15
- 📄 **Files:** 3
- 📦 **Entities:** 20
**Key Entities:**
- **ReportsService** (Class) `[CRITICAL]`
- Service layer for list/detail report retrieval and normaliza...
- 📦 **backend.src.services.reports.normalizer** (Module) `[CRITICAL]`
- Convert task manager task objects into canonical unified Tas...
- 📦 **backend.src.services.reports.report_service** (Module) `[CRITICAL]`
- Aggregate, normalize, filter, and paginate task reports for ...
- 📦 **backend.src.services.reports.type_profiles** (Module) `[CRITICAL]`
- Deterministic mapping of plugin/task identifiers to canonica...
**Dependencies:**
- 🔗 DEPENDS_ON -> backend.src.core.task_manager.manager.TaskManager
- 🔗 DEPENDS_ON -> backend.src.core.task_manager.models.Task
- 🔗 DEPENDS_ON -> backend.src.models.report
- 🔗 DEPENDS_ON -> backend.src.models.report.TaskType
- 🔗 DEPENDS_ON -> backend.src.services.reports.normalizer
### 📁 `__tests__/`
- 🏗️ **Layers:** Domain (Tests)
- 📊 **Tiers:** CRITICAL: 1, TRIVIAL: 2
- 📄 **Files:** 1
- 📦 **Entities:** 3
**Key Entities:**
- 📦 **backend.tests.test_report_normalizer** (Module) `[CRITICAL]`
- Validate unknown task type fallback and partial payload norm...
### 📁 `tests/`
- 🏗️ **Layers:** Domain (Tests), Test, Unknown
- 📊 **Tiers:** STANDARD: 54, TRIVIAL: 19
- 📄 **Files:** 7
- 📦 **Entities:** 73
**Key Entities:**
- **TestLogPersistence** (Class)
- Test suite for TaskLogPersistenceService.
- **TestTaskContext** (Class)
- Test suite for TaskContext.
- **TestTaskLogger** (Class)
- Test suite for TaskLogger.
- 📦 **backend.tests.test_dashboards_api** (Module)
- Contract-driven tests for Dashboard Hub API
- 📦 **test_auth** (Module) `[TRIVIAL]`
- Auto-generated module for backend/tests/test_auth.py
- 📦 **test_log_persistence** (Module)
- Unit tests for TaskLogPersistenceService.
- 📦 **test_resource_hubs** (Module) `[TRIVIAL]`
- Auto-generated module for backend/tests/test_resource_hubs.p...
- 📦 **test_task_logger** (Module)
- Unit tests for TaskLogger and TaskContext.
### 📁 `components/`
- 🏗️ **Layers:** Component, Feature, UI, Unknown
- 📊 **Tiers:** CRITICAL: 1, STANDARD: 45, TRIVIAL: 7
- 📄 **Files:** 13
- 📦 **Entities:** 53
**Key Entities:**
- 🧩 **DashboardGrid** (Component)
- Displays a grid of dashboards with selection and pagination.
- 🧩 **DynamicForm** (Component)
- Generates a form dynamically based on a JSON schema.
- 🧩 **EnvSelector** (Component)
- Provides a UI component for selecting source and target envi...
- 🧩 **Footer** (Component) `[TRIVIAL]`
- Displays the application footer with copyright information.
- 🧩 **MappingTable** (Component)
- Displays and allows editing of database mappings.
- 🧩 **MissingMappingModal** (Component)
- Prompts the user to provide a database mapping when one is m...
- 🧩 **Navbar** (Component)
- Main navigation bar for the application.
- 🧩 **PasswordPrompt** (Component)
- A modal component to prompt the user for database passwords ...
- 🧩 **TaskHistory** (Component)
- Displays a list of recent tasks with their status and allows...
- 🧩 **TaskList** (Component)
- Displays a list of tasks with their status and execution det...
### 📁 `auth/`
- 🏗️ **Layers:** Component
- 📊 **Tiers:** TRIVIAL: 1
- 📄 **Files:** 1
- 📦 **Entities:** 1
**Key Entities:**
- 🧩 **ProtectedRoute** (Component) `[TRIVIAL]`
- Wraps content to ensure only authenticated users can access ...
### 📁 `git/`
- 🏗️ **Layers:** Component
- 📊 **Tiers:** STANDARD: 26
- 📄 **Files:** 6
- 📦 **Entities:** 26
**Key Entities:**
- 🧩 **BranchSelector** (Component)
- UI для выбора и создания веток Git.
- 🧩 **CommitHistory** (Component)
- Displays the commit history for a specific dashboard.
- 🧩 **CommitModal** (Component)
- Модальное окно для создания коммита с просмотром изменений (...
- 🧩 **ConflictResolver** (Component)
- UI for resolving merge conflicts (Keep Mine / Keep Theirs).
- 🧩 **DeploymentModal** (Component)
- Modal for deploying a dashboard to a target environment.
- 🧩 **GitManager** (Component)
- Центральный компонент для управления Git-операциями конкретн...
### 📁 `llm/`
- 🏗️ **Layers:** UI, Unknown
- 📊 **Tiers:** STANDARD: 2, TRIVIAL: 10
- 📄 **Files:** 3
- 📦 **Entities:** 12
**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...
### 📁 `storage/`
- 🏗️ **Layers:** UI
- 📊 **Tiers:** STANDARD: 7
- 📄 **Files:** 2
- 📦 **Entities:** 7
**Key Entities:**
- 🧩 **FileList** (Component)
- Displays a table of files with metadata and actions.
- 🧩 **FileUpload** (Component)
- Provides a form for uploading files to a specific category.
### 📁 `tasks/`
- 🏗️ **Layers:** UI, Unknown
- 📊 **Tiers:** STANDARD: 4, TRIVIAL: 12
- 📄 **Files:** 4
- 📦 **Entities:** 16
**Key Entities:**
- 🧩 **LogEntryRow** (Component)
- Renders a single log entry with stacked layout optimized for...
- 🧩 **LogFilterBar** (Component)
- Compact filter toolbar for logs — level, source, and text se...
- 🧩 **TaskLogPanel** (Component)
- Combines log filtering and display into a single cohesive da...
- 📦 **LogFilterBar** (Module) `[TRIVIAL]`
- Auto-generated module for frontend/src/components/tasks/LogF...
- 📦 **TaskLogPanel** (Module) `[TRIVIAL]`
- Auto-generated module for frontend/src/components/tasks/Task...
- 📦 **TaskResultPanel** (Module) `[TRIVIAL]`
- Auto-generated module for frontend/src/components/tasks/Task...
### 📁 `tools/`
- 🏗️ **Layers:** UI, Unknown
- 📊 **Tiers:** STANDARD: 14, TRIVIAL: 2
- 📄 **Files:** 4
- 📦 **Entities:** 16
**Key Entities:**
- 🧩 **ConnectionForm** (Component)
- UI component for creating a new database connection configur...
- 🧩 **ConnectionList** (Component)
- UI component for listing and deleting saved database connect...
- 🧩 **DebugTool** (Component)
- UI component for system diagnostics and debugging API respon...
- 🧩 **MapperTool** (Component)
- UI component for mapping dataset column verbose names using ...
- 📦 **MapperTool** (Module) `[TRIVIAL]`
- Auto-generated module for frontend/src/components/tools/Mapp...
### 📁 `lib/`
- 🏗️ **Layers:** Infra, Infra-API, UI, UI-State
- 📊 **Tiers:** STANDARD: 20, TRIVIAL: 3
- 📄 **Files:** 5
- 📦 **Entities:** 23
**Key Entities:**
- 🧩 **Counter** (Component) `[TRIVIAL]`
- Simple counter demo component
- 📦 **Utils** (Module) `[TRIVIAL]`
- General utility functions (class merging)
- 📦 **api_module** (Module)
- Handles all communication with the backend API.
- 📦 **stores_module** (Module)
- Global state management using Svelte stores.
- 📦 **toasts_module** (Module)
- Manages toast notifications using a Svelte writable store.
### 📁 `api/`
- 🏗️ **Layers:** Infra
- 📊 **Tiers:** CRITICAL: 1, STANDARD: 4
- 📄 **Files:** 1
- 📦 **Entities:** 5
**Key Entities:**
- 📦 **frontend.src.lib.api.reports** (Module) `[CRITICAL]`
- Wrapper-based reports API client for list/detail retrieval w...
**Dependencies:**
- 🔗 DEPENDS_ON -> [DEF:api_module]
### 📁 `auth/`
- 🏗️ **Layers:** Feature
- 📊 **Tiers:** STANDARD: 7
- 📄 **Files:** 1
- 📦 **Entities:** 7
**Key Entities:**
- 🗄️ **authStore** (Store)
- Manages the global authentication state on the frontend.
### 📁 `layout/`
- 🏗️ **Layers:** UI, Unknown
- 📊 **Tiers:** CRITICAL: 3, STANDARD: 4, TRIVIAL: 26
- 📄 **Files:** 4
- 📦 **Entities:** 33
**Key Entities:**
- 🧩 **Breadcrumbs** (Component)
- Display page hierarchy navigation
- 🧩 **Sidebar** (Component) `[CRITICAL]`
- Persistent left sidebar with resource categories navigation
- 🧩 **TaskDrawer** (Component) `[CRITICAL]`
- Global task drawer for monitoring background operations
- 🧩 **TopNavbar** (Component) `[CRITICAL]`
- Unified top navigation bar with Logo, Search, Activity, and ...
- 📦 **Breadcrumbs** (Module) `[TRIVIAL]`
- Auto-generated module for frontend/src/lib/components/layout...
- 📦 **Sidebar** (Module) `[TRIVIAL]`
- Auto-generated module for frontend/src/lib/components/layout...
- 📦 **TaskDrawer** (Module) `[TRIVIAL]`
- Auto-generated module for frontend/src/lib/components/layout...
- 📦 **TopNavbar** (Module) `[TRIVIAL]`
- Auto-generated module for frontend/src/lib/components/layout...
### 📁 `__tests__/`
- 🏗️ **Layers:** Unknown
- 📊 **Tiers:** TRIVIAL: 3
- 📄 **Files:** 1
- 📦 **Entities:** 3
**Key Entities:**
- 📦 **test_breadcrumbs.svelte** (Module) `[TRIVIAL]`
- Auto-generated module for frontend/src/lib/components/layout...
### 📁 `reports/`
- 🏗️ **Layers:** UI, Unknown
- 📊 **Tiers:** CRITICAL: 4, STANDARD: 1, TRIVIAL: 10
- 📄 **Files:** 4
- 📦 **Entities:** 15
**Key Entities:**
- 🧩 **ReportCard** (Component) `[CRITICAL]`
- Render one report with explicit textual type label and profi...
- 🧩 **ReportDetailPanel** (Component) `[CRITICAL]`
- Display detailed report context with diagnostics and actiona...
- 🧩 **ReportsList** (Component) `[CRITICAL]`
- Render unified list of normalized reports with canonical min...
- 📦 **ReportCard** (Module) `[TRIVIAL]`
- Auto-generated module for frontend/src/lib/components/report...
- 📦 **ReportDetailPanel** (Module) `[TRIVIAL]`
- Auto-generated module for frontend/src/lib/components/report...
- 📦 **ReportsList** (Module) `[TRIVIAL]`
- Auto-generated module for frontend/src/lib/components/report...
- 📦 **frontend.src.lib.components.reports.reportTypeProfiles** (Module) `[CRITICAL]`
- Deterministic mapping from report task_type to visual profil...
**Dependencies:**
- 🔗 DEPENDS_ON -> frontend/src/lib/i18n/index.ts
### 📁 `__tests__/`
- 🏗️ **Layers:** UI, UI (Tests)
- 📊 **Tiers:** CRITICAL: 5, STANDARD: 1, TRIVIAL: 4
- 📄 **Files:** 6
- 📦 **Entities:** 10
**Key Entities:**
- 📦 **frontend.src.lib.components.reports.__tests__.report_card.ux** (Module) `[CRITICAL]`
- Test UX states and transitions for ReportCard component
- 📦 **frontend.src.lib.components.reports.__tests__.report_detail.integration** (Module) `[CRITICAL]`
- Validate detail-panel behavior for failed reports and recove...
- 📦 **frontend.src.lib.components.reports.__tests__.report_detail.ux** (Module) `[CRITICAL]`
- Test UX states and recovery for ReportDetailPanel component
- 📦 **frontend.src.lib.components.reports.__tests__.report_type_profiles** (Module) `[CRITICAL]`
- Validate report type profile mapping and unknown fallback be...
- 📦 **frontend.src.lib.components.reports.__tests__.reports_filter_performance** (Module)
- Guard test for report filter responsiveness on moderate in-m...
- 📦 **frontend.src.lib.components.reports.__tests__.reports_page.integration** (Module) `[CRITICAL]`
- Integration-style checks for unified mixed-type reports rend...
### 📁 `fixtures/`
- 🏗️ **Layers:** UI
- 📊 **Tiers:** STANDARD: 1
- 📄 **Files:** 1
- 📦 **Entities:** 1
**Key Entities:**
- 📦 **reports.fixtures** (Module)
- Shared frontend fixtures for unified reports states.
### 📁 `i18n/`
- 🏗️ **Layers:** Infra
- 📊 **Tiers:** STANDARD: 4
- 📄 **Files:** 1
- 📦 **Entities:** 4
**Key Entities:**
- 📦 **i18n** (Module)
- Determines the starting locale.
- 🗄️ **locale** (Store)
- Holds the current active locale string.
- 🗄️ **t** (Store)
- Derived store providing the translation dictionary.
**Dependencies:**
- 🔗 DEPENDS_ON -> locales/en.json
- 🔗 DEPENDS_ON -> locales/ru.json
### 📁 `stores/`
- 🏗️ **Layers:** UI, Unknown
- 📊 **Tiers:** CRITICAL: 1, STANDARD: 2, TRIVIAL: 12
- 📄 **Files:** 3
- 📦 **Entities:** 15
**Key Entities:**
- 📦 **sidebar** (Module) `[TRIVIAL]`
- Auto-generated module for frontend/src/lib/stores/sidebar.js
- 📦 **taskDrawer** (Module) `[TRIVIAL]`
- Auto-generated module for frontend/src/lib/stores/taskDrawer...
- 🗄️ **activity** (Store)
- Track active task count for navbar indicator
- 🗄️ **sidebar** (Store)
- Manage sidebar visibility and navigation state
- 🗄️ **taskDrawer** (Store) `[CRITICAL]`
- Manage Task Drawer visibility and resource-to-task mapping
**Dependencies:**
- 🔗 DEPENDS_ON -> WebSocket connection, taskDrawer store
### 📁 `__tests__/`
- 🏗️ **Layers:** Domain (Tests), UI
- 📊 **Tiers:** CRITICAL: 1, STANDARD: 8
- 📄 **Files:** 5
- 📦 **Entities:** 9
**Key Entities:**
- 📦 **frontend.src.lib.stores.__tests__.sidebar** (Module)
- Unit tests for sidebar store
- 📦 **frontend.src.lib.stores.__tests__.test_activity** (Module)
- Unit tests for activity store
- 📦 **frontend.src.lib.stores.__tests__.test_sidebar** (Module)
- Unit tests for sidebar store
- 📦 **frontend.src.lib.stores.__tests__.test_taskDrawer** (Module) `[CRITICAL]`
- Unit tests for task drawer store
- 📦 **setupTests** (Module)
- Global test setup with mocks for SvelteKit modules
**Dependencies:**
- 🔗 DEPENDS_ON -> frontend.src.lib.stores.taskDrawer
### 📁 `mocks/`
- 📊 **Tiers:** STANDARD: 3
- 📄 **Files:** 3
- 📦 **Entities:** 3
### 📁 `ui/`
- 🏗️ **Layers:** Atom
- 📊 **Tiers:** TRIVIAL: 7
- 📄 **Files:** 7
- 📦 **Entities:** 7
**Key Entities:**
- 🧩 **Button** (Component) `[TRIVIAL]`
- Define component interface and default values (Svelte 5 Rune...
- 🧩 **Card** (Component) `[TRIVIAL]`
- Standardized container with padding and elevation.
- 🧩 **Input** (Component) `[TRIVIAL]`
- Standardized text input component with label and error handl...
- 🧩 **LanguageSwitcher** (Component) `[TRIVIAL]`
- Dropdown component to switch between supported languages.
- 🧩 **PageHeader** (Component) `[TRIVIAL]`
- Standardized page header with title and action area.
- 🧩 **Select** (Component) `[TRIVIAL]`
- Standardized dropdown selection component.
- 📦 **ui** (Module) `[TRIVIAL]`
- Central export point for standardized UI components.
### 📁 `utils/`
- 🏗️ **Layers:** Infra
- 📊 **Tiers:** TRIVIAL: 2
- 📄 **Files:** 1
- 📦 **Entities:** 2
**Key Entities:**
- 📦 **Debounce** (Module) `[TRIVIAL]`
- Debounce utility for limiting function execution rate
### 📁 `pages/`
- 🏗️ **Layers:** UI
- 📊 **Tiers:** STANDARD: 11
- 📄 **Files:** 2
- 📦 **Entities:** 11
**Key Entities:**
- 🧩 **Dashboard** (Component)
- Displays the list of available plugins and allows selecting ...
- 🧩 **Settings** (Component)
- The main settings page for the application, allowing managem...
### 📁 `routes/`
- 🏗️ **Layers:** Infra, UI
- 📊 **Tiers:** CRITICAL: 1, STANDARD: 3, TRIVIAL: 1
- 📄 **Files:** 5
- 📦 **Entities:** 5
**Key Entities:**
- 📦 **RootLayoutConfig** (Module) `[TRIVIAL]`
- Root layout configuration (SPA mode)
- 📦 **layout** (Module)
- Bind global layout shell and conditional login/full-app rend...
### 📁 `roles/`
- 🏗️ **Layers:** Domain
- 📊 **Tiers:** STANDARD: 6
- 📄 **Files:** 1
- 📦 **Entities:** 6
**Key Entities:**
- 🧩 **AdminRolesPage** (Component)
- UI for managing system roles and their permissions.
### 📁 `settings/`
- 🏗️ **Layers:** Feature
- 📊 **Tiers:** STANDARD: 5
- 📄 **Files:** 1
- 📦 **Entities:** 5
**Key Entities:**
- 🧩 **AdminSettingsPage** (Component)
- UI for configuring Active Directory Group to local Role mapp...
### 📁 `llm/`
- 🏗️ **Layers:** UI, Unknown
- 📊 **Tiers:** STANDARD: 1, TRIVIAL: 2
- 📄 **Files:** 1
- 📦 **Entities:** 3
**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.
### 📁 `datasets/`
- 🏗️ **Layers:** UI, Unknown
- 📊 **Tiers:** CRITICAL: 1, TRIVIAL: 17
- 📄 **Files:** 1
- 📦 **Entities:** 18
**Key Entities:**
- 📦 **+page** (Module) `[TRIVIAL]`
- Auto-generated module for frontend/src/routes/datasets/+page...
### 📁 `[id]/`
- 🏗️ **Layers:** UI, Unknown
- 📊 **Tiers:** CRITICAL: 1, TRIVIAL: 6
- 📄 **Files:** 1
- 📦 **Entities:** 7
**Key Entities:**
- 📦 **+page** (Module) `[TRIVIAL]`
- Auto-generated module for frontend/src/routes/datasets/[id]/...
### 📁 `git/`
- 🏗️ **Layers:** Page
- 📊 **Tiers:** STANDARD: 3
- 📄 **Files:** 1
- 📦 **Entities:** 3
**Key Entities:**
- 🧩 **GitDashboardPage** (Component)
- Dashboard management page for Git integration.
### 📁 `login/`
- 🏗️ **Layers:** UI
- 📊 **Tiers:** STANDARD: 3
- 📄 **Files:** 1
- 📦 **Entities:** 3
**Key Entities:**
- 🧩 **LoginPage** (Component)
- Provides the user interface for local and ADFS authenticatio...
### 📁 `migration/`
- 🏗️ **Layers:** Page
- 📊 **Tiers:** STANDARD: 10
- 📄 **Files:** 1
- 📦 **Entities:** 10
**Key Entities:**
- 🧩 **DashboardSelectionSection** (Component)
- 🧩 **MigrationDashboard** (Component)
- Main dashboard for configuring and starting migrations.
### 📁 `mappings/`
- 🏗️ **Layers:** Page
- 📊 **Tiers:** STANDARD: 4
- 📄 **Files:** 1
- 📦 **Entities:** 4
**Key Entities:**
- 🧩 **MappingManagement** (Component)
- Page for managing database mappings between environments.
### 📁 `reports/`
- 🏗️ **Layers:** UI, Unknown
- 📊 **Tiers:** CRITICAL: 1, TRIVIAL: 7
- 📄 **Files:** 1
- 📦 **Entities:** 8
**Key Entities:**
- 🧩 **UnifiedReportsPage** (Component) `[CRITICAL]`
- Unified reports page with filtering and resilient UX states ...
- 📦 **+page** (Module) `[TRIVIAL]`
- Auto-generated module for frontend/src/routes/reports/+page....
### 📁 `settings/`
- 🏗️ **Layers:** UI, Unknown
- 📊 **Tiers:** CRITICAL: 1, STANDARD: 1, TRIVIAL: 10
- 📄 **Files:** 2
- 📦 **Entities:** 12
**Key Entities:**
- 📦 **+page** (Module) `[TRIVIAL]`
- Auto-generated module for frontend/src/routes/settings/+page...
### 📁 `connections/`
- 🏗️ **Layers:** UI
- 📊 **Tiers:** STANDARD: 2
- 📄 **Files:** 1
- 📦 **Entities:** 2
**Key Entities:**
- 🧩 **ConnectionsSettingsPage** (Component)
- Page for managing database connection configurations.
### 📁 `git/`
- 🏗️ **Layers:** Page
- 📊 **Tiers:** STANDARD: 5
- 📄 **Files:** 1
- 📦 **Entities:** 5
**Key Entities:**
- 🧩 **GitSettingsPage** (Component)
- Manage Git server configurations for dashboard versioning.
### 📁 `storage/`
- 🏗️ **Layers:** Page
- 📊 **Tiers:** TRIVIAL: 1
- 📄 **Files:** 1
- 📦 **Entities:** 1
### 📁 `repos/`
- 📊 **Tiers:** STANDARD: 3
- 📄 **Files:** 1
- 📦 **Entities:** 3
### 📁 `debug/`
- 🏗️ **Layers:** UI
- 📊 **Tiers:** TRIVIAL: 1
- 📄 **Files:** 1
- 📦 **Entities:** 1
**Key Entities:**
- 🧩 **DebugPage** (Component) `[TRIVIAL]`
- Page for system diagnostics and debugging.
### 📁 `mapper/`
- 🏗️ **Layers:** UI
- 📊 **Tiers:** TRIVIAL: 1
- 📄 **Files:** 1
- 📦 **Entities:** 1
**Key Entities:**
- 🧩 **MapperPage** (Component) `[TRIVIAL]`
- Page for the dataset column mapper tool.
### 📁 `storage/`
- 🏗️ **Layers:** UI
- 📊 **Tiers:** STANDARD: 5
- 📄 **Files:** 1
- 📦 **Entities:** 5
**Key Entities:**
- 🧩 **StoragePage** (Component)
- Main page for file storage management.
### 📁 `services/`
- 🏗️ **Layers:** Service
- 📊 **Tiers:** STANDARD: 33
- 📄 **Files:** 6
- 📦 **Entities:** 33
**Key Entities:**
- 📦 **GitServiceClient** (Module)
- API client for Git operations, managing the communication be...
- 📦 **adminService** (Module)
- Service for Admin-related API calls (User and Role managemen...
- 📦 **storageService** (Module)
- Frontend API client for file storage management.
**Dependencies:**
- 🔗 DEPENDS_ON -> frontend.src.lib.api
### 📁 `types/`
- 🏗️ **Layers:** Domain
- 📊 **Tiers:** TRIVIAL: 1
- 📄 **Files:** 1
- 📦 **Entities:** 1
**Key Entities:**
- 📦 **DashboardTypes** (Module) `[TRIVIAL]`
- TypeScript interfaces for Dashboard entities
### 📁 `root/`
- 🏗️ **Layers:** DevOps/Tooling
- 📊 **Tiers:** CRITICAL: 12, STANDARD: 16, TRIVIAL: 7
- 📄 **Files:** 1
- 📦 **Entities:** 35
**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) `[CRITICAL]`
- Scans the codebase to generate a Semantic Map, Module Map, a...
## Cross-Module Dependencies
```mermaid
graph TD
api-->|USES|backend
api-->|USES|backend
routes-->|DEPENDS_ON|backend
routes-->|DEPENDS_ON|backend
routes-->|DEPENDS_ON|backend
routes-->|DEPENDS_ON|backend
routes-->|DEPENDS_ON|backend
routes-->|DEPENDS_ON|backend
routes-->|DEPENDS_ON|backend
routes-->|DEPENDS_ON|backend
routes-->|DEPENDS_ON|backend
routes-->|DEPENDS_ON|backend
routes-->|USES|backend
routes-->|USES|backend
routes-->|CALLS|backend
routes-->|CALLS|backend
routes-->|CALLS|backend
routes-->|CALLS|backend
routes-->|CALLS|backend
routes-->|DEPENDS_ON|backend
routes-->|DEPENDS_ON|backend
routes-->|DEPENDS_ON|backend
routes-->|DEPENDS_ON|backend
routes-->|DEPENDS_ON|backend
routes-->|DEPENDS_ON|backend
routes-->|DEPENDS_ON|backend
__tests__-->|TESTS|backend
__tests__-->|TESTS|backend
__tests__-->|TESTS|backend
__tests__-->|TESTS|backend
core-->|USES|backend
core-->|USES|backend
core-->|USES|backend
core-->|USES|backend
auth-->|USES|backend
auth-->|USES|backend
auth-->|USES|backend
auth-->|USES|backend
utils-->|DEPENDS_ON|backend
utils-->|DEPENDS_ON|backend
utils-->|DEPENDS_ON|backend
models-->|INHERITS_FROM|backend
models-->|DEPENDS_ON|backend
models-->|USED_BY|backend
models-->|INHERITS_FROM|backend
llm_analysis-->|IMPLEMENTS|backend
llm_analysis-->|IMPLEMENTS|backend
storage-->|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-->|USES|backend
services-->|USES|backend
services-->|USES|backend
services-->|DEPENDS_ON|backend
services-->|DEPENDS_ON|backend
__tests__-->|TESTS|backend
reports-->|DEPENDS_ON|backend
reports-->|DEPENDS_ON|backend
reports-->|DEPENDS_ON|backend
reports-->|DEPENDS_ON|backend
reports-->|DEPENDS_ON|backend
reports-->|DEPENDS_ON|backend
reports-->|DEPENDS_ON|backend
__tests__-->|TESTS|backend
tests-->|TESTS|backend
reports-->|DEPENDS_ON|lib
__tests__-->|TESTS|routes
__tests__-->|TESTS|routes
__tests__-->|TESTS|lib
__tests__-->|TESTS|lib
__tests__-->|TESTS|lib
__tests__-->|TESTS|routes
```