Admin-Funktionen
Rollenabhängig
Die Funktionen auf dieser Seite sind je nach Rolle unterschiedlich zugänglich. Die meisten erfordern mindestens die Rolle Archivar, einige Admin oder Eigentümer. Siehe Rollen-Übersicht.
Einstellungen-Tabs
Die Einstellungen sind in vier Tabs organisiert:
| Tab | Sichtbar ab | Inhalt |
|---|---|---|
| 👤 Konto | Alle | Profil, Passwort, Sicherheit (MFA/Passkeys) |
| 🎵 Notenarchiv | Archivar | Stimmen-/Genreverwaltung, Excel-Import |
| 🏛️ Organisation | Archivar | Vereinsname, Logo, KI-Konfiguration, Mitglieder, Einladungen |
| 📊 Abo & Verbrauch | Admin | Preisstufe, Limits, Speicherverbrauch |
Routenschutz
Geschützte Seiten sind nicht nur in der Navigation versteckt, sondern auch routenseitig geschützt. Wenn ein Benutzer ohne ausreichende Berechtigung eine geschützte URL direkt aufruft, wird er automatisch zum Dashboard umgeleitet.
Die eigentliche Sicherheit liegt in der serverseitigen Berechtigungsprüfung (Fastify-Middleware). Der Routenschutz im Frontend ist eine zusätzliche Ebene (Defense-in-Depth).
Aktivitätsprotokoll
Unter Admin → Protokoll in der Navigation findest du das vollständige Aktivitätsprotokoll (ab Rolle Admin). Es dokumentiert alle Aktionen in der App:
- Stücke erstellt, bearbeitet, gelöscht
- Dateien hochgeladen, gelöscht
- Stimmen zugeordnet, gelöscht
- Aufführungen erfasst
- Konzerte erstellt, bearbeitet
- Profil-Änderungen
Filter
Du kannst das Protokoll filtern nach:
| Filter | Optionen |
|---|---|
| Aktion | Erstellt, Bearbeitet, Gelöscht |
| Bereich | Stücke, Dateien, Stimmen, Aufführungen, Konzerte, Benutzer |
| Benutzer | Welcher Archivar die Aktion ausgeführt hat |
Pagination
Wähle wie viele Einträge pro Seite angezeigt werden: 25, 50 oder 100.
Detail-Anreicherung
Im Protokoll werden technische IDs automatisch durch lesbare Namen ersetzt. Statt einer kryptischen Record-ID siehst du z.B. "Kaiserjägermarsch (Seelos)".
Falls ein Stück bereits gelöscht wurde, steht stattdessen "[Gelöscht: abc123]".
Stücke verwalten
Ab der Rolle Archivar hast du vollen Zugriff auf:
- Neues Stück anlegen — Über den Notenkatalog oder die Stück-Detailansicht
- Stück bearbeiten — Über "Bearbeiten" in der Detailansicht
- Stück löschen — Über "Löschen" in der Detailansicht (mit Sicherheitsabfrage)
- Dateien löschen — Einzelne Dateien in der Detailansicht entfernen
- Stimmen löschen — Einzelne Stimmenblätter in der Detailansicht entfernen
Konzerte verwalten
- Neues Konzert — Über "Neues Konzert" in der Konzert-Übersicht
- Konzert bearbeiten — Setlist umbauen, Daten ändern
- Konzert löschen — Über "Löschen" in der Konzert-Detailansicht
- Aufführungen erfassen — Automatisch für alle Stücke der Setlist
Einstellungen
Unter Einstellungen (Avatar → Einstellungen) können berechtigte Benutzer die App konfigurieren.
Vereinsname & Logo
Im Tab 🏛️ Organisation können Admins und Eigentümer folgendes anpassen:
- Vereinsname — Wird in der Navigation, Login-Seite, PDFs und rechtlichen Hinweisen angezeigt
- Vereinslogo — Erscheint auf der Login-Seite und in PDF-Exporten (Setlist, Moderationsnotizen, Jahresauswertung)
Mitglieder verwalten
Im Tab 🏛️ Organisation (ab Rolle Admin) findest du die Mitgliederverwaltung:
- Mitgliederliste — Alle Benutzer deines Vereins mit Rolle und Status
- Rolle ändern — Klicke auf die Rolle eines Mitglieds, um sie zu ändern (du kannst keine Rolle vergeben, die höher als deine eigene ist)
- Mitglied entfernen — Entfernt den Benutzer aus dem Verein
Einladungen
Neue Mitglieder werden per E-Mail-Einladung hinzugefügt (ab Rolle Admin):
- Gib die E-Mail-Adresse und die gewünschte Rolle ein
- Klicke auf Einladen
- Der Eingeladene erhält eine E-Mail mit einem Link zur Registrierung
Offene Einladungen können eingesehen und widerrufen werden.
Stimmen- & Genreverwaltung
Im Tab 🎵 Notenarchiv (ab Rolle Archivar) können die verfügbaren Stimmen (Instrumente) und Genres für den Verein angepasst werden. Genres sind nicht mehr fest vorgegeben, sondern können frei erstellt, umbenannt und gelöscht werden.
KI-Konfiguration
Pultwerk unterstützt verschiedene KI-Anbieter für die intelligenten Funktionen:
- Stimmenzuordnung — Beim Notenupload erkennt die KI automatisch, welche Seite zu welchem Instrument gehört
- Moderationstexte — Generiert Ansagetexte für Konzerte auf Basis der Stückinfos
- Metadaten-Vorschläge — KI schlägt Komponist, Genre, Schwierigkeit etc. vor
- QuickScan — Notenblatt fotografieren und Stück identifizieren (nur Premium)
Unter Einstellungen → Organisation → KI-Konfiguration kannst du folgende Optionen festlegen:
| Einstellung | Beschreibung |
|---|---|
| Anbieter | Google Gemini (Standard) oder OpenAI-kompatibel |
| API Key | Der API-Schlüssel des gewählten Anbieters |
| Modell | Modellname (leer = Standard: gemini-2.5-flash bzw. gpt-4o) |
| Base URL | Nur bei OpenAI-kompatibel: API-Endpunkt (z.B. https://api.openai.com/v1) |
Unterstützte Anbieter
| Anbieter | Anbieter-Typ | Base URL | Beispiel-Modell |
|---|---|---|---|
| Google Gemini | Gemini | (automatisch) | gemini-2.5-flash |
| OpenAI | OpenAI-kompatibel | https://api.openai.com/v1 | gpt-4o |
| Mistral | OpenAI-kompatibel | https://api.mistral.ai/v1 | mistral-large-latest |
| Ollama (lokal) | OpenAI-kompatibel | http://localhost:11434/v1 | llama3 |
| LM Studio (lokal) | OpenAI-kompatibel | http://localhost:1234/v1 | (automatisch) |
Kostenlos mit Gemini
Die Gemini API ist im kostenlosen Tier für diese Nutzung ausreichend. Lokale Modelle (Ollama, LM Studio) sind komplett kostenlos.
Gemini API-Key erstellen
- Öffne Google AI Studio
- Melde dich mit einem Google-Konto an
- Klicke auf „API-Schlüssel erstellen" (Create API key)
- Wähle ein bestehendes Google Cloud Projekt oder erstelle ein neues
- Der Key wird angezeigt — kopiere ihn (beginnt mit
AIzaSy...) - In Pultwerk: Einstellungen → KI-Konfiguration → API Key einfügen und speichern
Sicherheit
Der API-Key wird serverseitig verarbeitet. Er wird nie an den Browser der Benutzer ausgeliefert — alle KI-Anfragen laufen über den Server.
Ohne API-Key
Wenn kein API-Key hinterlegt ist, funktioniert die App weiterhin vollständig. Die KI-Features fallen auf einfachere Offline-Methoden zurück:
- Stimmenzuordnung: Per Fuzzy-Matching der OCR-Texte (weniger genau)
- Moderationstexte: Nicht verfügbar
Preisstufen & Limits
Im Tab 📊 Abo & Verbrauch (ab Rolle Admin) siehst du den aktuellen Verbrauch und die Limits deiner Preisstufe:
| Feature | Basic | Standard | Premium |
|---|---|---|---|
| Stücke | 100 | 1.000 | Unbegrenzt |
| Benutzer | 3 | 20 | Unbegrenzt |
| Konzerte | 5 | 50 | Unbegrenzt |
| Notenmappen | 2 | 20 | Unbegrenzt |
| Speicher | 500 MB | 5 GB | 50 GB |
| PDF-Export | — | ✓ | ✓ |
| Excel-Import | — | ✓ | ✓ |
| KI-Anfragen/Monat | 5 | 100 | 500 |
| Probenmodus | — | — | ✓ |
| QuickScan | — | — | ✓ |
Versionshistorie
Unter Changelog (erreichbar über die Einstellungen oder das Profil-Menü) findest du eine Übersicht aller Versionen und was sich jeweils geändert hat. Die aktuell installierte Version wird hervorgehoben.