diff --git a/AGENTS.md b/AGENTS.md index 80e5eaa..9c97f7e 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -1,5 +1,11 @@ # GovOPlaN Approvals 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 Approvals 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 the GovOPlaN Approvals platform module seed. diff --git a/src/govoplan_approvals/backend/manifest.py b/src/govoplan_approvals/backend/manifest.py index ed1524f..90d2f49 100644 --- a/src/govoplan_approvals/backend/manifest.py +++ b/src/govoplan_approvals/backend/manifest.py @@ -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.modules import DocumentationLink, DocumentationTopic, ModuleManifest, PermissionDefinition, RoleTemplate +from govoplan_core.core.provider_governance import declared_module_architecture MODULE_ID = "approvals" MODULE_NAME = "Approvals" @@ -63,8 +64,8 @@ DOCUMENTATION = ( "database models, migrations, and WebUI routes are introduced." ), layer="available", - documentation_types=("admin",), - audience=("operator", "module_admin", "product_owner"), + documentation_types=("admin", "user"), + audience=("user", "operator", "module_admin", "product_owner"), order=100, related_modules=OPTIONAL_DEPENDENCIES, links=( @@ -92,6 +93,15 @@ manifest = ModuleManifest( permissions=PERMISSIONS, role_templates=ROLE_TEMPLATES, documentation=DOCUMENTATION, + architecture=declared_module_architecture( + layer="human_work_procedure", + kind="governance", + maturity="scaffold", + documentation_ref="docs/APPROVALS_DOMAIN_BOUNDARY.md", + known_limits=("Runtime approval lifecycles and persistence are not implemented yet.",), + owned_concepts=("approval request", "approval chain", "approval decision"), + non_owned_concepts=("workflow execution", "identity", "document signature"), + ), )