# Not Fair — Referee Damage Index (Full Documentation)

> Fan-powered referee accountability platform tracking controversial calls across 60+ football leagues.

## Overview
Not Fair is a community-driven sports platform where football fans can report and vote on controversial referee decisions. The platform calculates quantitative indices — the Referee Damage Index (RDI) and Player Damage Index (PDI) — based on weighted community votes.

## Core Concepts

### Referee Damage Index (RDI)
A numerical score representing the volume and severity of controversial decisions attributed to a referee, as voted by fans. Higher RDI = more controversy.

### Player Damage Index (PDI)
A score representing how frequently a player is involved in controversial referee decisions (as the affected party). Higher PDI = more incidents affecting that player.

### 48-Hour Window
All reporting and voting must occur within 48 hours of a match's kickoff time. After this window closes, the match is archived and no further changes can be made.

### Vote Weighting
- Standard users: 1x vote weight
- Verified Professionals (coaches, journalists, licensed referees, analysts): 100x vote weight
- Users earn levels through participation: 100 votes = 1 level point, 25 reports = 1 level point

### Incident Categories
- Penalty decisions (given or not given)
- Red/yellow card decisions
- Offside calls
- Goal disallowed/allowed
- Foul decisions
- VAR interventions
- Handball decisions
- Advantage play decisions

### Severity Levels
- Low: Minor controversial call with limited match impact
- Medium: Significant call affecting match flow
- High: Major decision potentially changing the match outcome
- Critical: Game-defining controversial decision

## Available Pages

### Home (/)
Displays currently active matches (within 48h window) grouped by country and league. Users can filter by country and league. Shows trending matches sorted by total votes.

### Players (/players)
Complete list of all registered players, searchable and filterable by league. Each player links to their individual profile showing PDI and related incidents.

### Player Detail (/player/:slug)
Individual player page showing:
- Player name, nationality, team, position
- Player Damage Index score
- All incidents involving this player
- Incident voting interface

### Teams (/teams)
All registered football teams searchable and filterable by league. Links to individual team pages.

### Team Detail (/team/:slug)
Individual team page showing:
- Team name, league, team type
- All incidents affecting this team
- Team damage statistics

### Referees (/referees)
All referees ranked by Referee Damage Index, filterable by league.

### Referee Detail (/referee/:slug)
Individual referee page showing:
- Referee name, nationality, league
- Referee Damage Index score
- Fairness checker comparing incidents across teams
- All incidents from matches officiated by this referee
- Match history

### Match Detail (/match/:slug)
Individual match page showing:
- Score, teams, referee, league
- All reported incidents with voting
- Incident reporting form (within 48h window)
- Match statistics

### Leaderboards (/leaderboards)
Rankings of:
- Teams by total incidents and damage scores
- Referees by RDI

### Guidelines (/guidelines)
Community guidelines for responsible reporting.

### Privacy Policy (/privacy)
Data handling and privacy practices.

### Terms of Service (/terms)
Platform terms and conditions.

## Leagues Covered
Premier League, La Liga, Serie A, Bundesliga, Ligue 1, Eredivisie, Primeira Liga, Süper Lig, Saudi Pro League, MLS, Argentine Primera División, Brazilian Série A, J1 League, K League 1, Chinese Super League, A-League, Indian Super League, and 40+ additional leagues.

## Languages Supported
English, Spanish, French, German, Italian, Portuguese, Dutch, Turkish, Arabic, Japanese, Korean, Chinese

## Technical Details
- Single-page application (React)
- Real-time data updates
- Mobile-responsive design
- Dark theme interface

## Legal Entity
Not Fair Index LLC

## Contact
Website: https://notfair.lovable.app