From 0e3552069019caac9132a4796d08bb1220481812 Mon Sep 17 00:00:00 2001
From: Albrecht Degering <albrecht@degering.name>
Date: Sat, 22 Aug 2026 07:55:19 +0200
Subject: [PATCH] docs: complete public documentation baseline

---
 package.json                                 |  2 +-
 pyproject.toml                               |  2 +-
 src/govoplan_procurement/backend/manifest.py | 13 ++++++++++++-
 tests/test_manifest.py                       |  9 +++++++++
 4 files changed, 23 insertions(+), 3 deletions(-)

diff --git a/package.json b/package.json
index fdb1dd1..156bdea 100644
--- a/package.json
+++ b/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@govoplan/procurement",
-  "version": "0.1.18",
+  "version": "0.1.19",
   "private": true,
   "description": "GovOPlaN Procurement platform module seed.",
   "type": "module",
diff --git a/pyproject.toml b/pyproject.toml
index fd859fa..28a294c 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "govoplan-procurement"
-version = "0.1.18"
+version = "0.1.19"
 description = "GovOPlaN Procurement platform module seed."
 readme = "README.md"
 requires-python = ">=3.12"
diff --git a/src/govoplan_procurement/backend/manifest.py b/src/govoplan_procurement/backend/manifest.py
index 73069c6..bb883ad 100644
--- a/src/govoplan_procurement/backend/manifest.py
+++ b/src/govoplan_procurement/backend/manifest.py
@@ -6,7 +6,7 @@ from govoplan_core.core.provider_governance import declared_module_architecture
 
 MODULE_ID = "procurement"
 MODULE_NAME = "Procurement"
-MODULE_VERSION = "0.1.18"
+MODULE_VERSION = "0.1.19"
 READ_SCOPE = "procurement:workspace:read"
 WRITE_SCOPE = "procurement:workspace:write"
 ADMIN_SCOPE = "procurement:workspace:admin"
@@ -70,6 +70,13 @@ DOCUMENTATION = (
         layer="available",
         documentation_types=("admin", "user"),
         audience=("user", "operator", "module_admin", "product_owner"),
+        translations={
+            "de": {
+                "title": "Modulgrenze von Procurement",
+                "summary": "Beschaffungsverfahren für Bedarfsanforderungen, Genehmigungen, Lieferantenvergleiche, Ausschreibungsverweise, Vertragsübergaben, Wareneingänge und Rechnungsabgleiche.",
+                "body": "Dieses Repository ist derzeit ein Grundgerüst für ein Plattformmodul. Es registriert die Fachgrenze, Berechtigungsoberfläche, Rollenvorlagen und Dokumentationsmetadaten, bevor Laufzeit-APIs, Datenbankmodelle, Migrationen und WebUI-Routen eingeführt werden.",
+            }
+        },
         order=100,
         related_modules=OPTIONAL_DEPENDENCIES,
         links=(
@@ -80,7 +87,11 @@ DOCUMENTATION = (
             ),
         ),
         metadata={
+            "kind": "reference",
             "seed": True,
+            "consequence_classes": {
+                "seed_boundary": "Declares ownership and permissions only; no runtime workflow is available yet.",
+            },
             "domain_objects": ['purchase request lifecycle', 'vendor comparison records', 'tender references', 'goods receipt facts', 'contract handoff state', 'invoice matching context'],
             "first_slice": "Define purchase request, vendor comparison, goods receipt, and contract handoff records before integrating approval chains.",
         },
diff --git a/tests/test_manifest.py b/tests/test_manifest.py
index 18f71c6..e71bbd4 100644
--- a/tests/test_manifest.py
+++ b/tests/test_manifest.py
@@ -15,6 +15,15 @@ class ManifestSeedTests(unittest.TestCase):
         self.assertEqual({permission.scope for permission in manifest.permissions}, {READ_SCOPE, WRITE_SCOPE, ADMIN_SCOPE})
         self.assertEqual({role.slug for role in manifest.role_templates}, {"procurement_manager", "procurement_viewer"})
         self.assertTrue(manifest.documentation)
+        topic = manifest.documentation[0]
+        self.assertEqual("reference", topic.metadata["kind"])
+        self.assertIn("seed_boundary", topic.metadata["consequence_classes"])
+        self.assertTrue(
+            all(
+                topic.translations.get("de", {}).get(field)
+                for field in ("title", "summary", "body")
+            )
+        )
         self.assertIsNone(manifest.route_factory)
         self.assertIsNone(manifest.migration_spec)
         self.assertIsNone(manifest.frontend)