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

---
 package.json                                  |  2 +-
 pyproject.toml                                |  2 +-
 src/govoplan_certificates/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 56fa81b..1e6a37d 100644
--- a/package.json
+++ b/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@govoplan/certificates",
-  "version": "0.1.18",
+  "version": "0.1.19",
   "private": true,
   "description": "GovOPlaN Certificates platform module seed.",
   "type": "module",
diff --git a/pyproject.toml b/pyproject.toml
index 074591c..c4b908c 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "govoplan-certificates"
-version = "0.1.18"
+version = "0.1.19"
 description = "GovOPlaN Certificates platform module seed."
 readme = "README.md"
 requires-python = ">=3.12"
diff --git a/src/govoplan_certificates/backend/manifest.py b/src/govoplan_certificates/backend/manifest.py
index 5619a88..1602f10 100644
--- a/src/govoplan_certificates/backend/manifest.py
+++ b/src/govoplan_certificates/backend/manifest.py
@@ -6,7 +6,7 @@ from govoplan_core.core.provider_governance import declared_module_architecture
 
 MODULE_ID = "certificates"
 MODULE_NAME = "Certificates"
-MODULE_VERSION = "0.1.18"
+MODULE_VERSION = "0.1.19"
 READ_SCOPE = "certificates:workspace:read"
 WRITE_SCOPE = "certificates:workspace:write"
 ADMIN_SCOPE = "certificates:workspace:admin"
@@ -68,6 +68,13 @@ DOCUMENTATION = (
         layer="available",
         documentation_types=("admin", "user"),
         audience=("user", "operator", "module_admin", "product_owner"),
+        translations={
+            "de": {
+                "title": "Modulgrenze von Certificates",
+                "summary": "Ausstellung, Widerruf, Prüfung und Archivierung von Zertifikaten, Bescheinigungen, Teilnahmebestätigungen, Erlaubnissen und Eignungserklärungen.",
+                "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=(
@@ -78,7 +85,11 @@ DOCUMENTATION = (
             ),
         ),
         metadata={
+            "kind": "reference",
             "seed": True,
+            "consequence_classes": {
+                "seed_boundary": "Declares ownership and permissions only; no runtime workflow is available yet.",
+            },
             "domain_objects": ['certificate issuance records', 'revocation and verification state', 'attestation metadata', 'archive references', 'eligibility statements'],
             "first_slice": "Define certificate templates, issued certificate records, revocation state, and verification lookup contracts.",
         },
diff --git a/tests/test_manifest.py b/tests/test_manifest.py
index ec8d60d..160b5b3 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}, {"certificates_manager", "certificates_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)