# Pfadi Schichtplan – ausführliche Beschreibung

> Diese Datei beschreibt Zweck, Funktionen, Berechtigungen und Datenschutz des Pfadi 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://pfadi-schichtplan.ch/datenschutz).

## 1. Projekt

- **Name**: Pfadi Schichtplan
- **Website**: [pfadi-schichtplan.ch](https://pfadi-schichtplan.ch/)
- **Art**: Ehrenamtliche Open-Source-Web-App
- **Betrieb**: Unabhängiges, ehrenamtliches Projekt. Kein offizielles Angebot von Pfadibewegung Schweiz (PBS).
- **Zielgruppe**: Pfadi-Abteilungen und die Organisationskomitees (OK) ihrer Anlässe. Eine Abteilung richtet ihre Abteilungsleitung mit PBS MiData-Login ein; eintragen können sich danach alle Helfer*innen, auch Eltern, Ehemalige 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 Pfadi Schichtplan trennt das:

- **Trennung nach Abteilungen**: Jede Abteilung hat eine eigene Subdomain (`<abteilung>.pfadi-schichtplan.ch`).
- **Öffentliche Helferlisten**: Helfer*innen sehen bei anderen nur Name bzw. Pfadiname. Telefonnummern, Geburtsdaten und E-Mail-Adressen sind für sie nicht sichtbar.
- **Zugriff des OK**: Nur das berechtigte Organisationskomitee (OK) und die Abteilungsleitung 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 Pfadiname), 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 PBS MiData)
- Melden sich mit ihren Zugangsdaten der PBS MiData (Hitobito) (betrieben von Pfadibewegung Schweiz (PBS)) per OAuth 2.0 an.
- Name, Pfadiname, Rollen und Abteilung werden übernommen.
- Das OK verwaltet Schichten, sieht die Belegung live und kann Einteilungen bearbeiten.

### C. Abteilungsleitung
- Richtet den Schichtplan der Abteilung 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 Pfingstlager, SoLa, Abteilungsfest) ü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

- **Abteilungsfest 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.
- **Pfingstlager (PfiLa) und Sommerlager (SoLa)**: Kochteams, Materialtransporte und Fahrdienste werden für Eltern und Ehemalige freigegeben.
- **Jubiläen und Waldweihnachten**: Helfereinteilung nach Rollen statt Zettelwirtschaft.

## 7. Wichtige Adressen

- [Startseite](https://pfadi-schichtplan.ch/)
- [Zentraler Login](https://login.pfadi-schichtplan.ch/)
- [Hilfe-Center](https://hilfe.pfadi-schichtplan.ch/)
- [System-Status](https://status.pfadi-schichtplan.ch/)
- [Datenschutzerklärung](https://pfadi-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
- [Jubla Schichtplan](https://jubla-schichtplan.ch/): für Jubla-Scharen
- [Vereins Schichtplan](https://vereins-schichtplan.ch/): für Vereine & Festkomitees
