Glossary¶

Fantasy football¶

ADP — Average Draft Position. The mean pick number a player is selected at across drafts. Lower ADP = more valuable. We aggregate ADP from Sleeper's search_rank and FFC (FantasyFootballCalculator), and we also compute our own "League ADP" from our historical Yahoo drafts (2022 + 2025).

PPR — Points Per Reception. Scoring format that gives 1 point per catch in addition to yardage/TD points. Our league and our models use PPR throughout.

Half-PPR — Same as PPR but 0.5 points per reception. Supported in the scoring format selector but not our default.

VOR — Value Over Replacement. Fantasy points a player is projected to score above the replacement-level player at the same position. Captures positional scarcity — a mid-tier RB is worth more than a mid-tier QB because the RB replacement floor is deeper.

Waiver wire — The pool of unrostered, unowned players available for pickup during the regular season.

FAAB — Free Agent Acquisition Budget. Blind-bid dollar budget used in some leagues for waiver claims.

NFL / football data¶

PFR — Pro-Football-Reference. The canonical historical stats database, widely used as an ID system (pfr_id, pfr_player_id).

GSIS — Game Statistics and Information System. The NFL's internal player ID namespace. nflverse_player_ids.gsis_id is our primary cross-platform join key — it's the one ID nflverse, PFR, and NFL.com all agree on.

NGS — Next Gen Stats. NFL's tracking-data-derived advanced stats (separation, air yards, yards over expected, etc.). Source for nflverse_ngs_passing, nflverse_ngs_rushing, nflverse_ngs_receiving.

Snap count — Number of offensive/defensive/special-teams snaps a player was on the field for. A strong proxy for opportunity; top-20 RBs typically run 70%+ offensive snap share.

Combine — NFL Scouting Combine. Pre-draft workout including 40-yard dash, bench press, vertical jump, broad jump, cone drill, shuttle drill. Source for nflverse_combine.

Bye week — Week during which a team doesn't play. You can't start players on their bye.

Scoring Zone specific¶

PigPro — Our 0–10 composite player score. Eight weighted components (v1.1 Hybrid): ML Projection (27.6%), ADP Value (23%), VOR (18.4%), Consistency (9.2%), Boom Potential (9.2%), Usage / Opportunity (8%), Situation (2.3%), News Impact (2.3%). Detail in the concept page.

Tier — 1–4 rank of PigPro score: 1=PRIME (≥7.5), 2=CHOICE (5.5–7.5), 3=SELECT (3.5–5.5), 4=RESERVE (<3.5). The tier label is also the recommendation shown on the trading card.

Recommendation — Same as the tier label: PRIME / CHOICE / SELECT / RESERVE. See the concept page.

Trading Card — The unified player detail modal available everywhere. Full anatomy in /docs/pigpro/trading-card.

Situation score — 0–100 score measuring offseason context impact (coaching changes, team switches, depth-chart moves). Computed daily by the situation-tracking CronJob from Firecrawl-scraped NFL news + nflverse rosters. Feeds PigPro's Situation component (2.5% weight).

News Impact — Per-player structured signal extracted from daily news by Claude Haiku. Each impact has direction: positive|negative|neutral, magnitude: 0-1, confidence: 0-1, reason: str. Aggregated over last 7 days into PigPro's News Impact component.

Δ7d — Change in pigpro_score versus 7 days ago. Shown as up/down arrow on the trading card. Needs 7+ days of pigpro_score_history snapshots.

Infrastructure / data sources¶

CronJob — A Kubernetes scheduled workload. Our data pipeline runs as a set of CronJobs: nflverse backfill, offseason intel, PigPro scoring, news scraping, cluster synthesis, ML retraining, and player reconciliation. See the CronJob runbook (sign in required) for full details.

nflverse — Open-source collective of NFL stats data publishers (nfl-data-py is our Python entry point). Source of snap counts, NGS, rosters, player_ids, draft picks, combine, weekly stats.

Firecrawl — Self-hosted web scraper. Converts URLs to markdown. Feeds the offseason intel and news pipelines.

LiteLLM — In-cluster OpenAI-compatible LLM proxy. Routes every LLM call to Claude (Haiku / Sonnet / Opus) with cost attribution per feature tag. See /admin/llm-costs for running spend.

PostgreSQL — The app's primary database (CloudNativePG). Stores all player, PigPro, news, draft, and cron data.

Yahoo Fantasy — The fantasy platform our league uses. OAuth 2.0 authenticated; tokens are encrypted at rest and auto-refresh. League configuration is managed in the app settings.