# Data Dictionary — DocsGenie Contract Disputes by State

## File: docsgenie_contract_disputes_by_state.csv
One row per U.S. state / territory that reports to the NCSC Court Statistics Project.

| Column | Definition | Source | Notes |
|---|---|---|---|
| state | State or territory name | — | |
| filings_2020 | Incoming contract case filings, 2020 | NCSC CSP | Blank if state did not report 2020 |
| filings_2022 | Incoming contract case filings, 2022 | NCSC CSP | Year matched to the 2022 business base |
| filings_2024 | Incoming contract case filings, 2024 | NCSC CSP | Headline cross-section |
| pct_change_2020_2024 | Percent change in filings, 2020 to 2024 | Derived | Full-coverage states only |
| cagr_2020_2024_pct | Compound annual growth rate, 2020-2024 | Derived | Full-coverage states only |
| establishments_2022 | Business establishments, 2022 | Census SUSB 2022 | Latest available vintage (~2yr lag) |
| population_2024 | Resident population, 2024 | Census Population Estimates | Lag-free |
| filings_per_1k_establishments_2022basis | 2022 filings / 2022 establishments x 1,000 | Derived | Year-matched, cleanest ratio |
| filings_per_1k_establishments_2024basis | 2024 filings / 2022 establishments x 1,000 | Derived | Current volume, denominator lag disclosed |
| filings_per_1k_population_2024 | 2024 filings / 2024 population x 1,000 | Derived | Lag-free corroborator |
| rank_by_rate_2024 | Rank on the 2024-basis per-1k-establishments rate | Derived | 1 = highest |
| full_5yr_coverage | TRUE if the state reported all 5 years (2020-2024) | NCSC CSP | Use TRUE states for trend claims |

## File: docsgenie_legal_wages_by_state.csv
State-level mean annual wages for legal occupations (BLS OEWS, May 2024). Blank = BLS-suppressed (too few employed to publish).

| Column | Definition | SOC code |
|---|---|---|
| lawyers_mean_annual_usd | Mean annual wage, Lawyers | 23-1011 |
| paralegals_mean_annual_usd | Mean annual wage, Paralegals & Legal Assistants | 23-2011 |
| arbitrators_mediators_mean_annual_usd | Mean annual wage, Arbitrators/Mediators/Conciliators | 23-1022 |