feat(helpdesk): align module with core list/drawer standards

- add helpdesk module pages, services, settings and tests - standardize debtor list on drawer/grid contracts and robust filter drawer behavior - add helpdesk aside panel navigation and settings visibility provider - switch primary list slug to helpdesk/debitor and remove helpdesk/search compatibility - include required core contract updates for list contracts and detail/drawer integration
2026-04-02 17:48:27 +02:00
parent 5d07236758
commit a0d7670dd7
55 changed files with 5977 additions and 11 deletions
--- a/modules/helpdesk/lib/Module/Helpdesk/Service/DebitorSearchService.php
+++ b/modules/helpdesk/lib/Module/Helpdesk/Service/DebitorSearchService.php
@@ -0,0 +1,102 @@
+<?php
+
+namespace MintyPHP\Module\Helpdesk\Service;
+
+/**
+ * Service for searching BC debtors via OData.
+ */
+class DebitorSearchService
+{
+    public const MIN_QUERY_LENGTH = 2;
+
+    public function __construct(
+        private readonly BcODataGateway $bcODataGateway,
+        private readonly HelpdeskSettingsGateway $settingsGateway
+    ) {
+    }
+
+    /**
+     * Search debtors by name or number.
+     *
+     * @return array{status: string, results: array<int, array<string, mixed>>, error?: string}
+     */
+    public function search(string $query): array
+    {
+        $query = trim($query);
+
+        if ($query === '') {
+            return ['status' => 'empty', 'results' => []];
+        }
+
+        if (mb_strlen($query) < self::MIN_QUERY_LENGTH) {
+            return ['status' => 'too_short', 'results' => []];
+        }
+
+        if (!$this->settingsGateway->isConfigured()) {
+            return ['status' => 'not_configured', 'results' => [], 'error' => 'BC connection not configured'];
+        }
+
+        try {
+            $results = $this->bcODataGateway->searchCustomers($query);
+        } catch (\Throwable $e) {
+            return ['status' => 'error', 'results' => [], 'error' => 'BC connection failed'];
+        }
+
+        if ($results === []) {
+            return ['status' => 'no_results', 'results' => []];
+        }
+
+        return ['status' => 'success', 'results' => $results];
+    }
+
+    /**
+     * Build grid data for the helpdesk debtor list.
+     *
+     * @param array<string,mixed> $filters
+     * @return array{status: string, rows: array<int, array<string, mixed>>, total: int, error?: string}
+     */
+    public function listForGrid(array $filters): array
+    {
+        if (!$this->settingsGateway->isConfigured()) {
+            return [
+                'status' => 'not_configured',
+                'rows' => [],
+                'total' => 0,
+                'error' => 'BC connection not configured',
+            ];
+        }
+
+        $search = trim((string) ($filters['search'] ?? ''));
+        $city = trim((string) ($filters['city'] ?? ''));
+        $limit = (int) ($filters['limit'] ?? 10);
+        $offset = (int) ($filters['offset'] ?? 0);
+        $order = (string) ($filters['order'] ?? 'Name');
+        $dir = (string) ($filters['dir'] ?? 'asc');
+
+        if ($limit < 1) {
+            $limit = 1;
+        } elseif ($limit > 100) {
+            $limit = 100;
+        }
+        if ($offset < 0) {
+            $offset = 0;
+        }
+
+        try {
+            $result = $this->bcODataGateway->listCustomers($search, $city, $limit, $offset, $order, $dir);
+        } catch (\Throwable) {
+            return [
+                'status' => 'error',
+                'rows' => [],
+                'total' => 0,
+                'error' => 'BC connection failed',
+            ];
+        }
+
+        return [
+            'status' => 'success',
+            'rows' => (array) $result['rows'],
+            'total' => max(0, (int) $result['total']),
+        ];
+    }
+}