Helfertool

Einsatzplanung für Vereine. Wer hilft wann, wer bringt was mit – und wer hat sein Soll schon erfüllt.

Überblick

Ein Verein legt Anlässe an – ein Turnfest, einen Räbeliechtli-Umzug, eine Papiersammlung. Zu jedem Anlass gehören Aufgaben mit Zeitfenster: Kasse von 9 bis 12, Grill von 11 bis 14. Mitglieder tragen sich selbst ein oder werden vom Vorstand eingeteilt. Daneben steht die Bringliste für alles, was jemand mitbringt statt Zeit zu leisten.

Jeder Verein hat seine eigene Domain und eigene Datenbank. Was in einem Verein steht, ist in keinem anderen sichtbar; es gibt keine gemeinsame Mitgliederliste. Verwaltet werden die Vereine an einer separaten Stelle, der Vereinsverwaltung.

Die Oberfläche ist für das Telefon gebaut – die Navigation liegt unten, in Daumenreichweite. Am Rechner funktioniert sie genauso.

Für Mitglieder

Anmelden

Du bekommst deine Zugangsdaten per SMS vom Vorstand. Anmelden kannst du dich wahlweise mit dem Benutzernamen oder mit deiner Telefonnummer – beides funktioniert, und die Schreibweise der Nummer ist egal: 079 123 45 67, +41791234567 und 0791234567 gelten als dieselbe.

Das zugeschickte Passwort ist ein Einmalpasswort. Beim ersten Anmelden wirst du nach einem eigenen gefragt. Es braucht mindestens acht Zeichen und mindestens eine Ziffer.

Passwort vergessen

Auf der Anmeldeseite gibt es „Passwort vergessen“. Du gibst Benutzernamen oder Telefonnummer ein und bekommst ein neues Einmalpasswort per SMS.

Die Antwort lautet immer gleich, ob es den Zugang gibt oder nicht. Das ist Absicht: sonst liesse sich mit dem Formular herausfinden, wer Mitglied ist.

Pro Zugang geht höchstens alle zehn Minuten ein neues Passwort hinaus. Sonst könnte jemand dich mit fortlaufend neuen Passwörtern aus deinem eigenen Konto aussperren.

Bevor freigeschaltet ist

Der Vorstand kann ein Freischaltdatum setzen und die Planung bis dahin vorbereiten. Meldest du dich vorher an, siehst du einen Countdown statt der Aufgabenliste. Vorstand und Admin kommen schon vorher hinein.

Startseite

Die Startseite zeigt dir auf einen Blick:

  • deine nächsten Einsätze mit Datum und Zeit,
  • deinen Stundenstand im Verhältnis zum Soll,
  • was du zur Bringliste zugesagt hast.

Ob der Stundenstand sichtbar ist, entscheidet der Vorstand über eine Einstellung.

Aufgaben übernehmen

Unter Aufgaben stehen die offenen Plätze, nach Anlass gruppiert. Gleichartige Plätze werden zusammengefasst: „Kasse, 09:00–12:00 · 3 frei“ statt dreier gleich aussehender Zeilen.

Das Eintragen läuft in zwei Schritten:

  1. Vormerken. Du tippst eine Aufgabe an, sie ist damit für dich reserviert. Andere sehen sie als vergeben.
  2. Einschreiben. Wenn du alles beisammen hast, bestätigst du mit einem Klick. Erst jetzt ist es verbindlich.

So kannst du dir mehrere Schichten in Ruhe zusammenstellen, ohne dass dir jemand dazwischenkommt. Eine Vormerkung läuft nach einer eingestellten Zeit von selbst ab – standardmässig nach einigen Minuten –, damit reservierte Plätze nicht ewig blockiert bleiben. Freigeben kannst du sie jederzeit selbst.

Der Knopf zum Einschreiben erscheint erst, wenn du mindestens eine Aufgabe gewählt hast.

Ist bei einem Anlass alles vergeben, steht er unter Vollständig besetzt mit einem Verweis auf die Einsatzliste: wer macht was, in zeitlicher Folge. Dort siehst du auch, wer mit dir Dienst hat. Ohne diese Liste verschwände ein durchgeplanter Anlass ganz von der Seite, obwohl er stattfindet.

Stundensoll

Viele Vereine erwarten von jedem Mitglied eine bestimmte Zahl an Helferstunden pro Saison. Das Soll errechnet sich aus der Gesamtzahl der Aufgabenstunden im Zeitraum, geteilt durch die Zahl der Mitglieder, die mitzählen. Einzelne Mitglieder lassen sich davon ausnehmen.

Der Zeitraum ist entweder ein Kalenderjahr oder ein frei gesetzter Bereich. Deine Vormerkungen zählen mit – sonst könntest du dich über das Soll hinaus eintragen, während die Bestätigung noch aussteht.

Ist die Sperre aktiv, kannst du dich nicht mehr selbst eintragen, sobald dein Soll erreicht ist. Der Vorstand kann dich weiterhin einteilen.

Bringliste

Nicht jeder Beitrag ist eine Schicht. Auf der Bringliste steht, was zu einem Anlass gebraucht wird – Kuchen, Salat, Festbänke. Du tippst einen Eintrag an und hast ihn damit übernommen. Gleichartige Einträge sind zusammengefasst: „3 × Kuchen, 1 offen“.

Ist alles vergeben, klappt der Anlass zu einer Zeile zusammen und zeigt nur noch Ganze Liste – wer bringt was mit.

Austragen kannst du dich normalerweise selbst. Der Vorstand kann das sperren; dann läuft es über ihn, damit kurz vor dem Anlass nicht stillschweigend Zusagen verschwinden.

Gepflegt wird die Liste auf der Seite des Anlasses – siehe Bringliste im Vorstandsteil.

Ersatz melden

Kannst du eine übernommene Schicht nicht wahrnehmen, meldest du auf der Startseite bei deinem Einsatz eine Ersatzperson mit Namen und Telefonnummer. Die Aufgabe bleibt auf dich gebucht – deine Stunden bleiben dir.

Die Ersatzperson bekommt sofort eine SMS mit Aufgabe, Datum und Zeit, und danach auch die Erinnerungen dazu – am Vorabend und eine Woche vorher. Sie hat keinen Zugang zum Helfertool; die SMS ist ihr einziger Draht dahin. Wechselst du den Ersatz oder nimmst die Meldung zurück, erfährt die bisherige Person, dass sie nicht mehr gebraucht wird.

Frag die Person vorher. Das Helfertool schickt ihr eine SMS, aber es fragt sie nicht – zugesagt hat sie damit noch nichts.

Zurücknehmen kannst du die Meldung, solange du dieselbe Schicht nicht inzwischen ein zweites Mal übernommen hast. Das ist erlaubt – die erste geht dich ja nichts mehr an –, aber danach führt ein Zurücknehmen zu zwei Einsätzen auf derselben Zeit. In diesem Fall kannst du nur noch eine andere Ersatzperson melden oder dich an die Vereinsverwaltung wenden; welche der beiden Schichten weichen soll, kann dir niemand abnehmen.

Profil und Passwort

Unter Profil änderst du dein Passwort und siehst deine hinterlegte Telefonnummer. Mehr steht dort nicht – deine Einsätze und die Ersatzmeldung liegen auf der Startseite. Die Nummer pflegt der Vorstand – sie ist der Weg, auf dem dich Einladungen und Erinnerungen erreichen.

Dort stellst du auch die Darstellung ein: hell, dunkel oder automatisch – letzteres folgt der Einstellung deines Geräts.

Als App einrichten

Das Helfertool lässt sich wie eine App auf den Startbildschirm legen. Dann startet es ohne Adresszeile und fühlt sich an wie eine installierte Anwendung.

  • iPhone: in Safari öffnen, Teilen-Symbol, „Zum Home-Bildschirm“.
  • Android: in Chrome öffnen, Menü, „App installieren“.

Für den Vorstand

Rollen

RolleDarf
Mitglied Sich eintragen, Bringliste übernehmen, Ersatz melden.
Vorstand Dasselbe, aber schon vor dem Freischaltdatum. Keine Verwaltungsrechte.
Admin Alles: Anlässe, Aufgaben, Mitglieder, Einstellungen, Protokoll.

„Vorstand“ ist bewusst keine Verwaltungsrolle. Sie gibt früheren Zugang, damit die Planung geprüft werden kann, bevor sie für alle offensteht – mehr nicht.

Anlässe

Unter Verwaltung legst du Anlässe an: Titel und Datum. Titel und Datum zusammen müssen eindeutig sein.

  • Bearbeiten. Verschiebst du das Datum, werden alle eingeteilten Personen benachrichtigt – einmal je Person, mit allen ihren Schichten.
  • Wiederholen. Legt den Anlass mit allen Aufgaben an einem neuen Datum an. Zuweisungen kommen bewusst nicht mit: eine Wiederholung wird neu besetzt.
  • Löschen. Geht nur, solange keine Aufgabe vergeben ist. Erst die Zuweisungen lösen – dann wissen die Betroffenen auch, dass sie nicht mehr gebraucht werden.

Aufgaben

Im Reiter Aufgaben legst du sie an: Titel, Beginn, Ende und eine Anzahl. Brauchst du drei Leute an der Kasse, gibst du die Anzahl 3 an und bekommst drei gleiche Plätze. Dazu kommt ein Info-Feld für alles, was die Person wissen muss – „Schlüssel beim Hauswart abholen“.

Schichten über Mitternacht sind erlaubt: Ende vor Beginn heisst, dass es am Folgetag endet. Die Stunden werden entsprechend gerechnet.

Zuweisen und lösen

Über Zuweisen setzt du eine Person direkt auf eine Aufgabe – ohne Rücksicht auf Soll oder Freischaltung. Wechselt eine Aufgabe die Person, erfahren beide davon: die neue, dass sie eingeteilt ist, die bisherige, dass sie nicht mehr gebraucht wird.

Freie Plätze einer Art lassen sich gesammelt löschen, wenn ihr weniger Leute braucht als geplant. Vergebene Plätze bleiben dabei unberührt.

Bringliste

Jeder Anlass hat drei Bereiche, oben als Reiter: Aufgaben, Bringliste und Anlass für Titel, Datum, Wiederholen und Löschen. Die Zahl am Reiter zeigt, wie viel dort steht.

  • Auf die Liste setzen. Titel, Anzahl und ein Hinweis. Die Anzahl legt entsprechend viele gleiche Einträge an – jeder für eine Person, damit sich drei Leute für „3 × Kuchen“ unabhängig eintragen können.
  • Zuweisen. Wie bei den Aufgaben. Wechselt eine Zusage die Person, erfahren es beide.
  • Umbenennen. Ändert einen einzelnen Eintrag.
  • Freie entfernen. Räumt zu viel Angelegtes weg, ohne bestehende Zusagen anzutasten.
  • Löschen. Geht auch bei einer bestehenden Zusage – ein abgesagter Anlass soll sich aufräumen lassen. Die Person wird benachrichtigt.

Mitglieder

Unter Verwaltung → Mitglieder pflegst du die Liste. Je Person: Benutzername, Telefonnummer, Rolle, und zwei Schalter – vom Soll ausnehmen und Selbsteintragen sperren.

  • Einladen. Setzt ein Einmalpasswort und schickt es per SMS. Ohne hinterlegte Telefonnummer geht das nicht – dann Passwort zurücksetzen und persönlich weitergeben.
  • Passwort zurücksetzen. Zeigt dir das neue Passwort einmalig an, ohne SMS.
  • Löschen. Entfernt die Person. Vergangene Einsätze bleiben in der Auswertung erhalten.

Das Passwort steht nie in einem Anmeldelink. Solche Links landen in Server-Protokollen, im Verlauf des Browsers und im Referrer der nächsten Seite. Die Empfängerin tippt es einmal ab.

Einstellungen

Vier Gruppen unter Verwaltung → Einstellungen.

Einsatzplanung

Dauer einer Vormerkung Wie lange ein reservierter Platz für jemanden stehen bleibt, bevor er wieder freigegeben wird.
Sperre bei erreichtem Soll Wer sein Soll erfüllt hat, trägt sich nicht mehr selbst ein. Zuweisen durch den Vorstand bleibt möglich.
Austragen aus der Bringliste Ist das gesperrt, entfernen nur Admins Zusagen – auch die eigenen.
Freischaltung für Mitglieder Datum, ab dem die Planung für alle offensteht. Bis dahin sehen Mitglieder einen Countdown.

Stundensoll

Stundenübersicht sichtbar Zeigt jedem den eigenen Stand im Verhältnis zum Soll.
Zeitraum Ein Kalenderjahr oder ein eigener Bereich mit Von- und Bis-Datum.

Benachrichtigungen

SMS versenden Der Hauptschalter. Ist er aus, wird nichts eingereiht.
Uhrzeit der Tageserinnerung Wann die tägliche Erinnerung hinausgeht.
Bei Zuweisungen benachrichtigen Sofortmeldung, wenn jemand eine Aufgabe bekommt, verliert oder sich selbst einträgt.

Technik

Anbindung des SMS-Modems und die Betriebsart. Im Testbetrieb gehen sämtliche Nachrichten an eine hinterlegte Testnummer statt an die Mitglieder – der sichere Weg, um Texte zu prüfen.

Vor einer Änderung an den Modem-Angaben: die Test-SMS unter Nachrichten ist der schnellste Weg zu prüfen, ob die Verbindung noch steht.

Protokoll

Unter Verwaltung → Protokoll steht, wer wann was getan hat – Zuweisungen, Änderungen an Anlässen, Anmeldungen, Einladungen. Nach Kategorie filterbar. Es ist der erste Ort, an dem du nachsiehst, wenn etwas unerwartet aussieht.

Nachrichten

Wann etwas hinausgeht

AnlassAn wen
Einladung oder Passwort vergessen Die betroffene Person, mit Benutzername und Einmalpasswort.
Zuweisung durch den Vorstand Die eingeteilte Person. Beim Wechsel zusätzlich die bisherige.
Zuweisung aufgehoben Die Person, die nicht mehr gebraucht wird.
Zeiten oder Info geändert Die eingeteilte Person. Ein berichtigter Titel löst nichts aus.
Anlass verschoben Alle Eingeteilten – eine Nachricht je Person, mit allen Schichten.
Selbst eingeschrieben Bestätigung an die Person. Mehrere Schichten ergeben eine Nachricht.
Bringliste übernommen oder ausgetragen Die betroffene Person, sofern sie es nicht selbst war.
Tageserinnerung Wer morgen dran ist – und wer in einer Woche dran ist.

Wer eine Änderung selbst auslöst, bekommt keine SMS darüber. Einzige Ausnahme ist das Einschreiben, wo die Bestätigung als Beleg dient. Die Erinnerung eine Woche vorher gibt es, damit noch Zeit bleibt, einen Ersatz zu suchen.

Warteschlange und Modem

Nachrichten werden nicht sofort verschickt, sondern eingereiht. Ein Hintergrundprozess arbeitet die Warteschlange ab. Scheitert eine Zustellung, wird sie mit wachsendem Abstand erneut versucht; nach drei Fehlversuchen bleibt sie als gescheitert stehen.

Unter Verwaltung → Nachrichten siehst du den Stand, kannst gescheiterte Nachrichten erneut anstossen und eine Test-SMS verschicken.

Eine SMS fasst 153 Zeichen je Teil, solange sie im GSM-Zeichensatz bleibt. Ein einziges Zeichen ausserhalb – ein Halbgeviertstrich etwa, wie ihn Textverarbeitungen gern einfügen – schaltet die ganze Nachricht auf Unicode um und damit auf 67 Zeichen je Teil. Das Helfertool ersetzt solche Zeichen beim Versand automatisch. Umlaute bleiben, die stehen im GSM-Zeichensatz.

Vereinsverwaltung

Die Stelle, an der Vereine entstehen und gepflegt werden. Sie liegt unter einer eigenen Domain und hat eigene Zugänge – getrennt von den Mitgliederkonten der Vereine. Ein Vereinsadmin kann diese Ebene nicht erreichen.

Verein anlegen

Unter Neuer Verein gibst du an: ein Kürzel (dient als Ordnername), die Domain, den Anzeigenamen und den Benutzernamen des ersten Admins. Angelegt werden dabei Datenbank, Schema und das Admin-Konto.

Das Passwort des Admins wird einmalig angezeigt. Danach ist es nicht mehr einsehbar – nur noch zurücksetzbar.

Ein neuer Verein ist erst erreichbar, wenn die Domain auch tatsächlich auf den Server zeigt und der Webserver sie kennt. Das geschieht ausserhalb der App.

Pflege und Sicherung

  • Stammdaten – Anzeigename und Domain ändern.
  • Stilllegen – der Verein bleibt bestehen, ist aber nicht mehr erreichbar. Für einen Verein, der pausiert.
  • Migrationen ausführen – bringt das Datenbankschema auf den neuesten Stand. Offene Migrationen werden angezeigt.
  • Sichern – legt sofort eine Sicherung an. Automatisch geschieht das ohnehin viertelstündlich.
  • Wiederherstellen – setzt die Datenbank auf den Stand einer Sicherung zurück.

Wiederherstellen überschreibt den aktuellen Stand. Alles seit der gewählten Sicherung ist danach fort.

Fernwartung

Auf der Seite eines Vereins steht Als Verwaltung betreten. Damit öffnest du den Verein mit Administratorrechten, ohne dort ein Konto zu haben.

Dabei gilt:

  • Du bekommst keine Mitgliedskennung. Was du tust, steht unter deinem Namen im Protokoll und fällt keinem Mitglied zur Last.
  • Ein Balken über der Seite zeigt durchgehend, dass du als Verwaltung unterwegs bist.
  • Verlassen beendet den Zutritt und bringt dich zurück auf die Seite des Vereins in der Verwaltung.

Technisch läuft der Zutritt über eine einmalige Freigabe, weil eine Sitzung immer nur für eine Domain gilt. Sie hält eine Minute, gilt genau einmal und ist an ihren Verein gebunden.

Betrieb

Der Arbeiter

Ein zweiter Prozess läuft dauerhaft und wird einmal je Minute tätig – für alle Vereine gemeinsam. Er kümmert sich um:

  • die SMS-Warteschlange,
  • abgelaufene Vormerkungen,
  • alte Sitzungen,
  • die Tageserinnerung zur eingestellten Zeit,
  • Sicherungen, viertelstündlich.

Sicherungen der letzten 24 Stunden bleiben vollständig erhalten, danach wird auf eine je Tag ausgedünnt.

Konsole

Was sich nicht über die Oberfläche erledigen lässt:

php bin/console tenant:add <kürzel> <domain> [name]
php bin/console tenant:import <kürzel> <domain> <pfad-zur-app.db>
php bin/console tenant:list
php bin/console migrate [kürzel]
php bin/console superadmin:add <benutzername>
php bin/console routes

tenant:import übernimmt eine bestehende Datenbank als Verein – der Weg, auf dem ein Altbestand hereinkommt. superadmin:add fragt das Passwort interaktiv ab, damit es nicht in der Shell-Historie landet.

Begriffe

Anlass Eine Veranstaltung mit Datum, zu der Aufgaben gehören.
Aufgabe Ein Helferplatz mit Zeitfenster. Mehrere gleiche Plätze werden zusammengefasst gezeigt.
Vormerkung Eine Aufgabe ist für jemanden reserviert, aber noch nicht verbindlich übernommen.
Soll Die Stundenzahl, die von jedem Mitglied im Zeitraum erwartet wird.
Bringliste Was zu einem Anlass mitgebracht wird, statt Zeit zu leisten.
Ersatz Eine gemeldete Vertretung. Die Stunden bleiben beim ursprünglich Eingeteilten.
Freischaltung Datum, ab dem die Planung für alle Mitglieder offensteht.

Die Vereinsverwaltung liegt unter /superadmin.