# NFL Provider Sample Collection Packet

Offline handoff for collecting sanitized provider schema samples. This packet does not approve providers, require credentials, or enable live mode.

## Summary

- Requests: 7
- Blocked until provider approval: 0
- Pending samples: 0
- Missing samples: 0
- Invalid samples: 0
- Invalid JSON files: 0
- Unsupported sample shapes: 0
- Non-object sample rows: 0
- Missing required rows: 0
- Bad timestamp rows: 0
- Redaction findings: 0
- Next review action: review provider sample cross-family consistency

## Collection Checklist

| Source | Decision | Sample file | Required fields | Next action | Ready |
| --- | --- | --- | ---: | --- | --- |
| schedule | approved_pending_schema | schedule_sample.json | 7 | ready for adapter schema review | True |
| odds | approved_pending_schema | odds_sample.json | 7 | ready for adapter schema review | True |
| usage | approved_pending_schema | usage_sample.json | 5 | ready for adapter schema review | True |
| injuries | approved_pending_schema | injuries_sample.json | 3 | ready for adapter schema review | True |
| team_context | approved_pending_schema | team_context_sample.json | 5 | ready for adapter schema review | True |
| matchup | approved_pending_schema | matchup_sample.json | 2 | ready for adapter schema review | True |
| weather | approved_pending_schema | weather_sample.json | 5 | ready for adapter schema review | True |

## Redaction Rules

- remove API keys, account ids, request signatures, and auth headers
- replace real player names only if licensing or provider terms require it
- preserve field names, nesting, types, timestamps, and representative nulls
- include one normal record and one edge-case record when possible
- do not include sportsbook account, user, stake, or wager history data

## Validation Diagnostics

- Invalid JSON: replace the sample file with parseable sanitized JSON.
- Unsupported shape: use an object, an array of objects, or an object with `records`/`data` rows.
- Non-object rows: every sample row must be a JSON object with source-contract fields.
- Missing required rows: fill the required contract fields or keep the sample out of adapter review.
- Bad timestamp rows: use ISO-8601 timestamps with timezone offsets where available.

## Review Rules

- Keep fixture mode runnable without secrets.
- Do not add live-provider credentials to sample files.
- Add only sanitized JSON samples after provider approval.
- Rerun the quality gate after adding or changing samples.