docs: complete public documentation baseline

package.json

@@ -1,6 +1,6 @@
 {
   "name": "@govoplan/permits",
-  "version": "0.1.18",
+  "version": "0.1.19",
   "private": true,
   "description": "GovOPlaN Permits platform module seed.",
   "type": "module",

pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "govoplan-permits"
-version = "0.1.18"
+version = "0.1.19"
 description = "GovOPlaN Permits platform module seed."
 readme = "README.md"
 requires-python = ">=3.12"

src/govoplan_permits/backend/manifest.py

@@ -6,7 +6,7 @@ from govoplan_core.core.provider_governance import declared_module_architecture
 
 MODULE_ID = "permits"
 MODULE_NAME = "Permits"
-MODULE_VERSION = "0.1.18"
+MODULE_VERSION = "0.1.19"
 READ_SCOPE = "permits:workspace:read"
 WRITE_SCOPE = "permits:workspace:write"
 ADMIN_SCOPE = "permits:workspace:admin"
@@ -69,6 +69,13 @@ DOCUMENTATION = (
         layer="available",
         documentation_types=("admin", "user"),
         audience=("user", "operator", "module_admin", "product_owner"),
+        translations={
+            "de": {
+                "title": "Modulgrenze von Permits",
+                "summary": "Erlaubnis- und Lizenzverfahren für Anträge, Verlängerungen, Auflagen, Prüfungen, Widersprüche, Widerrufe und Compliance-Nachweise.",
+                "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=(
@@ -79,7 +86,11 @@ DOCUMENTATION = (
             ),
         ),
         metadata={
+            "kind": "reference",
             "seed": True,
+            "consequence_classes": {
+                "seed_boundary": "Declares ownership and permissions only; no runtime workflow is available yet.",
+            },
             "domain_objects": ['permit application lifecycle', 'license and permit records', 'conditions', 'renewals', 'objections', 'revocation state', 'inspection handoffs'],
             "first_slice": "Define permit type, application, decision, condition, renewal, objection, revocation, and inspection link records.",
         },

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}, {"permits_manager", "permits_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)