dev

System status

What runs now, read from the bus and the databases

Reading…

Source priority

Which sources decide and which only witness, by the kind of question (shared/config/source-priority.yaml). Read-only: it is a rule for research and reports, not something the desk collects.

Model

how to structure or describe something; how Sportradar or others solve a problem; a fixed …
Words
sportradar, structure, model, schema, dto, shape, approach, how others, how do they, solve, align, option list
  • tier 1
    sportradar_docs
    scripts/sportradar-ref.py, llm-guide/provider-alignment/sportradar-spec/, sportradar-pages/, sportradar-competition/; their general sports API (D-Z)
    decide
  • tier 2
    sportradar_docs
    Betradar Unified Odds Feed and Live Data pages — only where the sports API is silent (D-Z)
    witness
  • tier 3
    sportsapipro
    the shape of a paid all-sports source (feed-records.md §3)
    witness
  • tier 4
    sportmonks_docs, highlightly, football_data_org, wikidata, bp_1x2team
    what others do — informational
    helper

Reference data

facts about competitions, seasons, categories, competitors, players for any sport — fetchi…
Words
competition, competitions, league, leagues, cup, season, seasons, category, team, teams, competitor, all sports, fetch, measure, test on, real data, prefill, populate
  • tier 1
    sportradar_docs
    what their docs state as fact (category IDs, examples with real dates) — limited, never their data feed
    decide
  • tier 2
    sportsapipro
    paid, every sport; cache every answer; through the spend guard
    decide
  • tier 3
    highlightly
    paid; second voice
    witness
  • tier 4
    football_data_org, wikidata, cited-pages, bp_1x2team, fpl_api, jolpica_f1, espn_golf
    informational: hints, gaps, history; a person confirms what only these say (F1 drivers and classifications: events.md §3 rule 4, PD-16)
    helper

Sites events

a bookmaker site's events, odds, live — structure only (CLAUDE.md: real targets are struct…
Words
superbet, soccerbet, bookmaker, odds, live, scrape
  • tier 1
    sportradar_docs
    the model (D-Z); UOF for markets and odds
    decide
  • tier 2
    superbet, soccerbet
    captured samples in data/targets/ and the mocks
    witness

Source trust

how sources are measured, ordered, confirmed, suspended or scored — the Event Engine's sou…
Words
source trust, trust, provider, providers, uptime, coverage, suspension, suspend, scorecard, benchmark, learner, learning module, order of sources, which source
  • tier 1
    superbet, soccerbet, sportsapipro
    our own measurements of what each source sent and when — the recordings, the change log, the archive (044; RAMP: measured and tested on real data)
    decide
  • tier 2
    lsports_docs
    how a data vendor solved it (TRADE provider priority, mandatory providers, suspension by share, median outliers; BOOST coverage / uptime / benchmark, a person a…
    witness
  • tier 3
    sportradar_docs
    UOF producers, certainty 1 / 2, ended vs closed — where their pages speak
    witness

In a report

a measured claim names its sources by tier
Heading
Sources (by priority):