docs/data-coverage/CARRIER_STATE_MATRIX.md

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.