Spieleabend – Anleitung für Beta-Tester

Hey und vielen Dank, dass du die App vorab testest! Diese Anleitung führt dich Schritt für Schritt durch alles, was du wissen musst. Du brauchst keine technischen Vorkenntnisse — wenn etwas unklar ist, melde dich einfach.

Zeit, die du einplanen solltest: ca. 30–45 Minuten für den ersten Durchlauf.

#Was du brauchst

• Ein Smartphone (iPhone oder Android-Handy)
• Eine E-Mail-Adresse zum Registrieren
• WLAN oder mobile Daten
• Optional: einen Brettspiel-Karton zum Scannen

#1. App installieren

#iPhone (iOS)

1. TestFlight aus dem App Store laden (kostenlos, von Apple).
2. Du bekommst von uns eine Einladungs-E-Mail mit Betreff „TestFlight Einladung Spieleabend".
   • Falls nichts ankommt: Spam-Ordner prüfen.
3. In der E-Mail auf „Testen starten" tippen → öffnet TestFlight.
4. Auf „Installieren" tippen.
5. Spieleabend erscheint auf deinem Homescreen mit kleinem orangenen Punkt (zeigt: Beta-Version).
6. Updates kommen automatisch über TestFlight — bitte immer auf die neueste Version aktualisieren.

#Android

1. Du bekommst von uns einen Einladungs-Link per E-Mail (Betreff „Spieleabend Beta").
2. Auf dem Handy auf den Link tippen → Google Play Store öffnet.
3. Auf „Beta-Tester werden" tippen, kurz warten (bis zu 10 Minuten).
4. Im Play Store nach Spieleabend suchen oder den Link nochmal öffnen.
5. Installieren tippen.

Wenn die Installation nicht klappt: Mach einen Screenshot der Fehlermeldung und schick ihn uns.

#2. Erste Schritte

#Konto anlegen

1. App öffnen → Login-Bildschirm erscheint.
2. Unten auf „Registrieren" tippen.
3. Felder ausfüllen:
   • E-Mail: deine echte E-Mail (du bekommst gleich eine Bestätigung)
   • Passwort: mindestens 8 Zeichen, gerne mit Zahl und Sonderzeichen
   • Name: wie du in der App heißen sollst
4. Auf „Registrieren" tippen.
5. Du bekommst eine Bestätigungs-E-Mail. Den Link darin antippen.
   • Wenn nichts ankommt: Spam-Ordner checken oder in der App auf „Link erneut senden" tippen.
6. Nach der Bestätigung: zurück zur App, einloggen.

💡 Pull-to-refresh: In allen Listen kannst du nach unten ziehen, um Daten neu zu laden.

#3. Die App testen — 7 Schritte

#Schritt 1: Profil einrichten

• Tippe oben rechts auf das Drei-Punkte-Menü → Profil
• Profilbild hinzufügen — einmal aus der Galerie, einmal mit der Kamera
• Vor- und Nachname eintragen
• Speichern → Bestätigung erscheint

#Schritt 2: Brettspiel hinzufügen

Wichtig: Spiele werden primär per EAN-Barcode-Scan hinzugefügt.

• Im Hauptmenü zu „Spiele" wechseln
• Auf den „EAN scannen"-Button unten tippen
• Den Barcode auf einer Spieleschachtel scannen
  • Spiel bekannt → wird automatisch zur Bibliothek hinzugefügt
  • Spiel unbekannt → Online-Suche-Screen öffnet sich automatisch
    • Spielname eintippen → Treffer auswählen
    • Wenn kein Treffer: „Manuell anlegen" → Vollformular ausfüllen
• Spiel öffnen → Detail-Ansicht mit Cover, Verlag, Spielerzahl, Spielzeit

💡 Spiel ohne Scan hinzufügen: kleines +-Icon oben in der Bibliothek (führt zur Online-Suche)

#Schritt 3: Spielrunde anlegen

• Zu „Spielrunden" wechseln
• + unten rechts tippen
• Spiel auswählen: Tippe auf den großen Tile → Bottom-Sheet:
  • Tab „Bibliothek": Such- und Auswahl deiner Spiele
  • Tab „Freitext": Spielname frei eintippen (für Spiele, die nicht in der Datenbank sind)
• Start- und Endzeit anpassen (default: jetzt + 2 Stunden)
• Mitspieler hinzufügen:
  • Auf „Spieler hinzufügen"-Card tippen → Bottom-Sheet
  • Tab „Freunde": Aus deiner Freundesliste auswählen
  • Tab „Manuell": Namen frei eintippen (für Familie/Gäste ohne App-Account)
• Punkte direkt in jeder Spielerzeile eintragen (kein extra Dialog mehr!)
• Lange auf einen Spieler drücken → Entfernen-Bestätigung
• Gruppenergebnis (für kooperative Spiele wie Pandemic, Spirit Island, …): 🏆 Gewonnen / 💔 Verloren / 🎲 Egal (= kompetitiv, kein Gruppen-Ergebnis)
• Anzahl Runden (optional)
• Bemerkungen (optional)
• Ort (optional)
• Fotos:
  • Mehrere aus der Galerie auf einmal
  • Eines mit der Kamera aufnehmen
  • Eines als Cover markieren
  • Auf ein Foto-Thumbnail tippen → Vollbild-Modus mit Pinch-Zoom
• Speichern oben rechts

#Schritt 4: Spielrunden-Liste ansehen

• Liste mit allen Runden, sortiert nach neueste zuerst
• Zwei Ansichts-Modi mit dem kleinen Toggle-Button (unter dem +-Button):
  • Hero-Modus (default): große Cover-Cards mit Foto, Datum, Spielern, Sieg-Badge
  • Timeline-Modus: kompakte Liste mit Datums-Anker links, Sektionen „Heute", „Diese Woche", „Dieser Monat"
• Modus wird gespeichert — bleibt nach App-Neustart erhalten
• Pull-to-refresh holt frische Daten vom Server

#Schritt 5: Spielrunden-Detail

• Eine Runde aus der Liste antippen
• Hero-Header mit Cover-Foto / Boardgame-Cover / dunklem Fallback
• Stats-Pills: Spielerzahl, Dauer, Anzahl Runden auf einen Blick
• Mitspieler mit Punkten:
  • Kooperatives Spiel (Gruppen-Ergebnis gewählt): Spieler in eingegebener Reihenfolge, ohne Medaillen
  • Kompetitives Spiel („Egal" gewählt + Punkte): nach Punkten sortiert, 🥇🥈🥉 für Top 3
• Foto-Galerie unten — Tap auf Foto → Vollbild + Pinch-Zoom + Swipe
• Bearbeiten (Stift-Icon oben rechts)
• Löschen (Mülleimer-Icon, nur sichtbar wenn du die Runde erstellt hast) → roter Bestätigungs-Dialog

#Schritt 6: Freunde

• Zu „Freunde" wechseln
• Freundschaftsanfrage an einen anderen Tester senden (am besten zu zweit testen)
• Anfrage annehmen / ablehnen
• Auf einen Freund tippen → Detail-Seite:
  • Persönliche Infos
  • Gemeinsame Spielrunden — automatisch gefiltert, alle Runden in denen ihr beide gespielt habt
  • Tap auf eine gemeinsame Runde → Round-Detail
• Freund entfernen → verschwindet aus der Liste

#Schritt 7: Konto-Lebenszyklus

• Ausloggen (Drei-Punkte-Menü oben rechts)
• Erneut einloggen → klappt es?
• App komplett schließen und wieder öffnen → bist du noch eingeloggt?
• BGG-Sammlung importieren (falls du einen BGG-Account hast):
  • Im Profil den BGG-Namen eintragen, speichern
  • Button „BGG-Sammlung importieren" tippen
  • Deine BGG-Spiele werden in deine Bibliothek übernommen
• Im Profil ganz unten: „Konto löschen":
  • Lies dir den Hinweis durch
  • Probier mit falschem Passwort → Fehlermeldung
  • Mit richtigem Passwort → landest auf dem Login-Screen
  • Du kannst dich dann mit der gleichen E-Mail neu registrieren

#4. Was wir besonders wissen wollen

#5. Bugs melden

#Am einfachsten: Feedback-Formular auf dieser Seite

Scroll runter zum Formular am Ende der Seite — dort kannst du in 30 Sekunden alles Wichtige eintippen. Screenshot per Mail nachschicken oder am iPhone direkt aus TestFlight.

#iPhone-Bonus

1. Auf einer beliebigen Seite Screenshot machen (Power + Lauter-Taste).
2. Im Vorschau-Bild „Mit Notiz teilen" wählen → schickt automatisch alles inkl. Geräte-Infos an uns.
3. ODER: TestFlight öffnen → Spieleabend → „Feedback senden".

#Lieber per Mail

Geht auch — schick eine Mail an stefan@brettspielgilde.de mit:

• Was hast du gemacht?
• Was hast du erwartet?
• Was ist passiert?
• Screenshot wenn möglich
• Dein Gerät (z.B. „iPhone 13" oder „Samsung S22")

Auch „Kleinigkeiten" sind hilfreich — ein verwirrender Text ist genauso wichtig wie ein Absturz.

#6. Bekannte Einschränkungen

Diese kennen wir schon — bitte nicht nochmal melden:

• Mail-Bestätigungs-Links öffnen aktuell eine Webseite, von der du manuell zur App zurückwechseln musst. Echte App-Links („tippe Mail → App öffnet automatisch") kommen nach der Beta.
• Englische Übersetzung gibt's noch nicht — App ist nur auf Deutsch.
• Cover-Upload für Brettspiele ist nur für Administratoren möglich (Datenbank wird zentral gepflegt).
• Tablet-Layout ist optimiert für Smartphones, auf größeren Geräten wirkt das Layout etwas leer.
• Offline-Verhalten: Wenn das Internet weg ist, zeigt die App nicht immer eine schöne Meldung.
• Datenbank-IDs in URLs sind temporär — werden bei Production-Release stabilisiert.

#7. Updates während der Beta

• Wir laden regelmäßig neue Versionen hoch (etwa alle 1–2 Wochen).
• iPhone: TestFlight zeigt das automatisch. Auf „Aktualisieren" tippen.
• Android: Update wie bei jeder anderen App im Play Store.
• In der Update-Beschreibung steht jeweils, was neu ist und was wir besonders getestet haben wollen.

#8. Privatsphäre

• Deine Daten bleiben auf unseren Servern (nicht an Dritte).
• Konto löschen in der App entfernt deine persönlichen Daten dauerhaft.
• Spielrunden, an denen andere Tester teilgenommen haben, bleiben dort sichtbar — allerdings nur dein Spieler-Name (Snapshot), kein klickbares Profil.
• Nach Ende der Beta wird der gesamte Test-Datenbestand zurückgesetzt.
• Spieldaten kommen aus unserer eigenen Brettspiel-Datenbank. Wenn du deine BGG-Sammlung importierst, gleicht die App sie über die offizielle BGG XML API 2 mit unserer Datenbank ab. Das Powered by BGG-Logo im Info-Screen erfüllt BGGs Branding-Vorgabe für API-Nutzer.

#9. Kontakt

• Bugs / Probleme: stefan@brettspielgilde.de
• Fragen / Vorschläge: gleiche Adresse
• Antwort-Zeit: wir versuchen, innerhalb von 1–2 Werktagen zurückzumelden

#Danke!

Jeder gefundene Bug spart hunderten späteren Nutzern Frust. Ohne Zeitdruck, in deinem Tempo.

Viel Spaß beim Spielen und Testen 🎲