From 2be7232c83d20063424f2d6be41755d90f6130c0 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

---
 package.json                                   |  2 +-
 pyproject.toml                                 |  2 +-
 .../backend/german_structured_documentation.py | 18 ++++++++++++++++++
 src/govoplan_helpdesk/backend/manifest.py      | 10 +++++++++-
 tests/test_manifest.py                         |  2 +-
 webui/package.json                             |  2 +-
 6 files changed, 31 insertions(+), 5 deletions(-)
 create mode 100644 src/govoplan_helpdesk/backend/german_structured_documentation.py

diff --git a/package.json b/package.json
index 0562735..1b5ae2f 100644
--- a/package.json
+++ b/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@govoplan/helpdesk-webui",
-  "version": "0.1.20",
+  "version": "0.1.21",
   "private": true,
   "description": "GovOPlaN Helpdesk service-profile and ticket-routing policy module.",
   "type": "module",
diff --git a/pyproject.toml b/pyproject.toml
index 3519303..12dcb93 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "govoplan-helpdesk"
-version = "0.1.20"
+version = "0.1.21"
 description = "GovOPlaN Helpdesk service-profile and ticket-routing policy module."
 readme = "README.md"
 requires-python = ">=3.12"
diff --git a/src/govoplan_helpdesk/backend/german_structured_documentation.py b/src/govoplan_helpdesk/backend/german_structured_documentation.py
new file mode 100644
index 0000000..b447c11
--- /dev/null
+++ b/src/govoplan_helpdesk/backend/german_structured_documentation.py
@@ -0,0 +1,18 @@
+"""German translations for public structured documentation metadata."""
+
+from __future__ import annotations
+
+from typing import Any
+
+
+GERMAN_STRUCTURED_TRANSLATIONS: dict[str, dict[str, Any]] = {'helpdesk.module-boundary': {'consequence_classes': {'policy_overlay': 'Wendet Warteschlangen- '
+                                                                        'und '
+                                                                        'Service-Zielrichtlinien '
+                                                                        'an, ohne den '
+                                                                        'Ticket-Status zu '
+                                                                        'duplizieren.',
+                                                      'reduced_installation': 'Manuelles '
+                                                                              'Ticket-Routing '
+                                                                              'bleibt verfügbar, '
+                                                                              'wenn Helpdesk '
+                                                                              'deaktiviert ist.'}}}
diff --git a/src/govoplan_helpdesk/backend/manifest.py b/src/govoplan_helpdesk/backend/manifest.py
index f3af43d..32e6f05 100644
--- a/src/govoplan_helpdesk/backend/manifest.py
+++ b/src/govoplan_helpdesk/backend/manifest.py
@@ -1,5 +1,8 @@
 from __future__ import annotations
 
+from govoplan_core.core.modules import with_documentation_structured_translations
+from govoplan_helpdesk.backend.german_structured_documentation import GERMAN_STRUCTURED_TRANSLATIONS
+
 from pathlib import Path
 
 from govoplan_core.core.access import CAPABILITY_AUTH_PERMISSION_EVALUATOR, CAPABILITY_AUTH_PRINCIPAL_RESOLVER
@@ -31,7 +34,7 @@ from govoplan_helpdesk.backend.service import SqlHelpdeskRoutingProvider
 
 MODULE_ID = "helpdesk"
 MODULE_NAME = "Helpdesk"
-MODULE_VERSION = "0.1.20"
+MODULE_VERSION = "0.1.21"
 READ_SCOPE = "helpdesk:workspace:read"
 WRITE_SCOPE = "helpdesk:workspace:write"
 ADMIN_SCOPE = "helpdesk:workspace:admin"
@@ -220,5 +223,10 @@ manifest = ModuleManifest(
 )
 
 
+manifest = with_documentation_structured_translations(
+    manifest, locale="de", translations=GERMAN_STRUCTURED_TRANSLATIONS
+)
+
+
 def get_manifest() -> ModuleManifest:
     return manifest
diff --git a/tests/test_manifest.py b/tests/test_manifest.py
index 06e7cd9..ea6b4ff 100644
--- a/tests/test_manifest.py
+++ b/tests/test_manifest.py
@@ -11,7 +11,7 @@ class ManifestTests(unittest.TestCase):
     def test_manifest_registers_helpdesk_policy_overlay(self) -> None:
         manifest = get_manifest()
         self.assertEqual("helpdesk", manifest.id)
-        self.assertEqual("0.1.20", manifest.version)
+        self.assertEqual("0.1.21", manifest.version)
         self.assertEqual({READ_SCOPE, WRITE_SCOPE, ADMIN_SCOPE}, {item.scope for item in manifest.permissions})
         self.assertEqual({"helpdesk_manager", "helpdesk_viewer", "helpdesk_administrator"}, {item.slug for item in manifest.role_templates})
         self.assertIsNotNone(manifest.route_factory)
diff --git a/webui/package.json b/webui/package.json
index 845f014..37c6e37 100644
--- a/webui/package.json
+++ b/webui/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@govoplan/helpdesk-webui",
-  "version": "0.1.20",
+  "version": "0.1.21",
   "private": true,
   "type": "module",
   "main": "src/index.ts",