feat(helpdesk): add Software Products page with BC contract type sync

Add a new Software-Produkte feature to the helpdesk module that syncs contract types (Create_SaaS_License=true) from BC OData into a local database table with a nightly scheduler job, providing a Grid.js list page and detail/edit page for managing custom product names. - DB migration 003: helpdesk_software_products table (code UNIQUE key) - BcODataGateway: FS_Contract_Types entity with SaaS filter + fallback - SoftwareProductRepository: upsert, listPaged, softDelete, updateName - SoftwareProductSyncService: fetch → upsert → soft-delete lifecycle - SoftwareProductSyncJobHandler: daily at 02:00 via scheduler platform - SoftwareProductService: web UI business logic with validation - Permission: helpdesk.software-products.manage (nav-gated) - List page: Grid.js with Code, BC Description, Name, Status columns - Detail page: Code/BC Description read-only, Name editable, PRG pattern - i18n: de + en translation keys Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
2026-04-14 22:16:21 +02:00
parent d472026df4
commit ef4473de64
23 changed files with 1209 additions and 5 deletions
--- a/modules/helpdesk/web/js/pages/helpdesk-software-products-index.js
+++ b/modules/helpdesk/web/js/pages/helpdesk-software-products-index.js
@@ -0,0 +1,81 @@
+import { initStandardListPage } from '/js/core/app-grid-factory.js';
+import { readPageConfig } from '/js/core/app-page-config.js';
+import { warnOnce } from '/js/core/app-dom.js';
+import { escapeHtml, getAppBase, withCurrentListReturn } from '/js/pages/app-list-utils.js';
+
+const config = readPageConfig('helpdesk-software-products');
+if (config) {
+  const gridjs = window.gridjs;
+  if (!gridjs) {
+    warnOnce('UI_INIT_FAIL', 'Helpdesk software products grid init failed: Grid.js missing', { module: 'helpdesk-software-products', component: 'grid' });
+  } else {
+    const appBase = getAppBase();
+    const labels = config.labels || {};
+
+    const editUrlIndex = 4;
+
+    const gridOptions = {
+      gridjs,
+      container: '#helpdesk-software-products-grid',
+      dataUrl: config.dataUrl || 'helpdesk/software-products-data',
+      appBase,
+      columns: [
+        {
+          name: labels.code || 'Code',
+          sort: true,
+          formatter: (cell) => {
+            const code = escapeHtml(cell?.code || '');
+            const editUrl = String(cell?.url || '').trim();
+            if (editUrl === '') {
+              return gridjs.html(code);
+            }
+            const href = escapeHtml(withCurrentListReturn(editUrl));
+            return gridjs.html(`<a href="${href}">${code}</a>`);
+          },
+        },
+        { name: labels.bcDescription || 'BC Description', sort: true },
+        { name: labels.name || 'Product Name', sort: true },
+        {
+          name: labels.status || 'Status',
+          sort: true,
+          formatter: (cell) => {
+            const label = escapeHtml(cell?.label || '');
+            const variant = cell?.variant || 'neutral';
+            return gridjs.html(`<span class="badge" data-variant="${escapeHtml(variant)}">${label}</span>`);
+          },
+        },
+        { name: 'edit_url', hidden: true },
+      ],
+      sortColumns: ['code', 'bc_description', 'name', 'active', null],
+      paginationLimit: 20,
+      language: config.gridLang || {},
+      mapData: (data) => (data.data || []).map((row) => [
+        { code: row.code || '', url: row.edit_url || '' },
+        row.bc_description || '',
+        row.name || '',
+        { label: row.active_label || '', variant: row.active_variant || 'neutral' },
+        row.edit_url || '',
+      ]),
+      search: config.gridSearch || null,
+      filterSchema: config.filterSchema || [],
+      urlSync: true,
+      rowInteraction: { linkColumn: 0 },
+      rowDblClick: {
+        getUrl: (rowData) => rowData?.cells?.[editUrlIndex]?.data || '',
+      },
+    };
+
+    const { gridConfig } = initStandardListPage({
+      grid: gridOptions,
+      filters: {
+        mode: 'drawer',
+        chipMeta: config.filterChipMeta || {},
+        watchInputs: ['#helpdesk-software-products-search-input'],
+      },
+    });
+
+    if (!gridConfig || !gridConfig.grid) {
+      warnOnce('UI_INIT_FAIL', 'Helpdesk software products grid init failed', { module: 'helpdesk-software-products', component: 'grid' });
+    }
+  }
+}