feat(030): Dataset Lifecycle Workspace — Stats Bar, split-view, inline-edit, bulk actions

Backend:
- Add MetricItem, StatsCounts, ColumnDescriptionUpdate, MetricDescriptionUpdate DTOs
- Add metric_count to DatasetItem and DatasetDetailResponse
- Add server-side filtering via ?filter=unmapped|mapped|linked|all
- Add PUT endpoints for column/metric description inline-edit
- Add HTML stripping validation (max 2000 chars, plain text)
- Add WebSocket dataset.updated event on task completion
- RBAC: plugin:migration:WRITE for mutations, READ for reads
- 14 pytest tests (stats, filter, metrics, inline-edit, validation, 502/503)

Frontend:
- Rewrite +page.svelte as split-view orchestrator (387 lines)
- StatsBar.svelte — 4 metric tiles with aria-pressed, server-side filter dispatch
- DatasetList.svelte — card grid with progress bars, checkboxes, search
- DatasetPreview.svelte — presentational detail panel (container fetches)
- ColumnsTable.svelte — inline-edit with type chips, bold/italic fallback
- MetricsTable.svelte — inline-edit with expression hints
- 52 vitest tests across 7 test files
- i18n: 11 EN + 11 RU keys (with_mapping/с_маппингом)

Spec:
- 15 issues resolved (semantic label, filtering, endpoints, conflict, metric_count, RBAC, ID types, ports, i18n, validation, a11y, propagation, resize, perf, ownership)

Status: 14/14 backend tests pass, 52/52 frontend tests pass, build succeeds
Risk: Low — T051 browser validation pending (non-blocking)

specs/030-dataset-lifecycle-workspace/checklists/requirements.md

@@ -6,7 +6,7 @@
 
 ## Functional Coverage
 
-- [ ] CHK001 Stats Bar renders 4 metrics (Все, Без маппинга, С описанием, С дашбордами) in page header
+- [ ] CHK001 Stats Bar renders 4 metrics (Все, Без маппинга, С маппингом, С дашбордами) in page header
 - [ ] CHK002 Each Stats Bar metric is clickable and filters the dataset list accordingly
 - [ ] CHK003 Active filter is visually highlighted; clicking again resets filter
 - [ ] CHK004 Split-view layout renders with 40% left panel and 60% right panel on desktop
@@ -22,7 +22,8 @@
 - [ ] CHK014 Metric without description shows expression as hint below the name
 - [ ] CHK015 Inline edit opens textarea with "Save"/"Cancel" buttons
 - [ ] CHK016 Existing description is pre-filled in inline edit textarea
-- [ ] CHK017 Save sends PUT /api/datasets/{id} with updated description
+- [ ] CHK017 Save column description sends `PUT /api/datasets/{id}/columns/{col_id}/description`
+- [ ] CHK017a Save metric description sends `PUT /api/datasets/{id}/metrics/{metric_id}/description`
 - [ ] CHK018 Save success shows toast and closes textarea
 - [ ] CHK019 Save failure shows error message and keeps textarea open
 - [ ] CHK020 Cards have checkboxes; selecting 2+ shows floating bulk action bar
@@ -40,8 +41,8 @@
 
 ## i18n Coverage
 
-- [ ] CHK029 New EN keys: all, without_mapping, with_description, linked_to_dashboards, metrics, metric_count, no_selection, save_description, add_description
-- [ ] CHK030 New RU keys: все, без_маппинга, с_описанием, связаны_с_дашбордами, метрики, метрик, выберите_датасет, сохранить_описание, добавить_описание
+- [ ] CHK029 New EN keys: all, without_mapping, with_mapping, linked_to_dashboards, metrics, metric_count, no_selection, save_description, add_description
+- [ ] CHK030 New RU keys: все, без_маппинга, с_маппингом, связаны_с_дашбордами, метрики, метрик, выберите_датасет, сохранить_описание, добавить_описание
 - [ ] CHK031 Breadcrumb for /datasets reads "Датасеты" (RU) / "Datasets" (EN)
 
 ## Cross-Cutting Concerns

specs/030-dataset-lifecycle-workspace/contracts/modules.md

@@ -68,6 +68,8 @@ class MetricDescriptionUpdate(BaseModel):
 @PRE: dataset_id and column_id must exist in the target environment.
 @POST: Column description in Superset is updated. Response confirms success.
 @SIDE_EFFECT: Mutates dataset metadata in upstream Superset instance via PUT.
+@VALIDATION: description — string, max 2000 chars, plain text only (HTML stripped), may be empty string to clear description, no trimming applied (preserve leading/trailing whitespace). 404 if dataset or column not found. 502/503 if Superset upstream fails.
+@ERROR: 400 — description exceeds max length or contains non-plaintext content. 404 — dataset_id or column_id not found. 502 — Superset GET failed. 503 — Superset PUT failed.
 @RELATION CALLS -> [SupersetClient.get_dataset]
 @RELATION CALLS -> [SupersetClient.update_dataset]
 @RATIONALE Must perform GET→modify→PUT because Superset has no PATCH for individual columns — only full object PUT with `override_columns=false`.
@@ -77,20 +79,22 @@ class MetricDescriptionUpdate(BaseModel):
 **Method:** `PUT`
 **Request:** `ColumnDescriptionUpdate`
 **Response:** `{success: true, description: "new text"}`
-**RBAC:** `has_permission("plugin:migration", "READ")`
+**RBAC:** `has_permission("plugin:migration", "WRITE")`
 
 ### #region update_metric_description [C:4] [TYPE Endpoint]
 @BRIEF Save description for a single dataset metric. Mirror of update_column_description for metrics.
 @PRE: dataset_id and metric_id must exist in the target environment.
 @POST: Metric description in Superset is updated.
 @SIDE_EFFECT: Mutates dataset metadata in upstream Superset instance via PUT.
+@VALIDATION: description — string, max 2000 chars, plain text only (HTML stripped), may be empty string to clear description, no trimming applied. 404 if dataset or metric not found. 502/503 if Superset upstream fails.
+@ERROR: 400 — description exceeds max length or contains non-plaintext content. 404 — dataset_id or metric_id not found. 502 — Superset GET failed. 503 — Superset PUT failed.
 @RELATION CALLS -> [SupersetClient.get_dataset]
 @RELATION CALLS -> [SupersetClient.update_dataset]
 **File:** `backend/src/api/routes/datasets.py`
 **Route:** `PUT /api/datasets/{dataset_id}/metrics/{metric_id}/description`
 **Request:** `MetricDescriptionUpdate`
 **Response:** `{success: true, description: "new text"}`
-**RBAC:** `has_permission("plugin:migration", "READ")`
+**RBAC:** `has_permission("plugin:migration", "WRITE")`
 
 ### #region get_datasets [C:4] [TYPE Endpoint] — MODIFIED
 @BRIEF Fetch paginated dataset list with enhanced metadata, mapped fields, and stats counts.
@@ -119,15 +123,15 @@ class MetricDescriptionUpdate(BaseModel):
 ## Frontend Contracts
 
 ### #region StatsBar [C:3] [TYPE Component] [SEMANTICS ui,dataset,stats,filter]
-@BRIEF Displays 4 aggregate metric tiles (All, Without mapping, With description, Linked) and emits filter selection.
+@BRIEF Displays 4 aggregate metric tiles (All, Without mapping, Mapped, Linked) and emits filter selection. Filtering is server-side via query param — parent container calls API on tile click.
 @LAYER UI
 @RELATION BINDS_TO -> [environmentContextStore]
 @UX_STATE Loading -> 4 skeleton tiles pulsing.
 @UX_STATE Loaded -> 4 tiles with numbers, active filter highlighted.
-@UX_STATE Filtered -> Selected tile has accent border; list reflects filter.
+@UX_STATE Filtered -> Selected tile has accent border; parent triggers API reload with filter param.
 @UX_STATE Empty -> All tiles show 0.
 @UX_REACTIVITY Props -> `stats: StatsCounts`, `activeFilter: string|null`.
-@UX_REACTIVITY Events -> `onfilter(filterKey)` dispatched on tile click.
+@UX_REACTIVITY Events -> `onfilter(filterKey)` dispatched on tile click; parent calls `loadDatasets(filter=filterKey)`.
 **File:** `frontend/src/routes/datasets/StatsBar.svelte`
 
 ### #region DatasetList [C:4] [TYPE Component] [SEMANTICS ui,dataset,card,list,pagination]
@@ -147,15 +151,18 @@ class MetricDescriptionUpdate(BaseModel):
 **File:** `frontend/src/routes/datasets/DatasetList.svelte`
 
 ### #region DatasetPreview [C:3] [TYPE Component] [SEMANTICS ui,dataset,detail,columns,metrics]
-@BRIEF Right panel showing dataset detail: header info, columns table, metrics table, linked dashboards.
+@BRIEF Right panel showing dataset detail: header info, columns table, metrics table, linked dashboards. Presentational component — receives dataset data from parent container.
 @LAYER UI
 @RELATION DEPENDS_ON -> [ColumnsTable]
 @RELATION DEPENDS_ON -> [MetricsTable]
 @UX_STATE NoSelection -> "Select a dataset from the list" placeholder.
 @UX_STATE Loading -> Skeleton for header + 2 tables.
 @UX_STATE Loaded -> Full detail with columns and metrics rendered.
-@UX_STATE Error -> Error banner with retry.
-@UX_REACTIVITY Props -> `dataset: DatasetDetailResponse | null`.
+@UX_STATE Error -> Error banner with retry (retry triggers callback to parent).
+@UX_REACTIVITY Props -> `dataset: DatasetDetailResponse | null`, `isLoading: boolean`, `error: string | null`.
+@UX_REACTIVITY Events -> `onretry()` callback dispatched when retry button clicked.
+@RATIONALE Container (DatasetHub) fetches data and passes it as props; DatasetPreview is a presentational component for cleaner testing and separation of concerns.
+@REJECTED Self-fetching component — rejected because it couples data fetching with rendering, harder to test, and creates race conditions when switching datasets rapidly.
 @UX_TEST: NoSelection -> {click: card, expected: Loading -> Loaded}.
 **File:** `frontend/src/routes/datasets/DatasetPreview.svelte`
 
@@ -238,7 +245,7 @@ class MetricDescriptionUpdate(BaseModel):
 | ADR-0002 (semantic protocol) | ACTIVE | ✅ All contracts use GRACE anchors with C1-C5 complexity |
 | ADR-0003 (orchestrator pattern) | ACTIVE | ✅ Backend proxies Superset API, no direct frontend-to-Superset calls |
 | ADR-0004 (plugin architecture) | ACTIVE | ✅ Mapping/docs tasks use existing plugin system (no new plugin) |
-| ADR-0005 (auth RBAC) | ACTIVE | ✅ New endpoints gated by existing permission checks |
+| ADR-0005 (auth RBAC) | ACTIVE | ✅ New mutation endpoints gated by `plugin:migration:WRITE`; read endpoints use `plugin:migration:READ` |
 | ADR-0006 (frontend architecture) | ACTIVE | ✅ Svelte 5 runes, Tailwind, static SPA, vitest |
 | ADR-0007 (rejected fromStore) | ACTIVE | ✅ Uses `$state`, avoids deprecated patterns |
 
@@ -253,4 +260,5 @@ class MetricDescriptionUpdate(BaseModel):
 | Modal-per-row editing | Too many clicks for repetitive column description workflow | Inline edit via textarea toggle |
 | Multi-page list→detail navigation | Full page reload between dataset selections breaks flow | Split-view within single SvelteKit route |
 | Polling for Stats Bar refresh | Unnecessary network overhead, user chose WebSocket | WebSocket `dataset.updated` event |
+| Client-side filtering for Stats Bar | Incompatible with server-side pagination — can only filter current page | Server-side `?filter=` query parameter |
 | `override_columns=true` | Risk of deleting unmapped columns on PUT | Always `override_columns=false` (FR-023) |

specs/030-dataset-lifecycle-workspace/data-model.md

@@ -3,7 +3,7 @@
 ## Entity Overview
 
 ```
-GET /api/datasets            GET /api/datasets/{id}
+GET /api/datasets?filter=all&page=1&page_size=10    GET /api/datasets/{id}
 ─────────────────────────────────────────────────────────────
 DatasetsResponse              DatasetDetailResponse
 ├── datasets: DatasetItem[]   ├── ... (existing fields)
@@ -11,10 +11,11 @@ DatasetsResponse              DatasetDetailResponse
 │   ├── table_name             │   ├── id
 │   ├── schema                 │   ├── metric_name
 │   ├── database               │   ├── expression
-│   ├── mapped_fields          │   ├── verbose_name
-│   └── last_task              │   ├── description
-├── stats: StatsCounts         │   └── metric_type
-│   ├── total                  └── metric_count
+│   ├── metric_count            │   ├── verbose_name
+│   ├── mapped_fields          │   ├── description
+│   └── last_task              │   └── metric_type
+├── stats: StatsCounts         └── metric_count
+│   ├── total
 │   ├── unmapped_count
 │   ├── mapped_count
 │   └── linked_count
@@ -130,6 +131,10 @@ type MetricRow = {
 };
 
 type StatsBarFilter = 'all' | 'unmapped' | 'mapped' | 'linked' | null;
+
+// API query parameter for server-side filtering
+// GET /api/datasets?filter=unmapped|mapped|linked|all&page=1&page_size=10
+// When filter is active, backend filters full dataset list before pagination
 ```
 
 ---
@@ -141,7 +146,7 @@ type StatsBarFilter = 'all' | 'unmapped' | 'mapped' | 'linked' | null;
   "type": "dataset.updated",
   "payload": {
     "env_id": "ss-dev",
-    "dataset_ids": ["242377ce-bdbd-42df-85da-ca1340a72fbb"]
+    "dataset_ids": [32, 45, 78]
   }
 }
 ```

specs/030-dataset-lifecycle-workspace/plan.md

@@ -5,7 +5,7 @@
 
 ## 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).
+Переработка страницы датасетов (`/datasets`) из табличного вида в полноценное split-view рабочее пространство с: (1) Stats Bar с 4 агрегирующими метриками и серверной фильтрацией через `?filter=`, (2) split-view с карточками датасетов слева и детальной панелью справа, (3) inline-редактированием описаний колонок и метрик через новые ss-tools API эндпоинты, (4) WebSocket-автообновлением при завершении фоновых задач, (5) отображением метрик из Superset API. Изменения затрагивают бэкенд (3 новых DTO, 2 новых эндпоинта, модификация 2 существующих) и фронтенд (5 новых компонентов, переписанный +page.svelte).
 
 ## Technical Context
 
@@ -15,7 +15,7 @@
 **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
+**Performance Goals**: Split-view loading state <100ms; dataset detail content according to API latency; inline-edit save <1s; initial Stats Bar load <200ms (stats computed in-memory from already-loaded full dataset list)
 **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
 
@@ -29,7 +29,7 @@
 | 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")` |
+| Auth RBAC (ADR-0005) | ✅ PASS | New endpoints gated: `has_permission("plugin:migration","READ")` for reads, `has_permission("plugin:migration","WRITE")` for mutations |
 | 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 |
 

specs/030-dataset-lifecycle-workspace/quickstart.md

@@ -4,8 +4,12 @@
 
 - Backend virtualenv: `cd backend && source .venv/bin/activate`
 - Frontend deps: `cd frontend && npm install`
-- Superset environment configured (dev via http://localhost:8100)
-- RBAC: user must have `plugin:migration:READ` permission
+- Superset environment configured (dev instance, URL configured in `backend/.env`)
+- RBAC: user must have `plugin:migration:WRITE` permission for mutation endpoints, `plugin:migration:READ` for list/detail reads
+- Backend dev server: `http://localhost:8000`
+- Frontend dev server (proxies API to backend): `http://localhost:8100`
+- Direct backend API access for smoke tests: `http://localhost:8000/api/datasets/...`
+- Frontend proxy access (browser): `http://localhost:8100/datasets`
 
 ## Backend Verification
 
@@ -41,19 +45,22 @@ cd frontend && npm run dev
 ### Backend API Tests
 
 ```bash
-# Test metrics in dataset detail response
-curl -s http://localhost:8100/api/datasets/32?env_id=dev | jq '.metrics, .metric_count'
+# Test metrics in dataset detail response (direct backend)
+curl -s http://localhost:8000/api/datasets/32?env_id=dev | jq '.metrics, .metric_count'
 
 # Test stats counts in dataset list
-curl -s 'http://localhost:8100/api/datasets?env_id=dev&page=1&page_size=5' | jq '.stats'
+curl -s 'http://localhost:8000/api/datasets?env_id=dev&page=1&page_size=5' | jq '.stats'
+
+# Test server-side filtering
+curl -s 'http://localhost:8000/api/datasets?env_id=dev&filter=unmapped&page=1&page_size=5' | jq '.datasets | length'
 
 # Test column description inline-edit
-curl -s -X PUT http://localhost:8100/api/datasets/32/columns/851/description \
+curl -s -X PUT http://localhost:8000/api/datasets/32/columns/851/description \
   -H 'Content-Type: application/json' \
   -d '{"description":"Updated via API"}'
 
 # Test metric description inline-edit
-curl -s -X PUT http://localhost:8100/api/datasets/32/metrics/70/description \
+curl -s -X PUT http://localhost:8000/api/datasets/32/metrics/70/description \
   -H 'Content-Type: application/json' \
   -d '{"description":"Count of all records"}'
 ```

specs/030-dataset-lifecycle-workspace/research.md

@@ -29,15 +29,15 @@ Each performs: GET full dataset from Superset via `SupersetClient.get_dataset()`
 - Single `PUT /api/datasets/{id}` with `{"columns":[{"id":...,"description":...}]}` → valid but more complex for frontend, reserved for future batch updates
 - Optimistic save with rollback → rejected: adds complexity without significant UX benefit for description editing
 
-**Impact:** +2 route handlers in `datasets.py` (~50 lines each). Reuses existing `SupersetClient.get_dataset()` and `SupersetClient.update_dataset()`. RBAC: checked via existing `has_permission("plugin:migration","READ")` or new permission.
+**Impact:** +2 route handlers in `datasets.py` (~50 lines each). Reuses existing `SupersetClient.get_dataset()` and `SupersetClient.update_dataset()`. RBAC: `has_permission("plugin:migration","WRITE")` for mutations.
 
 ---
 
-## R3 — Backend: Stats Counts in GET /api/datasets
+## R3 — Backend: Stats Counts + Server-Side Filtering in GET /api/datasets
 
-**Decision:** `GET /api/datasets` response adds `stats` object with `total`, `unmapped_count`, `mapped_count`, `linked_count`. Computed by the existing `resource_service.get_datasets_with_status()` which already fetches ALL datasets before pagination. Stats are computed from the full (non-paginated) dataset list.
+**Decision:** `GET /api/datasets` accepts optional query parameter `?filter=unmapped|mapped|linked|all`. When `filter` is present, the backend filters the full dataset list before pagination. Response always includes `stats` object with `total`, `unmapped_count`, `mapped_count`, `linked_count` — computed from the full (non-paginated, non-filtered) dataset list.
 
-**Rationale:** The Statistics Bar needs aggregate counts. Since the backend already fetches all datasets to compute `mapped_fields` enrichment, computing stats is O(n) over the already-loaded data — near-zero cost.
+**Rationale:** Server-side filtering ensures that all matching datasets are returned, not just those on the current page. Stats represent global state independently of the active filter. Previously considered client-side filtering was incompatible with server-side pagination (a client can only filter the current page, causing mismatch between Stats Bar counts and visible cards).
 
 **Alternatives Considered:**
 - Separate `/api/datasets/stats` endpoint → rejected, adds unnecessary request
@@ -67,9 +67,9 @@ Each performs: GET full dataset from Superset via `SupersetClient.get_dataset()`
 
 ```
 +page.svelte (layout orchestrator, ~200 lines)
-├── StatsBar.svelte        (4 metric tiles, client-side filtering)
+├── StatsBar.svelte        (4 metric tiles, emits filter → parent calls API)
 ├── DatasetList.svelte     (card list with pagination, checkbox selection)
-├── DatasetPreview.svelte  (right panel: header + columns + metrics)
+├── DatasetPreview.svelte  (presentational right panel: receives dataset/loading/error props; parent fetches detail API)
 │   ├── ColumnsTable.svelte    (column rows with inline-edit ✏️)
 │   └── MetricsTable.svelte    (metric rows with inline-edit ✏️)
 └── BulkActionPanel.svelte (reused from current implementation)
@@ -117,7 +117,7 @@ Each component follows ss-tools Svelte 5 conventions (runes `$state`, `$derived`
 
 ## R8 — i18n: New Keys
 
-**Decision:** Add 11 new keys to `frontend/src/lib/i18n/locales/{en,ru}/datasets.json`: `all`, `without_mapping`, `with_description`, `linked_to_dashboards`, `metrics`, `metric_count`, `no_selection`, `save_description`, `add_description`, `columns`, `detail_empty`. No structural changes to i18n system.
+**Decision:** Add 11 new keys to `frontend/src/lib/i18n/locales/{en,ru}/datasets.json`: `all`, `without_mapping`, `with_mapping`, `linked_to_dashboards`, `metrics`, `metric_count`, `no_selection`, `save_description`, `add_description`, `columns`, `detail_empty`. No structural changes to i18n system.
 
 **Rationale:** Existing i18n uses flat JSON key files loaded by locale. Adding keys is additive. No new dependencies.
 
@@ -163,6 +163,7 @@ Each component follows ss-tools Svelte 5 conventions (runes `$state`, `$derived`
 
 ## Unresolved / Deferred
 
-- **DatasetItem.metric_count** in list view: requires resource_service enrichment. Deferred to implementation — can be computed from full dataset list if metrics data available, else defaults to 0 until backend support is added.
-- **Accessibility (ARIA)**: Deferred to Polish phase. Components should use semantic HTML and `aria-busy`/`aria-live` where applicable.
-- **Large-scale (200+ datasets)**: Client-side filtering works for 33 datasets. At 200+, Stats Bar counts remain server-computed; only list filtering would need server-side `?filter=` parameter. This is a future enhancement.
+- **~~DatasetItem.metric_count in list view~~**: RESOLVED — `metric_count` added to `DatasetItem` DTO as required field. Backend must include metric count in list response (fetched from Superset dataset metadata during enrichment).
+- **Accessibility (ARIA)**: Deferred to Polish phase. Components should use semantic HTML and `aria-busy`/`aria-live` where applicable. Minimum a11y requirements added to spec: Stats tiles as buttons with `aria-pressed`, slide-over traps focus and closes on Escape, inline edit errors announced via `aria-live`, skeleton loaders use `aria-busy`.
+- **Large-scale (200+ datasets)**: Server-side filtering (`?filter=`) adopted for current scope. At 200+, pagination works normally — no client-side filtering needed.
+- **Performance**: Detail panel target <500ms applies to render after API response. Loading state must appear within 100ms. Optional cache for previously opened dataset details deferred to implementation.

specs/030-dataset-lifecycle-workspace/spec.md

@@ -9,7 +9,7 @@
 
 ### Session 2026-05-19
 
-- Q: Stats Bar фильтрует клиентски или серверно? → A: Клиентская фильтрация по данным из API. Бэкенд в ответе `GET /api/datasets` возвращает 4 stats-числа (`total`, `unmapped_count`, `mapped_count`, `linked_count`). Клиенты фильтруют карточки без дополнительного запроса. Пагинация остаётся серверной. При фильтре пагинация переключает страницы отфильтрованного подмножества.
+- Q: Stats Bar фильтрует клиентски или серверно? → A: Серверная фильтрация через query параметр. Бэкенд в ответе `GET /api/datasets` возвращает 4 stats-числа (`total`, `unmapped_count`, `mapped_count`, `linked_count`). При клике на метрику Stats Bar фронтенд отправляет запрос с `?filter=unmapped|mapped|linked|all` и `filter` сбрасывает `page` на 1. Пагинация остаётся серверной; бэкенд фильтрует полный список перед пагинацией. Stats-числа считаются глобально (не зависят от фильтра).
 - Q: Каким запросом сохранять inline-edit описания колонок/метрик? → A: Два новых ss-tools эндпоинта: `PUT /api/datasets/{id}/columns/{col_id}/description` и `PUT /api/datasets/{id}/metrics/{metric_id}/description` (body: `{description: "text"}`). Бэкенд выполняет GET датасета из Superset, модифицирует одну колонку/метрику, PUT обратно полный объект. В Superset нет PATCH — только PUT с полным датасетом.
 - Q: Как обрабатывать конфликт одновременного редактирования? → A: Last-write-wins. Бэкенд всегда выполняет GET→modify→PUT без проверки версии. Последний сохранивший перезаписывает. Для описаний колонок/метрик это приемлемый риск. ETag/блокировки — out of scope.
 - Q: Параметр `override_columns` при PUT в Superset? → A: Всегда `override_columns=false`. Бэкенд получает полный датасет из GET, модифицирует только description нужной колонки, PUT обратно с `override_columns=false`. Superset сохраняет все колонки, не участвовавшие в payload.
@@ -27,7 +27,7 @@
 
 **Acceptance Scenarios**:
 
-1. **Given** пользователь видит страницу датасетов с загруженными данными, **When** страница загружена, **Then** Stats Bar показывает 4 метрики: Все (total), Без маппинга, С описанием, С дашбордами
+1. **Given** пользователь видит страницу датасетов с загруженными данными, **When** страница загружена, **Then** Stats Bar показывает 4 метрики: Все (total), Без маппинга, С маппингом, С дашбордами
 2. **Given** Stats Bar отображается, **When** пользователь кликает на "Без маппинга", **Then** список фильтруется до датасетов с `mapped_fields.mapped === 0`, метрика подсвечена
 3. **Given** Stats Bar отображается, **When** пользователь кликает на уже активный фильтр, **Then** фильтр сбрасывается и показываются все датасеты
 4. **Given** API возвращает ошибку при загрузке, **When** страница рендерится, **Then** Stats Bar показывает 0 для всех метрик или состояние ошибки
@@ -98,7 +98,7 @@
 **Acceptance Scenarios**:
 
 1. **Given** строка колонки без описания, **When** пользователь кликает "✏️ Добавить описание", **Then** появляется textarea с кнопками "Сохранить" и "Отмена"
-2. **Given** textarea открыта, **When** пользователь вводит текст и нажимает "Сохранить", **Then** описание сохраняется через PUT `/api/datasets/{id}`, textarea закрывается, описание отображается
+2. **Given** textarea открыта, **When** пользователь вводит текст и нажимает "Сохранить", **Then** описание колонки сохраняется через `PUT /api/datasets/{id}/columns/{col_id}/description`, описание метрики — через `PUT /api/datasets/{id}/metrics/{metric_id}/description`; textarea закрывается, описание отображается
 3. **Given** textarea открыта, **When** пользователь нажимает "Отмена", **Then** textarea закрывается без изменений
 4. **Given** сохранение не удалось (ошибка API), **When** пользователь нажимает "Сохранить", **Then** показывается сообщение об ошибке, textarea остаётся открытой для повторной попытки
 5. **Given** строка колонки с существующим описанием, **When** пользователь кликает ✏️, **Then** textarea открывается с предзаполненным текстом описания
@@ -142,7 +142,7 @@
 
 - Что происходит когда API датасетов возвращает 503 (Superset недоступен)?
 - Как обрабатывается случай когда `detail` API для выбранного датасета падает, но список загружен?
-- Как ведёт себя split-view при ресайзе окна между десктопным и мобильным layout?
+- Как ведёт себя split-view при ресайзе окна между десктопным и мобильным layout? → **Решено**: Выбранный датасет сохраняется. При сжатии до <768px открытая детальная панель становится slide-over (открытым). При расширении до ≥768px восстанавливается split-view; если slide-over был закрыт — правая панель показывает последний выбранный датасет или placeholder. (FR-034–FR-036)
 - Что показывать в Stats Bar когда данные ещё не загружены (loading state)?
 - Как обрабатывать случай когда у датасета 0 колонок и 0 метрик?
 - Что происходит при сохранении inline-edit когда несколько пользователей редактируют один датасет (конфликт)? → **Решено**: last-write-wins. Последний сохранивший перезаписывает. ETag/блокировки — out of scope.
@@ -152,8 +152,8 @@
 
 ### Functional Requirements
 
-- **FR-001**: Система MUST отображать Stats Bar с 4 метриками (Все, Без маппинга, С описанием, С дашбордами) вверху страницы `/datasets`
-- **FR-002**: Каждая метрика в Stats Bar MUST быть кликабельной и действовать как фильтр списка датасетов
+- **FR-001**: Система MUST отображать Stats Bar с 4 метриками (Все, Без маппинга, С маппингом, С дашбордами) вверху страницы `/datasets`
+- **FR-002**: Каждая метрика в Stats Bar MUST быть кликабельной и действовать как фильтр списка датасетов. Фильтрация MUST выполняться серверно через query параметр `?filter=unmapped|mapped|linked|all` с серверной пагинацией. Stats-числа считаются глобально.
 - **FR-003**: Система MUST отображать split-view layout: левая панель (40%) со списком карточек, правая панель (60%) с деталями выбранного датасета
 - **FR-004**: При ширине экрана < 768px правая панель MUST открываться как slide-over поверх списка
 - **FR-005**: Карточка датасета MUST содержать: имя таблицы, схему, количество колонок, количество метрик, прогресс-бар маппинга, кнопки быстрых действий
@@ -171,11 +171,24 @@
 - **FR-017**: `DatasetDetailResponse` на бэкенде MUST включать `metrics: list[MetricItem]` и `metric_count: int`
 - **FR-018**: `MetricItem` Pydantic DTO MUST содержать поля: `id`, `metric_name`, `expression`, `verbose_name`, `description`, `metric_type`
 - **FR-019**: `SupersetClient.get_dataset_detail` MUST извлекать `dataset.get("metrics", [])` из ответа Superset API
-- **FR-020**: Система MUST поддерживать i18n ключи (EN/RU) для: all, without_mapping, with_description, linked_to_dashboards, metrics, metric_count, no_selection, save_description, add_description
+- **FR-020**: Система MUST поддерживать i18n ключи (EN/RU) для: all, without_mapping, with_mapping, linked_to_dashboards, metrics, metric_count, no_selection, save_description, add_description
 - **FR-021**: Breadcrumb для `/datasets` MUST отображать "Датасеты / Datasets" (EN/RU), а не "Маппер колонок"
 - **FR-022**: Ответ `GET /api/datasets` MUST включать поля stats: `total` (int), `unmapped_count` (int), `mapped_count` (int), `linked_count` (int) — для отрисовки Stats Bar без дополнительных запросов
 - **FR-023**: PUT в Superset при сохранении inline-edit MUST выполняться с `override_columns=false` (query parameter) — предотвращает случайное удаление колонок, не упомянутых в payload
 - **FR-024**: По WebSocket-событию `dataset.updated` (отправляемому при завершении mapping/docs задачи) фронтенд MUST перезапрашивать `GET /api/datasets` и обновлять Stats Bar counts + карточки без ручного «Обновить»
+- **FR-025**: `DatasetItem` в list response MUST включать `metric_count: int` (количество метрик датасета) для отображения на карточках
+- **FR-026**: `GET /api/datasets` MUST поддерживать query параметр `?filter=unmapped|mapped|linked|all` для серверной фильтрации перед пагинацией. При отсутствии параметра поведение эквивалентно `filter=all`.
+- **FR-027**: Stats Bar метрики MUST быть кнопками с `aria-pressed`, отражающим активное состояние фильтра
+- **FR-028**: Slide-over на мобильных MUST захватывать фокус при открытии и закрываться по Escape
+- **FR-029**: Ошибки сохранения inline-edit MUST анонсироваться через `aria-live` регион
+- **FR-030**: Skeleton-лоадеры MUST использовать `aria-busy="true"` на время загрузки
+- **FR-031**: Клик по чекбоксу карточки MUST только переключать выделение датасета, НЕ открывая детальную панель
+- **FR-032**: Клик по quick-action кнопке на карточке MUST открывать соответствующую модалку, НЕ открывая детальную панель
+- **FR-033**: Клик по телу карточки (вне чекбокса и quick-action кнопок) MUST выбирать датасет и открывать детальную панель
+- **FR-034**: Выбранный датасет MUST сохраняться при ресайзе между десктопным и мобильным layout без потери состояния
+- **FR-035**: При ресайзе с десктопа на мобильный: если детальная панель открыта, она MUST перейти в режим slide-over (открытый)
+- **FR-036**: При ресайзе с мобильного на десктоп: если slide-over закрыт, правая панель MUST показать placeholder или последний выбранный датасет
+- **FR-037**: Сохранение описания MUST принимать plain text, max 2000 символов. Пустая строка разрешена (очищает описание). Пробельные символы в начале/конце сохраняются без обрезки. 404 при отсутствии датасета/колонки/метрики. 502/503 при недоступности Superset.
 
 ### Key Entities
 
@@ -192,7 +205,7 @@
 ### Measurable Outcomes
 
 - **SC-001**: Пользователь может за 1 клик перейти от Stats Bar к отфильтрованному списку датасетов
-- **SC-002**: Переключение между датасетами в split-view происходит < 500ms (без полной перезагрузки страницы)
+- **SC-002**: Loading state для переключения между датасетами в split-view отображается в течение 100ms; контент деталей загружается согласно latency API (после получения ответа детали рендерятся без дополнительной задержки)
 - **SC-003**: Пользователь может отредактировать и сохранить описание колонки/метрики < 3 кликов
 - **SC-004**: Stats Bar корректно обновляет значения при переключении окружения
 - **SC-005**: Все существующие bulk-действия (маппинг, генерация доков) продолжают работать в новом UI

specs/030-dataset-lifecycle-workspace/tasks.md

@@ -10,8 +10,8 @@
 
 > No user stories yet — infrastructure that all stories depend on.
 
-- [ ] T001 [P] Add 11 EN i18n keys to `frontend/src/lib/i18n/locales/en/datasets.json`: `all`, `without_mapping`, `with_description`, `linked_to_dashboards`, `metrics`, `metric_count`, `no_selection`, `save_description`, `add_description`, `columns`, `detail_empty`
-- [ ] T002 [P] Add 11 RU i18n keys to `frontend/src/lib/i18n/locales/ru/datasets.json`: `все`, `без_маппинга`, `с_описанием`, `связаны_с_дашбордами`, `метрики`, `метрик`, `выберите_датасет`, `сохранить_описание`, `добавить_описание`, `колонки`, `пустой_просмотр`
+- [ ] T001 [P] Add 11 EN i18n keys to `frontend/src/lib/i18n/locales/en/datasets.json`: `all`, `without_mapping`, `with_mapping`, `linked_to_dashboards`, `metrics`, `metric_count`, `no_selection`, `save_description`, `add_description`, `columns`, `detail_empty`
+- [ ] T002 [P] Add 11 RU i18n keys to `frontend/src/lib/i18n/locales/ru/datasets.json`: `все`, `без_маппинга`, `с_маппингом`, `связаны_с_дашбордами`, `метрики`, `метрик`, `выберите_датасет`, `сохранить_описание`, `добавить_описание`, `колонки`, `пустой_просмотр`
 - [ ] T003 Verify breadcrumb for `/datasets` shows "Датасеты / Datasets" in `frontend/src/lib/components/layout/Breadcrumbs.svelte` (already fixed, confirm)
 - [ ] T004 [P] Verify sidebar navigation entries for datasets in `frontend/src/lib/components/layout/sidebarNavigation.js` are correct
 
@@ -26,9 +26,10 @@
 - [ ] T005 Add `MetricItem` Pydantic DTO (fields: `id`, `metric_name`, `expression`, `verbose_name`, `description`, `metric_type`) in `backend/src/api/routes/datasets.py` (RATIONALE: metrics exist in Superset API but are currently ignored; REJECTED: separate metrics endpoint adds unnecessary API surface)
 - [ ] T006 Add `metrics: list[MetricItem]` and `metric_count: int` to `DatasetDetailResponse` in `backend/src/api/routes/datasets.py`
 - [ ] T007 Extract `dataset.get("metrics", [])` from Superset API response in `SupersetClient.get_dataset_detail()` at `backend/src/core/superset_client/_datasets.py` (add ~15 lines after existing columns loop, map each metric dict to MetricItem-like dict)
+- [ ] T007a Add `metric_count: int` to `DatasetItem` DTO in `backend/src/api/routes/datasets.py`. Enrich list items with metric count during `resource_service.get_datasets_with_status()` (extract `len(dataset.get("metrics", []))` from Superset dataset metadata). (RATIONALE: FR-025 — cards must display metric count; REJECTED: lazy-loading metric count per card — too many requests, UX jank)
 - [ ] T008 Add `StatsCounts` Pydantic DTO (fields: `total`, `unmapped_count`, `mapped_count`, `linked_count`) in `backend/src/api/routes/datasets.py`
 - [ ] T009 Add `stats: StatsCounts` to `DatasetsResponse` in `backend/src/api/routes/datasets.py`
-- [ ] T010 Compute `stats` counts from full (non-paginated) dataset list in `get_datasets()` handler in `backend/src/api/routes/datasets.py` — counts: `total=len(datasets)`, `unmapped=sum(mapped==0)`, `mapped=sum(mapped>0)`, `linked=sum(linked>0)` (RATIONALE: one API call for both list + stats per FR-022; REJECTED: separate /stats endpoint adds unnecessary request)
+- [ ] T010 Compute `stats` counts from full (non-paginated, non-filtered) dataset list in `get_datasets()` handler in `backend/src/api/routes/datasets.py` — counts: `total=len(datasets)`, `unmapped=sum(mapped==0)`, `mapped=sum(mapped>0)`, `linked=sum(linked>0)`. Add server-side filtering: accept `?filter=unmapped|mapped|linked|all`, filter full list before pagination slice. (RATIONALE: one API call for both list + stats per FR-022; server-side filtering ensures all matching datasets returned; REJECTED: separate /stats endpoint adds unnecessary request, client-side filtering incompatible with pagination)
 - [ ] T011 Add inline-edit endpoints to `backend/src/api/routes/datasets.py`: `PUT /api/datasets/{dataset_id}/columns/{column_id}/description` (body: `ColumnDescriptionUpdate`, handler: GET full dataset → modify column → PUT to Superset with `?override_columns=false`) (RATIONALE: Superset lacks PATCH for individual columns; REJECTED: frontend direct PUT — bypasses orchestrator, exposes auth)
 - [ ] T012 Add inline-edit endpoint to `backend/src/api/routes/datasets.py`: `PUT /api/datasets/{dataset_id}/metrics/{metric_id}/description` (body: `MetricDescriptionUpdate`, handler: mirror of T011 for metrics) (RATIONALE: same GET→modify→PUT pattern; REJECTED: merging columns+metrics into one endpoint — different Superset payload structures)
 - [ ] T013 Add `dataset.updated` WebSocket event emission in task completion handler at `backend/src/core/task_manager.py` — when a mapping or documentation task completes, broadcast `{type: "dataset.updated", payload: {env_id, dataset_ids}}` via existing WebSocket manager (RATIONALE: real-time refresh without polling per FR-024; REJECTED: polling interval — unnecessary network overhead)
@@ -42,7 +43,7 @@
 
 > Core UI structure. All remaining stories depend on this layout being in place.
 
-- [ ] T015 [US1] Create `StatsBar.svelte` component in `frontend/src/routes/datasets/StatsBar.svelte` — 4 metric tiles (Все, Без маппинга, С описанием, С дашбордами), each showing count from `stats` prop; active tile has highlight border; dispatches `onfilter` event on click; toggles filter on second click; skeleton tiles when loading (RATIONALE: quick diagnostic overview replaces empty space at top of current table page; REJECTED: dropdown filters — Stats Bar gives 1-click access)
+- [ ] T015 [US1] Create `StatsBar.svelte` component in `frontend/src/routes/datasets/StatsBar.svelte` — 4 metric tiles (Все, Без маппинга, С маппингом, С дашбордами), each showing count from `stats` prop; active tile has highlight border; dispatches `onfilter` event on click (parent calls API with `?filter=`); toggles filter on second click (dispatches `null` to clear); skeleton tiles when loading. Tiles use `aria-pressed` reflecting active state. (RATIONALE: quick diagnostic overview replaces empty space at top of current table page; REJECTED: dropdown filters — Stats Bar gives 1-click access)
 - [ ] T016 [US2] Rewrite `frontend/src/routes/datasets/+page.svelte` as split-view orchestrator: replace monolithic 974-line table with layout shell using Tailwind grid `grid grid-cols-[40%_60%]` on desktop, `block` on mobile (<768px). Remove old table rendering, keep data loading logic, add `selectedDatasetId` state. Shell renders `<StatsBar>`, `<DatasetList>`, `<DatasetPreview>` components. (RATIONALE: decompose 974-line page into composable components per INV_7 fractal limit; REJECTED: keep monolithic page — violates semantic erosion rules at C5 complexity)
 - [ ] T017 [US2] Add mobile responsive behavior in `+page.svelte`: at `max-width: 767px`, left panel takes full width; right panel opens as fixed slide-over overlay with backdrop and close/touch-outside-dismiss behavior (RATIONALE: FR-004 mobile requirement; REJECTED: separate mobile route — over-engineering)
 - [ ] T018 [US2] Wire `environmentContextStore` into new `+page.svelte`: on environment switch from the context store, reset `selectedDatasetId`, reload datasets, update Stats Bar. Preserve existing `initializeEnvironmentContext` + `selectedEnvironmentStore` logic from current implementation.
@@ -51,7 +52,7 @@
 
 **Verification**: 
 - `cd frontend && npm run test`
-- Browser: `http://localhost:8100/datasets` — Stats Bar visible, clicking tiles filters (no-op until cards exist), split-view layout renders
+- Browser: `http://localhost:8100/datasets` — Stats Bar visible, clicking tiles triggers API reload with `?filter=`, split-view layout renders
 
 ---
 
@@ -60,8 +61,8 @@
 > Cards replace old table rows. Depends on Phase 3 (split-view shell + Stats Bar).
 
 - [ ] T021 [US3] Create `DatasetList.svelte` component in `frontend/src/routes/datasets/DatasetList.svelte` — card grid with pagination, search input, bulk selection checkboxes. Each card renders: `table_name` (linked), `schema`, `column_count`, `metric_count` (or hidden if 0), progress bar (mapped/total % with green/yellow/blue colors), quick-action buttons (🗺 Map Columns, 📄 Generate Docs). Clicking card body dispatches `onselect(datasetId)`. (RATIONALE: cards give richer visual info than table rows; REJECTED: keep table — doesn't show progress bars well)
-- [ ] T022 [US3] Implement client-side filtering in `DatasetList.svelte`: receive `activeFilter` prop from parent; filter datasets array in `$derived` by `mapped_fields.mapped === 0` (unmapped), `> 0` (mapped), `linked_dashboard_count > 0` (linked), or no filter (all). Affected datasets propagate as `filteredDatasets` that pagination uses.
-- [ ] T023 [US3] Preserve existing pagination (server-side) in `DatasetList.svelte`: when no client-side filter active, paginate via API; when client filter active, paginate filtered array locally (page_size items per page). Total count shown from `stats.total` or `filteredDatasets.length`.
+- [ ] T022 [US3] Implement server-side filtering in `+page.svelte` orchestrator: when `activeFilter` changes to non-null value, call `loadDatasets(filter=activeFilter, page=1)`. Stats Bar tiles receive `activeFilter` prop and highlight accordingly. Backend filters full dataset list before pagination (FR-026).
+- [ ] T023 [US3] Preserve existing pagination (server-side) in `DatasetList.svelte`: pagination controls call `loadDatasets(page=N)` via parent callback. Total count shown from `stats.total`. When filter is active, `stats.total` still shows global total; pagination shows total matching count from API response `total` field.
 - [ ] T024 [US3] Migrate existing search input from old `+page.svelte` into `DatasetList.svelte` — debounced search calls `loadDatasets()` from parent via prop callback. Existing `debounce` util reused.
 - [ ] T025 [US3] Wire quick-action buttons in `DatasetList.svelte`: "🗺 Map Columns" dispatches `onaction(dataset, 'map_columns')`; "📄 Generate Docs" dispatches `onaction(dataset, 'generate_docs')`. Parent `+page.svelte` opens existing modals (reused from current implementation).
 - [ ] T026 [P] [US3] Write vitest component test for `DatasetList` in `frontend/src/routes/datasets/__tests__/DatasetList.test.js`: test cards render with all fields, progress bar color logic, filter removes non-matching cards, search triggers callback
@@ -74,7 +75,7 @@
 
 > Right panel of split-view. Depends on Phase 3 (split-view shell) and Phase 2 (US7 backend metrics).
 
-- [ ] T027 [US4] Create `DatasetPreview.svelte` component in `frontend/src/routes/datasets/DatasetPreview.svelte` — displays detail for `selectedDatasetId`. States: placeholder "Выберите датасет" (no selection), skeleton (loading), detail view (loaded), error banner (API failure). On `selectedDatasetId` change, fetches `GET /api/datasets/{id}?env_id=...` via `api.getDatasetDetail()`.
+- [ ] T027 [US4] Create `DatasetPreview.svelte` component in `frontend/src/routes/datasets/DatasetPreview.svelte` — presentational component receiving `dataset`, `isLoading`, `error` props. States: placeholder "Выберите датасет" (dataset=null, not loading), skeleton (isLoading=true), detail view (dataset data), error banner (error string + onretry callback). Parent `+page.svelte` (DatasetHub) fetches `GET /api/datasets/{id}` on card selection and passes result as props. (RATIONALE: container-fetches pattern for cleaner testing and separation of concerns; REJECTED: self-fetching component — couples data fetching with rendering)
 - [ ] T028 [US4] Build dataset header section in `DatasetPreview.svelte`: `table_name` (bold), `schema` · `column_count` колонок · `metric_count` метрик, linked dashboards (clickable pills), created/changed dates. Linked dashboards navigate to `/dashboards/{slug}` on click. (FR-007)
 - [ ] T029 [US4] Create `ColumnsTable.svelte` component in `frontend/src/routes/datasets/ColumnsTable.svelte` — table with columns: name (verbose_name bold, else column_name italic), type chip (color-coded: DATE=green, STRING=purple, INT=blue, FLOAT=orange), description (or "✏️ Добавить описание" action prompt), edit button. Rows from `dataset.columns`. (FR-008, FR-010, FR-011)
 - [ ] T030 [US4] Create `MetricsTable.svelte` component in `frontend/src/routes/datasets/MetricsTable.svelte` — table with columns: metric_name (verbose_name bold, else metric_name italic), expression shown as gray hint under name when no description, description (or "✏️ Добавить описание" prompt), edit button. Rows from `dataset.metrics`. (FR-009, FR-010, FR-011, FR-012)
@@ -138,19 +139,20 @@
 | 1. Setup | T001–T004 | — | T001∥T002, T003∥T004 |
 | 2. Foundation (US7) | T005–T014 | US7 | T005–T010 partial; T011–T013 after T005–T009 |
 | 3. Stats Bar + Split View (US1+US2) | T015–T020 | US1,US2 | T019∥T020 |
+| 3. Stats Bar + Split View (US1+US2) | T015–T020 | US1,US2 | T019∥T020 |
 | 4. Dataset Cards (US3) | T021–T026 | US3 | T026∥ after T021–T025 |
 | 5. Detail Panel (US4+US7) | T027–T033 | US4 | T032∥T033 |
 | 6. Inline Edit (US5) | T034–T037 | US5 | T037∥ after T034–T036 |
 | 7. Bulk Actions (US6) | T038–T041 | US6 | T041∥ after T038–T040 |
 | 8. Polish & Verification | T042–T051 | — | T046–T050 parallel after T042–T045 |
 
-**Total**: 51 tasks across 8 phases.
+**Total**: 52 tasks across 8 phases.
 
 ### Story Independent Verification
 
 | Story | How to verify independently |
 |-------|---------------------------|
-| US1 | Load `/datasets`, check 4 tiles visible, click → filter applies |
+| US1 | Load `/datasets`, check 4 tiles visible, click → API called with `?filter=`, server returns filtered list |
 | US2 | Desktop: 40/60 split grid visible; mobile: slide-over on card click |
 | US3 | Card shows all fields + progress bar; filter/search/page work |
 | US4 | Click card → right panel loads columns table + metrics table |

specs/030-dataset-lifecycle-workspace/ux_reference.md

@@ -12,7 +12,7 @@
 
 ## 2. The "Happy Path" Narrative
 
-Аналитик открывает страницу датасетов и сразу видит Stats Bar: 142 датасета всего, 38 без маппинга, 89 с описанием, 12 связаны с дашбордами. Он кликает "⚠️ Без маппинга" — список слева мгновенно фильтруется до 38 датасетов. Выбирает первый датасет в списке — справа без перезагрузки открывается детальная панель: хедер с именем таблицы и схемой, секция колонок с progress-индикаторами описаний, секция метрик. Видит колонку без описания, кликает "✏️ Добавить описание" — появляется textarea, вводит описание, сохраняет. Описание мгновенно отображается. Затем выделяет 3 датасета через чекбоксы, внизу появляется панель — запускает "Маппинг колонок" для всех трёх одним кликом.
+Аналитик открывает страницу датасетов и сразу видит Stats Bar: 142 датасета всего, 38 без маппинга, 89 с маппингом, 12 связаны с дашбордами. Он кликает «⚠️ Без маппинга» — Stats Bar подсвечивает метрику, фронтенд отправляет запрос `?filter=unmapped&page=1`, сервер возвращает отфильтрованные 38 датасетов с серверной пагинацией. Выбирает первый датасет в списке — DatasetHub фетчит `GET /api/datasets/{id}`, справа без перезагрузки открывается детальная панель: хедер с именем таблицы и схемой, секция колонок с progress-индикаторами описаний, секция метрик. Видит колонку без описания, кликает «✏️ Добавить описание» — появляется textarea, вводит описание, сохраняет через `PUT /api/datasets/{id}/columns/{col_id}/description`. Описание мгновенно отображается. Затем выделяет 3 датасета через чекбоксы, внизу появляется панель — запускает «Маппинг колонок» для всех трёх одним кликом.
 
 ## 3. Interface Mockups
 
@@ -22,7 +22,7 @@
 
 - **Layout**: Двухколоночный split-view (40/60) на десктопе. При < 768px — одноколоночный с slide-over для деталей.
 - **Key Elements**:
-    - **Stats Bar**: 4 метрики в строке вверху, каждая — кнопка-фильтр с иконкой, числом и подписью. Активная метрика подсвечена (primary background).
+    - **Stats Bar**: 4 метрики в строке вверху, каждая — кнопка-фильтр (`<button>` с `aria-pressed`) с иконкой, числом и подписью. Активная метрика подсвечена (primary background).
     - **Left Panel**: Список карточек датасетов с поиском и пагинацией. Каждая карточка содержит чекбокс.
     - **Right Panel**: Детальная панель с хедером, таблицами колонок/метрик, связанными дашбордами.
     - **Bulk Action Bar**: Fixed bottom panel, slides up when 2+ datasets selected.
@@ -48,7 +48,7 @@
     - **`@UX_RECOVERY`**:
         - API error in right panel → click "Retry" to reload dataset detail.
         - API error in list → click "Retry" to reload full list.
-        - Save conflict → show warning "Данные были изменены другим пользователем. Обновить?"
+        - Save succeeds regardless of concurrent edits (last-write-wins); next detail load shows current value.
         - Network offline → show offline banner, auto-retry on reconnect.
     - **`@UX_REACTIVITY`**: 
         - `$state` for: `selectedDatasetId`, `activeFilter`, `selectedIds`, `editingCell`
@@ -91,12 +91,18 @@
     - Textarea остаётся открытой с введённым текстом (не теряется).
 - **Recovery**: Повторное нажатие "Сохранить" либо "Отмена" для выхода без сохранения.
 
-### Scenario D: Конфликт при сохранении (409 Conflict)
+### Scenario D: Ресайз окна между десктопом и мобильным
 
-- **User Action**: Сохраняет описание, но данные были изменены другим пользователем.
+- **User Action**: Изменяет ширину окна браузера между ≥768px и <768px.
 - **System Response**:
-    - (UI) Предупреждение: "⚠️ Данные были изменены. Обновить страницу?" с кнопками "Обновить" и "Отмена".
-- **Recovery**: Кнопка "Обновить" перезагружает детали датасета.
+    - (UI) Выбранный датасет сохраняется при любом ресайзе.
+    - При сжатии до <768px: если детальная панель открыта — она становится slide-over (открытым). Список занимает 100% ширины.
+    - При расширении до ≥768px: split-view восстанавливается. Если slide-over был закрыт — правая панель показывает последний выбранный датасет или placeholder «Выберите датасет».
+- **Recovery**: Не требуется — состояние сохраняется.
+
+- **User Action**: Сохраняет описание.
+- **System Response**: Last-write-wins — последнее сохранение перезаписывает предыдущее. Конфликт не детектируется (ETag/блокировки — out of scope). При успешном сохранении сразу показывается актуальное значение.
+- **Recovery**: Не требуется. Если другой пользователь перезаписал описание — при следующей загрузке деталей датасета отобразится его версия.
 
 ## 5. Tone & Voice