Phase 3: Plugin-UI-System (WordPress-Style)

Backend: - PluginManifest um 5 neue UI-Felder erweitert: menu_items, page_routes, detail_tabs, settings_pages, dashboard_widgets (FrontendMenuItem, FrontendPageRoute, FrontendDetailTab, FrontendSettingsPage, FrontendDashboardWidget) - GET /api/v1/plugins/active-manifests Endpoint liefert UI-Manifeste aller aktiven Plugins - Registry.get_active_manifests() + PluginService.get_active_manifests() - 12 Built-in Plugins mit UI-Manifest-Daten gefuellt (menu_items, page_routes, detail_tabs, settings_pages) - Plugin-Install-System: POST /upload (ZIP), POST /install-url (URL) mit Validierung (Manifest, dangerous imports, SQL migrations) Frontend: - pluginStore.ts (Zustand) mit PluginUiManifest Typen + Selektoren - useActivePluginManifests() React Query Hook - PluginRegistry.tsx — fetcht Manifeste beim App-Start - PluginLoader.tsx — dynamisches React.lazy() mit ErrorBoundary - PluginRouteRenderer.tsx — Catch-all fuer Plugin-Routes - routes/index.tsx — Catch-all Routes fuer Plugin-Pages + Settings - Sidebar.tsx — dynamische Plugin Menu-Items mit Grouping + Icons - Settings.tsx — dynamische Plugin Settings-Pages - ContactDetail.tsx — dynamische Plugin Detail-Tabs mit Permissions - AppShell.tsx — PluginRegistry Provider eingebunden - SettingsPlugins.tsx — Install-UI (ZIP Upload + URL Install) - plugins.ts — useUploadPlugin() + useInstallPluginFromUrl() Hooks Docs & Templates: - docs/plugin-development-guide.md — komplette Entwickler-Doku - templates/plugin-template/ — Boilerplate mit allen Manifest-Feldern Tests: - 34 Vitest-Tests (PluginRegistry, PluginLoader, PluginRouteRenderer, pluginStore) — alle bestanden - TSC: keine neuen Errors (nur pre-existing Dms.tsx)
2026-07-23 19:01:18 +02:00
parent 4f70c1d912
commit fc96a2f86c
43 changed files with 3005 additions and 204 deletions
@@ -0,0 +1,128 @@
+import { create } from 'zustand';
+
+export interface PluginMenuItem {
+  label_key: string;
+  label: string;
+  path: string;
+  icon: string;
+  group: string;
+  order: number;
+  badge_key: string;
+}
+
+export interface PluginPageRoute {
+  path: string;
+  component: string;
+  parent: string;
+  protected: boolean;
+  order: number;
+}
+
+export interface PluginDetailTab {
+  entity_type: string;
+  label_key: string;
+  label: string;
+  component: string;
+  icon: string;
+  order: number;
+  permission: string;
+}
+
+export interface PluginSettingsPage {
+  path: string;
+  label_key: string;
+  label: string;
+  component: string;
+  icon: string;
+  order: number;
+  permission: string;
+}
+
+export interface PluginDashboardWidget {
+  id: string;
+  label_key: string;
+  label: string;
+  component: string;
+  icon: string;
+  order: number;
+  col_span: number;
+  row_span: number;
+  permission: string;
+}
+
+export interface PluginUiManifest {
+  name: string;
+  display_name: string;
+  version: string;
+  is_core: boolean;
+  menu_items: PluginMenuItem[];
+  page_routes: PluginPageRoute[];
+  detail_tabs: PluginDetailTab[];
+  settings_pages: PluginSettingsPage[];
+  dashboard_widgets: PluginDashboardWidget[];
+}
+
+interface PluginState {
+  manifests: PluginUiManifest[];
+  loading: boolean;
+  error: string | null;
+  loaded: boolean;
+  setManifests: (manifests: PluginUiManifest[]) => void;
+  setLoading: (loading: boolean) => void;
+  setError: (error: string | null) => void;
+  reset: () => void;
+  // Computed selectors
+  getAllMenuItems: () => PluginMenuItem[];
+  getAllPageRoutes: () => PluginPageRoute[];
+  getDetailTabsForEntity: (entityType: string) => PluginDetailTab[];
+  getAllSettingsPages: () => PluginSettingsPage[];
+  getAllDashboardWidgets: () => PluginDashboardWidget[];
+}
+
+export const usePluginStore = create<PluginState>((set, get) => ({
+  manifests: [],
+  loading: false,
+  error: null,
+  loaded: false,
+
+  setManifests: (manifests) => set({ manifests, loaded: true, loading: false, error: null }),
+  setLoading: (loading) => set({ loading }),
+  setError: (error) => set({ error, loading: false }),
+  reset: () => set({ manifests: [], loading: false, error: null, loaded: false }),
+
+  getAllMenuItems: () => {
+    const { manifests } = get();
+    return manifests
+      .flatMap((m) => m.menu_items)
+      .sort((a, b) => a.order - b.order);
+  },
+
+  getAllPageRoutes: () => {
+    const { manifests } = get();
+    return manifests
+      .flatMap((m) => m.page_routes)
+      .sort((a, b) => a.order - b.order);
+  },
+
+  getDetailTabsForEntity: (entityType: string) => {
+    const { manifests } = get();
+    return manifests
+      .flatMap((m) => m.detail_tabs)
+      .filter((t) => t.entity_type === entityType)
+      .sort((a, b) => a.order - b.order);
+  },
+
+  getAllSettingsPages: () => {
+    const { manifests } = get();
+    return manifests
+      .flatMap((m) => m.settings_pages)
+      .sort((a, b) => a.order - b.order);
+  },
+
+  getAllDashboardWidgets: () => {
+    const { manifests } = get();
+    return manifests
+      .flatMap((m) => m.dashboard_widgets)
+      .sort((a, b) => a.order - b.order);
+  },
+}));