Onboarding & Einladen

Messenger-Buttons (WhatsApp, Telegram, Signal) sind Pro-Funktion — der Code oder Link selbst ist nicht an Pro gebunden.

Fehlen dir Schaltflächen, liegt es fast immer an den Rollen, nicht am Gerät.

---

Auf dem Dashboard erscheint für die Leitung eine Onboarding-Checkliste. Die sinnvolle Reihenfolge:

1. Teameinstellungen anpassen — Rufname, Erinnerungen, Messenger
2. Spielerliste anlegen — per DFBnet-Import oder Mitglied hinzufügen
3. Mannschaft einladen — Team-Code und Einladungstext teilen
4. Trainer anlegen — Rollen vergeben
5. Danach: Kalender, Spielplan, Teamkasse (je nach Bedarf)

Tipp: Erst die Liste aufbauen, dann einladen — so können Familien beim Beitritt ihr Schattenprofil wiedererkennen und beanspruchen.

---

---

Wann: Massen-Einladung — ideal für WhatsApp-Gruppen oder Elternbriefe.

Wo in der App:

• Team → Button „Mannschaft einladen"
• Dashboard → Onboarding-Checkliste → Schritt „Mannschaft einladen"
• Einstellungen → Team → Einladungscode (Code anzeigen oder neu erzeugen)

Was passiert:

1. Jedes Team hat einen Einladungscode und einen Registrierungslink (/onboarding?code=…).
2. Ihr kopiert Code oder Link — oder teilt eine Messenger-Vorlage (Pro).
3. Neue Personen registrieren sich und werden dem Team zugeordnet.
4. Der Code ist 14 Tage gültig. Danach muss ein Team-Admin einen neuen Code erzeugen (Trainer:innen und Betreuer:innen sehen den Knopf Neu, bekommen aber eine Fehlermeldung).

Was die Eingeladenen tun:

1. Link öffnen oder Code bei der Registrierung eingeben.
2. Konto anlegen (E-Mail + Passwort).
3. Ggf. Profil auf der Liste beanspruchen (siehe Variante F) oder als neues Mitglied starten.

Wichtig: Derselbe Code dient auch der Vereins-Verknüpfung — siehe Handbuch Verein. Behandelt ihn wie einen gemeinsamen Schlüssel und teilt ihn nicht öffentlich in Social Media.

---

Wann: Eine bestimmte Person auf der Spielerliste soll genau ihr Schattenprofil übernehmen — z. B. nach DFBnet-Import.

Wo in der App:

• Team → Tabellenzeile → „Zur App einladen (Login / Profil verknüpfen)" (Symbol Person mit Plus; nicht bei Kindern unter 13)
• Team → ⋮ Weitere Aktionen → „Persönlichen Einladungs-Link senden (Magic Link)" (nur bei Zeilen mit DFB-Passnummer, am Computer)
• Profil bearbeiten → Bereich Einladungen

Was passiert:

1. Sidelinq erzeugt einen personengebundenen Token für genau dieses Profil.
2. Ihr teilt die URL /auth/accept-invite?token=… (Kopieren oder per Messenger, Pro).
3. Die Person registriert sich oder ist bereits eingeloggt und übernimmt das Profil.
4. Name, Passnummer und Team-Zugehörigkeit bleiben erhalten — nur Login und Kontaktdaten kommen dazu.

Besonderheiten:

• Player-Links laufen nicht ab (im Gegensatz zu Stellvertretungs-Links).
• Verschwindet die Einladungs-Schaltfläche, hat die Person vermutlich bereits einen aktiven Login.
• Bitte nur bewusst verschicken (DSGVO).

---

Wann: Ihr kennt die E-Mail und wollt, dass die Person sofort eine Einladungsmail von Sidelinq bekommt.

Wo: Team → Mitglied hinzufügen (/dashboard/members/add)

Ablauf:

1. Name und Rolle eintragen, E-Mail setzen.
2. Checkbox Einladungs-E-Mail senden aktivieren.
3. Sidelinq legt Profil und Auth-Konto an und verschickt eine Supabase-Einladungsmail.
4. Die Person klickt den Link → Passwort setzen → ist danach direkt eingeloggt.

Besonderheiten:

• Ist die E-Mail schon registriert, wird das Team an das bestehende Konto gehängt — keine zweite Registrierung.
• Im Demo-Modus nicht verfügbar.

---

Wann: Person soll auf der Liste stehen, Einladung kommt später.

Wo: Gleiches Formular wie Variante C — ohne E-Mail oder ohne Einladungs-Checkbox.

Ablauf:

1. Sidelinq legt ein Schattenprofil an (Nur-Datenlage, kein Login).
2. Später: Magic Link (Variante B) oder Team-Code + Profil beanspruchen (Variante F).

„Schattenprofil" heißt: Die Person existiert in der Teamliste, kann sich aber noch nicht anmelden.

---

Wann: Ihr habt die Spielberechtigungsliste als CSV aus dem Verbandsportal.

Wo: Team → DFBnet-Import (/dashboard/members/import)

Ablauf:

1. CSV hochladen und Vorschau prüfen.
2. Neue Passnummern werden als Schattenprofile angelegt (Platzhalter-E-Mail intern).
3. Keine automatische Einladungsmail — das ist bewusst so.
4. Danach: Magic Links (Variante B) an einzelne Familien oder Mannschaftscode (Variante A) in den Eltern-Chat.

Besonderheiten:

• Der Import gilt immer für das in der Sidebar aktive Team — ein anderes Team ist nicht wählbar.
• Beim Wiederimport mit gleicher Passnummer zeigt Sidelinq eine Änderungsvorschau.
• Im Demo-Modus nicht verfügbar.
• Details: siehe auch FAQ auf sidelinq.de und Handbuch Team.

---

Wann: Jemand hat sich selbst registriert (Team-Code) und erkennt sich auf der Spielerliste wieder — z. B. nach DFBnet-Import.

Ablauf für die eingeladene Person:

1. Registrierung mit Team-Code abschließen.
2. Beim Beitritt Rolle wählen: Ich spiele selbst, Ich vertrete jemanden oder Trainer:in / Betreuer:in.
3. Wer sich auf der Liste erkennt, beansprucht das Schattenprofil (ohne eigenes Login). Spieler:innen mit eigenem Konto stehen nicht auf dieser Liste — sie laden Stellvertretung selbst ein.
4. Ich spiele selbst + Name auf der Liste: Die Übernahme gilt sofort — die Daten des Schattenprofils werden übernommen, kein doppelter Eintrag.
5. Ich vertrete jemanden + Kind auf der Liste: Die Anfrage landet bei der Leitung zur Freigabe (Team-Seite). Erst danach ist die Person Stellvertretung dieses Kindes.
6. Als Stellvertretung ohne Treffer („Kind nicht in der Liste“ oder leere Liste) tritt die Person als Stellvertreter:in ohne Zuordnung bei. Die Leitung verknüpft später im Spielerprofil.

Für die Leitung:

1. Spieler:in auf der Liste: Ihr bekommt eine Benachrichtigung über das neue Mitglied. Eine Freigabe ist nicht nötig. Hat jemand das falsche Profil erwischt, korrigiert ihr das im Spielerprofil.
2. Stellvertretung für ein Kind auf der Liste: Oben auf der Team-Seite erscheint eine Anfrage. Prüfen → annehmen oder ablehnen.

Besonderheiten:

• Rollenanfragen (z. B. „Ich bin Trainer") brauchen dagegen eine Freigabe auf der Team-Seite.
• Team-Code abgelaufen → Person kann nicht beitreten; Admin muss Code erneuern.
• Stellvertretung ohne Kind: Kalender zeigt nur Mannschaftstermine (keine Teil-Einladungen). Zu-/Absagen gibt es erst nach der Verknüpfung. Ausnahme: ein Event, zu dem die Person selbst eingeladen ist (z. B. Elternabend).

---

Wann: Eltern, Partner:in oder andere Kontaktperson soll für eine Spieler:in mitverantworten.

Wo:

• Team → violettes Icon bei Spieler:innen-Zeilen
• Profil der Spieler:in → „Stellvertretung per Link einladen"

Ablauf:

1. Sidelinq erzeugt einen personengebundenen Link (48 Stunden gültig).
2. Link per Kopieren oder Messenger (Pro) an die Kontaktperson senden — die Standard-Vorlage erklärt Registrierung (Google/Apple/E-Mail), App-Download, Benachrichtigungen und Kalender-Abo. Platzhalter wie {{kind}}, {{einladungslink}}, {{absender}} werden ersetzt; unter Vorlage bearbeiten speicherst du den Text pro Team.
3. Nach Klick: Registrierung → Stellvertretung ist mit dem Kind verknüpft.
4. Alternativ: Bereits registrierte Person aus dem Dropdown zuweisen (nur Leitung).

Besonderheiten:

• Link ist zeitlich begrenzt (ca. 48 Stunden).
• Abgelaufene, ungenutzte Links werden automatisch bereinigt.
• Hat die Kontaktperson schon ein Sidelinq-Konto (z. B. Stellvertretung in einem anderen Team): Link öffnen → „Ich habe schon ein Sidelinq-Konto“ bzw. Login — nicht neu registrieren. Ist sie bereits eingeloggt, erscheint eine kurze Bestätigung (Konto, Kind, Team) — erst nach Übernehmen wird die Stellvertretung zugeordnet.
• Details: Handbuch Stellvertretung und Profil.

---

Wann: Die Person hat ein Auth-Konto, kommt aber nicht rein (Passwort vergessen, Mail verloren).

Wo: Profil bearbeiten der betroffenen Person → Passwort-Link senden → „Passwort-Link per E-Mail senden“

Besonderheiten:

• Funktioniert nur, wenn bereits ein Auth-Konto existiert und die Einladung abgeschlossen ist.
• Ohne Auth-Konto: zuerst persönlichen Magic Link (Variante B) nutzen.
• Im Demo-Modus nicht verfügbar.

---

Ja — ein Login, zwei Mannschaften. Rollen liegen pro Team. Oben in der Seitenleiste Team wechseln.

Als Spieler:in ins zweite Team

1. In Team A eingeloggt bleiben (kein zweites Konto).
2. Team B schickt den Mannschaftscode bzw. /onboarding?code=… — nicht den persönlichen Einladungslink (Symbol Person mit Plus).
3. Link öffnen → Ich spiele selbst.
4. Steht der Name nach DFBnet-Import auf der Liste: genau diesen Eintrag wählen (sonst Doppel-Eintrag).
5. Steht der Name nicht: Mein Name ist nicht in der Liste.

Leitung in Team B alternativ: Mitglied hinzufügen mit derselben E-Mail — hängt das bestehende Konto an.

Nicht: Persönlichen Spieler-Link (Person mit Plus) an jemanden mit bestehendem Konto — der Link ist nur für den Erst-Login. Zweites Team geht über Code oder gleiche E-Mail.

Als Stellvertretung in einem zweiten Team

Stellvertretung per Link (Variante G) öffnen und mit dem bestehenden Konto anmelden. Bei bestehender Session: Bestätigung Übernehmen tippen. Team A bleibt erhalten; Team B und die Kind-Verknüpfung kommen dazu.

---

Diese Begriffe tauchen in Sidelinq auf, meinen aber etwas anderes:

---

„Der Einladungscode ist abgelaufen"

Team-Codes gelten 14 Tage. Admin erzeugt unter Einstellungen → Team → Einladungscode einen neuen Code und teilt ihn erneut.

„Der Stellvertretungs-Link funktioniert nicht mehr"

Guardian-Links sind ca. 48 Stunden gültig. Einfach neuen Link erzeugen und erneut senden.

„E-Mail ist schon registriert"

Beim Anlegen mit E-Mail hängt Sidelinq das Team ans bestehende Konto. Die Person soll sich einloggen, nicht erneut registrieren. Bei einem Stellvertretungs-Link führt der Login nach dem Anmelden den Link weiter — die Einladung geht nicht verloren.

„Magic Link — falscher Account eingeloggt"

Die Person ist mit einem anderen Sidelinq-Konto angemeldet. Abmelden oder im richtigen Browser-Profil den Link erneut öffnen. Ein persönlicher Spieler-Link funktioniert nicht, wenn schon ein Konto existiert — dann Mannschaftscode fürs zweite Team nutzen.

„Ich bin schon STV in einem Team und bekomme einen neuen STV-Link"

Nicht neu registrieren. Link öffnen → Ich habe schon ein Sidelinq-Konto / Login (oder schon eingeloggt). Kurz Übernehmen bestätigen. Danach bist du in beiden Teams Stellvertretung (jeweils mit dem verknüpften Kind).

Doppelter Name nach Import

Es kann ein Schatten- und ein Live-Profil geben. Die Leitung nutzt ⋮ Weitere Aktionen → Mit bestehendem Spieler verknüpfen, falls angeboten. Beim Beitritt zum zweiten Team den Import-Eintrag auf der Liste wählen — nicht „nicht in der Liste“.

Demo-Modus

Im Demo sind Mitglied anlegen, DFBnet-Import und Passwort erneut senden blockiert. Für echte Tests einen eigenen Test-Team-Account nutzen.

---

1. DFBnet-Import oder manuelle Liste — dann eine Testperson durch Magic Link oder Code prüfen.
2. Mannschaftscode in den Eltern-Chat — nicht öffentlich posten.
3. Rollenanfragen regelmäßig abarbeiten und neue Mitglieder kurz prüfen.
4. Nach großen Turnieren: Code erneuern, falls er „durchgereicht" wurde.
5. Stellvertretungs-Links nur direkt an die Kontaktperson — nicht in Gruppenchats.

---