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

# Cash Flow Forecast

> View projected cash inflows and outflows by period, generate new forecasts using configurable assumptions, and export forecast data to CSV.

Cash Flow Forecast shows projected cash positions by period (daily, weekly, or monthly), visualized in a chart and detailed in a data table, with the ability to generate new forecasts using configurable assumptions. Route: `/fa/cash-forecasts`

## Overview

The page fetches the current cash position via `useLatestCashPosition` and a list of cash forecasts filtered by the selected period via `useCashForecastList`. A period selector (daily / weekly / monthly) controls both the chart and table. Forecast assumptions (horizon, growth rates, budget weight, period adjustments) are configurable in a dialog. Users can generate a new forecast and export results to CSV.

## Who it's for

Requires permission: `fa.cash_management.view`

## Before you start

* Cash positions must have been calculated (via the Cash Management dashboard or automated process).
* You must hold the `fa.cash_management.view` permission.

## Steps

<Steps>
  <Step title="Navigate to Cash Flow Forecast">
    Go to `/fa/cash-forecasts`.
  </Step>

  <Step title="Select a period">
    Choose Daily, Weekly, or Monthly from the period selector to change the chart and table granularity.
  </Step>

  <Step title="Review the chart and table">
    The `CashFlowForecastChart` visualizes projected cash positions. The data table shows period-by-period detail.
  </Step>

  <Step title="Configure assumptions and generate a forecast (optional)">
    Click the settings icon to open the Forecast Assumptions dialog. Adjust the forecast horizon, growth rates, and budget weight, then click Generate.
  </Step>

  <Step title="Export to CSV (optional)">
    Click the download button to export the current forecast data.
  </Step>
</Steps>

## Key concepts

* **`ForecastAssumptions`** — Object containing `forecastHorizon`, `inflowGrowthRate`, `outflowGrowthRate`, `budgetWeight`, and `periodAdjustments`.
* **`useGenerateForecast`** — Hook that triggers forecast generation based on current assumptions.
* **`useCashForecastList`** — Primary data hook; accepts `organizationId` and `{ period }`.
* **`CashFlowForecastChart`** — Chart component rendering the forecast visualization.

## 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/CashFlowForecastPage.tsx
  * src/cores/fa/hooks/useCashForecasts.ts
  * src/cores/fa/hooks/useCashPositions.ts
  * src/cores/fa/components/CashFlowForecastChart.tsx
  * src/cores/fa/components/ForecastAssumptionsDialog.tsx
</Accordion>