48 KiB
48 KiB
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
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