Pinmate-Dokumentation

Registrierung mit E-Mail und Passwort. Wir senden einen Bestätigungslink an diese Adresse; du hast 24 Stunden, ihn zu klicken. Bis dahin existiert das Konto, kann aber keine Pins hosten oder zusagen — nur die öffentliche Karte ist sichtbar.

Login mit derselben E-Mail + Passwort. Danach kommt ein sechsstelliger 2FA-Code per Mail; Eingabe gibt dir eine Session, die Reloads übersteht. Du kannst einen neuen Code anfordern, falls der erste nicht ankam oder ablief.

Das Dashboard ist der Startbildschirm für eingeloggte Nutzer. Lädt bis zu 200 aktive Pins im Beobachtungsradius, sortiert nach Startzeit. Pins ausserhalb laden nicht.

Marker tragen zwei Infos: Sportart (Farbe des Punkts) und Zeitstatus. Live-Pins pulsieren limettengrün; bald-startende mit statischem violetten Ring; abgelaufene verblassen. Auswahl fügt einen weichen violetten Halo hinzu.

Filter im rechten Panel (mobile: zusammenklappbar). Änderungen wirken sofort client-seitig. URL-State wird nicht synchronisiert — Reload setzt auf deine Defaults zurück.

Tippe einen Punkt auf der Karte an, um einen Pin zu setzen, oder benutze den „Pin setzen“-Button (Fadenkreuz). Das Modal ist mit der gewählten Position vorbefüllt — den Punkt kannst du im Header neu wählen.

Pflichtfelder: Titel (max 120 Zeichen), Kategorie, Zielgruppe, Startzeit, Dauer. Optional: Beschreibung (bis 2000), Disziplin (40 Zeichen Freitext wie „MTB“ oder „5v5“) und Sichtbarkeit (öffentlich vs Gruppe). Social-Links aus dem Profil hängen automatisch dran.

Bearbeiten ist dasselbe Formular. Einige Felder sind gesperrt: die Position änderst du nur durch Löschen und Neu-Erstellen, die Sichtbarkeit lässt sich nicht zwischen öffentlich und Gruppe umschalten (würde bereits zugesagte Mitglieder überraschen).

Jeder Pin zeigt zwei Antwort-Buttons: „Gehe hin“ (Zusage, harter Zähler) und „Interessiert“ (weiches Beobachtungs-Signal). Umschalten oder zurücknehmen jederzeit vor Start.

Teilnehmer-Zahlen sehen alle, die den Pin sehen. Namen der Teilnehmer werden nicht aufgelistet, bis der Host das explizit erlaubt (zukünftige Einstellung).

Die Aktivitäten-Seite ist dein persönlicher Kalender. Drei Buckets: anstehend „Gehe hin“, beobachtet („Interessiert“) und vergangen „Gehe hin“. Server-paginiert.

Vergangenes „Interessiert“ wird absichtlich nicht angezeigt — wenn du nur beobachtet hast, gibt's hinterher nichts zu erinnern.

Dein öffentliches Profil unter /profile/[deine-id]. Zeigt Anzeigename, Avatar, Bio, Social Handles, Verifizierungs-Badge (falls vorhanden), Follower-Zahl und deine kommenden öffentlichen Pins. Gruppen-Pins sind für Nicht-Mitglieder versteckt — auch auf deinem Profil.

Bearbeiten in Einstellungen → Profil. Avatar kann ein Foto oder eine der acht Trail-Mix-Farben mit deinem Initial sein. Verifizierungs-Badges („organizer“ oder „creator“) sind Admin-kuratiert. Auto-Verify-Cron promotet dich nach fünf gehosteten Pins zum „creator“.

Tippe Folgen auf einem Profil, damit anstehende Pins der Person in deinem Netzwerk-Tile auftauchen. Einseitig — die andere Person muss nicht zustimmen und bekommt keine Benachrichtigung. Wer dir folgt, sieht nur dein eigenes Profil.

Per-Follow-Einstellungen auf /network. Du kannst stummschalten (Benachrichtigungen aus ohne Entfolgen), E-Mail/Push unabhängig schalten, auf bestimmte Kategorien beschränken und einen Geo-Radius setzen.

Follow-Benachrichtigungen feuern mit 12 Minuten Verzögerung nach Pin-Erstellung. Absichtlich — absorbiert die Create-Edit-Delete-Schleife der ersten Minuten.

Gruppen sind Kreise nur per Einladung, die private Pins teilen. Aktuell nur Secret-Modus; Closed (Beitritt anfragen) und Open sind verschoben. Pins in Gruppen sind für Nicht-Mitglieder auf jeder Ebene unsichtbar.

Erstelle eine Gruppe auf /groups. Du wirst Owner. Lade Mitglieder mit teilbarem Link (mit optionalem Ablauf und Nutzungsgrenze) oder direkt per User-ID ein.

Verlassen ist ein Klick. Als einziges Mitglied: Gruppe wird gelöscht. Als Owner mit anderen Mitgliedern: erst Eigentum übertragen oder Mitglieder entfernen.

Pinmate hat zwei Kanäle: Push (Web-Push via Service Worker, Browser-Berechtigung nötig) und E-Mail (SMTP in dev, Elastic Email in prod). Unabhängig.

Kanäle sind per-Pin (Erinnerungen für zugesagte Pins), per-Follow (Benachrichtigungen über fremde neue Pins) und global in den Einstellungen konfigurierbar. Vor dem Versand prüft der Server, dass der Pin existiert, nicht abgelaufen und für dich sichtbar ist.

Pinmate ist um die Idee gebaut, dass deine lokale Karte lokal bleibt. Konkret: Server erzwingt Sichtbarkeits-Scopes in jeder Pin-Abfrage, dein Heim-Standort wird nie ausgestrahlt, der Default-Build enthält keine Third-Party-Tracker.

Cookies sind eingeteilt in zwingend notwendig (Session, Locale, Theme), Analytics (default aus, Opt-In über Banner) und Marketing (default aus). Cookie-Banner ist die kanonische Quelle.