Data Dictionary

Fields Behind The Ledger

Each card now exposes a small audit record. These fields prepare the site for revision logs, CSV and JSON exports, source challenges, and data-license products.

claimId

Values
asl:<slug> unless an explicit card ID is set
Use
Stable identifier for score revisions, source changes, exports, and correction requests.

evidenceQuality

Values
primary/court record; official/primary data; court record; official data; academic/data research; watchdog/index; press supported; advocacy/secondary; mixed
Use
Reader-facing summary of the strongest source class attached to the card.

factualMaturity

Values
documented; developing; contested; early
Use
Separates whether the underlying event is well established from whether the score is final.

legalPosture

Values
court-recorded; active or recently litigated; needs docket mapping; not primarily legal
Use
Shows whether a claim has docket support, needs legal mapping, or is not mainly a legal claim.

scoringMaturity

Values
score-ready; scored with caveats; seed score
Use
Flags whether the current score is ready for ranking use or still needs better data.

jurisdictionLevel

Values
federal/national; state/local; mixed; nonstate/private
Use
Keeps federal, state, municipal, and private-actor claims from being collapsed into one bucket.

sourceProfile

Values
Count by registered source type
Use
Shows source mix, such as court records, official data, watchdog reports, news, or advocacy sources.

sourceRoleProfile

Values
Count by source role: primary proof, denominator, analytical context, discovery, salience, counterargument
Use
Shows how attached sources are used. A tracker can discover a case; a docket or opinion proves legal posture.

Rules For Use

  1. Source types summarize support quality; they do not prove that a score is correct.
  2. A legal tracker can find a case, but court records are the scoring source.
  3. A public-data series can move a score only after the snapshot, units, denominator, geography, and retrieval date are saved.
  4. Press and NGO sources can start a card. They should not be the final record when a primary document or official dataset exists.
  5. A source role says why a URL is attached. It does not upgrade the source beyond what the record can prove.
  6. Methodology caveats are warning labels. They name limits in the source mix, legal posture, status, or dataset coverage.