Implementation Plan: Dataset Lifecycle Workspace

Branch: 030-dataset-lifecycle-workspace | Date: 2026-05-19 | Spec: spec.md Input: Feature specification from specs/030-dataset-lifecycle-workspace/spec.md

Summary

Переработка страницы датасетов (/datasets) из табличного вида в полноценное split-view рабочее пространство с: (1) Stats Bar с 4 агрегирующими метриками и клиентской фильтрацией, (2) split-view с карточками датасетов слева и детальной панелью справа, (3) inline-редактированием описаний колонок и метрик через новые ss-tools API эндпоинты, (4) WebSocket-автообновлением при завершении фоновых задач, (5) отображением метрик из Superset API. Изменения затрагивают бэкенд (3 новых DTO, 2 новых эндпоинта, модификация 2 существующих) и фронтенд (5 новых компонентов, переписанный +page.svelte).

Technical Context

Language/Version: Python 3.9+ (backend), JavaScript/TypeScript — Svelte 5 runes (frontend) Primary Dependencies: FastAPI 0.104+, Pydantic v2, SQLAlchemy (backend); SvelteKit 2.x, Svelte 5.x, Vite 7.x, Tailwind CSS 3.x (frontend) Storage: PostgreSQL 16 (ss-tools own DB); no schema changes in this feature Testing: pytest (backend), vitest + @testing-library/svelte 5.x (frontend) Target Platform: Linux server (Docker), modern browsers Project Type: web application (FastAPI REST + WebSocket backend, SvelteKit SPA frontend) Performance Goals: Split-view dataset switch <500ms, inline-edit save <1s, initial Stats Bar load <200ms Constraints: <400 lines per module (INV_7), RBAC on all new endpoints, Tailwind-only styling, Svelte 5 runes only Scale/Scope: 33 datasets (current), single environment (dev), 5 new frontend components, 2 new API endpoints

Constitution Check

GATE: Must pass before Phase 0 research. Re-check after Phase 1 design.

Principle	Status	Notes
Library-First	✅ N/A	No new library extracted
Semantic Protocol (ADR-0002)	✅ PASS	All C4/C5 contracts use belief_scope/reason/reflect markers. All components use @UX_STATE. @RATIONALE/@REJECTED on key decisions.
Orchestrator Pattern (ADR-0003)	✅ PASS	Backend proxies Superset API; no direct frontend-to-Superset calls
Plugin Architecture (ADR-0004)	✅ PASS	No new plugin; mapping/docs reuse existing MapperPlugin/DocumentationPlugin
Auth RBAC (ADR-0005)	✅ PASS	New endpoints gated: `has_permission("plugin:migration","READ")`
Frontend Svelte 5 Runes (ADR-0006)	✅ PASS	All components use $state/$derived/$props/$effect
Anti-Erosion (INV_7)	✅ PASS	New components <400 lines each; no monolithic page

No blocking conflicts detected.

Project Structure

Documentation (this feature)

specs/030-dataset-lifecycle-workspace/
├── plan.md              # This file
├── research.md          # 10 research decisions
├── data-model.md        # Pydantic schemas, frontend types, state machines
├── quickstart.md        # Verification commands
├── contracts/
│   └── modules.md       # 16 contracts with complexity classes
├── spec.md              # Feature specification (7 user stories, 24 FR)
├── ux_reference.md      # UX interaction reference
└── checklists/
    └── requirements.md  # 44 checklist items

Source Code Changes

backend/
├── src/
│   ├── api/routes/
│   │   └── datasets.py           # +MetricItem, +StatsCounts, +2 endpoints, MOD DatasetsResponse
│   └── core/
│       ├── superset_client/
│       │   └── _datasets.py      # MOD get_dataset_detail (metrics extraction)
│       └── task_manager.py       # MOD on_task_complete (WebSocket event)
└── tests/
    └── __tests__/
        └── test_datasets.py      # +tests for new endpoints and metrics

frontend/
├── src/
│   ├── routes/datasets/
│   │   ├── +page.svelte          # REWRITE (split-view orchestrator, ~200 lines)
│   │   ├── StatsBar.svelte       # NEW (4 metric tiles, ~80 lines)
│   │   ├── DatasetList.svelte    # NEW (card grid, pagination, ~250 lines)
│   │   ├── DatasetPreview.svelte # NEW (detail panel, ~150 lines)
│   │   ├── ColumnsTable.svelte   # NEW (inline-edit columns, ~180 lines)
│   │   └── MetricsTable.svelte   # NEW (inline-edit metrics, ~150 lines)
│   └── lib/i18n/locales/
│       ├── en/datasets.json      # +11 keys
│       └── ru/datasets.json      # +11 keys
└── tests/
    └── routes/datasets/
        └── dataset_workspace.test.js  # +component tests for new components

Complexity Tracking

No violations. All components adhere to C1-C5 tier rules per ADR-0002.

Contract	C	Justification
MetricItem, StatsCounts, *Update DTOs	1	Pure data classes, anchors only
DatasetDetailResponse, DatasetsResponse (mod)	2	DTOs with @PURPOSE
get_dataset_detail (mod), StatsBar, DatasetPreview	3	Multi-step logic with @RELATION
update_*_description endpoints, get_datasets (mod), DatasetList, ColumnsTable, MetricsTable	4	Stateful operations with @PRE/@POST/@SIDE_EFFECT
DatasetHub (+page.svelte rewrite)	5	Orchestrator with @DATA_CONTRACT, @INVARIANT, decision memory

5.7 KiB Raw Blame History Unescape Escape