Files
govoplan-forms-runtime/README.md
2026-07-11 16:49:02 +02:00

1.9 KiB

GovOPlaN Forms Runtime

Repository type: module (platform).

govoplan-forms-runtime is the GovOPlaN platform module seed for runtime form submissions for validation, drafts, attachments, signatures, status tracking, and handoff to domain modules.

This repository is initialized as a discoverable module seed. It exposes a module manifest, initial permissions, role templates, documentation metadata, Gitea workflow templates, and a focused manifest test. It intentionally does not yet add HTTP routes, database models, migrations, or WebUI navigation.

Initial Ownership

  • form submissions
  • draft state
  • runtime validation results
  • attachment references
  • signature state
  • handoff status

Boundaries

This module does not own:

  • form definition authoring
  • document storage
  • domain-specific adjudication

Detailed boundary notes are in docs/FORMS_RUNTIME_DOMAIN_BOUNDARY.md.

Integrations

Expected optional integrations:

  • forms
  • files
  • approvals
  • workflow
  • portal

Development Install

From the core checkout:

cd /mnt/DATA/git/govoplan-core
./.venv/bin/python -m pip install -e ../govoplan-forms-runtime

Focused manifest verification:

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

Gitea Workflow

Issue templates are installed under .gitea/, and the shared label taxonomy is copied to docs/gitea-labels.json with the module label module/forms-runtime.

From the core checkout, labels can be synced once a local GITEA_TOKEN is available:

cd /mnt/DATA/git/govoplan-core
/mnt/DATA/git/govoplan/tools/gitea/gitea-sync-labels.py --root /mnt/DATA/git/govoplan-forms-runtime --apply