GovOPlaN Forms Runtime 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 Forms Runtime 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 Forms Runtime platform module seed.

Runtime form submissions for validation, drafts, attachments, signatures, status tracking, and handoff to domain modules.

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