From 69396fc0d0ce7f21da5e72c2ad6d4cf7c599a857 Mon Sep 17 00:00:00 2001
From: Albrecht Degering <albrecht@degering.name>
Date: Wed, 9 Sep 2026 02:03:58 +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_payments/backend/manifest.py    | 5 +++++
 webui/src/features/payments/PaymentsPage.tsx | 4 ++--
 2 files changed, 7 insertions(+), 2 deletions(-)

diff --git a/src/govoplan_payments/backend/manifest.py b/src/govoplan_payments/backend/manifest.py
index 9567561..55663f3 100644
--- a/src/govoplan_payments/backend/manifest.py
+++ b/src/govoplan_payments/backend/manifest.py
@@ -348,6 +348,8 @@ manifest = ModuleManifest(
             title="Payment requests and manual reconciliation",
             summary="Create an exact obligation and mark it paid only with matching, immutable evidence.",
             body=(
+                "Documentation books sit immediately beside the visible heading or contextual label for "
+                "Payment requests, not among operational action buttons. Field help remains beside its label. "
                 "Payments owns the tenant-bound payment ID, human payment reference, requested amount and currency, lifecycle events, and reconciliation evidence. "
                 "A Case, Workflow, or other procedure calls the payments.requests capability with its own source reference and a replay key; it keeps the returned payment ID instead of writing Payments tables. "
                 "The Payments workspace lists requested and paid obligations with source, due or settled times, and reconciliation evidence. A writer creates a request through the guided dialog; a reconciler uses the separate consequential dialog, which fixes the amount and currency and requires an external transaction reference plus a same-tenant versioned or checksum-bound EvidenceReference. Reload preserves loaded data and marks it stale when refresh fails. Missing create or reconciliation authority remains visible with the required permission and responsible administrator. "
@@ -418,6 +420,9 @@ manifest = ModuleManifest(
                         "Nachweis als bezahlt kennzeichnen."
                     ),
                     "body": (
+                        "Dokumentationsbücher stehen unmittelbar neben der sichtbaren Überschrift oder "
+                        "Kontextbezeichnung für Zahlungsanforderungen, nicht zwischen ausführbaren "
+                        "Aktionsschaltflächen. Feldhilfe bleibt neben der Feldbezeichnung. "
                         "Payments führt die mandantengebundene Zahlungskennung, die menschenlesbare "
                         "Zahlungsreferenz, angeforderten Betrag und Währung, Lebenszyklusereignisse und "
                         "Abstimmungsnachweise. Ein Case, Workflow oder anderes Verfahren ruft die Fähigkeit "
diff --git a/webui/src/features/payments/PaymentsPage.tsx b/webui/src/features/payments/PaymentsPage.tsx
index b8af8cb..21d80b9 100644
--- a/webui/src/features/payments/PaymentsPage.tsx
+++ b/webui/src/features/payments/PaymentsPage.tsx
@@ -264,7 +264,7 @@ export default function PaymentsPage({ settings, auth }: PlatformRouteContext) {
       <PageLayout
         archetype="collection"
         mode="standalone"
-        title="Payment requests"
+        title="Payment requests" titleHelp={<DocumentationHelpLink reference={{ topicId: "payments.requests-and-reconciliation", documentationType: "user" }} label="Open Payments documentation" />}
         description="Track source-bound obligations and record exact manual receipts against immutable evidence."
         loading={loading}
         loadingLabel="Loading payment requests"
@@ -281,7 +281,7 @@ export default function PaymentsPage({ settings, auth }: PlatformRouteContext) {
             helpContextId="payments.workspace"
             helpModuleId="payments"
             reloadAction={{ onReload: () => void reload(), loading: refreshing, label: "Reload payment requests" }}
-            helpAction={<DocumentationHelpLink reference={{ topicId: "payments.requests-and-reconciliation", documentationType: "user" }} label="Open Payments documentation" />}
+
             createAction={createButton}
           />
         )}