docs: declare institutional architecture boundary

This commit is contained in:
2026-08-01 17:48:25 +02:00
parent c49f79ad76
commit 381cb77fc7
2 changed files with 18 additions and 2 deletions
+6
View File
@@ -1,5 +1,11 @@
# GovOPlaN Contracts Codex Guide # GovOPlaN Contracts 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 Contracts 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 Contracts platform module seed. This repository owns the GovOPlaN Contracts 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 = "contracts" MODULE_ID = "contracts"
MODULE_NAME = "Contracts" MODULE_NAME = "Contracts"
@@ -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="domain_capability",
kind="domain",
maturity="scaffold",
documentation_ref="docs/CONTRACTS_DOMAIN_BOUNDARY.md",
known_limits=("Contract persistence, obligations, amendments, and expiry handling are not implemented yet.",),
owned_concepts=("contract", "contract version", "contract obligation"),
non_owned_concepts=("procurement procedure", "file content", "payment"),
),
) )