Files
tessera-ctl/apps/web/src/lib/stores/dashboard-store.ts
T
schalli 05feaa3dd6 feat(quick-260923-ad9): Reiter per Ziehen umsortieren - Task 4
dashboard-tabs.tsx: Ziehen ueber Pointer-Ereignisse (Muster
xframe-config-form.tsx, D-05 - keine neue Abhaengigkeit). Schwelle 4 px
waagerechte Auslenkung trennt Klick von Ziehen; darueber wird der Zeiger
eingefangen (jsdom-Schutzhuelle), die Leiste zeigt die Vorschau-Reihenfolge
(computeReorderedIds, Einfuegen vor dem ersten Nachbarn mit Mittelpunkt
rechts vom Zeiger), beim Loslassen geht die VOLLSTAENDIGE Kennungsliste an
onReorder. Abbruch des Zeigers verwirft die Vorschau ohne zu senden. Ein
hasDraggedRef-Merker unterdrueckt den Klick, der im echten Browser nach
einem Ziehen folgt. Ziehen ist IMMER moeglich, nicht nur im
Bearbeitungsmodus (D-09) - ein Hinweistext erklaert, dass der erste Reiter
beim Oeffnen geladen wird.

dashboard-store.ts: reorderDashboards() setzt die neue Reihenfolge SOFORT
optimistisch, sendet sie und stellt bei einem Fehler die vorherige
Reihenfolge wieder her; der aktive Reiter bleibt aktiv.

dashboard-tabs.test.tsx: 21 Tests (12 alte aus Task 3 + 9 neue fuer jeden
Punkt des Verhaltensblocks). getBoundingClientRect wird je Reiter-Wrapper
ueber data-tab-index gestubbt (Reiter i belegt 100i..100i+100 - jsdom
liefert keine echten Masse). dashboard-store.test.ts: 17 Tests (15 alte +
2 neue fuer Optimismus/Ruecknahme).

Messages: widgets.tabs.dragHint war bereits in Task 3 eingetragen
(vorausschauend) - in diesem Task keine weitere Aenderung an de.json/en.json
noetig.

Gemessene Abweichung von der Plan-Erwartung (kein Rule-1/2/3-Fall, reine
Zahlendifferenz): `grep -c "react-grid-layout|dnd|sortable"
apps/web/package.json` liefert 2 statt der im Plan erwarteten 1 - der
zweite Treffer ist `@types/react-grid-layout`, bereits vor diesem Task
vorhanden (siehe `git diff --stat apps/web/package.json`: keine Aenderung
in keinem der vier Tasks). D-05 (keine neue Zieh-Abhaengigkeit) ist damit
weiterhin erfuellt, nur an der leeren package.json-Diff nachgewiesen statt
an der im Plan vorausgesagten Zahl. Ebenso liefert `pnpm --filter
@tessera/web test` 82 statt der erwarteten 83 Dateien - Task 4 fuegt (siehe
files_modified oben) keine neue Testdatei hinzu, Task 3 hatte die
Dateizahl bereits auf 82 gebracht.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
2026-09-23 08:18:25 +02:00

329 lines
11 KiB
TypeScript

import { create } from 'zustand';
import * as api from '@/lib/dashboard-api';
import type { DashboardTab } from '@/lib/dashboard-api';
import type { WidgetType } from '@/components/dashboard/widget-registry';
import { WIDGET_CONSTRAINTS } from '@/components/dashboard/widget-registry';
import { migrateGridLayouts, withGridVersion } from '@/lib/grid-layout-migration';
export interface WidgetInstance {
id: string;
widgetType: string;
config: Record<string, unknown>;
}
interface DashboardState {
dashboards: DashboardTab[];
activeDashboardId: string | null;
isSwitchingDashboard: boolean;
layouts: Record<string, Array<{ i: string; x: number; y: number; w: number; h: number }>>;
widgets: WidgetInstance[];
isEditMode: boolean;
isDirty: boolean;
isLoading: boolean;
error: string | null;
setEditMode: (mode: boolean) => void;
updateLayouts: (layouts: Record<string, unknown>) => void;
addWidget: (widgetType: WidgetType) => Promise<void>;
removeWidget: (id: string) => Promise<void>;
loadDashboard: () => Promise<void>;
saveLayout: () => Promise<void>;
selectDashboard: (id: string) => Promise<void>;
createDashboard: () => Promise<void>;
renameDashboard: (id: string, name: string) => Promise<void>;
deleteDashboard: (id: string) => Promise<void>;
reorderDashboards: (ids: string[]) => Promise<void>;
}
/**
* Schutz gegen doppeltes Laden der Reiterliste (quick-260923-ad9, Task 3,
* T-AD9-07 — Gegenstück zur Transaktionssperre in `listDashboards` auf der
* API): ein modul-globales Versprechen statt eines Zustandsfeldes, damit
* ZWEI synchron hintereinander ausgeloeste `loadDashboard()`-Aufrufe (z. B.
* React StrictMode, doppeltes Einhaengen) sich dasselbe, noch nicht
* aufgeloeste Versprechen teilen — `api.fetchDashboards()` laeuft dann nur
* EINMAL. Nach Abschluss (Erfolg ODER Fehler) wird die Sperre zurueckgesetzt,
* damit ein spaeteres, echtes Neuladen (Seite erneut besucht, langer
* Zeitabstand) wieder ein frisches Netzwerkergebnis holt statt fuer immer
* auf dem ersten Ergebnis zu bleiben.
*/
let dashboardsLoadPromise: Promise<DashboardTab[]> | null = null;
function loadDashboardsOnce(): Promise<DashboardTab[]> {
if (!dashboardsLoadPromise) {
dashboardsLoadPromise = api.fetchDashboards().finally(() => {
dashboardsLoadPromise = null;
});
}
return dashboardsLoadPromise;
}
/**
* Dashboard Zustand store. NO persist middleware — layout comes from DB (D-05).
* Save only on exiting edit mode (D-01), not on every drag.
*
* quick-260916-bwo: Gespeicherte Anordnungen in alten Raster-Einheiten werden
* beim Laden einmalig umgerechnet (`migrateGridLayouts`) und sofort mit dem
* Marker `__gridVersion` zurueckgeschrieben. Der Marker lebt NUR im
* gespeicherten JSON, nie im Zustand (dieser Store iteriert mit Object.keys
* ueber die Breakpoints). Fehlt der Marker beim Speichern, wird beim naechsten
* Laden erneut verdoppelt — deshalb `withGridVersion` an BEIDEN Speicherstellen
* (Sofort-Speichern nach der Umrechnung und `saveLayout`), T-BWO-02.
*
* quick-260923-ad9 (Task 3): Reiter — mehrere Dashboards je Benutzer. Der
* erste (`position` aufsteigend) ist der Standard und wird beim Laden aktiv.
* `layouts`/`widgets` gehoeren IMMER zum `activeDashboardId` — ein
* Reiterwechsel ersetzt beide vollstaendig, nie ein Zusammenfuehren. Die
* Marker-Umrechnung oben gilt weiterhin je Reiter: `selectDashboard`
* durchlaeuft dieselbe Umrechnung-plus-Sofort-Speichern-Logik wie
* `loadDashboard`.
*/
export const useDashboardStore = create<DashboardState>()((set, get) => ({
dashboards: [],
activeDashboardId: null,
isSwitchingDashboard: false,
layouts: { lg: [], md: [], sm: [], xs: [], xxs: [] },
widgets: [],
isEditMode: false,
isDirty: false,
isLoading: false,
error: null,
setEditMode: (mode: boolean) => {
const prev = get().isEditMode;
set({ isEditMode: mode });
// On exit edit mode, auto-save if dirty (D-01)
if (prev && !mode && get().isDirty) {
get().saveLayout();
}
},
updateLayouts: (layouts) => {
set({
layouts: layouts as DashboardState['layouts'],
isDirty: true,
});
},
addWidget: async (widgetType: WidgetType) => {
const dashboardId = get().activeDashboardId;
if (!dashboardId) return;
try {
const newWidget = await api.addWidget(dashboardId, widgetType);
const constraints = WIDGET_CONSTRAINTS[widgetType];
set((state) => {
// Add default layout entry for all breakpoints
const newLayouts = { ...state.layouts };
for (const bp of Object.keys(newLayouts)) {
const arr = [...(newLayouts[bp] || [])];
// Place at next available y position
const maxY = arr.reduce((max, item) => Math.max(max, item.y + item.h), 0);
arr.push({
i: newWidget.id,
x: 0,
y: maxY,
w: constraints.defaultW,
h: constraints.defaultH,
});
newLayouts[bp] = arr;
}
return {
widgets: [...state.widgets, newWidget],
layouts: newLayouts,
isDirty: true,
};
});
} catch (err) {
console.error('Failed to add widget:', err);
}
},
removeWidget: async (id: string) => {
try {
await api.removeWidget(id);
set((state) => {
const newLayouts = { ...state.layouts };
for (const bp of Object.keys(newLayouts)) {
newLayouts[bp] = newLayouts[bp].filter((item) => item.i !== id);
}
return {
widgets: state.widgets.filter((w) => w.id !== id),
layouts: newLayouts,
isDirty: true,
};
});
} catch (err) {
console.error('Failed to remove widget:', err);
}
},
loadDashboard: async () => {
set({ isLoading: true, error: null });
try {
const dashboards = await loadDashboardsOnce();
const first = dashboards[0];
if (!first) {
set({ error: 'Failed to load dashboard', isLoading: false });
return;
}
const [rawLayouts, widgets] = await Promise.all([
api.fetchLayout(first.id),
api.fetchWidgets(first.id),
]);
const { layouts: migratedLayouts, migrated } = migrateGridLayouts(rawLayouts);
set({
dashboards,
activeDashboardId: first.id,
layouts: migratedLayouts,
widgets,
isLoading: false,
});
// Umgerechnete Anordnung SOFORT mit Marker persistieren — nach dem set,
// damit die Oberflaeche unabhaengig vom Speichern rendert; eigener
// try/catch, damit ein Speicherfehler NICHT als Ladefehler erscheint.
if (migrated) {
try {
await api.saveLayout(first.id, withGridVersion(migratedLayouts));
} catch (err) {
console.error('Failed to persist migrated layout:', err);
}
}
} catch {
set({
error: 'Failed to load dashboard',
isLoading: false,
});
}
},
saveLayout: async () => {
const dashboardId = get().activeDashboardId;
if (!dashboardId) return;
try {
await api.saveLayout(dashboardId, withGridVersion(get().layouts));
set({ isDirty: false });
} catch (err) {
console.error('Failed to save layout:', err);
}
},
/**
* Wechselt den aktiven Reiter (quick-260923-ad9, Task 3). Eine
* ungespeicherte Anordnung wird ZUERST fuer den ALTEN Reiter geschrieben
* (`get().saveLayout()` liest `activeDashboardId` VOR dem `set` unten,
* schreibt also unter der Kennung des alten Reiters) — erst danach werden
* Kacheln und Anordnung des neuen Reiters geladen und ersetzen den
* Zustand VOLLSTAENDIG (kein Zusammenfuehren).
*/
selectDashboard: async (id: string) => {
const state = get();
if (id === state.activeDashboardId) return;
if (state.isDirty) {
await get().saveLayout();
}
set({ isSwitchingDashboard: true, error: null });
try {
const [rawLayouts, widgets] = await Promise.all([
api.fetchLayout(id),
api.fetchWidgets(id),
]);
const { layouts: migratedLayouts, migrated } = migrateGridLayouts(rawLayouts);
set({
activeDashboardId: id,
layouts: migratedLayouts,
widgets,
isDirty: false,
isSwitchingDashboard: false,
});
if (migrated) {
try {
await api.saveLayout(id, withGridVersion(migratedLayouts));
} catch (err) {
console.error('Failed to persist migrated layout:', err);
}
}
} catch (err) {
console.error('Failed to switch dashboard:', err);
set({ isSwitchingDashboard: false, error: 'Failed to switch dashboard' });
}
},
/** Legt einen neuen, leeren Reiter an und macht ihn aktiv (D-08). */
createDashboard: async () => {
try {
const created = await api.createDashboardTab();
set((state) => ({ dashboards: [...state.dashboards, created] }));
await get().selectDashboard(created.id);
} catch (err) {
console.error('Failed to create dashboard:', err);
}
},
renameDashboard: async (id: string, name: string) => {
try {
const updated = await api.renameDashboardTab(id, name);
set((state) => ({
dashboards: state.dashboards.map((d) => (d.id === id ? updated : d)),
}));
} catch (err) {
console.error('Failed to rename dashboard:', err);
}
},
/**
* Loescht einen Reiter. Beim aktiven Reiter wird danach der dann erste
* verbleibende Reiter aktiv und sein Inhalt geladen (`selectDashboard`).
* Die verbleibende Liste wird lokal gefiltert statt neu geladen — die vom
* Server neu vergebenen `position`-Werte werden dabei nicht nachgezogen;
* das ist fuer die Reihenfolge in der Leiste unschaedlich (sie filtert nur,
* sortiert nicht neu), ein spaeteres Umsortieren sendet ohnehin die
* VOLLSTAENDIGE Kennungsliste, nicht die Positionszahlen.
*/
deleteDashboard: async (id: string) => {
try {
await api.deleteDashboardTab(id);
const remaining = get().dashboards.filter((d) => d.id !== id);
set({ dashboards: remaining });
if (get().activeDashboardId === id) {
const next = remaining[0];
if (next) {
set({ activeDashboardId: null });
await get().selectDashboard(next.id);
}
}
} catch (err) {
console.error('Failed to delete dashboard:', err);
}
},
/**
* Persistiert eine per Ziehen bestimmte Reihenfolge (quick-260923-ad9,
* Task 4). Setzt die neue Reihenfolge SOFORT im Zustand (optimistisch —
* die Leiste in `dashboard-tabs.tsx` zeigt schon ihre eigene Vorschau
* waehrend des Ziehens, dieses `set` uebernimmt sie beim Loslassen als
* Tatsache) und stellt bei einem fehlgeschlagenen Speichern die VORHERIGE
* Reihenfolge wieder her. Der aktive Reiter bleibt aktiv, auch wenn er
* seine Position wechselt — `activeDashboardId` bleibt unberuehrt.
*/
reorderDashboards: async (ids: string[]) => {
const previous = get().dashboards;
const byId = new Map(previous.map((d) => [d.id, d]));
const optimistic = ids.map((id) => byId.get(id)).filter((d): d is DashboardTab => d !== undefined);
set({ dashboards: optimistic });
try {
const updated = await api.reorderDashboardTabs(ids);
set({ dashboards: updated });
} catch (err) {
console.error('Failed to reorder dashboards:', err);
set({ dashboards: previous });
}
},
}));