1511 lines
52 KiB
Markdown
1511 lines
52 KiB
Markdown
# Module Map
|
||
|
||
> High-level module structure for AI Context. Generated automatically.
|
||
|
||
**Generated:** 2026-02-24T21:04:43.328895
|
||
|
||
## Summary
|
||
|
||
- **Total Modules:** 74
|
||
- **Total Entities:** 1571
|
||
|
||
## Module Hierarchy
|
||
|
||
### 📁 `backend/`
|
||
|
||
- 🏗️ **Layers:** Unknown, Utility
|
||
- 📊 **Tiers:** STANDARD: 2, TRIVIAL: 2
|
||
- 📄 **Files:** 2
|
||
- 📦 **Entities:** 4
|
||
|
||
**Key Entities:**
|
||
|
||
- 📦 **backend.delete_running_tasks** (Module)
|
||
- Script to delete tasks with RUNNING status from the database...
|
||
- 📦 **test_auth_debug** (Module) `[TRIVIAL]`
|
||
- Auto-generated module for backend/test_auth_debug.py
|
||
|
||
### 📁 `src/`
|
||
|
||
- 🏗️ **Layers:** API, Core, UI (API)
|
||
- 📊 **Tiers:** CRITICAL: 2, STANDARD: 19, TRIVIAL: 2
|
||
- 📄 **Files:** 2
|
||
- 📦 **Entities:** 23
|
||
|
||
**Key Entities:**
|
||
|
||
- 📦 **AppModule** (Module) `[CRITICAL]`
|
||
- The main entry point for the FastAPI application. It initial...
|
||
- 📦 **Dependencies** (Module)
|
||
- Manages creation and provision of shared application depende...
|
||
|
||
### 📁 `api/`
|
||
|
||
- 🏗️ **Layers:** API
|
||
- 📊 **Tiers:** STANDARD: 7
|
||
- 📄 **Files:** 1
|
||
- 📦 **Entities:** 7
|
||
|
||
**Key Entities:**
|
||
|
||
- 📦 **backend.src.api.auth** (Module)
|
||
- Authentication API endpoints.
|
||
|
||
### 📁 `routes/`
|
||
|
||
- 🏗️ **Layers:** API, UI (API)
|
||
- 📊 **Tiers:** CRITICAL: 2, STANDARD: 182, TRIVIAL: 4
|
||
- 📄 **Files:** 17
|
||
- 📦 **Entities:** 188
|
||
|
||
**Key Entities:**
|
||
|
||
- ℂ **AssistantAction** (Class) `[TRIVIAL]`
|
||
- UI action descriptor returned with assistant responses.
|
||
- ℂ **AssistantMessageRequest** (Class) `[TRIVIAL]`
|
||
- Input payload for assistant message endpoint.
|
||
- ℂ **AssistantMessageResponse** (Class)
|
||
- Output payload contract for assistant interaction endpoints.
|
||
- ℂ **BranchCheckout** (Class)
|
||
- Schema for branch checkout requests.
|
||
- ℂ **BranchCreate** (Class)
|
||
- Schema for branch creation requests.
|
||
- ℂ **BranchSchema** (Class)
|
||
- Schema for representing a Git branch metadata.
|
||
- ℂ **CommitCreate** (Class)
|
||
- Schema for staging and committing changes.
|
||
- ℂ **CommitSchema** (Class)
|
||
- Schema for representing Git commit details.
|
||
- ℂ **ConfirmationRecord** (Class)
|
||
- In-memory confirmation token model for risky operation dispa...
|
||
- ℂ **ConflictResolution** (Class)
|
||
- Schema for resolving merge conflicts.
|
||
|
||
**Dependencies:**
|
||
|
||
- 🔗 DEPENDS_ON -> ConfigManager
|
||
- 🔗 DEPENDS_ON -> ConfigModels
|
||
- 🔗 DEPENDS_ON -> backend.src.core.database
|
||
- 🔗 DEPENDS_ON -> backend.src.core.superset_client
|
||
- 🔗 DEPENDS_ON -> backend.src.core.task_manager
|
||
|
||
### 📁 `__tests__/`
|
||
|
||
- 🏗️ **Layers:** API, Domain (Tests), UI (API Tests)
|
||
- 📊 **Tiers:** CRITICAL: 3, STANDARD: 33, TRIVIAL: 81
|
||
- 📄 **Files:** 7
|
||
- 📦 **Entities:** 117
|
||
|
||
**Key Entities:**
|
||
|
||
- ℂ **_FakeConfigManager** (Class) `[TRIVIAL]`
|
||
- Provide deterministic environment aliases required by intent...
|
||
- ℂ **_FakeConfigManager** (Class) `[TRIVIAL]`
|
||
- Environment config fixture with dev/prod aliases for parser ...
|
||
- ℂ **_FakeDb** (Class) `[TRIVIAL]`
|
||
- In-memory session substitute for assistant route persistence...
|
||
- ℂ **_FakeDb** (Class) `[TRIVIAL]`
|
||
- In-memory fake database implementing subset of Session inter...
|
||
- ℂ **_FakeQuery** (Class) `[TRIVIAL]`
|
||
- Minimal chainable query object for fake DB interactions.
|
||
- ℂ **_FakeQuery** (Class) `[TRIVIAL]`
|
||
- Minimal chainable query object for fake SQLAlchemy-like DB b...
|
||
- ℂ **_FakeTask** (Class) `[TRIVIAL]`
|
||
- Lightweight task model used for assistant authz tests.
|
||
- ℂ **_FakeTask** (Class) `[TRIVIAL]`
|
||
- Lightweight task stub used by assistant API tests.
|
||
- ℂ **_FakeTaskManager** (Class) `[TRIVIAL]`
|
||
- Minimal task manager for deterministic operation creation an...
|
||
- ℂ **_FakeTaskManager** (Class) `[TRIVIAL]`
|
||
- Minimal async-compatible TaskManager fixture for determinist...
|
||
|
||
**Dependencies:**
|
||
|
||
- 🔗 DEPENDS_ON -> backend.src.api.routes.assistant
|
||
|
||
### 📁 `core/`
|
||
|
||
- 🏗️ **Layers:** Core
|
||
- 📊 **Tiers:** STANDARD: 116, TRIVIAL: 7
|
||
- 📄 **Files:** 9
|
||
- 📦 **Entities:** 123
|
||
|
||
**Key Entities:**
|
||
|
||
- ℂ **AuthSessionLocal** (Class) `[TRIVIAL]`
|
||
- A session factory for the authentication database.
|
||
- ℂ **BeliefFormatter** (Class)
|
||
- Custom logging formatter that adds belief state prefixes to ...
|
||
- ℂ **ConfigManager** (Class)
|
||
- A class to handle application configuration persistence and ...
|
||
- ℂ **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) `[TRIVIAL]`
|
||
- A session factory for the main mappings database.
|
||
|
||
**Dependencies:**
|
||
|
||
- 🔗 DEPENDS_ON -> AppConfigRecord
|
||
- 🔗 DEPENDS_ON -> ConfigModels
|
||
- 🔗 DEPENDS_ON -> PyYAML
|
||
- 🔗 DEPENDS_ON -> backend.src.core.auth.config
|
||
- 🔗 DEPENDS_ON -> backend.src.models.mapping
|
||
|
||
### 📁 `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: 10, STANDARD: 63, TRIVIAL: 5
|
||
- 📄 **Files:** 7
|
||
- 📦 **Entities:** 78
|
||
|
||
**Key Entities:**
|
||
|
||
- ℂ **LogEntry** (Class) `[CRITICAL]`
|
||
- A Pydantic model representing a single, structured log entry...
|
||
- ℂ **LogFilter** (Class)
|
||
- Filter parameters for querying task logs.
|
||
- ℂ **LogStats** (Class)
|
||
- Statistics about log entries for a task.
|
||
- ℂ **Task** (Class)
|
||
- A Pydantic model representing a single execution instance of...
|
||
- ℂ **TaskCleanupService** (Class)
|
||
- Provides methods to clean up old task records and their asso...
|
||
- ℂ **TaskContext** (Class) `[CRITICAL]`
|
||
- A container passed to plugin.execute() providing the logger ...
|
||
- ℂ **TaskLog** (Class)
|
||
- A Pydantic model representing a persisted log entry from the...
|
||
- ℂ **TaskLogPersistenceService** (Class) `[CRITICAL]`
|
||
- Provides methods to save and query task logs from the task_l...
|
||
- ℂ **TaskLogger** (Class) `[CRITICAL]`
|
||
- A wrapper around TaskManager._add_log that carries task_id a...
|
||
- ℂ **TaskManager** (Class) `[CRITICAL]`
|
||
- Manages the lifecycle of tasks, including their creation, ex...
|
||
|
||
**Dependencies:**
|
||
|
||
- 🔗 DEPENDS_ON -> TaskLogRecord
|
||
- 🔗 DEPENDS_ON -> TaskLogger, USED_BY -> plugins
|
||
- 🔗 DEPENDS_ON -> TaskManager, CALLS -> TaskManager._add_log
|
||
|
||
### 📁 `utils/`
|
||
|
||
- 🏗️ **Layers:** Core, Domain, Infra
|
||
- 📊 **Tiers:** STANDARD: 48, TRIVIAL: 1
|
||
- 📄 **Files:** 4
|
||
- 📦 **Entities:** 49
|
||
|
||
**Key Entities:**
|
||
|
||
- ℂ **APIClient** (Class)
|
||
- Инкапсулирует HTTP-логику для работы с API, включая сессии, ...
|
||
- ℂ **AuthenticationError** (Class)
|
||
- Exception raised when authentication fails.
|
||
- ℂ **DashboardNotFoundError** (Class)
|
||
- Exception raised when a dashboard cannot be found.
|
||
- ℂ **DatasetMapper** (Class)
|
||
- Класс для меппинга и обновления verbose_map в датасетах Supe...
|
||
- ℂ **InvalidZipFormatError** (Class)
|
||
- Exception raised when a file is not a valid ZIP archive.
|
||
- ℂ **NetworkError** (Class)
|
||
- Exception raised when a network level error occurs.
|
||
- ℂ **PermissionDeniedError** (Class)
|
||
- Exception raised when access is denied.
|
||
- ℂ **SupersetAPIError** (Class)
|
||
- Base exception for all Superset API related errors.
|
||
- 📦 **backend.core.utils.dataset_mapper** (Module)
|
||
- Этот модуль отвечает за обновление метаданных (verbose_map) ...
|
||
- 📦 **backend.core.utils.fileio** (Module)
|
||
- Предоставляет набор утилит для управления файловыми операция...
|
||
|
||
**Dependencies:**
|
||
|
||
- 🔗 DEPENDS_ON -> backend.core.superset_client
|
||
- 🔗 DEPENDS_ON -> backend.src.core.logger
|
||
- 🔗 DEPENDS_ON -> pandas
|
||
- 🔗 DEPENDS_ON -> psycopg2
|
||
- 🔗 DEPENDS_ON -> pyyaml
|
||
|
||
### 📁 `models/`
|
||
|
||
- 🏗️ **Layers:** Domain, Model
|
||
- 📊 **Tiers:** CRITICAL: 9, STANDARD: 21, TRIVIAL: 21
|
||
- 📄 **Files:** 11
|
||
- 📦 **Entities:** 51
|
||
|
||
**Key Entities:**
|
||
|
||
- ℂ **ADGroupMapping** (Class)
|
||
- Maps an Active Directory group to a local System Role.
|
||
- ℂ **AppConfigRecord** (Class)
|
||
- Stores the single source of truth for application configurat...
|
||
- ℂ **AssistantAuditRecord** (Class)
|
||
- Store audit decisions and outcomes produced by assistant com...
|
||
- ℂ **AssistantConfirmationRecord** (Class)
|
||
- Persist risky operation confirmation tokens with lifecycle s...
|
||
- ℂ **AssistantMessageRecord** (Class)
|
||
- Persist chat history entries for assistant conversations.
|
||
- ℂ **ConnectionConfig** (Class) `[TRIVIAL]`
|
||
- Stores credentials for external databases used for column ma...
|
||
- ℂ **DashboardMetadata** (Class) `[TRIVIAL]`
|
||
- Represents a dashboard available for migration.
|
||
- ℂ **DashboardSelection** (Class) `[TRIVIAL]`
|
||
- Represents the user's selection of dashboards to migrate.
|
||
- ℂ **DatabaseMapping** (Class)
|
||
- Represents a mapping between source and target databases.
|
||
- ℂ **DeploymentEnvironment** (Class) `[TRIVIAL]`
|
||
- Target Superset environments for dashboard deployment.
|
||
|
||
**Dependencies:**
|
||
|
||
- 🔗 DEPENDS_ON -> Role
|
||
- 🔗 DEPENDS_ON -> TaskRecord
|
||
- 🔗 DEPENDS_ON -> backend.src.core.task_manager.models
|
||
- 🔗 DEPENDS_ON -> backend.src.models.mapping
|
||
- 🔗 DEPENDS_ON -> sqlalchemy
|
||
|
||
### 📁 `__tests__/`
|
||
|
||
- 🏗️ **Layers:** Domain
|
||
- 📊 **Tiers:** STANDARD: 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: 19, TRIVIAL: 24
|
||
- 📄 **Files:** 4
|
||
- 📦 **Entities:** 43
|
||
|
||
**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: 58, TRIVIAL: 5
|
||
- 📄 **Files:** 7
|
||
- 📦 **Entities:** 64
|
||
|
||
**Key Entities:**
|
||
|
||
- ℂ **AuthService** (Class)
|
||
- Provides high-level authentication services.
|
||
- ℂ **EncryptionManager** (Class) `[CRITICAL]`
|
||
- Handles encryption and decryption of sensitive data like API...
|
||
- ℂ **GitService** (Class)
|
||
- Wrapper for GitPython operations with semantic logging and e...
|
||
- ℂ **LLMProviderService** (Class)
|
||
- Service to manage LLM provider lifecycle.
|
||
- ℂ **MappingService** (Class)
|
||
- Service for handling database mapping logic.
|
||
- ℂ **ResourceService** (Class)
|
||
- Provides centralized access to resource data with enhanced m...
|
||
- 📦 **backend.src.services** (Module)
|
||
- Package initialization for services module
|
||
- 📦 **backend.src.services.auth_service** (Module)
|
||
- Orchestrates authentication business logic.
|
||
- 📦 **backend.src.services.git_service** (Module)
|
||
- Core Git logic using GitPython to manage dashboard repositor...
|
||
- 📦 **backend.src.services.llm_prompt_templates** (Module)
|
||
- Provide default LLM prompt templates and normalization helpe...
|
||
|
||
**Dependencies:**
|
||
|
||
- 🔗 DEPENDS_ON -> backend.src.core.config_manager
|
||
- 🔗 DEPENDS_ON -> backend.src.core.database
|
||
- 🔗 DEPENDS_ON -> backend.src.core.superset_client
|
||
- 🔗 DEPENDS_ON -> backend.src.core.task_manager
|
||
- 🔗 DEPENDS_ON -> backend.src.core.utils.matching
|
||
|
||
### 📁 `__tests__/`
|
||
|
||
- 🏗️ **Layers:** Domain Tests, Service
|
||
- 📊 **Tiers:** STANDARD: 14
|
||
- 📄 **Files:** 2
|
||
- 📦 **Entities:** 14
|
||
|
||
**Key Entities:**
|
||
|
||
- 📦 **backend.src.services.__tests__.test_llm_prompt_templates** (Module)
|
||
- Validate normalization and rendering behavior for configurab...
|
||
- 📦 **backend.src.services.__tests__.test_resource_service** (Module)
|
||
- Unit tests for ResourceService
|
||
|
||
**Dependencies:**
|
||
|
||
- 🔗 DEPENDS_ON -> backend.src.services.llm_prompt_templates
|
||
|
||
### 📁 `reports/`
|
||
|
||
- 🏗️ **Layers:** Domain
|
||
- 📊 **Tiers:** CRITICAL: 5, STANDARD: 15
|
||
- 📄 **Files:** 3
|
||
- 📦 **Entities:** 20
|
||
|
||
**Key Entities:**
|
||
|
||
- ℂ **ReportsService** (Class) `[CRITICAL]`
|
||
- Service layer for list/detail report retrieval and normaliza...
|
||
- 📦 **backend.src.services.reports.normalizer** (Module) `[CRITICAL]`
|
||
- Convert task manager task objects into canonical unified Tas...
|
||
- 📦 **backend.src.services.reports.report_service** (Module) `[CRITICAL]`
|
||
- Aggregate, normalize, filter, and paginate task reports for ...
|
||
- 📦 **backend.src.services.reports.type_profiles** (Module) `[CRITICAL]`
|
||
- Deterministic mapping of plugin/task identifiers to canonica...
|
||
|
||
**Dependencies:**
|
||
|
||
- 🔗 DEPENDS_ON -> backend.src.core.task_manager.manager.TaskManager
|
||
- 🔗 DEPENDS_ON -> backend.src.core.task_manager.models.Task
|
||
- 🔗 DEPENDS_ON -> backend.src.models.report
|
||
- 🔗 DEPENDS_ON -> backend.src.models.report.TaskType
|
||
- 🔗 DEPENDS_ON -> backend.src.services.reports.normalizer
|
||
|
||
### 📁 `__tests__/`
|
||
|
||
- 🏗️ **Layers:** Domain (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, UI -->, Unknown
|
||
- 📊 **Tiers:** CRITICAL: 1, STANDARD: 49, TRIVIAL: 4
|
||
- 📄 **Files:** 13
|
||
- 📦 **Entities:** 54
|
||
|
||
**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: 11
|
||
- 📄 **Files:** 3
|
||
- 📦 **Entities:** 13
|
||
|
||
**Key Entities:**
|
||
|
||
- 🧩 **DocPreview** (Component)
|
||
- UI component for previewing generated dataset documentation ...
|
||
- 🧩 **ProviderConfig** (Component)
|
||
- UI form for managing LLM provider configurations.
|
||
- 📦 **DocPreview** (Module) `[TRIVIAL]`
|
||
- Auto-generated module for frontend/src/components/llm/DocPre...
|
||
- 📦 **ProviderConfig** (Module) `[TRIVIAL]`
|
||
- Auto-generated module for frontend/src/components/llm/Provid...
|
||
- 📦 **ValidationReport** (Module) `[TRIVIAL]`
|
||
- Auto-generated module for frontend/src/components/llm/Valida...
|
||
|
||
### 📁 `__tests__/`
|
||
|
||
- 🏗️ **Layers:** UI Tests
|
||
- 📊 **Tiers:** STANDARD: 2
|
||
- 📄 **Files:** 1
|
||
- 📦 **Entities:** 2
|
||
|
||
**Key Entities:**
|
||
|
||
- 📦 **frontend.src.components.llm.__tests__.provider_config_integration** (Module)
|
||
- Protect edit-button interaction contract in LLM provider set...
|
||
|
||
### 📁 `storage/`
|
||
|
||
- 🏗️ **Layers:** UI
|
||
- 📊 **Tiers:** STANDARD: 7
|
||
- 📄 **Files:** 2
|
||
- 📦 **Entities:** 7
|
||
|
||
**Key Entities:**
|
||
|
||
- 🧩 **FileList** (Component)
|
||
- Displays a table of files with metadata and actions.
|
||
- 🧩 **FileUpload** (Component)
|
||
- Provides a form for uploading files to a specific category.
|
||
|
||
### 📁 `tasks/`
|
||
|
||
- 🏗️ **Layers:** UI, Unknown
|
||
- 📊 **Tiers:** STANDARD: 4, TRIVIAL: 12
|
||
- 📄 **Files:** 4
|
||
- 📦 **Entities:** 16
|
||
|
||
**Key Entities:**
|
||
|
||
- 🧩 **LogEntryRow** (Component)
|
||
- Renders a single log entry with stacked layout optimized for...
|
||
- 🧩 **LogFilterBar** (Component)
|
||
- Compact filter toolbar for logs — level, source, and text se...
|
||
- 🧩 **TaskLogPanel** (Component)
|
||
- Combines log filtering and display into a single cohesive da...
|
||
- 📦 **LogFilterBar** (Module) `[TRIVIAL]`
|
||
- Auto-generated module for frontend/src/components/tasks/LogF...
|
||
- 📦 **TaskLogPanel** (Module) `[TRIVIAL]`
|
||
- Auto-generated module for frontend/src/components/tasks/Task...
|
||
- 📦 **TaskResultPanel** (Module) `[TRIVIAL]`
|
||
- Auto-generated module for frontend/src/components/tasks/Task...
|
||
|
||
### 📁 `tools/`
|
||
|
||
- 🏗️ **Layers:** UI, Unknown
|
||
- 📊 **Tiers:** STANDARD: 14, TRIVIAL: 2
|
||
- 📄 **Files:** 4
|
||
- 📦 **Entities:** 16
|
||
|
||
**Key Entities:**
|
||
|
||
- 🧩 **ConnectionForm** (Component)
|
||
- UI component for creating a new database connection configur...
|
||
- 🧩 **ConnectionList** (Component)
|
||
- UI component for listing and deleting saved database connect...
|
||
- 🧩 **DebugTool** (Component)
|
||
- UI component for system diagnostics and debugging API respon...
|
||
- 🧩 **MapperTool** (Component)
|
||
- UI component for mapping dataset column verbose names using ...
|
||
- 📦 **MapperTool** (Module) `[TRIVIAL]`
|
||
- Auto-generated module for frontend/src/components/tools/Mapp...
|
||
|
||
### 📁 `lib/`
|
||
|
||
- 🏗️ **Layers:** Infra, Infra-API, UI, UI-State
|
||
- 📊 **Tiers:** STANDARD: 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, Infra-API
|
||
- 📊 **Tiers:** CRITICAL: 1, STANDARD: 10
|
||
- 📄 **Files:** 2
|
||
- 📦 **Entities:** 11
|
||
|
||
**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
|
||
|
||
### 📁 `auth/`
|
||
|
||
- 🏗️ **Layers:** Feature
|
||
- 📊 **Tiers:** STANDARD: 7
|
||
- 📄 **Files:** 1
|
||
- 📦 **Entities:** 7
|
||
|
||
**Key Entities:**
|
||
|
||
- 🗄️ **authStore** (Store)
|
||
- Manages the global authentication state on the frontend.
|
||
|
||
### 📁 `assistant/`
|
||
|
||
- 🏗️ **Layers:** UI, Unknown
|
||
- 📊 **Tiers:** CRITICAL: 1, STANDARD: 12, TRIVIAL: 4
|
||
- 📄 **Files:** 1
|
||
- 📦 **Entities:** 17
|
||
|
||
**Key Entities:**
|
||
|
||
- 🧩 **AssistantChatPanel** (Component) `[CRITICAL]`
|
||
- Slide-out assistant chat panel for natural language command ...
|
||
- 📦 **AssistantChatPanel** (Module) `[TRIVIAL]`
|
||
- Auto-generated module for frontend/src/lib/components/assist...
|
||
|
||
### 📁 `__tests__/`
|
||
|
||
- 🏗️ **Layers:** UI Tests
|
||
- 📊 **Tiers:** STANDARD: 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_confirmation_integration** (Module)
|
||
- Validate confirm/cancel UX contract bindings in assistant ch...
|
||
|
||
### 📁 `layout/`
|
||
|
||
- 🏗️ **Layers:** UI, Unknown
|
||
- 📊 **Tiers:** CRITICAL: 3, STANDARD: 5, TRIVIAL: 26
|
||
- 📄 **Files:** 4
|
||
- 📦 **Entities:** 34
|
||
|
||
**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: 7, TRIVIAL: 12
|
||
- 📄 **Files:** 4
|
||
- 📦 **Entities:** 20
|
||
|
||
**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
|
||
- 🗄️ **assistantChat** (Store)
|
||
- Control assistant chat panel visibility and active conversat...
|
||
- 🗄️ **sidebar** (Store)
|
||
- Manage sidebar visibility and navigation state
|
||
- 🗄️ **taskDrawer** (Store) `[CRITICAL]`
|
||
- Manage Task Drawer visibility and resource-to-task mapping
|
||
|
||
**Dependencies:**
|
||
|
||
- 🔗 DEPENDS_ON -> WebSocket connection, taskDrawer store
|
||
|
||
### 📁 `__tests__/`
|
||
|
||
- 🏗️ **Layers:** Domain (Tests), UI, UI Tests
|
||
- 📊 **Tiers:** CRITICAL: 1, STANDARD: 10
|
||
- 📄 **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) `[CRITICAL]`
|
||
- 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/`
|
||
|
||
- 📊 **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: 5
|
||
- 📄 **Files:** 1
|
||
- 📦 **Entities:** 6
|
||
|
||
**Key Entities:**
|
||
|
||
- 🧩 **LLMSettingsPage** (Component)
|
||
- Admin settings page for LLM provider configuration.
|
||
- 📦 **+page** (Module) `[TRIVIAL]`
|
||
- Auto-generated module for frontend/src/routes/admin/settings...
|
||
|
||
### 📁 `users/`
|
||
|
||
- 🏗️ **Layers:** Feature
|
||
- 📊 **Tiers:** STANDARD: 6
|
||
- 📄 **Files:** 1
|
||
- 📦 **Entities:** 6
|
||
|
||
**Key Entities:**
|
||
|
||
- 🧩 **AdminUsersPage** (Component)
|
||
- UI for managing system users and their roles.
|
||
|
||
### 📁 `dashboards/`
|
||
|
||
- 🏗️ **Layers:** UI, Unknown
|
||
- 📊 **Tiers:** CRITICAL: 1, TRIVIAL: 27
|
||
- 📄 **Files:** 1
|
||
- 📦 **Entities:** 28
|
||
|
||
**Key Entities:**
|
||
|
||
- 📦 **+page** (Module) `[TRIVIAL]`
|
||
- Auto-generated module for frontend/src/routes/dashboards/+pa...
|
||
|
||
### 📁 `[id]/`
|
||
|
||
- 🏗️ **Layers:** UI, Unknown
|
||
- 📊 **Tiers:** CRITICAL: 1, TRIVIAL: 5
|
||
- 📄 **Files:** 1
|
||
- 📦 **Entities:** 6
|
||
|
||
**Key Entities:**
|
||
|
||
- 📦 **+page** (Module) `[TRIVIAL]`
|
||
- Auto-generated module for frontend/src/routes/dashboards/[id...
|
||
|
||
### 📁 `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: 14
|
||
- 📄 **Files:** 2
|
||
- 📦 **Entities:** 16
|
||
|
||
**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, Domain, Unknown
|
||
- 📊 **Tiers:** CRITICAL: 14, STANDARD: 24, TRIVIAL: 10
|
||
- 📄 **Files:** 3
|
||
- 📦 **Entities:** 48
|
||
|
||
**Key Entities:**
|
||
|
||
- ℂ **ComplianceIssue** (Class) `[TRIVIAL]`
|
||
- Represents a single compliance issue with severity.
|
||
- ℂ **ReportsService** (Class) `[CRITICAL]`
|
||
- Service layer for list/detail report retrieval and normaliza...
|
||
- ℂ **SemanticEntity** (Class) `[CRITICAL]`
|
||
- Represents a code entity (Module, Function, Component) found...
|
||
- ℂ **SemanticMapGenerator** (Class) `[CRITICAL]`
|
||
- Orchestrates the mapping process with tier-based validation.
|
||
- ℂ **Severity** (Class) `[TRIVIAL]`
|
||
- Severity levels for compliance issues.
|
||
- ℂ **Tier** (Class) `[TRIVIAL]`
|
||
- Enumeration of semantic tiers defining validation strictness...
|
||
- 📦 **backend.src.services.reports.report_service** (Module) `[CRITICAL]`
|
||
- Aggregate, normalize, filter, and paginate task reports for ...
|
||
- 📦 **generate_semantic_map** (Module)
|
||
- Scans the codebase to generate a Semantic Map, Module Map, a...
|
||
- 📦 **test_analyze** (Module) `[TRIVIAL]`
|
||
- Auto-generated module for test_analyze.py
|
||
|
||
**Dependencies:**
|
||
|
||
- 🔗 DEPENDS_ON -> backend.src.core.task_manager.manager.TaskManager
|
||
- 🔗 DEPENDS_ON -> backend.src.models.report
|
||
- 🔗 DEPENDS_ON -> backend.src.services.reports.normalizer
|
||
|
||
## Cross-Module Dependencies
|
||
|
||
```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
|
||
routes-->|DEPENDS_ON|backend
|
||
routes-->|DEPENDS_ON|backend
|
||
__tests__-->|TESTS|backend
|
||
__tests__-->|TESTS|backend
|
||
__tests__-->|TESTS|backend
|
||
__tests__-->|TESTS|backend
|
||
__tests__-->|DEPENDS_ON|backend
|
||
__tests__-->|DEPENDS_ON|backend
|
||
core-->|USES|backend
|
||
core-->|USES|backend
|
||
core-->|DEPENDS_ON|backend
|
||
core-->|DEPENDS_ON|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-->|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-->|DEPENDS_ON|backend
|
||
services-->|USES|backend
|
||
services-->|USES|backend
|
||
services-->|USES|backend
|
||
services-->|DEPENDS_ON|backend
|
||
services-->|DEPENDS_ON|backend
|
||
__tests__-->|DEPENDS_ON|backend
|
||
__tests__-->|TESTS|backend
|
||
reports-->|DEPENDS_ON|backend
|
||
reports-->|DEPENDS_ON|backend
|
||
reports-->|DEPENDS_ON|backend
|
||
reports-->|DEPENDS_ON|backend
|
||
reports-->|DEPENDS_ON|backend
|
||
reports-->|DEPENDS_ON|backend
|
||
reports-->|DEPENDS_ON|backend
|
||
__tests__-->|TESTS|backend
|
||
tests-->|TESTS|backend
|
||
__tests__-->|VERIFIES|components
|
||
__tests__-->|VERIFIES|lib
|
||
__tests__-->|VERIFIES|lib
|
||
reports-->|DEPENDS_ON|lib
|
||
__tests__-->|TESTS|routes
|
||
__tests__-->|TESTS|routes
|
||
__tests__-->|TESTS|lib
|
||
__tests__-->|TESTS|lib
|
||
__tests__-->|TESTS|lib
|
||
__tests__-->|TESTS|routes
|
||
root-->|DEPENDS_ON|backend
|
||
root-->|DEPENDS_ON|backend
|
||
root-->|DEPENDS_ON|backend
|
||
```
|