feat(user-lifecycle): cockpit foundation — KPI row + aside quick actions

Phase 1 of the Stripe-style policy-cockpit redesign for the user-lifecycle
settings page. Pure server-rendering — no async, no JS components, no
sparklines yet (those land in later phases).

Adds a four-tile KPI row above the configuration form (Last run,
Deactivated/30d, Deleted/30d, Pending deletion/7d), populates the
previously empty aside with three quick actions (Run policy now,
Purge logs, Policy reference link), and surfaces a relative-time +
status hint under the existing Run-Now collapsible.

Module-isolation is preserved through a new read-side contract:

* core/Service/Audit/UserLifecycleAuditDashboardInterface — read-only
  pendant to the existing write-side UserLifecycleAuditInterface.
  Methods: lastRun(), summaryByAction(int days), countActionInWindow(...).
* core/Service/Audit/NullUserLifecycleAuditDashboard — fail-closed
  default when the audit module is disabled. KPI tiles 1-3 then
  render "—"; tile 4 (pending deletion) keeps working because it
  lives in the core domain.
* modules/audit/.../Service/UserLifecycleAuditDashboardService — the
  module's implementation; reads through the existing
  UserLifecycleAuditRepository (extended with three new aggregation
  queries: lastRun, countByActionStatusSinceTimestamp, countSinceTimestamp).
* AuditContainerRegistrar binds the interface to the module impl;
  registerContainer.php registers the Null fallback before module
  bindings, mirroring how the write-side audit interface is wired.

The new core service UserLifecyclePolicyDashboardService computes
the pending-deletion-window count from the users table directly
(no audit dependency) — defensive when both policy days are 0
(returns 0 rather than running an unbounded query).

New shared template partial templates/partials/app-kpi-row.phtml is
generic — accepts a $kpiTiles array of {label, count, icon, iconTone,
href, tooltip} and reuses the existing app-tile primitive. Other
settings pages can pick it up without ceremony.

Includes:
* PHPUnit tests for both new services (happy path + Null-fallback +
  policy-disabled edge cases).
* AuditModuleIsolationContractTest allowlist extended for the new
  interface and module service.
* 14 new translation keys in both default_de.json and default_en.json
  (i18n parity verified).

All six quality gates green.

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

pages/admin/settings/user-lifecycle().php

@@ -4,7 +4,10 @@ use MintyPHP\Buffer;
 use MintyPHP\Http\SessionStoreInterface;
 use MintyPHP\Router;
 use MintyPHP\Service\Access\SettingsAuthorizationPolicy;
+use MintyPHP\Service\Audit\NullUserLifecycleAuditDashboard;
+use MintyPHP\Service\Audit\UserLifecycleAuditDashboardInterface;
 use MintyPHP\Service\Settings\AdminSettingsService;
+use MintyPHP\Service\User\UserLifecyclePolicyDashboardService;
 use MintyPHP\Support\Flash;
 use MintyPHP\Support\Guard;
 
@@ -75,6 +78,135 @@ if ($request->isMethod('POST')) {
     Router::redirect($redirectTarget);
 }
 
+// ── KPI cockpit data (server-rendered, no async) ─────────────────────
+$deactivateDays = (int) ($values['user_inactivity_deactivate_days'] ?? 0);
+$deleteDays = (int) ($values['user_inactivity_delete_days'] ?? 0);
+
+$dashboardService = app(UserLifecyclePolicyDashboardService::class);
+$auditDashboard = app(UserLifecycleAuditDashboardInterface::class);
+$auditDashboardActive = !($auditDashboard instanceof NullUserLifecycleAuditDashboard);
+
+$lastRun = $auditDashboard->lastRun();
+$summary = $auditDashboard->summaryByAction(30);
+$pendingCount = $dashboardService->pendingDeletionCount($deactivateDays, $deleteDays, 7);
+
+$lastRunAt = $lastRun !== null ? (string) ($lastRun['created_at'] ?? '') : null;
+$lastRunStatus = $lastRun !== null ? (string) ($lastRun['status'] ?? '') : null;
+if ($lastRunAt !== null && $lastRunAt === '') {
+    $lastRunAt = null;
+}
+
+// Build relative-time + status suffix for the Run-Now <details> summary line and the KPI tile.
+$lastRunRelative = '—';
+$lastRunStatusLabel = '';
+if ($lastRunAt !== null) {
+    try {
+        $createdUtc = (new \DateTimeImmutable($lastRunAt, new \DateTimeZone('UTC')))->getTimestamp();
+        $diffDays = (int) floor((time() - $createdUtc) / 86400);
+        if ($diffDays <= 0) {
+            $lastRunRelative = t('today');
+        } elseif ($diffDays === 1) {
+            $lastRunRelative = t('yesterday');
+        } else {
+            $lastRunRelative = sprintf(t('%d days ago'), $diffDays);
+        }
+    } catch (\Throwable) {
+        $lastRunRelative = '—';
+    }
+    if ($lastRunStatus !== null && $lastRunStatus !== '') {
+        // Status enum tokens are translated via existing 'Success'/'Failed'/'Skipped' keys.
+        $statusKey = ucfirst(strtolower($lastRunStatus));
+        $lastRunStatusLabel = t($statusKey);
+    }
+}
+
+$lastRunSummary = '';
+if ($lastRunAt !== null) {
+    $lastRunSummary = sprintf(
+        '%s: %s%s',
+        t('Last run'),
+        $lastRunRelative,
+        $lastRunStatusLabel !== '' ? ' · ' . $lastRunStatusLabel : ''
+    );
+} else {
+    $lastRunSummary = t('No runs yet');
+}
+
+$lastRunTooltip = $lastRunStatusLabel !== '' ? $lastRunStatusLabel : t('No runs yet');
+$pendingDisabled = ($deactivateDays <= 0 || $deleteDays <= 0);
+
+/** @var array<int, array<string, mixed>> $kpiTiles */
+$kpiTiles = [
+    [
+        'label' => t('Last run'),
+        'count' => $lastRunAt !== null ? $lastRunRelative : '—',
+        'icon' => 'bi bi-clock-history',
+        'iconTone' => 'blue',
+        'href' => 'admin/settings/user-lifecycle',
+        'tooltip' => $lastRunTooltip,
+    ],
+    [
+        'label' => t('Deactivated'),
+        'count' => $auditDashboardActive ? (string) ((int) ($summary['deactivate'] ?? 0)) : '—',
+        'icon' => 'bi bi-person-dash',
+        'iconTone' => 'amber',
+        'href' => 'admin/settings/user-lifecycle',
+        'tooltip' => t('Last 30 days'),
+    ],
+    [
+        'label' => t('Deleted'),
+        'count' => $auditDashboardActive ? (string) ((int) ($summary['delete'] ?? 0)) : '—',
+        'icon' => 'bi bi-person-x',
+        'iconTone' => 'red',
+        'href' => 'admin/settings/user-lifecycle',
+        'tooltip' => t('Last 30 days'),
+    ],
+    [
+        'label' => t('Pending deletion'),
+        'count' => $pendingDisabled ? '—' : (string) $pendingCount,
+        'icon' => 'bi bi-exclamation-triangle',
+        'iconTone' => 'orange',
+        'href' => 'admin/users',
+        'tooltip' => t('Next 7 days'),
+    ],
+];
+
+// ── Aside quick actions ──────────────────────────────────────────────
+/** @var array<int, array<string, mixed>> $asideActions */
+$asideActions = [];
+if ($canUpdateSettings) {
+    $asideActions[] = [
+        'type' => 'form',
+        'label' => t('Run policy now'),
+        'action' => 'admin/settings/run-user-lifecycle',
+        'method' => 'POST',
+        'class' => 'secondary outline small',
+        'tone' => 'danger',
+        'confirm' => t('Run user lifecycle now?'),
+        'detailActionKind' => 'danger',
+    ];
+}
+if ($canUpdateSettings && $auditDashboardActive) {
+    $asideActions[] = [
+        'type' => 'form',
+        'label' => t('Purge logs'),
+        'action' => 'admin/settings/user-lifecycle/audit-purge',
+        'method' => 'POST',
+        'class' => 'secondary outline small',
+        'tone' => 'danger',
+        'confirm' => t('Purge old user lifecycle audit log entries?'),
+        'detailActionKind' => 'purge',
+    ];
+}
+$asideActions[] = [
+    'type' => 'link',
+    'label' => t('Policy reference'),
+    'href' => 'docs/reference-benutzer-lifecycle-policy.md',
+    'class' => 'secondary outline small',
+    'target' => '_blank',
+    'rel' => 'noopener',
+];
+
 Buffer::set('title', t('User lifecycle settings'));
 
 $breadcrumbs = [

pages/admin/settings/user-lifecycle(default).phtml

@@ -4,6 +4,9 @@
  * @var array $values
  * @var array $settings
  * @var bool  $canUpdateSettings
+ * @var array<int, array<string, mixed>> $kpiTiles
+ * @var string $lastRunSummary
+ * @var array<int, array<string, mixed>> $asideActions
  */
 
 use MintyPHP\Session;
@@ -17,6 +20,9 @@ $userInactivityDeleteDaysDesc = $settings['user_inactivity_delete_days']['descri
 $canUpdateSettings = (bool) ($canUpdateSettings ?? false);
 $isReadOnly = !$canUpdateSettings;
 $readonlyAttr = $isReadOnly ? 'readonly' : '';
+$kpiTiles = is_array($kpiTiles ?? null) ? $kpiTiles : [];
+$lastRunSummary = (string) ($lastRunSummary ?? '');
+$asideActions = is_array($asideActions ?? null) ? $asideActions : [];
 $layoutAuth = is_array($viewAuth['layout'] ?? null) ? $viewAuth['layout'] : [];
 $layoutNav = is_array($layoutNav ?? null) ? $layoutNav : [];
 $moduleSlots = is_array($layoutNav['moduleSlots'] ?? null) ? $layoutNav['moduleSlots'] : [];
@@ -52,6 +58,8 @@ $moduleLifecyclePanelSlots = is_array($moduleSlots['settings.user_lifecycle.pane
     require templatePath('partials/app-details-titlebar.phtml');
     ?>
 
+    <?php require templatePath('partials/app-kpi-row.phtml'); ?>
+
     <form id="settings-user-lifecycle-form" method="post" data-details-storage="settings-user-lifecycle-details-v1" data-standard-detail-form="1">
       <div class="grid">
         <label class="app-field">
@@ -74,6 +82,9 @@ $moduleLifecyclePanelSlots = is_array($moduleSlots['settings.user_lifecycle.pane
         <details class="app-details-card" name="settings-user-lifecycle-run-now" data-details-key="settings-user-lifecycle-run-now">
           <summary>
             <span class="app-details-card-summary-title"><?php e(t('Run lifecycle now')); ?></span>
+            <?php if ($lastRunSummary !== ''): ?>
+              <span class="app-details-card-summary-meta"><?php e($lastRunSummary); ?></span>
+            <?php endif; ?>
           </summary>
           <div class="app-details-card-container">
             <blockquote data-variant="warning">
@@ -111,6 +122,8 @@ $moduleLifecyclePanelSlots = is_array($moduleSlots['settings.user_lifecycle.pane
     <?php endforeach; ?>
   </section>
   <aside id="app-details-aside-section">
-    <div class="app-details-aside-section"></div>
+    <div class="app-details-aside-section">
+      <?php require templatePath('partials/app-details-aside-actions.phtml'); ?>
+    </div>
   </aside>
 </div>