# GovOPlaN Workflow Engine

<!-- govoplan-repository-type:start -->
**Repository type:** module (platform).
<!-- govoplan-repository-type:end -->

Headless workflow definition and execution services for GovOPlaN modules.

Workflow Engine owns the canonical BPMN/native graph model, immutable
definition revisions, runtime instances and evidence, migrations, validation,
execution adapters, dispatch, retries, and recovery. It intentionally provides
no primary navigation or visual editor. Modules can depend on runtime module ID
`workflow_engine` and the versioned `workflow.*` interfaces without installing
the optional `govoplan-workflow` editor.

The extraction preserves the existing `workflow_*` tables, Alembic revision
IDs, `/api/v1/workflow` routes, `workflow:*` permissions, instance IDs, and
audit references. See [the engine/editor split](docs/ENGINE_EDITOR_SPLIT.md)
for the ownership and compatibility policy.
See [the module concept](docs/CONCEPT.md) and
[BPMN interoperability contract](docs/BPMN_INTEROPERABILITY.md) for runtime
semantics and adapter boundaries.

## Checks

```bash
/mnt/DATA/git/govoplan/.venv/bin/python -m unittest discover -s tests
```