.. _songs: Song-Datenbank ============== Die Song-Datenbank enthält das gesamte Repertoire der Band. Admins und Editors können Songs anlegen, bearbeiten und archivieren. .. image:: ../_static/screenshots/songs_overview.png :alt: Gigs Detail Screenshot :width: 500px :align: center Song anlegen ------------ Klicke auf **+ Neuer Song**, um das Formular zu öffnen. .. list-table:: :header-rows: 1 :widths: 25 75 * - Feld - Beschreibung * - **Titel** - Offizieller Songtitel * - **Interpret** - Ursprünglicher Interpret * - **Komponist** - Name(n) der Komponisten (für GEMA-Export) * - **Texter** - Name(n) der Texter (für GEMA-Export) * - **Bearbeiter** - Name des Bearbeiters (falls eigenes Arrangement) * - **Verlag** - Musikverlag (für GEMA-Export) * - **Tonart** - Tonart des Songs (z. B. „Am“, „G“, „C#“) * - **Dauer** - Spielzeit in Minuten:Sekunden (z. B. ``3:45``) * - **Genre** - Genre aus der konfigurierten Liste (siehe :ref:`configuration`) * - **Status** - Aktueller Status im Workflow (s. u.) * - **Sänger** - Hauptsänger aus der Sängerliste .. image:: ../_static/screenshots/songs_new.png :alt: Song Formular Screenshot :width: 500px :align: center .. tip:: Beim Ausfuellen von **Titel** und **Interpret** erfolgt direkt im Formular eine Live-Pruefung auf wahrscheinliche Dubletten (inklusive kleiner Schreibfehler oder Abweichungen). Wenn ein aehnlicher Song bereits existiert, erscheint unter dem Feld **Interpret** ein Warning-Hinweis mit dessen Status. Das Speichern bleibt trotzdem moeglich. Status-Workflow --------------- .. list-table:: :header-rows: 1 :widths: 25 75 * - Status - Bedeutung * - **vorschlag** - Song wurde vorgeschlagen, aber noch nicht bewertet * - **angenommen** - Song ist grundsätzlich akzeptiert * - **proben** - Song wird aktiv geprobt * - **spielbar** - Song ist bühnenreif – erscheint im Setlist-Editor * - **bedarfsweise_proben** - Song ist spielbar, wird aber bei Bedarf nochmals geprobt .. note:: Nur Songs mit Status **spielbar** oder **bedarfsweise_proben** erscheinen im Setlist-Editor. Filtern und Suchen ------------------ * Status (Mehrfachauswahl) * Genre * Sänger * Freitextsuche (Titel / Interpret) CSV-Export der aktuellen Songtabelle ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ Im Songs-Tab steht ein CSV-Export zur Verfügung, der den **aktuellen Tabellenstand** exportiert: * aktive Filter * aktuelle Sortierung * aktuell sichtbare Spalten Dadurch entspricht die exportierte Datei genau der gerade angezeigten Ansicht. Repertoire-Listen ----------------- Im zusätzlichen Tab **Repertoire-Listen** können unabhängige Listen aus dem Song-Repertoire angelegt und verwaltet werden. Jeder Benutzer kann eigene Repertoire-Listen anlegen. Jede Liste ist dabei einem Benutzer zugeordnet und besitzt zusätzlich eine Sichtbarkeitseigenschaft: * **öffentlich** – alle Nutzer können die Liste sehen und bearbeiten * **privat** – nur der Eigentümer (und Admins) kann die Liste sehen und bearbeiten Beim Anlegen einer Liste kann der Benutzer den Namen der Liste direkt festlegen sowie mit einem Haken entscheiden, ob die Liste öffentlich oder privat sein soll. Der Name und die Sichtbarkeit können nachträglich jederzeit geändert werden. Funktionen: * Liste anlegen, umbenennen und löschen * Sichtbarkeit nachträglich zwischen **öffentlich** und **privat** umschalten * Liste im Setlist-Editor öffnen * Liste direkt im Songs-Bereich anzeigen * Export als **PDF** (gleiches Setlisten-Template wie Gig-Setlisten) * Export als **CSV** Repertoire-Listen sind nicht an einen Gig gekoppelt und werden separat in der Datenbank gespeichert. .. note:: Eine öffentlich sichtbare Liste kann von jedem Benutzer bearbeitet werden. Eine private Liste bleibt nur für den Eigentümer sichtbar; andere Nutzer sehen sie nicht und können sie auch nicht ändern. Song-Details und Statistiken ----------------------------- Ein Klick auf einen Song öffnet die Detailansicht mit: * Alle Felder des Songs * **Proben-Historie:** Wie oft und wann wurde der Song geprobt? * **Gig-Historie:** Bei welchen Auftritten wurde der Song gespielt, mit Bewertungen? * **Feedback-Verteilung:** Balkendiagramm der Bewertungen aus dem Live-Modus * **Häufige Begleiter:** Welche anderen Songs erscheinen am häufigsten in derselben Setlist? .. image:: ../_static/screenshots/songs_details.png :alt: Songs Detail Screenshot :width: 500px :align: center Song-Vorschläge & Abstimmung ----------------------------- Neu eingereichte Songs erhalten zunächst den Status **vorschlag** und erscheinen im Tab **Vorschläge** der Song-Seite. Dort können alle stimmberechtigten Bandmitglieder (Musiker) ihr Votum abgeben, bevor ein Song offiziell übernommen wird. .. image:: ../_static/screenshots/songs_vorschlaege.png :alt: Songs Vorschläge Screenshot :width: 500px :align: center Abstimmen ~~~~~~~~~ Jedes Mitglied mit dem Flag **Musiker** kann pro Song eine von drei Stimmen abgeben: .. list-table:: :widths: 15 85 * - 👍 - **Ja** – ich möchte den Song ins Repertoire aufnehmen * - 👎 - **Nein** – ich bin gegen die Aufnahme * - 🤷 - **Enthaltung** – ich habe keine Meinung / möchte mich enthalten Dieselbe Schaltfläche nochmals klicken zieht die Stimme zurück. Abstimmungsergebnis auf einen Blick ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ Das Ergebnis wird je Song als kompakte Badge-Zeile angezeigt: * **∑ x / y** – abgegebene Stimmen (Ja + Nein + Enthaltung) von y Stimmberechtigten gesamt * **(n f. Quorum)** – Hinweis, wie viele Stimmen noch für das Quorum fehlen * 👍 **n (xx %)** – absolute und relative Anzahl der Ja-Stimmen * 👎 **n (xx %)** – absolute und relative Anzahl der Nein-Stimmen * 🤷 **n** – Enthaltungen (werden nur angezeigt, wenn mindestens eine vorliegt) Freigabe-Kriterien ~~~~~~~~~~~~~~~~~~ Der **✓-Button** erscheint für Admins und Editoren, sobald gleichzeitig gilt: 1. Mindestens **75 % aller Stimmberechtigten** haben abgestimmt (Quorum – Enthaltungen zählen mit). 2. Der Ja-Anteil unter den gültigen Stimmen (Ja + Nein) beträgt **≥ 50 %**. .. note:: Das Quorum wird berechnet als ``max(3, floor(Anzahl Musiker × 0,75))``. Bei 4 Musikern sind das mindestens 3 Stimmen, bei 8 Musikern mindestens 6. Song übernehmen ~~~~~~~~~~~~~~~ Sind alle Kriterien erfüllt, erscheint für **Admins und Editoren** ein grüner **✓-Button** in der Aktionsspalte. Ein Klick übernimmt den Song offiziell und setzt seinen Status auf **angenommen**. Solange das Quorum nicht erreicht ist, wird kein Button angezeigt. Persönliche Abstimmung ~~~~~~~~~~~~~~~~~~~~~~ Wurde in einer Probe direkt per Handzeichen abgestimmt, kann ein Admin/Editor den Song ohne digitale Abstimmung direkt als **angenommen** eintragen – vorausgesetzt, die anwesenden Stimmberechtigten haben mehrheitlich zugestimmt (Enthaltungen zählen nicht).