This commit is contained in:
2026-06-08 15:08:02 +03:00
parent 3c84161606
commit 73e809e189
7 changed files with 289 additions and 565 deletions

View File

@@ -81,10 +81,11 @@ def format_timestamp(ts: datetime) -> str:
### C3 (Flow) — Module with nested functions, service layer
```python
# #region Migration.Dashboard [C:3] [TYPE Module] [SEMANTICS migration,dashboard]
# @BRIEF Dashboard migration service — export/import dashboards with validation.
# @defgroup Migration Dashboard export/import with validation.
# @LAYER Service
# #region Migration.Dashboard.Migrate [C:3] [TYPE Function] [SEMANTICS migration,dashboard]
# @ingroup Migration
# @BRIEF Migrate a single dashboard from source to target Superset instance.
# @RELATION DEPENDS_ON -> [SupersetClient]
# @RELATION DEPENDS_ON -> [DashboardValidator]
@@ -102,6 +103,7 @@ def migrate_dashboard(source_client, target_client, dashboard_id: str, db_mappin
### C4 (Orchestration) — Stateful operations with belief runtime
```python
# #region Migration.RunTask [C:4] [TYPE Function] [SEMANTICS migration,task,state]
# @ingroup Migration
# @BRIEF Execute a full migration task with rollback capability and progress reporting.
# @PRE Database connection is established. Task record exists with valid migration plan.
# @POST Task status updated to COMPLETED or FAILED. Migration audit log written.
@@ -139,6 +141,7 @@ async def run_migration_task(task_id: str, db_session) -> dict:
### C5 (Critical) — With decision memory
```python
# #region Index.Rebuild [C:5] [TYPE Function] [SEMANTICS indexing,recovery,semantic]
# @ingroup Index
# @BRIEF Rebuild the full semantic index from source with atomic swap and rollback.
# @PRE Workspace root is accessible. Source files exist.
# @POST New index atomically swapped; old preserved for rollback.