> ## Documentation Index
> Fetch the complete documentation index at: https://mirage.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# How Mirage works

> The building blocks of Mirage and how evidence flows from the field to your donors

## The evidence pipeline

Everything in Mirage follows one flow:

1. **You define what to measure.** A project declares its metrics ("Wells dug", "Attendance rate") and reporting tasks describe what evidence to collect.
2. **Reporters capture reality.** Field reporters answer your questions and attach photos, video, and audio from the reporter app.
3. **AI analyzes the evidence.** Mirage transcribes audio (including translation to English), summarizes media, and proposes metric values, each with a confidence score and a trace back to the exact answer or attachment it came from.
4. **Stewards verify.** Nothing counts until someone on your team approves it. Rejected values are excluded; approved values roll up into your project metrics.
5. **Donors see verified impact.** Donor reports assemble approved data, consented photos, and an AI-written narrative into a public page.

This is why Mirage describes itself as *AI assisted and steward approved*: the AI proposes, your team decides.

## Building blocks

| Concept | What it is |
| - | - |
| **Organization** | Your nonprofit's home in Mirage. Holds your team, projects, billing, and verification status. |
| **Project** | An impact initiative: a well-drilling program, a school, a food distribution effort. Projects own metrics, reporting tasks, and donor reports. |
| **Metric** | A number you want to prove: a total, an average, a percentage. Defined per project with flexible aggregation and display formatting. |
| **Reporting task** | A work unit for field reporters: instructions, questions, and required evidence types (photo/video/audio), with an optional bounty and response capacity. |
| **Field report** | One reporter's submission against a task: their answers plus attached media. |
| **Contribution** | An AI-extracted metric value from a report, with a confidence score. Stewards approve or reject each one; approved contributions feed the project's aggregated metrics. |
| **Donor report** | A generated, public, shareable impact page: narrative, metrics, photo gallery, and call to action. |
| **Revisit** | A scheduled follow-up verification: proof that impact was sustained months after the original report. |

## Roles

| Role | Who it's for | What they can do |
| - | - | - |
| **Steward** | Nonprofit staff / admins | Create and manage projects, define metrics, create reporting tasks, invite team members and reporters, review and approve contributions, generate donor reports, manage billing and verification. |
| **Reporter** | Field workers | See their organizations' open tasks, capture evidence, submit reports, and track the status of their submissions. |

A steward works in the **Steward Dashboard** ([app.mirage.partners](https://app.mirage.partners)); a reporter works in the **Reporter App** ([report.mirage.partners](https://report.mirage.partners)). The same underlying account can hold either role, and a person can belong to multiple organizations.

## Consent and privacy, built in

When reporters capture photos or video, they record whether the people pictured gave **face permission** and whether the media is **internal only**. Donor-facing pages respect those flags automatically: media without face permission or marked internal-only never appears on a public donor report. See [Sharing donor reports](https://mirage.mintlify.site/donor-reports/sharing-donor-reports.md#privacy-and-consent) for details.

## What "verified" means

* Every metric contribution links back to its **source**: the specific question answer or media attachment it was extracted from.
* Media is analyzed by Mirage's verification engine: audio is transcribed and language-detected, video and photos are summarized by AI.
* A steward reviewed and approved every value that appears in a donor report.
* Organizations can additionally complete [organization verification](https://mirage.mintlify.site/organization/verification.md) to display a verified badge to donors.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.