Tips & Tricks: Fest-Pool (SSV-Import)

Stand: August 2026 · Bereich: Admin-HQ → Fest-Pool (SSV-Import)

Der Fest-Pool holt externe Schützenfeste aus dem offiziellen SSV-Kalender (kalender.schuetzenportal.ch) in TargetSync — als Kandidaten, die der Superadmin prüft, ergänzt und erst dann als echte Feste freigibt.

---

1. Der Grundgedanke

• Kandidaten sind keine Feste. Sie liegen in einer eigenen Warteliste.
• Erst «Als Fest übernehmen» erzeugt ein externes Fest — sofort sichtbar für alle Vereine der jeweiligen Disziplin, mit Vermerk «Quelle: SSV-Kalender».
• Jeder Kandidat trägt einen Quell-Hash. Bei späteren Importen wird alles Unveränderte erkannt und übersprungen — keine Dubletten im Pool.

2. Neuen Auszug aus dem Schützenportal holen (Re-Import)

1. kalender.schuetzenportal.ch öffnen → Filter setzen:

   • Disziplinen: G300, P50, P25 (nur diese!)
   • Kantone: alle

2. PDF-Auszug erstellen (Druck-/Export-Funktion des Kalenders).

3. Das PDF Claude in den Chat hochladen — Claude parst es und aktualisiert scripts/data/ssv-fest-kandidaten.json (nur Anlässe ab dem aktuellen Tag).

4. Nur diese eine Datei per SFTP auf den Server kopieren: scripts/data/ssv-fest-kandidaten.json

5. Auf dem Server (PuTTY, /var/www/target-sync):

   node scripts/import-fest-kandidaten.js              # DRY-RUN: zeigt nur, was [NEU] wäre
   node scripts/import-fest-kandidaten.js --schreiben  # schreibt in die Datenbank
   

6. Fertig — neue Anlässe stehen im Fest-Pool mit Status Neu. Kein Build, kein Restart nötig (nur Datenimport).

3. Kandidaten prüfen und übernehmen

1. Admin-HQ → Fest-Pool (SSV-Import) → Filter «Offen».
2. Karte aufklappen → «Prüfen & ergänzen»:
   • Website / Ausschreibung: steht auf der Detailseite im SSV-Kalender — Knopf «SSV-Kalender öffnen» nutzen, Link kopieren, einfügen.
   • Google Maps Link der Schiessanlage ergänzen.
   • Kanton wählen (steht nicht im PDF).
   • Schiesstage & Zeiten: pro Tag zwei Zeitfenster möglich (z.B. 08:00–12:00 / 13:30–19:00) — laut Ausschreibung nachtragen.
3. «Als Fest übernehmen» → das Fest ist live. Nachträgliche Änderungen dann unter «Schützenfeste verwalten».
4. Nicht relevant? → «Verwerfen» (jederzeit wiederherstellbar).

4. Dubletten-Hinweis richtig nutzen

• Gelbes Badge «⚠ Mögliches Duplikat»: Es existiert bereits ein Fest mit überlappenden Daten und ähnlichem Namen (geprüft über Titel, Veranstalter und Ort — auch Jubiläums-Zahlen wie «350» zählen).
• Klick auf das vermutete Fest öffnet es in einem neuen Tab («Schützenfeste verwalten» mit vorbefüllter Suche) — der Pool bleibt, wie er ist. Ist es dasselbe Fest: Tab schliessen, Kandidat verwerfen.
• Hat der Veranstalter etwas geändert (z.B. Schiesstag verschoben), kommt der Anlass beim Re-Import als neuer Kandidat — der Dubletten-Hinweis zeigt dann auf dein bereits übernommenes Fest: Unterschied anschauen, Fest anpassen, Kandidaten verwerfen.

5. Was zieht bei der Übernahme alles mit?

Kandidat	→ Fest
Name	Titel
Veranstalter + Anlasstyp	Beschreibung (+ Quelle-Vermerk)
Ort / Kanton	Ort / Kanton
Schiesstage inkl. Zeiten	Einzelne Event-Tage (eventDates)
Website / Maps-Link	Website / Anfahrt
TargetSync-Disziplinen	Disziplinen (steuert Sichtbarkeit)

Abgesagte Anlässe (laut SSV) sind für die Übernahme gesperrt.

6. Ausbau-Ideen für später (noch nicht gebaut)

• PDF-Upload direkt in der App: Auszug im Fest-Pool hochladen, Vorschau «neu / geändert / unverändert», bestätigen — ohne Chat und ohne SFTP.
• Änderungs-Abgleich: geänderte Anlässe automatisch der alten Version zuordnen und als «ersetzt» markieren statt als neuer Kandidat.
• Weitere Disziplinen (G50, G10/P10) aufnehmen, falls Vereine sie brauchen.