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

# Contract Progress

> Report showing lifetime recognition progress for each revenue contract, aggregated across all linked revenue schedules.

Contract Progress is a read-only report displaying lifetime revenue recognition progress per revenue contract, derived from associated revenue schedules. Route: `/fa/revenue-reports/contract-progress`

## Overview

The page fetches contract progress rows via `useContractProgressReport(orgId)`. Each row represents a revenue contract (`fa_revenue_contracts`) with its aggregated recognition amounts from linked `fa_revenue_schedules`. A progress bar visualizes recognition completion. Cancelled records may be flagged with a `Badge`.

Page header description from code: "Lifetime recognition progress per revenue contract, aggregated across all linked schedules."

## Who it's for

Requires permission: `fa.revenue_contracts.view`

## Before you start

* Revenue contracts must exist and have linked revenue schedules with recognition entries.
* You must hold the `fa.revenue_contracts.view` permission.

## Steps

<Steps>
  <Step title="Navigate to Contract Progress">
    Go to `/fa/revenue-reports/contract-progress`.
  </Step>

  <Step title="Review the report">
    Each row shows a revenue contract with its recognition progress. The progress bar shows completion percentage.
  </Step>

  <Step title="Identify contracts needing attention">
    Look for contracts with low progress or status badges indicating issues.
  </Step>
</Steps>

## Key concepts

* **`useContractProgressReport`** — Primary data hook; returns rows derived from `fa_revenue_contracts` joined with `fa_revenue_schedules`.
* **`total_recognized`** — Aggregated recognized amount from linked revenue schedules.

## Related

<Columns cols={2}>
  <Card title="Finance & Revenue" icon="building-columns" href="/fa/overview">
    Finance & Revenue 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/fa.tsx
  * src/cores/fa/pages/ContractProgressReportPage.tsx
  * src/cores/fa/hooks/useRevenueReports.ts
</Accordion>
