# Vereins Schichtplan – ausführliche Beschreibung

> Diese Datei beschreibt Zweck, Funktionen, Berechtigungen und Datenschutz des Vereins Schichtplans. Sie richtet sich an Suchmaschinen, Sprachmodelle und alle, die das Projekt genauer kennenlernen wollen. Massgebend für den Datenschutz ist die [Datenschutzerklärung](https://vereins-schichtplan.ch/datenschutz).

## 1. Projekt

- **Name**: Vereins Schichtplan
- **Website**: [vereins-schichtplan.ch](https://vereins-schichtplan.ch/)
- **Art**: Ehrenamtliche Open-Source-Web-App
- **Betrieb**: Unabhängiges, ehrenamtliches Projekt.
- **Zielgruppe**: Vereine, Festkomitees und die Organisationskomitees (OK) ihrer Anlässe. Der Verein wird von seiner Leitung mit E-Mail und Passwort eingerichtet; eintragen können sich danach alle Helfer*innen, auch Mitglieder, Eltern, Freunde und Leute aus anderen Vereinen.
- **Kosten**: Kostenlos (0 CHF), keine Abos, keine Transaktionsgebühren, keine Werbung.
- **Quellcode**: [GitHub-Repository](https://github.com/NelsStorch/schichtplan_v2)
- **Weitere Ausgaben**: dieselbe Software gibt es auch für andere Zielgruppen, mit eigener Domain und getrennten Daten (siehe Abschnitt 8).

## 2. Technik

- **Frontend**: Next.js 16 (App Router), React 19, Tailwind CSS 4, TypeScript
- **Komponenten**: gemeinsames Design-System (`@schichtplan/ui`), Progressive Web App (PWA)
- **Backend**: Fastify 5 mit TypeScript-REST-API
- **Datenbank**: PostgreSQL 17 mit Prisma 7
- **Zeitzone**: Alle Termine und Schichtzeiten laufen in **Europe/Zurich**. Server und Container laufen in UTC, die Umrechnung erfolgt automatisch.
- **Hosting**: Server bei Avoro (dataforest GmbH) in einem Rechenzentrum in Frankfurt am Main, Deutschland. Traefik als Reverse Proxy, TLS-Zertifikate von Let's Encrypt. Verschlüsselte Sicherungskopien liegen zusätzlich bei Google Drive und bei Infomaniak in der Schweiz; die Schlüssel hat nur das Projekt.

## 3. Datenschutz (nDSG)

In vielen Vereinen werden Helferlisten offen per Excel oder WhatsApp geteilt. Dann sehen alle die Handynummern und E-Mail-Adressen aller anderen.

Der Vereins Schichtplan trennt das:

- **Trennung nach Vereine**: Jeder Verein hat eine eigene Subdomain (`<verein>.vereins-schichtplan.ch`).
- **Öffentliche Helferlisten**: Helfer*innen sehen bei anderen nur Name bzw. Spitzname. Telefonnummern, Geburtsdaten und E-Mail-Adressen sind für sie nicht sichtbar.
- **Zugriff des OK**: Nur das berechtigte Organisationskomitee (OK) und die Vereinsleitung sehen Kontaktdaten, für Notfälle und die Einsatzkoordination.
- **Kein Werbe-Tracking**: Kein Google Analytics, kein Meta Pixel, keine Werbe-Cookies. Es gibt nur eine anonyme Nutzungsstatistik ohne Cookies.

## 4. Berechtigungen und Anmeldung

### A. Helfer*innen (ohne Konto)
- Tragen sich über den vom OK geteilten Link in wenigen Sekunden ein.
- Brauchen kein Passwort und kein Konto.
- Angaben: Vorname und Nachname (oder Spitzname), Handynummer für Notfälle und Geburtsdatum für die Altersprüfung.
- Können den Einsatz als Kalendereintrag übernehmen (.ics für Apple Kalender, Google Kalender, Outlook).

### B. Leitende und Anlass-OK (Login mit E-Mail und Passwort)
- Melden sich mit E-Mail-Adresse und Passwort an.
- Name und Verein werden beim Einrichten erfasst.
- Das OK verwaltet Schichten, sieht die Belegung live und kann Einteilungen bearbeiten.

### C. Vereinsleitung
- Richtet den Schichtplan des Vereins ein (eigene Subdomain).
- Verwaltet Einstellungen wie Farbe, Logo und Vorlagen.
- Kann Anlässe vergangener Jahre mit einem Klick als Vorlage übernehmen.

## 5. Funktionen im Detail

1. **Eintragen ohne Hürden**: Für das Handy gebaut, ohne App-Store-Download und ohne Passwort.
2. **Mindestalter**: Schichten können ein Mindestalter haben (z. B. 16 Jahre für Bier und Wein, 18 Jahre für Spirituosen an der Bar). Das Geburtsdatum wird bei der Eintragung automatisch geprüft.
3. **Vorlage vom Vorjahr**: Wiederkehrende Anlässe (jährliches Vereinsfest, Turnier, Dorffest) übernehmen alle Schichten mit einem Klick ins neue Jahr.
4. **Live-Übersicht**: Farbige Belegungsbalken zeigen sofort, welche Schichten noch frei sind.
5. **Mehrere Anlässe**: Mehrere Anlässe lassen sich gleichzeitig planen, jedes OK sieht seinen Anlass.
6. **PWA**: Bereits geladene Schichtpläne bleiben auch bei schwachem Netz im Festzelt oder Lagerhaus lesbar.

## 6. Einsatzbeispiele

- **Vereinsfest und Dorffest**: Schichten meist in Blöcken von 2 bis 3 Stunden, etwa «Aufbau», «Grill», «Getränke», «Kasse», «Bar» und «Abbau». Den Link teilt das OK im Gruppenchat oder als QR-Code auf dem Flyer.
- **Turniere**: Spielleitung, Festwirtschaft und Parkdienst werden für Mitglieder, Eltern und Freunde des Vereins freigegeben.
- **Jubiläen und Feste**: Helfereinteilung nach Rollen statt Zettelwirtschaft.

## 7. Wichtige Adressen

- [Startseite](https://vereins-schichtplan.ch/)
- [Zentraler Login](https://login.vereins-schichtplan.ch/)
- [Hilfe-Center](https://hilfe.vereins-schichtplan.ch/)
- [System-Status](https://status.vereins-schichtplan.ch/)
- [Datenschutzerklärung](https://vereins-schichtplan.ch/datenschutz)
- [GitHub-Repository](https://github.com/NelsStorch/schichtplan_v2)

## 8. Weitere Ausgaben

Dieselbe Software läuft für vier Zielgruppen, jeweils mit eigener Domain, eigenem Login und getrennten Daten. Neben diesem Angebot gibt es:

- [Cevi Schichtplan](https://cevi-schichtplan.ch/): für Cevi-Abteilungen
- [Pfadi Schichtplan](https://pfadi-schichtplan.ch/): für Pfadi-Abteilungen
- [Jubla Schichtplan](https://jubla-schichtplan.ch/): für Jubla-Scharen
