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

# Proof of Work: Photo Evidence

> See how CleanScan captures photo proof, notes, and timestamps when issues are resolved, creating a defensible record for contractors and facilities.

When a contractor says "we cleaned that", the facility has no way to verify it without CleanScan. When a resolver closes an issue in CleanScan, they can attach a photo and a written note before marking it done. That creates a timestamped record — visible to both the facility manager and the contractor — that replaces "I think we got to that" with a photo, a name, and a time.

## What proof of work means

Proof of work is the record attached to an issue when it's resolved. It can include a photo of the resolved state, a written note explaining what was done, or both. It's timestamped and tied to the specific resolver who submitted it.

The facility manager sees this proof in the issue timeline and in the proof gallery. The contractor's dashboard shows the same photos, so there's no version of events — just a shared record.

<Note>
  Proof of work is separate from cleaning documentation. Proof of work is reactive — it's attached to an issue that was reported. Cleaning documentation is proactive — a porter scans a tag, takes a photo of a clean space, and submits it independently of any reported issue. Both appear in the facility's record.
</Note>

## Resolution policies

How much proof is required when an issue is closed depends on the resolution policy configured for that zone, category, or service relationship. There are four options:

<AccordionGroup>
  <Accordion title="tap_to_resolve">
    The resolver marks the issue done with no additional input required. No photo, no note. Use this for low-stakes internal tasks where documentation isn't needed.
  </Accordion>

  <Accordion title="photo_required">
    The resolver must upload at least one photo before the issue can be closed. When they tap "Resolve", the camera opens automatically. The issue cannot be marked resolved until a photo is submitted.

    This is the most common policy for contractor-resolved issues, giving facilities photo evidence for every closure.
  </Accordion>

  <Accordion title="description_required">
    The resolver must provide a written note before closing. Use this for maintenance issues where explaining what was done is more useful than a photo — a note about what was adjusted, replaced, or escalated.
  </Accordion>

  <Accordion title="photo_and_description">
    Both a photo and a written note are required. Use this for critical or high-stakes resolutions where you want a complete record of what was done and what the space looked like when the work was finished.
  </Accordion>
</AccordionGroup>

## Where policies are configured

Resolution policies can be set at three levels. The most specific policy wins.

| Level                | Where to configure                                          | Example                                                       |
| -------------------- | ----------------------------------------------------------- | ------------------------------------------------------------- |
| Service relationship | Contractor dashboard or facility's **Contractors** settings | "Everything ABC Cleaning resolves requires a photo"           |
| Category             | **Settings → Issue categories**                             | "All Safety Hazard resolutions require photo and description" |
| Zone                 | Zone settings in the **Zones** view                         | "All issues in the Locker Room require photo proof"           |

<Tip>
  Start with a service relationship-level policy to set a consistent baseline for your contractor, then add category-level policies for anything that needs stricter or looser requirements.
</Tip>

## Cleaning documentation

Cleaning documentation is the proactive side of proof of work. It doesn't require a reported issue — a porter scans a tag, takes one or more photos of the cleaned space, and submits. The target is under 5 seconds from scan to submission.

This is how contractors document routine work: each porter moves through their zones, scans the tag, takes an after photo, and moves on. By the end of a shift, there's a timestamped photo record for every zone they visited — even if no one reported a problem in any of them.

<Steps>
  <Step title="Porter scans the zone tag">
    The porter scans the QR or NFC tag at the zone. The mobile app opens the zone context.
  </Step>

  <Step title="Tap 'Document cleaning'">
    The default action in the mobile app. The camera opens.
  </Step>

  <Step title="Take a photo of the cleaned space">
    One tap to capture the after state. The porter can add a note if needed.
  </Step>

  <Step title="Submit">
    The cleaning record is saved with a timestamp, the porter's name, and the zone. The porter moves to the next zone.
  </Step>
</Steps>

## Proof gallery

Facility managers can browse all resolution photos and cleaning documentation photos across all contractors in one gallery. The gallery is filterable by date, zone, contractor, and activity type.

This is the record that matters when a client challenges whether work was done. Instead of searching through chat threads or asking your supervisor to remember, you open the gallery and filter by zone and date.

<Warning>
  Resolution photos are stored permanently and cannot be deleted. This is intentional — the record needs to be defensible.
</Warning>

<CardGroup cols={2}>
  <Card title="Service relationships" icon="handshake" href="/concepts/service-relationships">
    Learn how resolution policies are set per contractor relationship.
  </Card>

  <Card title="Issues and submissions" icon="circle-dot" href="/concepts/issues-and-submissions">
    Understand the issue lifecycle that proof of work closes out.
  </Card>

  <Card title="Cleaning documentation (contractors)" icon="broom" href="/contractors/cleaning-documentation">
    Step-by-step guide to logging proactive cleaning records from the mobile app.
  </Card>

  <Card title="Zones and tags" icon="tag" href="/concepts/zones-and-tags">
    See how zone tags trigger the cleaning documentation and resolution flows.
  </Card>
</CardGroup>
