Qualification Pathways
At a glance
Multi-stage qualification pathways model the journey from local to international level — club > district > regional > national > continental > world — with configurable spots per stage, automatic registration on qualification, ranking-based qualification thresholds, wild cards, and a per-player history of every championship qualified for.
How it works
Each pathway is defined as an ordered chain of competition stages tied to the federation's structure. The federation declares the chain (e.g., Sweden: club open → district championship → SM; France: club → comité → ligue → national; FIPJP: national → continental → world) and allocates qualification spots per stage — top 4 from each district to regional, top 16 from regional to national, top 2 nations from continental qualifying to world. When a player or team places within the allocated spots, automatic qualification tracking advances them: the system creates a registration in the next stage's competition, sends a confirmation push and email, and surfaces the qualification on their profile.
Wild card and invitation slots let federations override the algorithm for sponsor commitments, host-nation places, or selectors' picks; wild cards are tracked separately so the public can see who earned a spot and who was invited. Qualification via ranking runs a parallel pathway — the top N nationally on the federation ranking auto-qualify for continental qualifying, bypassing the regional stage. Qualification history per player is a chronological log of every championship qualified for and the route taken; it surfaces on player profiles and feeds Records & Milestones.
Cross-reference linkage ties national qualification to continental and world entry: the federation submits its squad based on the qualification snapshot taken at the deadline (see F04.20), and the international competition's accreditation system in F04.12 picks up the named athletes automatically.
Key capabilities
- Configurable pathway chains: club > district > regional > national > continental > world
- Spot allocation per stage with automatic next-stage registration on qualification
- Wild card and invitation slots tracked separately from earned places
- Ranking-based qualification (top N nationally bypass regional stage)
- Player qualification history with full route taken
- Cross-reference national → continental → world entry via squad submission
- Notifications and confirmations on every qualification step
In practice
A young Swedish triplette wins their district championship in early June and immediately receives a push notification: "You have qualified for the SM regional stage on July 12 in Linköping — confirm your participation by July 1." The system has pre-registered them and reserved a slot. They confirm, play the regional, finish second of 32, and qualify automatically for SM Finals in August. Their profile page now shows the qualification history: District champion → Regional silver → SM Finals.
Three months later, the federation's qualification snapshot at the EM deadline shows them inside the top 4; they are added to the candidate pool for national team selection (F04.09) and the continental accreditation system (F04.12) is primed for their badge.
Features in this subsystem
7| ID | Status | Features |
|---|---|---|
| F04.11.01 | Shipped | Qualification pathway definition (e.g., club > district > regional > national > world) — PL-F0411a ✅ greenfield-byggd i 7cd8cecf.m-4 (nivåerna kommer ur tenantens egna org_node_levels) |
| F04.11.02 | Shipped | Qualification spots allocation (how many advance from each stage) — PL-F0411a ✅ greenfield-byggd i 7cd8cecf.m-4 (places_forward per bunden tävlingsklass) |
| F04.11.03 | Shipped | Automatic qualification tracking (player qualifies at district → registered for regional) — PL-F0411a ✅ greenfield-byggd i 7cd8cecf.m-4 — med BOKFÖRD avgränsning: auto_entry_on_advancement flyttar spelaren fram i STEGEN och skriver INGEN tävlingsanmälan (anmälan ägs av D-COMP med avgift, godkännandegrind och klubbbundenhet) |
| F04.11.04 | Shipped | Wild card / invitation slots — PL-F0411a ✅ greenfield-byggd i 7cd8cecf.m-4 (den enda LAGRADE kvalificeringen; taket prövas under radlås) |
| F04.11.05 | Shipped | Qualification via ranking (top N nationally qualify for continental) — PL-F0411b ✅ greenfield-byggd i 7cd8cecf.m-4 (topp N ur en LÅST kval-snapshot, låset prövat vid varje härledning) |
| F04.11.06 | Shipped | Qualification history per player (which championships qualified for) — PL-F0411b ✅ greenfield-byggd i 7cd8cecf.m-5 — spelarhistoriken (GET /v1/tenant/selection/history/players/{userId}): hennes uttagningar + hennes kvalificeringar med EVIDENS, härledd vid läsning (ingen ny tabell, kval-halvan är m-4:s EGEN spårningssöm skopad till en människa). I 7cd8cecf.m-4 var raden ännu inte greenfield-byggd — m-4 spårade EN kvalstege i taget (m-4:s non-goal 8) och historiken över säsonger/stegar var uttryckligen senare arbete; det arbetet är m-5. ORDET är UTTAGNINGAR, aldrig landskamper: huset har inget landskampsregister, så selection_count räknar uttagningar registrerade i Petanque Life |
| F04.11.07 | Planned | Cross-reference: national qualification linked to continental/world entry — PL-F0411b ⛔ F04.11.07 är fortfarande inte greenfield-byggd — varken i 7cd8cecf.m-4 eller i 7cd8cecf.m-5, och det är ett UTTRYCKLIGT beslut: m-5 PRODUCERAR squad-artefakten (petanque-life-v1) men skickar den aldrig — inlämningen, kvittensen och M2M-mottagningen är D-PUBAPI (m-5:s bindande non-goal 1). Utan ett kvitto från CEP/FIPJP finns ingen byggd källa att korsreferera mot; mockupens fotnot renderas INTE och fabriceras inte. Uppdaterat (D-PUBAPI a95566cc.m-6, 2026-09): KVITTOT FINNS NU. Truppinlämningen till CEP/FIPJP är byggd (/v1/squad-submissions, kvittensen med sina MÄTTA kontroller, accepten på F1-6:s generiska ärendeyta — squad-submissions.md), så det finns en mottagen och beslutad inlämning att korsreferera MOT. Själva korsreferensen — att koppla den nationella kvalificeringen till den kontinentala/globala anmälan — är fortsatt D-NATIONAL/D-COMP:s och är INTE byggd här; m-6 äger transporten, inte kvalvägens koppling |
Stakeholders who need this subsystem
Surfaces in 1 stakeholder analyses