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.

README.md

@@ -32,3 +32,21 @@ PYTHONPATH=src:/mnt/DATA/git/govoplan-core/src \
 
 cd webui && npm run test:interface-pattern
 ```
+
+## Git-source WebUI package
+
+The repository root exposes `@govoplan/payments-webui` for Git-tagged release
+dependencies. It mirrors the owning `webui/package.json` version, public
+TypeScript/CSS exports and peer requirements, with entry paths under
+`webui/src`. Consumers provide the shared Core/React peers; the facade runs no
+development or install scripts. The source archive contains `webui/src`, this
+README and any repository license file. Run module development checks from `webui/`; Python
+installation remains governed by `pyproject.toml`.
+
+Das Repository stellt `@govoplan/payments-webui` am Wurzelpfad für versionierte
+Git-Abhängigkeiten bereit. Version, öffentliche TypeScript-/CSS-Exporte und
+Peer-Anforderungen entsprechen `webui/package.json`; die Einstiegspfade liegen
+unter `webui/src`. Gemeinsame Core-/React-Peers stellt die einbindende Anwendung
+bereit. Die Fassade führt keine Entwicklungs- oder Installationsskripte aus.
+Entwicklungsprüfungen bleiben in `webui/`, die Python-Installation weiterhin in
+`pyproject.toml` definiert.

package.json

@@ -0,0 +1,33 @@
+{
+  "name": "@govoplan/payments-webui",
+  "version": "0.1.22",
+  "private": true,
+  "type": "module",
+  "main": "webui/src/index.ts",
+  "module": "webui/src/index.ts",
+  "types": "webui/src/index.ts",
+  "exports": {
+    ".": {
+      "types": "./webui/src/index.ts",
+      "import": "./webui/src/index.ts"
+    },
+    "./styles/payments.css": "./webui/src/styles/payments.css"
+  },
+  "peerDependencies": {
+    "@govoplan/core-webui": "^0.1.18",
+    "lucide-react": "^1.23.0",
+    "react": ">=19.2.7 <20",
+    "react-dom": ">=19.2.7 <20",
+    "react-router": ">=8.3.0 <9"
+  },
+  "peerDependenciesMeta": {
+    "@govoplan/core-webui": {
+      "optional": true
+    }
+  },
+  "files": [
+    "webui/src",
+    "README.md",
+    "LICENSE"
+  ]
+}

pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "govoplan-payments"
-version = "0.1.21"
+version = "0.1.22"
 description = "Replay-safe payment obligations and reconciliation evidence for GovOPlaN."
 readme = "README.md"
 requires-python = ">=3.12"

src/govoplan_payments/__init__.py

@@ -1,3 +1,3 @@
 """GovOPlaN Payments module."""
 
-__version__ = "0.1.21"
+__version__ = "0.1.22"

src/govoplan_payments/backend/manifest.py

@@ -36,7 +36,7 @@ from govoplan_payments.backend.service import SqlPaymentRequestProvider
 
 MODULE_ID = "payments"
 MODULE_NAME = "Payments"
-MODULE_VERSION = "0.1.21"
+MODULE_VERSION = "0.1.22"
 READ_SCOPE = "payments:payment:read"
 WRITE_SCOPE = "payments:payment:write"
 RECONCILE_SCOPE = "payments:payment:reconcile"
@@ -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 "

tests/test_payments.py

@@ -1,6 +1,8 @@
 from __future__ import annotations
 
 from datetime import UTC, datetime, timedelta
+from pathlib import Path
+import tomllib
 import unittest
 
 from sqlalchemy import create_engine
@@ -201,7 +203,8 @@ class PaymentTests(unittest.TestCase):
         self.assertEqual((), self.provider.list_payments(self.session, tenant_id="tenant-2"))
 
     def test_manifest_exposes_permission_bounded_operator_workspace(self) -> None:
-        self.assertEqual("0.1.21", manifest.version)
+        project = tomllib.loads((Path(__file__).parents[1] / "pyproject.toml").read_text())
+        self.assertEqual(project["project"]["version"], manifest.version)
         self.assertIsNotNone(manifest.frontend)
         assert manifest.frontend is not None
         self.assertEqual("@govoplan/payments-webui", manifest.frontend.package_name)

webui/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@govoplan/payments-webui",
-  "version": "0.1.21",
+  "version": "0.1.22",
   "private": true,
   "type": "module",
   "main": "src/index.ts",

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}
           />
         )}