govoplan-forms/docs/FORMS_BOUNDARY.md

Forms Module Boundary

govoplan-forms owns reusable form definitions and validation metadata. Runtime submissions and workflow handoff are separate behavior.

The core boundary decision register is in /mnt/DATA/git/govoplan-core/docs/MODULE_ARCHITECTURE.md.

Ownership

Forms owns:

• form definitions, field schemas, sections, validation rules, and visibility rules
• localization, accessibility metadata, versioning, draft/published lifecycle, and admin editing
• form import/export and configuration-package fragments
• schema contracts that let portal, workflow, cases, and reporting understand a form without importing form internals

govoplan-forms-runtime owns, when implemented:

• public/internal submission sessions, drafts, receipts, submitted values, validation evidence, attachment references, and submission status
• submission handoff events to workflow, cases, tasks, mail, reporting, files, DMS, or portal

Boundaries

Forms does not own:

• public portal identity and anonymous/authenticated public entry points
• file storage and file permissions for uploaded attachments
• cases, workflow transitions, tasks, or assignment state
• DMS document lifecycle and generated record storage
• reporting aggregation or dataflow transformation

Submission Status Model

Candidate runtime statuses:

• draft
• submitted
• validated
• needs_review
• accepted
• rejected
• handed_off
• archived

The definition module can declare valid transitions and required evidence, but runtime state belongs to the runtime module.

Accessibility And Validation Requirements

Form definitions should carry:

• labels, descriptions, required markers, and help text
• machine-readable validation rules
• field grouping and ordering
• keyboard and screen-reader metadata where needed
• localization keys and fallback text
• data classification for privacy/retention decisions

Candidate Capabilities

• forms.catalog
• forms.schema
• forms.validation
• forms.packageFragments
• forms.runtime when runtime is installed

First Implementation Slice

1. Define manifest metadata, permissions, and capability names.
2. Add form definition/version DTOs.
3. Add validation metadata for one reusable form schema.
4. Add package fragment import/export format.
5. Add tests that portal/workflow/reporting can detect form capabilities without importing form internals.