docs: declare institutional architecture boundary

This commit is contained in:
2026-08-01 17:48:25 +02:00
parent 45bffd3598
commit bd63d2a62a
2 changed files with 18 additions and 2 deletions
+6
View File
@@ -1,5 +1,11 @@
# GovOPlaN Consultation Codex Guide # GovOPlaN Consultation Codex Guide
## Documentation Contract
- Treat documentation as part of every behavior change. Update this module's manifest-driven `DocumentationTopic` contributions for affected user and administrator behavior.
- Keep feature content here; `govoplan-docs` projects it without importing Consultation internals.
- Maintain a static user/admin baseline and run `/mnt/DATA/git/govoplan/tools/checks/check-manifest-shapes.py` after behavior or manifest changes.
## Scope ## Scope
This repository owns the GovOPlaN Consultation platform module seed. This repository owns the GovOPlaN Consultation platform module seed.
+12 -2
View File
@@ -2,6 +2,7 @@ from __future__ import annotations
from govoplan_core.core.access import CAPABILITY_AUTH_PERMISSION_EVALUATOR, CAPABILITY_AUTH_PRINCIPAL_RESOLVER from govoplan_core.core.access import CAPABILITY_AUTH_PERMISSION_EVALUATOR, CAPABILITY_AUTH_PRINCIPAL_RESOLVER
from govoplan_core.core.modules import DocumentationLink, DocumentationTopic, ModuleManifest, PermissionDefinition, RoleTemplate from govoplan_core.core.modules import DocumentationLink, DocumentationTopic, ModuleManifest, PermissionDefinition, RoleTemplate
from govoplan_core.core.provider_governance import declared_module_architecture
MODULE_ID = "consultation" MODULE_ID = "consultation"
MODULE_NAME = "Consultation" MODULE_NAME = "Consultation"
@@ -65,8 +66,8 @@ DOCUMENTATION = (
"database models, migrations, and WebUI routes are introduced." "database models, migrations, and WebUI routes are introduced."
), ),
layer="available", layer="available",
documentation_types=("admin",), documentation_types=("admin", "user"),
audience=("operator", "module_admin", "product_owner"), audience=("user", "operator", "module_admin", "product_owner"),
order=100, order=100,
related_modules=OPTIONAL_DEPENDENCIES, related_modules=OPTIONAL_DEPENDENCIES,
links=( links=(
@@ -94,6 +95,15 @@ manifest = ModuleManifest(
permissions=PERMISSIONS, permissions=PERMISSIONS,
role_templates=ROLE_TEMPLATES, role_templates=ROLE_TEMPLATES,
documentation=DOCUMENTATION, documentation=DOCUMENTATION,
architecture=declared_module_architecture(
layer="communication_participation",
kind="domain",
maturity="scaffold",
documentation_ref="docs/CONSULTATION_DOMAIN_BOUNDARY.md",
known_limits=("Consultation publication, submission, and evaluation lifecycles are not implemented yet.",),
owned_concepts=("consultation", "submission", "consultation phase"),
non_owned_concepts=("poll response", "formal decision", "campaign delivery"),
),
) )