docs: declare institutional architecture boundary

This commit is contained in:
2026-08-01 17:48:41 +02:00
parent 9d987c7339
commit ca32a6ee5c
3 changed files with 33 additions and 1 deletions
+16
View File
@@ -0,0 +1,16 @@
# GovOPlaN Workflow Codex Guide
## Scope
This repository owns the workflow editing and inspection experience, including BPMN-compatible native graph authoring and module-provided definition views.
## 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 Workflow internals.
- Maintain a static user/admin baseline and run `/mnt/DATA/git/govoplan/tools/checks/check-manifest-shapes.py` after behavior or manifest changes.
## Boundaries
- `govoplan-workflow-engine` owns headless definitions, versions, execution, and resumable runtime state.
- The editor must consume engine contracts without duplicating execution semantics.
+12
View File
@@ -10,6 +10,7 @@ from govoplan_core.core.modules import (
NavItem, NavItem,
ViewSurface, ViewSurface,
) )
from govoplan_core.core.provider_governance import declared_module_architecture
from govoplan_workflow_engine.backend.manifest import ( from govoplan_workflow_engine.backend.manifest import (
ADMIN_SCOPE, ADMIN_SCOPE,
DEFINITION_READ_SCOPE, DEFINITION_READ_SCOPE,
@@ -111,6 +112,17 @@ manifest = ModuleManifest(
order=76, order=76,
), ),
), ),
architecture=declared_module_architecture(
layer="human_work_procedure",
kind="editor",
maturity="vertical_slice",
documentation_ref="docs/ENGINE_EDITOR_SPLIT.md",
test_ref="tests/test_manifest.py",
known_limits=("The editor intentionally cannot execute definitions without Workflow Engine and target-tested adapters.",),
owned_concepts=("workflow editing surface", "workflow revision inspection", "workflow activation controls"),
non_owned_concepts=("workflow definition persistence", "workflow instance execution", "domain action"),
security_docs=("docs/CONCEPT.md",),
),
) )
+5 -1
View File
@@ -1076,7 +1076,11 @@ function WorkflowStandardComparisonDialog({
{error} {error}
</DismissibleAlert> </DismissibleAlert>
) : null} ) : null}
{!error && !comparison ? <LoadingFrame label="Comparing workflow revisions..." /> : null} {!error && !comparison ? (
<LoadingFrame loading label="Comparing workflow revisions...">
<div className="workflow-standard-comparison" />
</LoadingFrame>
) : null}
{comparison ? ( {comparison ? (
<div className="workflow-standard-comparison"> <div className="workflow-standard-comparison">
<div className="workflow-standard-comparison-summary"> <div className="workflow-standard-comparison-summary">