Skip to content
orcndPublic

About

Source-linked Turkish football data explorer and transparent advantage/disadvantage index

Resources

Stars

0 stars

Watchers

0 watching

Forks

Repository files navigation

Süper Lig Advantage / Disadvantage Index

Live app · Data explorer · Methodology · Sources

A Next.js data explorer for match and event records from three Süper Lig seasons. It applies documented rules to verified penalty decisions and suspension-related effects for Galatasaray, Fenerbahçe, Beşiktaş, and Trabzonspor.

Scope and interpretation

  • The index is not evidence of referee error, intentional favoritism, or harm.
  • Ordinary cards, injuries, match results, and absence from a lineup do not earn points by themselves.
  • A penalty decision is scored independently of whether the kick was scored, missed, or saved.
  • A suspension effect is counted only when the served suspension, affected match, and independent player rating are supported by sources.
  • Weights are explicit model assumptions, not scientific constants.
  • Penalty and VAR research is incomplete. Unverified records are excluded; missing data does not mean zero impact. Partial totals should not be treated as definitive rankings.

Data and method

The project keeps raw source snapshots, normalized JSON, a source manifest, and schema checks so data changes can be reviewed. The explorer filters records by season and team. Source links point to Turkish Football Federation (TFF) match details. Duplicate event IDs are counted once.

Cards, penalty goals, and selected match context come from TFF records. Rest intervals, pre-match opponent form, post-card lineup absence, and lineup continuity are derived using documented rules. Absence from a lineup is not presented as confirmed injury or suspension without a source. Unverified mock records are excluded from scoring.

The score combines event impact, a confidence factor, and a category weight. Missing measurements remain unknown rather than being treated as zero. The live /methodology page documents current weights, direction multipliers, and missing-data handling.

Application pages

  • /: season comparisons, index rankings, components, and data coverage.
  • /data: match and event records.
  • /methodology: scoring formula, weights, and confidence rules.
  • /sources: source material, derived measures, and verification limits.
  • /test: summary checks for imported match data.

Run locally

Requirements: a Node.js version supported by Next.js 16 and npm.

npm ci
npm run dev

The development server opens at http://localhost:3000.

Commands

Command Purpose
npm run dev Start the local development server.
npm run lint Run ESLint.
npm test Run Vitest.
npm run build Build the static site into out/.
npm run pages:build Build the site for Cloudflare Pages.
npm run pages:deploy Upload out/ with Wrangler.
npm run data:import:tff Refresh three seasons of TFF fixtures and match details.

Data updates

The app does not make live TFF requests. Builds use JSON files committed to the repository. Raw snapshots are in data/raw/tff/; normalized records for the four clubs are in data/normalized/big-four-matches.json. data/sources-manifest.json records source URLs, retrieval times, record counts, and SHA-256 hashes.

Refresh the snapshots with:

npm run data:import:tff

Review the generated diffs and verify them before publishing. Missing events are not inferred from match results. See data/README.md for the data files and import details.

Contact

Contributions and corrections: info@orcuncandan.com

About

Source-linked Turkish football data explorer and transparent advantage/disadvantage index

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages