Zum Hauptinhalt springen

Vorstand App

Native Android-App für Vorstandsmitglieder zur mobilen Vereinsverwaltung.

Download & Installation​

  1. Gehe zu GitHub Releases
  2. Lade die neueste vorstand-app-vX.X.X.apk herunter (Tags: vorstand-v*)
  3. Öffne die APK-Datei auf deinem Android-Gerät
  4. Erlaube bei Bedarf die Installation aus unbekannten Quellen

Systemvoraussetzungen:

  • Android 8.0 (API 26) oder neuer
  • Internetverbindung

Login​

Die App verwendet das gleiche Login wie das Vorstand-Portal im Browser:

  1. Öffne die App
  2. Gib deine Vereins-E-Mail-Adresse ein (z.B. praesident@fwv-raura.ch)
  3. Gib dein E-Mail-Passwort ein
  4. Tippe auf Anmelden

Die Anmeldung erfolgt über IMAP — es werden die gleichen Zugangsdaten wie für den E-Mail-Abruf verwendet. Der JWT-Token (HS256, 8h gültig) wird verschlüsselt auf dem Gerät gespeichert.

Erlaubte E-Mail-Adressen: Nur Vorstand-Mailboxen können sich anmelden (z.B. praesident, aktuar, kassier, materialwart, beisitzer). Die erlaubten Adressen werden serverseitig via VORSTAND_EMAILS konfiguriert.


Funktionen​

Nach dem Login siehst du eine Bottom-Navigation mit 5 Tabs:

TabFunktion
MitgliederMitglieder anzeigen, suchen, bearbeiten, Fotos verwalten
EventsAnlässe und Schichten verwalten, Anmeldungen bearbeiten
DispatchNachrichten versenden (in Entwicklung)
VerwaltungMitgliedschaftsanträge und Admin-Funktionen
MehrEinstellungen, Audit-Log, Logout

Mitgliederverwaltung​

Mitglieder anzeigen​

  • Liste aller Mitglieder mit Suchfunktion
  • Tippe auf ein Mitglied für Details (inkl. Foto, Kontaktdaten, Status)

Mitglied bearbeiten​

  1. Tippe auf ein Mitglied in der Liste
  2. Tippe auf das Bearbeiten-Symbol
  3. Ändere die gewünschten Felder
  4. Tippe auf Speichern

Neues Mitglied erfassen​

  1. Tippe auf das + Symbol
  2. Fülle die Pflichtfelder aus (Vorname, Nachname, etc.)
  3. Tippe auf Speichern

Foto verwalten​

  • Im Mitglied-Detail: Foto hochladen oder löschen
  • Fotos werden auf dem Server unter /uploads gespeichert

Event-Management​

Events anzeigen​

  • Liste aller Anlässe (vergangene und zukünftige)
  • Tippe auf ein Event für Details mit Schichten

Schichten verwalten​

  1. Öffne ein Event
  2. Sieh die definierten Schichten (mit Bereich, z.B. Küche, Bar)
  3. Tippe auf eine Schicht für die Anmeldungen

Anmeldungen bearbeiten​

  • Sieh wer sich für welche Schicht angemeldet hat
  • Bestätige oder lehne Anmeldungen ab
  • Schlage alternative Schichten vor

Mitgliedschaftsanträge​

Im Tab Verwaltung können Mitgliedschaftsanträge bearbeitet werden:

  1. Offene Anträge werden mit Badge-Zähler angezeigt
  2. Tippe auf einen Antrag für Details
  3. Genehmigen oder Ablehnen

Audit-Log​

Das Audit-Log zeigt alle Änderungen im System:

  1. Gehe zu Mehr > Audit-Log
  2. Sieh die letzten Aktivitäten:
    • Mitglieder erstellt/bearbeitet/gelöscht
    • Anmeldungen genehmigt/abgelehnt
    • Logins

Benachrichtigungen​

Die App informiert dich im Hintergrund über wichtige Änderungen via Android WorkManager:

Aktivieren​

  1. Erlaube Benachrichtigungen für die App in den Android-Einstellungen
  2. Die App prüft automatisch alle 15 Minuten auf neue Aktivitäten

Benachrichtigte Ereignisse​

  • Neues Mitglied erstellt
  • Mitglied bearbeitet
  • Mitglied gelöscht / Löschantrag gestellt
  • Neuer Mitgliedschaftsantrag

Tipp: Bei mehreren Änderungen wird eine zusammenfassende Benachrichtigung angezeigt.


Auto-Update​

Die App prüft beim Start automatisch auf Updates via GitHub Releases:

  1. Beim App-Start wird geprüft, ob ein neues Release mit Tag vorstand-v* verfügbar ist
  2. Falls ja, erscheint ein Dialog mit der neuen Version
  3. Tippe auf Herunterladen um die neue Version zu installieren

Logout​

  1. Gehe zu Mehr
  2. Tippe auf Abmelden
  3. Der Token wird aus dem verschlüsselten Speicher gelöscht
  4. Der Vorstand-Cookie auf .fwv-raura.ch wird ebenfalls gelöscht
  5. Du wirst zum Login-Screen weitergeleitet

Geplante Funktionen (Phase 2)​

Folgende Features sind in Planung:

FeatureBeschreibung
DispatchNachrichten per E-Mail und Brief direkt aus der App versenden
E-Mail/MailcowMailcow-Postfächer und Aliases verwalten
PingenBriefversand über Pingen-Integration
Cloud-BerechtigungenNextcloud-Zugriff verwalten

Problemlösung​

Login funktioniert nicht​

  • Prüfe ob E-Mail und Passwort korrekt sind
  • Stelle sicher, dass du eine Vorstand-Mailbox verwendest (praesident, aktuar, etc.)
  • Prüfe deine Internetverbindung
  • IMAP-Port 993 muss erreichbar sein

Keine Benachrichtigungen​

  • Prüfe die Benachrichtigungseinstellungen in Android
  • Stelle sicher, dass die App nicht vom Energiesparen ausgeschlossen ist
  • Die Prüfung erfolgt alle 15 Minuten — es kann etwas dauern

App stürzt ab​

  • Stelle sicher, dass du die neueste Version verwendest (Auto-Update)
  • Lösche die App-Daten in den Android-Einstellungen
  • Installiere die App neu

Session abgelaufen​

  • Der Vorstand-Token ist 8 Stunden gültig
  • Nach Ablauf wirst du automatisch zum Login weitergeleitet
  • Bei Problemen: Manuell abmelden und neu anmelden

Technische Details​

EigenschaftWert
Min. Android8.0 (API 26)
SpracheKotlin
ArchitekturMVVM (Model-View-ViewModel)
API-KommunikationRetrofit + Gson
UI-FrameworkMaterial 3
Hintergrund-SyncWorkManager (AuditNotificationWorker)
Token-SpeicherungEncryptedSharedPreferences
Auto-UpdateUpdateChecker (GitHub Releases, Tag-Filter vorstand-v*)
CI/CDGitHub Actions (build-android-vorstand.yml)
SigningKeystore via GitHub Secrets