Add a module kernel (ModuleManifest, ModuleRegistry) that allows modules to contribute routes, UI slots, search providers, layout context, session lifecycle, and permissions. Modules are activated via config/modules.php or APP_ENABLED_MODULES env variable. Conflicts (duplicate routes, permissions, slot keys) cause a fail-fast with a clear error message. Extract the address book from hardcoded Core integration points into the first module (modules/addressbook/). The module provides: - Aside icon-bar tab + People panel via UI slot system - Global search resource via AddressBookSearchProvider - Layout context data via AddressBookLayoutProvider - Session lifecycle via AddressBookSessionProvider Core cleanup removes address-book hardcodings from SearchSqlResourceProvider, SearchUiMetaProvider, SearchItemMapperProvider, appBuildLayoutNavContext(), and the aside templates. Permissions (ADDRESS_BOOK_VIEW) and business logic (AddressBookService) remain in Core as they gate general user visibility. Includes 38 new tests (894 total), PHPStan level 5 clean, and architecture tests verifying zero hardcoded address-book references in search/templates. Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
41 lines
1.4 KiB
PHP
41 lines
1.4 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' 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' => [
|
|
'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']
|
|
: [],
|
|
],
|
|
];
|
|
}
|
|
}
|