Automatische Riegeneinteilung (Squad Auto Assign)¶

┌─────────────────────────────────────────────────────────────────┐
│  Frontend (React)                                               │
│  ┌─────────────────────┐  ┌──────────────────────────────────┐  │
│  │ AutoAssignDialog.tsx │  │ useAutoAssign.ts (Custom Hook)   │  │
│  │ (620 Zeilen, 3-Step │──│ - criteria State                 │  │
│  │  Wizard mit Sub-     │  │ - generateProposals(eventId)     │  │
│  │  Komponenten)        │  │ - applyProposal(eventId, prop.)  │  │
│  └─────────────────────┘  └──────────┬───────────────────────┘  │
│                                      │ HTTP POST                │
├──────────────────────────────────────┼──────────────────────────┤
│  Backend (Express)                   ▼                          │
│  ┌──────────────────────────────────────────────────────────┐   │
│  │ squadAutoAssign.ts (Route + Algorithmus)                 │   │
│  │ POST /api/squad-management/auto-assign/generate          │   │
│  │ POST /api/squad-management/auto-assign/apply             │   │
│  │                                                          │   │
│  │ Interne Funktionen:                                      │   │
│  │ - fetchEventParticipants()  - distributeIntoSquads()     │   │
│  │ - parseAgeCategoryRanges()  - generateSquadName()        │   │
│  │ - getAgeCategory()          - generateProposal()         │   │
│  │ - shuffle() (Fisher-Yates)                               │   │
│  └──────────────────────────────────────────────────────────┘   │
│                          │                                      │
│                          ▼                                      │
│  ┌──────────────────────────────┐                               │
│  │ PostgreSQL                   │                               │
│  │ tfx_wertungen.var_riege      │                               │
│  │ tfx_teilnehmer               │                               │
│  │ tfx_wettkaempfe              │                               │
│  │ tfx_vereine                  │                               │
│  └──────────────────────────────┘                               │
└─────────────────────────────────────────────────────────────────┘

1. Teilnehmer laden
   └─ SQL: DISTINCT ON (int_teilnehmerid) aus tfx_wertungen → tfx_teilnehmer → tfx_vereine
   └─ Filter: nur Teilnehmer mit Wertungen in der gewählten Veranstaltung
   └─ Berechnung: Alter aus dat_geburtstag, Geschlecht aus int_geschlecht (1=m, 2=w)

2. Nach Geschlecht gruppieren (optional)
   ├─ separateGenders=true:  → male[], female[], mixed[]
   └─ separateGenders=false: → mixed[] (alle)

3. Shuffle (Fisher-Yates)
   └─ Jede Geschlechtergruppe wird zufällig gemischt
   └─ Erzeugt Variation zwischen den Vorschlägen

4. Nach Alterskategorie unterteilen (optional)
   └─ Parst z.B. "6-8,9-10,11-12,13-14,15-18"
   └─ Jeder Teilnehmer wird einer Kategorie zugeordnet
   └─ "unknown" bei fehlendem Geburtsdatum, "other" bei außerhalb

5. Verteilung in Riegen
   ├─ keepClubsTogether=true:
   │   └─ Bin-Packing-Heuristik (First-Fit Decreasing)
   │   └─ Vereine nach Größe sortiert, größte zuerst zugewiesen
   │   └─ Überfüllte Vereine werden in max-große Blöcke aufgeteilt
   └─ keepClubsTogether=false:
       └─ Einfache sequenzielle Auffüllung

6. Benennung
   ├─ "gender": Präfix (m/w/g) + Farbkürzel → "mRot", "wBlau", "gGlb"
   ├─ "number": Nummeriert → "R01", "R02", "R03"
   └─ "none":   Nur Farbe → "Rot", "Blau", "Grn"
   └─ ALLE Namen ≤ 5 Zeichen (Datenbankfeld VarChar(5))

7. Pausen-Riegen anhängen
   └─ Leere Riegen für Geräte-Rotation ("Paus" / "P01")

8. Statistiken berechnen
   └─ Gesamt, Durchschnitt, Min, Max Teilnehmer pro Riege
   └─ Geschlechterverteilung

9. Wiederholen für jeden Vorschlag (Shuffle erzeugt Variation)

10. Anwenden (bei Auswahl eines Vorschlags)
    └─ clearExisting: var_riege = NULL für alle Wertungen der Veranstaltung
    └─ Update: var_riege = Riegenname für jeden zugewiesenen Teilnehmer

{
  "proposals": [
    {
      "id": 1,
      "squads": [
        {
          "name": "mRot",
          "colorName": "Rot",
          "genderGroup": "male",
          "ageCategory": null,
          "participants": [
            { "id": 42, "firstname": "Max", "lastname": "Müller", "club": "TV Musterstadt", "clubId": 5, "gender": "male", "age": 12, "birthYear": 2014 }
          ],
          "isBreak": false
        }
      ],
      "stats": {
        "totalSquads": 6,
        "totalParticipants": 48,
        "avgParticipantsPerSquad": 8.0,
        "minParticipantsPerSquad": 7,
        "maxParticipantsPerSquad": 9,
        "breakSquads": 0,
        "genderDistribution": { "male": 24, "female": 24 }
      }
    }
  ],
  "eventId": 59,
  "totalParticipants": 48,
  "criteria": { "maxParticipantsPerSquad": 12, "separateGenders": true, "..." : "..." }
}

{
  "success": true,
  "message": "Successfully assigned 48 participants to 6 squads",
  "eventId": 59,
  "squadsCreated": 6,
  "participantsAssigned": 48
}

{
  "description": "Default criteria for automatic squad assignment (Riegeneinteilung).",
  "maxParticipantsPerSquad": 12,
  "separateGenders": true,
  "keepClubsTogether": true,
  "groupByAgeCategory": false,
  "ageCategoryRanges": "6-8,9-10,11-12,13-14,15-18",
  "numberOfProposals": 3,
  "namingPrefix": "gender",
  "breakCount": 0
}

cd server
npx jest tests/unit/squadAutoAssign.test.ts --verbose

SELECT DISTINCT ON (t.int_teilnehmerid) 
  t.int_teilnehmerid, t.var_vorname, t.var_nachname,
  v.var_name as vereinsname, t.int_vereineid,
  t.int_geschlecht, t.dat_geburtstag
FROM tfx_wertungen w
JOIN tfx_wettkaempfe wk ON w.int_wettkaempfeid = wk.int_wettkaempfeid
JOIN tfx_teilnehmer t ON w.int_teilnehmerid = t.int_teilnehmerid
LEFT JOIN tfx_vereine v ON t.int_vereineid = v.int_vereineid
WHERE wk.int_veranstaltungenid = $1
ORDER BY t.int_teilnehmerid

UPDATE tfx_wertungen w SET var_riege = NULL
FROM tfx_wettkaempfe wk
WHERE w.int_wettkaempfeid = wk.int_wettkaempfeid
  AND wk.int_veranstaltungenid = $1

UPDATE tfx_wertungen w SET var_riege = $1
FROM tfx_wettkaempfe wk
WHERE w.int_wettkaempfeid = wk.int_wettkaempfeid
  AND wk.int_veranstaltungenid = $2
  AND w.int_teilnehmerid = ANY($3::int[])