Mirrored from /mnt/DATA/git/govoplan-forms/README.md.
Origin: repository.
Active tasks and changing state belong in Gitea issues; this wiki page is durable project context.
GovOPlaN Forms
Repository type: module (domain).
govoplan-forms owns reusable, immutable form definitions, validation rules,
and form package fragments. Submission runtime behavior remains in
govoplan-forms-runtime.
The module persists exact tenant-bound revisions, exposes bounded catalogue,
history, and write APIs, and provides forms.definitions for consumers. A
published revision can be used by Forms Runtime without importing Forms tables;
existing submissions keep their exact revision when a new schema is published.
The /forms designer uses shared application controls to create, revise,
publish, retire, search, and inspect definitions. It edits field order, types,
choices, validation constraints, draft behavior, attachment and signature
requirements, policy references, and permitted handoff kinds. Saving always
creates an exact immutable revision; it never mutates a published schema in
place.
Definition writes use optimistic concurrency. Replaying the same object and
revision is safe only when the payload is identical. Published definitions may
be retired but not silently returned to draft.
Focused verification:
See docs/FORMS_BOUNDARY.md for the boundary decision.