> ## Documentation Index
> Fetch the complete documentation index at: https://guide.bajeti-ufahamu.org/llms.txt
> Use this file to discover all available pages before exploring further.

# Webapp: Flow Management

> Creating, tracking, and managing budget-participation flows.

## The Flows page

The **Flows** page lists every flow you have access to, grouped into **Active**, **Completed**, and **Archived** sections.

<Frame caption="The Flows page, grouped by status">
  <img src="https://mintcdn.com/bajeti-ufahamu/lKb_jxRH0kWfficP/images/webapp-flows/flows-page.png?fit=max&auto=format&n=lKb_jxRH0kWfficP&q=85&s=1260fe7509a6b701dd51d5758f39db7a" alt="Flows page" width="1084" height="1005" data-path="images/webapp-flows/flows-page.png" />
</Frame>

Use the search bar to find a flow by name or type, or narrow the list with the region filter and the recency sort. The **My flows** / **All flows** toggle switches between flows you're personally involved in (the default) and every flow available on Bajeti Ufahamu

<Frame caption="Search, filter, sort, and the My flows / All flows toggle">
  <img src="https://mintcdn.com/bajeti-ufahamu/lKb_jxRH0kWfficP/images/webapp-flows/flows-filters.png?fit=max&auto=format&n=lKb_jxRH0kWfficP&q=85&s=27a7913702b787b0d93caf02600e4cde" alt="Flows page search and filters" width="1047" height="534" data-path="images/webapp-flows/flows-filters.png" />
</Frame>

## Create a flow

Role access: Facilitator and above

<Steps>
  <Step title="Click Create Flow">
    From the Flows page, click **Create Flow**.

    <Frame>
      <img src="https://mintcdn.com/bajeti-ufahamu/lKb_jxRH0kWfficP/images/webapp-flows/create-flow-click.png?fit=max&auto=format&n=lKb_jxRH0kWfficP&q=85&s=80828ee320c6f865017736e915fa09fe" alt="Create Flow button" width="1065" height="410" data-path="images/webapp-flows/create-flow-click.png" />
    </Frame>
  </Step>

  <Step title="Fill in the flow details">
    * **Flow Name** (required) this is the name that is used to identify the flow in the app and on whatsapp. It should clearly indicate what document the flow represents as well as the year.
    * **Flow Type** (required): the budget document whose lifecycle this flow is tracking. Options are: BPS, ADP, CFSP, County Budget Review, Sector Working Report, or Custom
    * **Status**: controls which section of the Flows page the flow shows up in. Default is Active.
    * **Location Type**: the administrative level the flow belongs to: County, Region, or Country.
    * **Location**: the specific county/region/country the flow is for; options are limited to your own assigned location and its scope (a Facilitator only sees their county; a Coordinator sees their region and its counties)
    * **Description** (optional): A description of the flow that is being created.

    <Frame caption="The Create Flow form">
      <img src="https://mintcdn.com/bajeti-ufahamu/lKb_jxRH0kWfficP/images/webapp-flows/create-flow-form.png?fit=max&auto=format&n=lKb_jxRH0kWfficP&q=85&s=fa382771b2fa8214f1c95fcec68d7966" alt="Create Flow form" width="618" height="548" data-path="images/webapp-flows/create-flow-form.png" />
    </Frame>
  </Step>

  <Step title="Submit">
    Click **Create Flow** to save it. It appears immediately in the Flows list.
  </Step>
</Steps>

<Note>
  Coordinator, facilitator and champions are automatically assigned to flows
  based on the location.
</Note>

## Edit a flow

Role access: Facilitator and above, within their location scope

From the Flows page, open the **⋮** menu on a flow card and choose **Edit Flow**. This opens the same the edit form. Update any field and click **Update Flow**.

## Archive a flow

Role access: Facilitator and above

To archive a flow, **edit it** and set **Status** to **Archived**, then save. The flow moves to the Archived section of the Flows page.

## The flow detail page

Clicking a flow opens its workspace, with five tabs: **Overview**, **Analytics**, **Documents**, **Feedback**, **Connectors**.

<Frame caption="Flow detail tabs">
  <img src="https://mintcdn.com/bajeti-ufahamu/lKb_jxRH0kWfficP/images/webapp-flows/flow-tabs.png?fit=max&auto=format&n=lKb_jxRH0kWfficP&q=85&s=3d8eefda010fa3e4b6784934be927cef" alt="Flow detail page tabs" width="1087" height="1010" data-path="images/webapp-flows/flow-tabs.png" />
</Frame>

### Overview tab

<Frame caption="The Overview tab">
  <img src="https://mintcdn.com/bajeti-ufahamu/lKb_jxRH0kWfficP/images/webapp-flows/overview-tab.png?fit=max&auto=format&n=lKb_jxRH0kWfficP&q=85&s=cc49699f1450c79d3add28f0ced4d417" alt="Overview tab" width="1415" height="844" data-path="images/webapp-flows/overview-tab.png" />
</Frame>

Shows:

* **Location**, **Current Step**, **Last Updated**, and **Related Users** (coordinator and facilitators assigned to the flow's location)
* **Description**
* The **current stage card**: the active stage's instructions and completion criteria (see [Stage instructions](#stage-instructions) below), with a button to advance it
* **Stage Tracking**: every stage in the flow's lifecycle, with its status

#### Stage instructions

Every flow moves through the same set of stages. Some complete automatically; others need someone to confirm the work is done.

<Frame caption="Step Tracking, showing every stage in the flow's lifecycle">
  <img src="https://mintcdn.com/bajeti-ufahamu/lKb_jxRH0kWfficP/images/webapp-flows/stage-list.png?fit=max&auto=format&n=lKb_jxRH0kWfficP&q=85&s=d35b62f1e1619174374474a0b4b309a3" alt="All steps in Stage Tracking" width="1418" height="1001" data-path="images/webapp-flows/stage-list.png" />
</Frame>

| Stage                      | Auto-managed? | What it takes                                                           |
| -------------------------- | ------------- | ----------------------------------------------------------------------- |
| Flow creation              | Yes           | Completes automatically when the flow is created                        |
| Flow validation            | No            | Review the flow's name, description, location, type, and assigned users |
| Budget document upload     | Yes           | Completes automatically once the budget document is uploaded            |
| Infopack creation          | Yes           | Completes automatically once the infopack is uploaded                   |
| Infopack review/validation | No            | Review the infopack for accuracy and completeness                       |
| Feedback collection        | No            | Confirm enough feedback has been gathered from stakeholders             |
| Memo drafting              | Yes           | Completes automatically once the memo is uploaded                       |
| Memo validation            | No            | Review the memo for accuracy and compliance                             |
| Memo stamp                 | No            | Confirm the memo has been officially stamped                            |
| Flow closure               | No            | Final review that confirm all stages and documents are complete         |

<Steps>
  <Step title="Open a step">
    Click any step in Step Tracking to see its full instructions, completion criteria, and history (who started/completed it and when).

    <Frame>
      <img src="https://mintcdn.com/bajeti-ufahamu/lKb_jxRH0kWfficP/images/webapp-flows/step-details.png?fit=max&auto=format&n=lKb_jxRH0kWfficP&q=85&s=7f94b8cb249948140ba29b6756d0a8cb" alt="Step details dialog" width="406" height="659" data-path="images/webapp-flows/step-details.png" />
    </Frame>
  </Step>

  <Step title="Update its status">
    If you have edit access and the step isn't auto-managed, click **Start Step** or **Mark Complete** (or **Mark Incomplete** to reopen a completed step).
  </Step>
</Steps>

<Note>
  Some steps are auto-managed and can't be updated manually. They complete
  automatically based on another action (e.g. "Budget document upload" completes
  itself once you upload the budget document).
</Note>

### Documents tab

See [Document Management](/knowledge-base/webapp-documents).

### Analytics tab

See [Analytics](/knowledge-base/webapp-analytics).

### Feedback tab

See [Feedback](/knowledge-base/webapp-feedback) for reviewing and validating participant feedback collected across WhatsApp, KoboToolbox, Google Sheets, and Feedback PDFs.

### Connectors tab

See [Connectors](/knowledge-base/webapp-connectors) for bringing in feedback automatically from KoboToolbox and Google Sheets.
