From 26ec2ca5a9ed7c1b9d1ae6853f84bd4787df66bc Mon Sep 17 00:00:00 2001 From: Albrecht Degering Date: Wed, 9 Sep 2026 02:03:34 +0200 Subject: [PATCH] fix(ui): align contextual documentation with headings Verified with the coordinated workspace changes by devkit full run 2026-09-08T225814-186389-0000-3e3ed7cd (all seven phases passed). This shared UI pass does not mark the individual module reviews complete. --- src/govoplan_audit/backend/manifest.py | 12 ++++++++++-- webui/src/features/audit/AdminAuditPanel.tsx | 10 +++++----- 2 files changed, 15 insertions(+), 7 deletions(-) diff --git a/src/govoplan_audit/backend/manifest.py b/src/govoplan_audit/backend/manifest.py index d3eb2c8..f13ce43 100644 --- a/src/govoplan_audit/backend/manifest.py +++ b/src/govoplan_audit/backend/manifest.py @@ -153,7 +153,9 @@ manifest = ModuleManifest( id="audit.read-authorized-evidence", title="Read authorized audit evidence", summary="Audit history explains who performed a governed action, when it happened, and which resource and trace context were involved.", - body="Audit views are permission- and tenant-scoped. Entries are evidence, not editable business records. Sensitive payloads may be redacted while stable resource, actor, outcome, request, run, and trace references remain available for investigation.", + body="Open the documentation book beside the audit heading to understand the displayed evidence " + "and its access boundary. " + "Audit views are permission- and tenant-scoped. Entries are evidence, not editable business records. Sensitive payloads may be redacted while stable resource, actor, outcome, request, run, and trace references remain available for investigation.", documentation_types=("user",), audience=("auditor", "tenant_admin", "operator"), translations={ @@ -161,6 +163,8 @@ manifest = ModuleManifest( "title": "Berechtigte Audit-Nachweise lesen", "summary": "Der Audit-Verlauf erklärt, wer eine gesteuerte Handlung wann ausgeführt hat und welche Ressourcen- und Trace-Zusammenhänge beteiligt waren.", "body": ( + "Öffnen Sie das Dokumentationsbuch neben der Audit-Überschrift, um die angezeigten Nachweise " + "und ihre Zugriffsgrenzen zu verstehen. " "Audit-Ansichten sind nach Berechtigung und Mandant begrenzt. Einträge sind Nachweise und keine bearbeitbaren Fachdaten. " "Sensible Nutzdaten können geschwärzt sein, während stabile Verweise auf Ressource, Akteur, Ergebnis, Anfrage, Lauf und Trace für Untersuchungen verfügbar bleiben." ), @@ -180,7 +184,9 @@ manifest = ModuleManifest( id="audit.recording-retention-and-outbox", title="Operate audit recording and event delivery", summary="Audit owns durable audit records, retention operations, and the transactional platform-event outbox.", - body="Modules record bounded audit facts through the Audit capability. Governed platform events are committed to the outbox with retry and delivery metadata so a failed consumer does not erase the originating transaction. Worker dispatch is partitioned by tenant entitlement; an unavailable consumer retains its durable delivery and records an operator-required outcome instead of acknowledging the event. Retention and destructive retirement must preserve the configured evidence and recovery guarantees.", + body="Open the documentation book beside the audit heading to understand the displayed evidence " + "and its access boundary. " + "Modules record bounded audit facts through the Audit capability. Governed platform events are committed to the outbox with retry and delivery metadata so a failed consumer does not erase the originating transaction. Worker dispatch is partitioned by tenant entitlement; an unavailable consumer retains its durable delivery and records an operator-required outcome instead of acknowledging the event. Retention and destructive retirement must preserve the configured evidence and recovery guarantees.", documentation_types=("admin",), audience=("auditor", "security_officer", "operator"), related_modules=("policy", "ops"), @@ -189,6 +195,8 @@ manifest = ModuleManifest( "title": "Audit-Aufzeichnung, Aufbewahrung und Ereigniszustellung betreiben", "summary": "Audit verwaltet dauerhafte Audit-Datensätze, Aufbewahrungsvorgänge und die transaktionale Plattformereignis-Outbox.", "body": ( + "Öffnen Sie das Dokumentationsbuch neben der Audit-Überschrift, um die angezeigten Nachweise " + "und ihre Zugriffsgrenzen zu verstehen. " "Module zeichnen begrenzte Audit-Fakten über die Audit-Fähigkeit auf. Gesteuerte Plattformereignisse werden zusammen mit Wiederholungs- und Zustellmetadaten in die Outbox übernommen, sodass ein ausgefallener Verbraucher die ursprüngliche Transaktion nicht auslöscht. " "Die Worker-Zustellung wird nach Mandantenberechtigung getrennt; ein nicht verfügbarer Verbraucher behält seine dauerhafte Zustellung und erfasst ein Ergebnis, das einen betrieblichen Eingriff verlangt, statt das Ereignis zu bestätigen. " "Aufbewahrung und destruktive Ausmusterung müssen die konfigurierten Nachweis- und Wiederherstellungsgarantien erhalten." diff --git a/webui/src/features/audit/AdminAuditPanel.tsx b/webui/src/features/audit/AdminAuditPanel.tsx index 84b9c41..3cdcca3 100644 --- a/webui/src/features/audit/AdminAuditPanel.tsx +++ b/webui/src/features/audit/AdminAuditPanel.tsx @@ -208,6 +208,11 @@ export default function AdminAuditPanel({ settings, auth, systemMode = false }: <> } description={pageDescription} loading={loading} error={error} @@ -221,11 +226,6 @@ export default function AdminAuditPanel({ settings, auth, systemMode = false }: {I18N.exportEvidence} )} -