# User Guide — US SLED Contact Directory

## If you just want the list
1. Open `dataset/contacts.csv` in Excel / Google Sheets / Numbers. Each row is one
   organization; the `state` column is your grouping key (sort or filter by it).
2. Prefer one state at a time? Open `dataset/by-state/TX.csv` (etc.).
3. Prefer to click around? Open `public/index.html` in any browser — pick a state
   from the dropdown or type in the search box (matches organization, city, county,
   or phone).

## What each column means
| Column | Source | Notes |
|--------|--------|-------|
| `state` / `stateName` | real | USPS code + full name (grouping key) |
| `organizationName` | real | The district / education agency ("company name") |
| `organizationType` | real | e.g. "Regular local school district" |
| `phone` | real | Main office phone, normalized to `(XXX) XXX-XXXX` |
| `streetAddress`, `city`, `zip`, `county` | real | Physical location |
| `enrollment`, `schools` | real | Size indicators (blank if not reported) |
| `leaid` | real | NCES unique agency id (stable key) |
| `source`, `sourceUrl`, `datasetYear`, `retrievedAt` | real | Provenance |
| `contactTitle`, `contactName`, `email`, `domain` | **seam** | **Empty** — not published by the source; never invented |

## Why are title / email / domain blank?
Because the authoritative public-record source for a nationwide school-district
census does not publish them. Rather than guess, those columns are left blank. To
fill them, see the sourcing plan in `proof/LIMITATIONS.md` and
`design/CAPABILITY_GAP.json` (a licensed SLED provider, per-state directories, or
domain enrichment + verification).

## Refreshing the data
Run `node src/collect.mjs` to re-pull from the live source, then `node verify.mjs`.
Pass `--year 2022` (etc.) to pull an older cycle.
