Repo Interface für tests

2026-03-05 08:26:51 +01:00
parent 8f4dd5840d
commit 4b31fc7664
171 changed files with 3518 additions and 2297 deletions
--- a/lib/Support/helpers/app.php
+++ b/lib/Support/helpers/app.php
@@ -413,3 +413,144 @@ function sortByDescription(array &$items): void
        strcasecmp((string) ($a['description'] ?? ''), (string) ($b['description'] ?? ''))
    );
 }
+
+/**
+ * Decide whether any admin panel capability is available in layout auth.
+ *
+ * @param array<string, mixed> $layoutAuth
+ */
+function layoutHasAdminPanel(array $layoutAuth): bool
+{
+    $capabilityKeys = array_keys(\MintyPHP\Service\Access\UiCapabilityMap::LAYOUT);
+    foreach ($capabilityKeys as $key) {
+        if ($key === 'can_view_address_book') {
+            continue;
+        }
+        if (!empty($layoutAuth[$key])) {
+            return true;
+        }
+    }
+
+    return false;
+}
+
+/**
+ * Normalize list-like input to sorted unique non-empty strings.
+ *
+ * @return list<string>
+ */
+function appNormalizeStringList(mixed $value): array
+{
+    $raw = is_array($value) ? $value : explode(',', (string) $value);
+    $list = array_filter(array_map('trim', $raw), static fn ($item) => $item !== '');
+    $list = array_values(array_unique($list));
+    sort($list, SORT_STRING);
+    return $list;
+}
+
+/**
+ * Normalize list-like input to sorted unique positive integers.
+ *
+ * @return list<int>
+ */
+function appNormalizePositiveIntList(mixed $value): array
+{
+    $raw = is_array($value) ? $value : explode(',', (string) $value);
+    $list = array_values(array_unique(array_map('intval', $raw)));
+    $list = array_values(array_filter($list, static fn ($item) => $item > 0));
+    sort($list, SORT_NUMERIC);
+    return $list;
+}
+
+/**
+ * Normalize address-book custom field query keys/values.
+ *
+ * @param array<string, mixed> $rawQuery
+ * @return array<string, string|list<int>>
+ */
+function appNormalizeAddressBookCustomFilterQuery(array $rawQuery): array
+{
+    $normalized = [];
+    foreach ($rawQuery as $rawKey => $rawValue) {
+        $key = strtolower(trim((string) $rawKey));
+        if ($key === '') {
+            continue;
+        }
+        if (preg_match('/^cf_[a-f0-9-]{36}$/', $key)) {
+            $value = trim((string) $rawValue);
+            if ($value !== '') {
+                $normalized[$key] = $value;
+            }
+            continue;
+        }
+        if (preg_match('/^cfm_[a-f0-9-]{36}$/', $key)) {
+            $ids = appNormalizePositiveIntList($rawValue);
+            if ($ids) {
+                $normalized[$key] = $ids;
+            }
+            continue;
+        }
+        if (preg_match('/^cfd_[a-f0-9-]{36}_(from|to)$/', $key)) {
+            $value = trim((string) $rawValue);
+            $dt = \DateTimeImmutable::createFromFormat('Y-m-d', $value);
+            if ($dt && $dt->format('Y-m-d') === $value) {
+                $normalized[$key] = $value;
+            }
+        }
+    }
+    ksort($normalized, SORT_STRING);
+    return $normalized;
+}
+
+/**
+ * Build precomputed layout navigation context for templates.
+ *
+ * @param array<string, mixed> $layoutAuth
+ * @param array<string, mixed> $session
+ * @param array<string, mixed> $query
+ * @return array<string, mixed>
+ */
+function appBuildLayoutNavContext(array $layoutAuth, array $session, array $query): array
+{
+    $currentTenant = is_array($session['current_tenant'] ?? null) ? $session['current_tenant'] : null;
+    $availableTenants = is_array($session['available_tenants'] ?? null) ? $session['available_tenants'] : [];
+    $tenantUuid = trim((string) ($currentTenant['uuid'] ?? ''));
+    $tenantName = trim((string) ($currentTenant['description'] ?? ''));
+
+    $tenantQueryParam = '';
+    if (count($availableTenants) > 1 && $tenantUuid !== '') {
+        $tenantQueryParam = '?tenant=' . urlencode($tenantUuid);
+    }
+
+    $tenantHasAvatar = false;
+    if ($tenantUuid !== '' && class_exists(\MintyPHP\Service\Tenant\TenantAvatarService::class)) {
+        $tenantHasAvatar = app(\MintyPHP\Service\Tenant\TenantAvatarService::class)->hasAvatar($tenantUuid);
+    }
+
+    $csrfKey = \MintyPHP\Session::$csrfSessionKey;
+    $csrfToken = (string) ($session[$csrfKey] ?? '');
+
+    return [
+        'hasAdminPanel' => layoutHasAdminPanel($layoutAuth),
+        'currentTenant' => $currentTenant,
+        'availableTenants' => $availableTenants,
+        'tenantQueryParam' => $tenantQueryParam,
+        'tenantAvatar' => [
+            'uuid' => $tenantUuid,
+            'name' => $tenantName,
+            'hasAvatar' => $tenantHasAvatar,
+        ],
+        'addressBook' => [
+            'url' => lurl('address-book'),
+            'activeSearch' => trim((string) ($query['search'] ?? '')),
+            'activeTenants' => appNormalizeStringList($query['tenants'] ?? ''),
+            'activeDepartments' => appNormalizePositiveIntList($query['departments'] ?? ''),
+            'activeRoles' => appNormalizePositiveIntList($query['roles'] ?? ''),
+            'activeCustomFilters' => appNormalizeAddressBookCustomFilterQuery($query),
+            'peopleGroups' => is_array($session['available_departments_by_tenant'] ?? null) ? $session['available_departments_by_tenant'] : [],
+            'savedFilters' => is_array($session['address_book_saved_filters'] ?? null) ? $session['address_book_saved_filters'] : [],
+        ],
+        'csrfKey' => $csrfKey,
+        'csrfToken' => $csrfToken,
+    ];
+}