forked from fa/breadcrumb-the-shire
Six targeted improvements to the modular monolith platform: 1. Fix AddressBook session key prefix to follow module.<id>.* convention 2. Move ADDRESS_BOOK_VIEW permission constant from core PermissionService into module 3. Add declarative JSON schema for module manifests (.agents/contracts/) 4. Add `requires` field with missing-dependency and circular-dependency detection 5. Add lightweight fire-and-forget event dispatcher (user.created/deleted/login/logout) 6. Add module deactivation hook interface and CLI script (bin/module-deactivate.php) Includes 15 new architecture/unit tests covering all new functionality. Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
81 lines
2.8 KiB
PHP
81 lines
2.8 KiB
PHP
<?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['module.addressbook.departments_by_tenant'] ?? null)
|
|
? $session['module.addressbook.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;
|
|
}
|
|
}
|