# Carrier-State Coverage Matrix

This matrix is the working inventory for source completeness across carriers and states.

Primary data file:
- `/Users/petedunn/Library/CloudStorage/Dropbox/Mac/Downloads/Masters telecom/POTS Shutdown Notice app/backend/app/pots_shutdown_tracker/data/source_coverage_matrix.json`

How to use it:
- `connector_status` tracks whether discovery is wired for the official source family.
- `parse_status` tracks whether the source family is parsed cleanly into notice records.
- `geography_status` tracks the strongest geography we can derive from that family.
- `search_visibility` tracks whether the source family is represented in area coverage and area-risk workflows.

Admin report:
- `GET /api/pots-shutdown/admin/source-coverage-report`

The report combines the planned matrix with live corpus metrics:
- live raw document counts
- live notices by carrier and state
- analog-relevant versus analog-possible notice counts
- active notice counts
- unique CLLI counts
- unique wire-center counts
- notice-location row counts
- impacted-address row counts
- structured-state versus parsed-state-fallback usage

This is the baseline artifact for closing source gaps carrier by carrier before Neon and Hugging Face rollout.