From f3daca7ed72cb45d3841912f3bc682e328c18928 Mon Sep 17 00:00:00 2001
From: Albrecht Degering <albrecht@degering.name>
Date: Mon, 24 Aug 2026 01:15:34 +0200
Subject: [PATCH] docs: complete German structured documentation

---
 pyproject.toml                                |  2 +-
 src/govoplan_identity/__init__.py             |  2 +-
 .../german_structured_documentation.py        | 38 +++++++++++++++++++
 src/govoplan_identity/backend/manifest.py     | 10 ++++-
 webui/package.json                            |  2 +-
 5 files changed, 50 insertions(+), 4 deletions(-)
 create mode 100644 src/govoplan_identity/backend/german_structured_documentation.py

diff --git a/pyproject.toml b/pyproject.toml
index 60c6dd5..da657c7 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "govoplan-identity"
-version = "0.1.19"
+version = "0.1.20"
 description = "GovOPlaN identity directory module."
 readme = "README.md"
 requires-python = ">=3.12"
diff --git a/src/govoplan_identity/__init__.py b/src/govoplan_identity/__init__.py
index a94b56d..c31eaa7 100644
--- a/src/govoplan_identity/__init__.py
+++ b/src/govoplan_identity/__init__.py
@@ -1,3 +1,3 @@
 """GovOPlaN identity module."""
 
-__version__ = "0.1.19"
+__version__ = "0.1.20"
diff --git a/src/govoplan_identity/backend/german_structured_documentation.py b/src/govoplan_identity/backend/german_structured_documentation.py
new file mode 100644
index 0000000..bc55a36
--- /dev/null
+++ b/src/govoplan_identity/backend/german_structured_documentation.py
@@ -0,0 +1,38 @@
+"""German translations for public structured documentation metadata."""
+
+from __future__ import annotations
+
+from typing import Any
+
+
+GERMAN_STRUCTURED_TRANSLATIONS: dict[str, dict[str, Any]] = {'identity.administration': {'outcome': 'Canonical Identität und Link Zustand ändert sich atomar '
+                                        'mit system-scoped Audit-Beweis.',
+                             'prerequisites': ['Der Administrator verfügt über die Berechtigung '
+                                               'zur Verwaltung der Systemidentität.',
+                                               'Konto-IDs werden von einem autorisierten '
+                                               'Access-Verwaltungsworkflow abgerufen.'],
+                             'verification': 'Laden Sie die Identität neu, überprüfen Sie den '
+                                             'primären Marker und den Lebenszykluszustand und '
+                                             'prüfen Sie dann die entsprechenden '
+                                             'Systemaudit-Aufzeichnungen.'},
+ 'identity.data-subject-requests': {'consequence_classes': {'corroborated_export': 'Gibt nur ein '
+                                                                                   'übereinstimmendes '
+                                                                                   'Identitäts-/Konto-Link-Paar '
+                                                                                   'an.',
+                                                            'manual_erasure_review': 'Verhindert, '
+                                                                                     'dass eine '
+                                                                                     'Mandantenanfrage '
+                                                                                     'den '
+                                                                                     'systemweiten '
+                                                                                     'Identitätsstatus '
+                                                                                     'ändert.'}},
+ 'identity.lifecycle': {'outcome': 'Identitätssichtbarkeit oder Statusänderungen des Primärkontos, '
+                                   'ohne die Herkunft des Kontolinks zu löschen.',
+                        'prerequisites': ['Der Anrufer hat eine separate Lifecycle-Berechtigung '
+                                          'eingerichtet.',
+                                          'Das Ersatz-Primärkonto ist bereits mit der Identität '
+                                          'verknüpft.'],
+                        'verification': 'Bestätigen Sie gewöhnliche versus inaktive '
+                                        'Verzeichnisergebnisse, überprüfen Sie jeden beibehaltenen '
+                                        'Kontolink und überprüfen Sie den entsprechenden '
+                                        'Identitätslebenszyklus-Audit-Record.'}}
diff --git a/src/govoplan_identity/backend/manifest.py b/src/govoplan_identity/backend/manifest.py
index ee116e1..6472934 100644
--- a/src/govoplan_identity/backend/manifest.py
+++ b/src/govoplan_identity/backend/manifest.py
@@ -1,5 +1,8 @@
 from __future__ import annotations
 
+from govoplan_core.core.modules import with_documentation_structured_translations
+from govoplan_identity.backend.german_structured_documentation import GERMAN_STRUCTURED_TRANSLATIONS
+
 from pathlib import Path
 
 from govoplan_core.core.access import (
@@ -115,7 +118,7 @@ def _dsar_provider(context: ModuleContext) -> IdentityDsarProvider:
 manifest = ModuleManifest(
     id="identity",
     name="Identity",
-    version="0.1.19",
+    version="0.1.20",
     required_capabilities=(
         CAPABILITY_AUTH_PRINCIPAL_RESOLVER,
         CAPABILITY_AUTH_PERMISSION_EVALUATOR,
@@ -362,5 +365,10 @@ manifest = ModuleManifest(
 )
 
 
+manifest = with_documentation_structured_translations(
+    manifest, locale="de", translations=GERMAN_STRUCTURED_TRANSLATIONS
+)
+
+
 def get_manifest() -> ModuleManifest:
     return manifest
diff --git a/webui/package.json b/webui/package.json
index b57c5cd..99d6a59 100644
--- a/webui/package.json
+++ b/webui/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@govoplan/identity-webui",
-  "version": "0.1.19",
+  "version": "0.1.20",
   "private": true,
   "type": "module",
   "main": "src/index.ts",