mcp

.ai/MODULE_MAP.md

@@ -2,7 +2,7 @@
 
 > High-level module structure for AI Context. Generated automatically.
 
-**Generated:** 2026-03-15T16:33:41.022837
+**Generated:** 2026-03-15T16:48:04.692685
 
 ## Summary
 
@@ -124,10 +124,10 @@
 
     ### 📁 `core/`
 
-    - 🏗️ **Layers:** Core, Domain
-    - 📊 **Tiers:** CRITICAL: 10, STANDARD: 149, TRIVIAL: 9
-    - 📄 **Files:** 13
-    - 📦 **Entities:** 168
+    - 🏗️ **Layers:** Core, Domain, Infra
+    - 📊 **Tiers:** CRITICAL: 11, STANDARD: 150, TRIVIAL: 9
+    - 📄 **Files:** 14
+    - 📦 **Entities:** 170
 
     **Key Entities:**
 
@@ -411,9 +411,9 @@
     ### 📁 `plugins/`
 
     - 🏗️ **Layers:** App, Plugin, Plugins
-    - 📊 **Tiers:** CRITICAL: 2, STANDARD: 62
+    - 📊 **Tiers:** CRITICAL: 2, STANDARD: 61
     - 📄 **Files:** 7
-    - 📦 **Entities:** 64
+    - 📦 **Entities:** 63
 
     **Key Entities:**
 
@@ -426,7 +426,7 @@
       - ℂ **MapperPlugin** (Class)
         - Plugin for mapping dataset columns verbose names.
       - ℂ **MigrationPlugin** (Class) `[CRITICAL]`
-        - Implementation of the migration plugin logic.
+        - Implementation of the migration plugin workflow and transfor...
       - ℂ **SearchPlugin** (Class)
         - Plugin for searching text patterns in Superset datasets.
       - 📦 **BackupPlugin** (Module)
@@ -436,13 +436,15 @@
       - 📦 **MapperPluginModule** (Module)
         - Implements a plugin for mapping dataset columns using extern...
       - 📦 **MigrationPlugin** (Module) `[CRITICAL]`
-        - A plugin that provides functionality to migrate Superset das...
+        - Orchestrates export, DB-mapping transformation, and import o...
 
     **Dependencies:**
 
+      - 🔗 DEPENDS_ON -> IdMappingService
+      - 🔗 DEPENDS_ON -> MigrationEngine
+      - 🔗 DEPENDS_ON -> SupersetClient
       - 🔗 DEPENDS_ON -> superset_tool.client
       - 🔗 DEPENDS_ON -> superset_tool.utils
-      - 🔗 IMPLEMENTS -> PluginBase
 
       ### 📁 `git/`
 
@@ -574,9 +576,9 @@
     ### 📁 `scripts/`
 
     - 🏗️ **Layers:** Scripts, UI, Unknown
-    - 📊 **Tiers:** CRITICAL: 1, STANDARD: 46, TRIVIAL: 30
+    - 📊 **Tiers:** CRITICAL: 1, STANDARD: 45, TRIVIAL: 30
     - 📄 **Files:** 9
-    - 📦 **Entities:** 77
+    - 📦 **Entities:** 76
 
     **Key Entities:**
 
@@ -2142,6 +2144,7 @@ graph TD
     core-->|DEPENDS_ON|backend
     core-->|DEPENDS_ON|backend
     core-->|DEPENDS_ON|backend
+    core-->|DEPENDS_ON|backend
     __tests__-->|TESTS|backend
     auth-->|USES|backend
     auth-->|USES|backend

.ai/PROJECT_MAP.md

@@ -2442,8 +2442,6 @@
   - 🏗️ Layer: Scripts
   - 🔒 Invariant: Safe to run multiple times (idempotent).
   - 🔗 CALLS -> `backend.src.core.database.init_db`
-  - ƒ **ensure_encryption_key** (`Function`)
-    - 📝 Ensure backend runtime has a persistent Fernet encryption key during first-time installation.
   - ƒ **run_init** (`Function`)
     - 📝 Main entry point for the initialization script.
 - 📦 **backend.src.scripts.create_admin** (`Module`)
@@ -2636,6 +2634,13 @@
     - 📝 Auto-detected function (orphan)
   - ƒ **as_bool** (`Function`) `[TRIVIAL]`
     - 📝 Auto-detected function (orphan)
+- 📦 **backend.src.core.encryption_key** (`Module`) `[CRITICAL]`
+  - 📝 Resolve and persist the Fernet encryption key required by runtime services.
+  - 🏗️ Layer: Infra
+  - 🔒 Invariant: Runtime key resolution never falls back to an ephemeral secret.
+  - 🔗 DEPENDS_ON -> `backend.src.core.logger`
+  - ƒ **ensure_encryption_key** (`Function`)
+    - 📝 Ensure backend runtime has a persistent valid Fernet key.
 - 📦 **ConfigManagerModule** (`Module`) `[CRITICAL]`
   - 📝 Manages application configuration persistence in DB with one-time migration from legacy JSON.
   - 🏗️ Layer: Domain
@@ -6522,29 +6527,29 @@
       - ƒ **_get_env** (`Function`)
         - 📝 Вспомогательный метод для получения конфигурации окружения.
 - 📦 **MigrationPlugin** (`Module`) `[CRITICAL]`
-  - 📝 A plugin that provides functionality to migrate Superset dashboards between environments.
+  - 📝 Orchestrates export, DB-mapping transformation, and import of Superset dashboards across environments.
   - 🏗️ Layer: App
+  - 🔒 Invariant: Dashboards must never be imported with unmapped/source DB connections to prevent data leaks or cross-environment pollution.
   - 🔗 IMPLEMENTS -> `PluginBase`
-  - 🔗 DEPENDS_ON -> `superset_tool.client`
-  - 🔗 DEPENDS_ON -> `superset_tool.utils`
+  - 🔗 DEPENDS_ON -> `SupersetClient`
+  - 🔗 DEPENDS_ON -> `MigrationEngine`
+  - 🔗 DEPENDS_ON -> `IdMappingService`
   - ℂ **MigrationPlugin** (`Class`) `[CRITICAL]`
-    - 📝 Implementation of the migration plugin logic.
+    - 📝 Implementation of the migration plugin workflow and transformation orchestration.
     - ƒ **id** (`Function`)
       - 📝 Returns the unique identifier for the migration plugin.
     - ƒ **name** (`Function`)
-      - 📝 Returns the human-readable name of the migration plugin.
+      - 📝 Returns the human-readable name of the plugin.
     - ƒ **description** (`Function`)
-      - 📝 Returns a description of the migration plugin.
+      - 📝 Returns the semantic description of the plugin.
     - ƒ **version** (`Function`)
-      - 📝 Returns the version of the migration plugin.
+      - 📝 Returns the semantic version of the migration plugin.
     - ƒ **ui_route** (`Function`)
-      - 📝 Returns the frontend route for the migration plugin.
+      - 📝 Returns the frontend routing anchor for the plugin.
     - ƒ **get_schema** (`Function`)
-      - 📝 Returns the JSON schema for migration plugin parameters.
+      - 📝 Generates the JSON Schema for the plugin execution form dynamically.
     - ƒ **execute** (`Function`)
-      - 📝 Executes the dashboard migration logic with TaskContext support.
-      - 📦 **MigrationPlugin.execute** (`Action`)
-        - 📝 Execute the migration logic with proper task logging.
+      - 📝 Orchestrates the dashboard migration pipeline including extraction, AST mutation, and ingestion.
 - 📦 **src.plugins** (`Package`)
   - 📝 Plugin package root for dynamic discovery and runtime imports.
 - ƒ **schedule_dashboard_validation** (`Function`)