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.

This repository owns the GovOPlaN Approvals platform module seed.

Generic approval and sign-off chains with delegation, substitution, four-eyes principle, escalation, and signatures.

Depend on kernel contracts from govoplan-core and access contracts from govoplan-access.
Keep domain behavior in this module; expose integration through manifests, capabilities, API routes, events, typed DTOs, and documentation topics.
Do not import internals from sibling feature modules. Use optional dependencies and capabilities for cross-module behavior.
Keep the seed non-invasive until runtime routes, persistence, and WebUI flows are intentionally designed.

Use Gitea issues as the canonical backlog and state log. The shared workflow is installed under .gitea/, with labels in docs/gitea-labels.json.

Focused verification:

PYTHONPATH=src:/mnt/DATA/git/govoplan-core/src /mnt/DATA/git/govoplan-core/.venv/bin/python -m unittest discover -s tests