# Reporting Workflow Specification

Clearweft · Week 17 · Practical build

Use your own verified records. Blank fields are intentionally unpopulated. Label demonstrations, unavailable data and assumptions; never present them as actual customer results.

## Reporting contract
- Decision supported:
- Measures and definitions:
- Period/time zone:
- Required sources and expected refresh:
- Complete / partial / blocked conditions:
- Owner and review deadline:

## Five-layer specification
| Layer | Responsibility | Inputs | Outputs | Owner/check |
| --- | --- | --- | --- | --- |
| Logic | Definitions, exclusions, calculations | | | |
| Data | Source and derived records | | | |
| Intelligence | Optional evidence-based interpretation | | | |
| Orchestration | Collection, sequence, retries, review | | | |
| Presentation | Private scorecard and public explanation | | | |

## Source contract
| Source | Export/API route | Required fields | Stable identifiers | Refresh/cutoff | Missing/late handling |
| --- | --- | --- | --- | --- | --- |
| | | | | | |

## Reliability checks
- Run identifier and log location:
- Duplicate/rerun rule:
- Corrected-record handling:
- Missing field behaviour:
- Native total reconciliation:
- Secret configuration location (name only):
- Public/private output boundary:

## Acceptance test
| Scenario | Expected result | Observed result | Correction |
| --- | --- | --- | --- |
| Complete input set | | | |
| Missing source | | | |
| Duplicate import/rerun | | | |
| Corrected/refunded record | | | |
| Public output review | | | |

## Operating decision
- Collection effort before/after, if measured:
- New maintenance required:
- Next source justified by:
- Review owner/date:

## Completion check

A reviewer can trace each published result to its source and reproduce the calculation.

Date:

Owner:

Next review: