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

# Regulatory Log

> Track and manage regulatory changes that affect healthcare workflow patterns and compliance obligations.

The Regulatory Log page at `/fw/regulatory-log` provides a list view of regulatory change entries with status filtering, and a dialog for creating or editing entries.

## Overview

The Regulatory Change Log displays entries representing regulatory changes that affect healthcare workflow patterns. Each entry includes a regulation identifier, change description, effective date, optional impact assessment, and a lifecycle status. Users with the `fw.healthcare_patterns.manage` permission can create, edit, and delete entries.

The page includes an explicit PHI notice in the entry form: fields must not contain patient names, MRNs, or other PHI. This log is for regulatory metadata only.

## Who it's for

Requires `fw.healthcare_patterns.manage` permission, enforced by `RequirePermission` in `src/routes/fw.tsx`. Users without this permission cannot access the route.

The "Add Entry" button and delete action on each entry are additionally gated by `PermissionGate permission="fw.healthcare_patterns.manage"` within the component.

## Before you start

* You must have the `fw.healthcare_patterns.manage` permission.
* Do not enter PHI in any field. The form includes explicit reminders that patient names, MRNs, and other PHI must not be entered in the Description or Impact Assessment fields.

## Steps

**To view entries:**

1. Navigate to `/fw/regulatory-log`.
2. Use the status filter buttons (All, Pending, Reviewed, Applied, Dismissed) to narrow the list.
3. Click an entry row to open the edit dialog.

**To create an entry:**

1. Select "Add Entry."
2. Enter the **Regulation** identifier (e.g., a regulatory citation — do not include PHI).
3. Enter a **Description** of the change. Do not include PHI.
4. Set the **Effective Date**.
5. Optionally enter an **Impact Assessment**. Do not include PHI.
6. Set the **Status** (defaults to `pending`).
7. Select **Create**.

**To update an entry:**

1. Click the entry row to open the edit dialog.
2. Update the relevant fields.
3. Select **Update**.

**To delete an entry:**

1. Click the trash/Delete button on the entry row.
2. Deletion is immediate (no confirmation dialog visible in the component).

## Key concepts

* **Status lifecycle** — Entries move through `pending` → `reviewed` → `applied` (or `dismissed`). Status labels are defined in `REGULATORY_CHANGE_STATUS_LABELS`.
* **Regulation** — A free-text identifier for the regulatory citation. SME should confirm the expected format.
* **Effective date** — The date the regulation change takes effect.
* **Impact assessment** — Optional narrative on how the change affects existing workflows. Must not contain PHI.

## Related

<Columns cols={2}>
  <Card title="Forms & Workflow" icon="diagram-project" href="/fw/overview">
    Forms & Workflow core overview.
  </Card>

  <Card title="Governance & parity" icon="scale-balanced" href="/governance/index" />
</Columns>

<Note>
  This page documents shipped product behavior. It is not medical, legal, or
  billing advice. Verify against your organization's policies and applicable
  regulations before using it for clinical, compliance, or billing decisions.
  Protected health information (PHI) shown in the product is governed by your
  tenant's access controls and is never exposed in this documentation.
</Note>

<Accordion title="Documentation sources">
  * src/routes/fw\.tsx
  * src/cores/fw/pages/RegulatoryChangeLogPage.tsx
  * src/cores/fw/hooks/useHealthcarePatterns.ts
  * src/cores/fw/types/healthcare-patterns.ts
</Accordion>