> ## 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.

# Multi-Page Forms — Integration

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

**Feature ID:** FW-05\
**Status:** ✅ Complete (All Phases)\
**Spec:** [FW-05-multi-page-forms.md](../../../specs/fw/archive/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)

| Dependency                         | Pattern                    | Purpose                                                                                                     |
| ---------------------------------- | -------------------------- | ----------------------------------------------------------------------------------------------------------- |
| PF-01 (Organizations & Sites)      | Platform dependency        | Organization-scoped drafts and form access                                                                  |
| PF-02 (RBAC)                       | Platform dependency        | Draft access control; permission keys for form builder and drafts                                           |
| PF-08 (Platform Forms Integration) | Platform Integration Layer | Form definition, renderer, submission; page structure in `fw_forms.settings`                                |
| FW-01 (Form Builder)               | Intra-core                 | Page structure in form definition; page organizer UI                                                        |
| FW-02 (Form Submissions)           | Intra-core                 | Drafts 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.

***

## Related Docs

* [CROSS\_CORE\_INTEGRATIONS.md](./CROSS_CORE_INTEGRATIONS.md)
* [PLATFORM\_INTEGRATION\_LAYERS.md](./PLATFORM_INTEGRATION_LAYERS.md)
* [FW-05-multi-page-forms.md](../../../specs/fw/archive/FW-05-multi-page-forms.md)