refactor: align addressbook module to MintyPHP\Module\AddressBook namespace

Migrates addressbook service classes from core namespace
(MintyPHP\Service\AddressBook\*) to proper module namespace
(MintyPHP\Module\AddressBook\Service\*), consistent with the
bookmarks module pattern.

Moved to module:
- AddressBookService → modules/addressbook/lib/Module/AddressBook/Service/
- AddressBookServicesFactory → modules/addressbook/lib/Module/AddressBook/Service/
- AddressBookServiceTest → modules/addressbook/tests/Module/AddressBook/Service/
- Pages, templates, CSS, JS all in module directory

All module PHP classes now live under MintyPHP\Module\<Name>\*,
enforced by ModuleStructureContractTest::testModuleClassesUseModuleNamespace.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

modules/addressbook/lib/Module/AddressBook/Providers/AddressBookLayoutProvider.php

@@ -0,0 +1,80 @@
+<?php
+
+namespace MintyPHP\Module\AddressBook\Providers;
+
+use MintyPHP\App\AppContainer;
+use MintyPHP\App\Module\Contracts\LayoutContextProvider;
+
+/**
+ * Provides address book data for the layout navigation context.
+ *
+ * Contributes the 'addressbook.nav' key to $layoutNav with URL, active filters,
+ * and people groups from the session.
+ */
+final class AddressBookLayoutProvider implements LayoutContextProvider
+{
+    public function provide(array $session, AppContainer $container): array
+    {
+        // Read query params for active filter state
+        $query = [];
+        try {
+            $query = requestInput()->queryAll();
+        } catch (\Throwable) {
+            // fail-open: may not be available in CLI context
+        }
+
+        return [
+            'addressbook.nav' => [
+                'url' => lurl('address-book'),
+                'activeSearch' => trim((string) ($query['search'] ?? '')),
+                'activeTenants' => appNormalizeStringList($query['tenants'] ?? ''),
+                'activeDepartments' => appNormalizePositiveIntList($query['departments'] ?? ''),
+                'activeRoles' => appNormalizePositiveIntList($query['roles'] ?? ''),
+                'activeCustomFilters' => self::normalizeCustomFilterQuery($query),
+                'peopleGroups' => is_array($session['available_departments_by_tenant'] ?? null)
+                    ? $session['available_departments_by_tenant']
+                    : [],
+            ],
+        ];
+    }
+
+    /**
+     * Normalize address-book custom field query keys/values.
+     *
+     * @param array<string, mixed> $rawQuery
+     * @return array<string, string|list<int>>
+     */
+    public static function normalizeCustomFilterQuery(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;
+    }
+}