# Jubla Schichtplan – ausführliche Beschreibung

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

## 1. Projekt

- **Name**: Jubla Schichtplan
- **Website**: [jubla-schichtplan.ch](https://jubla-schichtplan.ch/)
- **Art**: Ehrenamtliche Open-Source-Web-App
- **Betrieb**: Unabhängiges, ehrenamtliches Projekt. Kein offizielles Angebot von Jungwacht Blauring Schweiz (Jubla).
- **Zielgruppe**: Jubla-Scharen und die Organisationskomitees (OK) ihrer Anlässe. Eine Schar richtet ihre Scharleitung mit Jubla-DB-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 Jubla Schichtplan trennt das:

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

### C. Scharleitung
- Richtet den Schichtplan der Schar 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 Sommerlager, Scharfest, Pfarreianlässe) ü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

- **Scharfest 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.
- **Lager**: Kochteams, Materialtransporte und Fahrdienste werden für Eltern und Ehemalige freigegeben.
- **Jubiläen und Feste**: Helfereinteilung nach Rollen statt Zettelwirtschaft.

## 7. Wichtige Adressen

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