Aller au contenu principal
Petanque Life

Competition Overview Analytics

F10.03 6 fonctionnalités Livré

En bref

Competition Overview Analytics aggregates results across tournaments to expose participation patterns, average match shapes, upset tracking, field-strength-weighted club rankings, and regional strength. It gives organizers, club presidents, and federations a fast, comparative view of how the competitive landscape is evolving across seasons, with multi-year trends, year-over-year deltas, and capability-gated drill-downs from national level into individual brackets.

Comment ça fonctionne

Each completed competition emits a closure event that triggers a competition-scoped aggregator. The aggregator walks the bracket and the per-match analytics from F10.02, then writes a CompetitionRollup document keyed on competition_id, plus dimensional rollups keyed on (club_id, season), (region_id, season), and (year, format). Participation statistics (F10.03.01) sum entries by category, club, and region.

Average match scores and duration (F10.03.02) read directly from the per-match aggregates. Upset tracking (F10.03.03) flags any match where the loser's pre-match ranking score exceeded the winner's by a configurable threshold; upsets are stored as a denormalized list so the dashboard can show the latest giant-killings without re-scanning matches. Club performance comparison (F10.03.04) ranks clubs by weighted points (placement * field-strength), where field-strength is the average pre-match rating in the bracket; this prevents a club that wins easy local opens from outranking one that survives strong fields.

Regional strength analysis (F10.03.05) aggregates the same metric to org-node level and surfaces the top regions per format. Historical competition data trends (F10.03.06) are built from the (year, format) rollups and rendered as multi-year line charts. All cross-competition reads use the daily/monthly closures from the platform's pre-computed AnalyticsRollup, so the dashboard stays responsive even at FIPJP scale.

Capability-gating restricts club-comparison and region-strength reports to roles that hold the competitions:read or federation:reports capability, while public participation counts are open.

Capacités clés

  • CompetitionRollup per tournament plus club, region, and year dimensions
  • Upset detection with configurable rating-gap threshold
  • Field-strength-weighted club ranking to prevent easy-bracket inflation
  • Multi-season trend lines from monthly_close rollups
  • Regional strength comparison aggregated to OrgNode hierarchy
  • Capability-gated access for sensitive comparative reports

En pratique

A district sport director opens the competition overview after the spring season closes. The participation tab shows a 12% increase in doublettes entries year-over-year, mostly driven by two new clubs. The club comparison ranks her clubs by field-strength-weighted points: a smaller club ranks third because it has been entering stronger regional opens.

The upset tab lists six giant-killings worth highlighting in the season newsletter, each linking back to the bracket. She switches the regional strength chart to triplettes and a five-year trend reveals her district has narrowed the gap to the strongest neighbour by nine points. She exports the view to Excel for her quarterly board meeting.

Fonctionnalités de ce sous-système

6
ID Status Fonctionnalités
F10.03.01 Livré Competition participation statistics ✅ PL-F1003
F10.03.02 Livré Average match scores and duration ✅ PL-F1003
F10.03.03 Livré Upset tracking (lower-ranked beats higher-ranked) ✅ PL-F1003
F10.03.04 Livré Club performance comparison ✅ PL-F1003
F10.03.05 Livré Regional strength analysis ✅ PL-F1003
F10.03.06 Livré Historical competition data trends ✅ PL-F1003