From aff4df9e6bc531b8ecb4ba703d52444ec466943d Mon Sep 17 00:00:00 2001 From: Albrecht Degering Date: Sat, 22 Aug 2026 07:55:18 +0200 Subject: [PATCH] docs: complete public documentation baseline --- package.json | 2 +- pyproject.toml | 2 +- src/govoplan_consultation/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 aec58fc..315dd1d 100644 --- a/package.json +++ b/package.json @@ -1,6 +1,6 @@ { "name": "@govoplan/consultation", - "version": "0.1.18", + "version": "0.1.19", "private": true, "description": "GovOPlaN Consultation platform module seed.", "type": "module", diff --git a/pyproject.toml b/pyproject.toml index 8d964a3..aff223e 100644 --- a/pyproject.toml +++ b/pyproject.toml @@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta" [project] name = "govoplan-consultation" -version = "0.1.18" +version = "0.1.19" description = "GovOPlaN Consultation platform module seed." readme = "README.md" requires-python = ">=3.12" diff --git a/src/govoplan_consultation/backend/manifest.py b/src/govoplan_consultation/backend/manifest.py index 0671569..f16a45a 100644 --- a/src/govoplan_consultation/backend/manifest.py +++ b/src/govoplan_consultation/backend/manifest.py @@ -6,7 +6,7 @@ from govoplan_core.core.provider_governance import declared_module_architecture MODULE_ID = "consultation" MODULE_NAME = "Consultation" -MODULE_VERSION = "0.1.18" +MODULE_VERSION = "0.1.19" READ_SCOPE = "consultation:workspace:read" WRITE_SCOPE = "consultation:workspace:write" ADMIN_SCOPE = "consultation: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 Consultation", + "summary": "Öffentliche Konsultationen, Anhörungen, Rückmeldungen von Interessengruppen, förmliche Stellungnahmen, Erwiderungsmatrizen und Veröffentlichung von Ergebnissen.", + "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": ['consultation processes', 'hearing events', 'stakeholder feedback', 'formal comments', 'response matrices', 'publication state'], "first_slice": "Define consultation, phase, stakeholder, comment, response, publication, and record-link concepts.", }, diff --git a/tests/test_manifest.py b/tests/test_manifest.py index 525af68..c24eba6 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}, {"consultation_manager", "consultation_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)