Files
breadcrumb-the-shire/modules/helpdesk/templates/aside-helpdesk-panel.phtml
fs a26c106083 feat(helpdesk): add handover protocol management
Implement handover protocols as a new entity in the helpdesk module,
allowing users to create fillable protocol records from admin-defined
software product schemas.

Key additions:
- DB migration (helpdesk_handovers table) with tenant scope
- HandoverService with status workflow (draft/in_progress/completed/archived)
- Three-tier permissions (view/create/manage)
- Two-step creation wizard (Stripe-style assistant)
- Grid.js list page with search and status filter
- Edit/detail page with aside metadata and status controls
- Reusable core autocomplete lookup component (app-lookup-field)
- Debitor lookup data endpoint for autocomplete
- Dynamic form rendering from schema snapshots
- 11 PHPUnit tests for HandoverService
- DE+EN i18n translations (48 keys each)

Also includes: PHPStan fixes (dead code removal, stale baseline cleanup),
software product edit title improvement, fieldset simplification,
and Stripe-style hover for schema preview.

Workflow: HD-HANDOVERS-001 (.agents/runs/HD-HANDOVERS-001/)

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
2026-04-15 20:42:41 +02:00

130 lines
4.7 KiB
PHTML

<?php
$layoutNav = is_array($layoutNav ?? null) ? $layoutNav : [];
$helpdeskNav = is_array($layoutNav['helpdesk.nav'] ?? null) ? $layoutNav['helpdesk.nav'] : [];
$canManageSettings = !empty($helpdeskNav['can_manage_settings']);
$canViewTeam = !empty($helpdeskNav['can_view_team']);
$canViewRiskRadar = !empty($helpdeskNav['can_view_risk_radar']);
$canManageSoftwareProducts = !empty($helpdeskNav['can_manage_software_products']);
$canViewHandovers = !empty($helpdeskNav['can_view_handovers']);
$settingsActive = navActive('helpdesk/settings', true);
$teamActive = navActive('helpdesk/team', true);
$riskRadarActive = navActive('helpdesk/risk-radar', true);
$domainsActive = navActive('helpdesk/domains', true);
$softwareProductsActive = navActive('helpdesk/software-products', true);
$handoversActive = navActive('helpdesk/handovers', true);
$customersActive = navActive('helpdesk', true);
if ($settingsActive['isActive'] || $teamActive['isActive'] || $riskRadarActive['isActive'] || $domainsActive['isActive'] || $softwareProductsActive['isActive'] || $handoversActive['isActive']) {
$customersActive = ['class' => '', 'aria' => '', 'isActive' => false];
}
$helpdeskNavGroups = [
[
'key' => 'helpdesk-lookup',
'label' => t('Lookup'),
'icon' => 'bi-search',
'items' => [
[
'label' => t('Customers'),
'path' => 'helpdesk',
'active' => $customersActive,
'visible' => true,
],
[
'label' => t('Domains'),
'path' => 'helpdesk/domains',
'active' => $domainsActive,
'visible' => true,
],
],
],
[
'key' => 'helpdesk-monitoring',
'label' => t('Monitoring'),
'icon' => 'bi-bar-chart-line',
'items' => [
[
'label' => t('Team workload'),
'path' => 'helpdesk/team',
'active' => $teamActive,
'visible' => $canViewTeam,
],
[
'label' => t('Risk radar'),
'path' => 'helpdesk/risk-radar',
'active' => $riskRadarActive,
'visible' => $canViewRiskRadar,
],
],
],
[
'key' => 'helpdesk-operations',
'label' => t('Operations'),
'icon' => 'bi-clipboard-check',
'items' => [
[
'label' => t('Handovers'),
'path' => 'helpdesk/handovers',
'active' => $handoversActive,
'visible' => $canViewHandovers,
],
],
],
[
'key' => 'helpdesk-administration',
'label' => t('Administration'),
'icon' => 'bi-sliders',
'items' => [
[
'label' => t('Software products'),
'path' => 'helpdesk/software-products',
'active' => $softwareProductsActive,
'visible' => $canManageSoftwareProducts,
],
[
'label' => t('Settings'),
'path' => 'helpdesk/settings',
'active' => $settingsActive,
'visible' => $canManageSettings,
],
],
],
];
?>
<ul>
<?php foreach ($helpdeskNavGroups as $group):
$visibleItems = array_values(array_filter($group['items'], static fn (array $item): bool => !empty($item['visible'])));
if (!$visibleItems) {
continue;
}
$groupIsActive = false;
foreach ($visibleItems as $item) {
if (!empty(($item['active'] ?? [])['isActive'])) {
$groupIsActive = true;
break;
}
}
?>
<li class="app-sidebar-group app-sidebar-admin-group">
<details data-details-key="<?php e($group['key']); ?>"<?php if ($groupIsActive): ?> open<?php endif; ?>>
<summary>
<i class="bi <?php e($group['icon']); ?>"></i>
<span><?php e($group['label']); ?></span>
</summary>
<ul>
<?php foreach ($visibleItems as $item):
$active = $item['active'] ?? ['class' => '', 'aria' => ''];
?>
<li>
<a href="<?php e(lurl($item['path'])); ?>" class="<?php e($active['class'] ?? ''); ?>" <?php echo $active['aria'] ?? ''; // raw-html-ok: pre-built ARIA attribute from navActive() ?>>
<?php e($item['label']); ?>
</a>
</li>
<?php endforeach; ?>
</ul>
</details>
</li>
<?php endforeach; ?>
</ul>