Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.encoreos.io/llms.txt

Use this file to discover all available pages before exploring further.

Feature ID: FW-05
Status: ✅ Complete (All Phases)
Spec: FW-05-multi-page-forms.md
Last Updated: 2026-03-17

Overview

FW-05 adds multi-page form support (page structure, progress tracking, save draft, conditional pages) to the Forms & Workflow core. It consumes Platform Foundation and existing FW form/submission capabilities; it does not publish new event or API contracts.

Integration Points (from Spec)

DependencyPatternPurpose
PF-01 (Organizations & Sites)Platform dependencyOrganization-scoped drafts and form access
PF-02 (RBAC)Platform dependencyDraft access control; permission keys for form builder and drafts
PF-08 (Platform Forms Integration)Platform Integration LayerForm definition, renderer, submission; page structure in fw_forms.settings
FW-01 (Form Builder)Intra-corePage structure in form definition; page organizer UI
FW-02 (Form Submissions)Intra-coreDrafts stored as submissions with status = 'draft'; submission_data holds current page and field values

Platform Integration Layer Usage

  • PF-08 (Forms): @/platform/forms — form definition (with settings.pages), form renderer (multi-page UI), submission/draft save. No new contracts; extends existing form schema and submission payload.

Consumer Core Dependencies (Downstream)

  • RH (Recovery Housing): Multi-page intake forms
  • HR (Workforce): Multi-page onboarding forms
  • GR (Governance): Multi-page compliance forms

Security and Tenant Isolation

  • Drafts and form definitions scoped by organization_id via existing RLS on fw_forms and fw_form_submissions.
  • UPDATE policies on fw_form_submissions must include WITH CHECK so organization_id (and tenant context) cannot be changed.
  • Draft access: user’s own drafts via submitted_by = auth.uid(); org admin read-only for org drafts.