docs: declare institutional architecture boundary

This commit is contained in:
2026-08-01 17:48:26 +02:00
parent cef2ba9482
commit e1c092ece7
2 changed files with 20 additions and 0 deletions
+6
View File
@@ -1,5 +1,11 @@
# GovOPlaN Dataflow 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 Dataflow 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
This repository owns canonical pipeline definitions, immutable revisions,
+14
View File
@@ -29,6 +29,7 @@ from govoplan_core.core.modules import (
PermissionDefinition,
RoleTemplate,
)
from govoplan_core.core.provider_governance import declared_module_architecture
from govoplan_core.core.datasources import (
CAPABILITY_DATASOURCE_CATALOGUE,
CAPABILITY_DATASOURCE_LIFECYCLE,
@@ -425,6 +426,19 @@ manifest = ModuleManifest(
),
),
documentation=DOCUMENTATION,
architecture=declared_module_architecture(
layer="data_reporting_integration",
kind="runtime",
maturity="vertical_slice",
documentation_ref="README.md",
test_ref="tests/test_golden_flows.py",
known_limits=("Execution adapters and operator recovery evidence do not yet cover every declared node family.",),
owned_concepts=("dataflow definition", "dataflow revision", "dataflow run", "transformation graph"),
non_owned_concepts=("datasource binding", "connector transport", "report presentation", "workflow task"),
recovery_docs=("README.md",),
security_docs=("README.md",),
operations_docs=("README.md",),
),
)