project documentary

man/pages/veranstaltung-details.md

@@ -0,0 +1,216 @@
+# Veranstaltungsdetails
+
+## Zweck
+
+Die Veranstaltungsdetails sind der zentrale Arbeitsbereich für eine einzelne Veranstaltung. Hier siehst du Datum, Art, Status, Besitzer, Liedliste und alle Aktionen, die für diese Veranstaltung möglich sind.
+
+Auf dieser Seite bereitest du die Liedreihenfolge vor, fügst Lieder hinzu, passt Lieder für genau diese Veranstaltung an, veröffentlichst die Veranstaltung, teilst sie, erledigst die CCLI-Meldung und lädst Dokumente herunter.
+
+## Berechtigung
+
+Die Detailseite kann von berechtigten Benutzern geöffnet werden, wenn sie Zugriff auf Veranstaltungen haben.
+
+Einige Aktionen sind zusätzlich eingeschränkt:
+
+- **Archivieren**, **Wiederherstellen**, **Veröffentlichen**, **Veröffentlichung zurückziehen**, **Teilen**, **CCLI** und **Ändern** sind nur für **Lobpreisleiter** sichtbar, die Besitzer dieser Veranstaltung sind.
+- **Ändern** ist nur bei unveröffentlichten Veranstaltungen sichtbar.
+- **Herunterladen** ist auf der Detailseite als allgemeine Aktion verfügbar.
+- Veröffentlichte Veranstaltungen sind weitgehend geschützt: Reihenfolge, Kopfdaten und Lieder können dann nicht mehr wie in einem Entwurf bearbeitet werden.
+
+## Seitenelemente
+
+### Kopfbereich
+
+Oben steht die Art der Veranstaltung, das Datum und der Status, zum Beispiel **entwurf**, **veröffentlicht** oder **gemeldet**.
+
+Darunter siehst du:
+
+- ob die Veranstaltung **öffentlich** oder **geschlossen** ist
+- wer die Veranstaltung erstellt hat
+- bei eigenen Veranstaltungen den Veröffentlichungsstatus
+- bei eigenen Veranstaltungen den CCLI-Meldestatus, falls relevant
+
+### Öffentliche und geschlossene Veranstaltungen
+
+Eine **öffentliche Veranstaltung** ist für die Veröffentlichung und gegebenenfalls für eine CCLI-Meldung relevant. Wenn in einer öffentlichen Veranstaltung CCLI-pflichtige Lieder verwendet werden, erscheint nach dem Veröffentlichen die Aufgabe **CCLI**.
+
+Eine **geschlossene Veranstaltung** ist nicht öffentlich. Beim Veröffentlichen wird sie als veröffentlicht markiert, aber normalerweise ist keine CCLI-Meldung notwendig.
+
+### Liedliste
+
+Die Liedliste zeigt alle Lieder der Veranstaltung in der geplanten Reihenfolge. Je nach Zustand der Veranstaltung kannst du:
+
+- die Reihenfolge per Ziehen ändern
+- die Tonart eines Liedes für diese Veranstaltung ändern
+- den Liedtext für diese Veranstaltung bearbeiten
+- ein Lied aus der Veranstaltung entfernen
+- Liedtexte ein- oder ausblenden
+
+Bei veröffentlichten Veranstaltungen ist die Liedliste nicht mehr frei bearbeitbar.
+
+### Text anzeigen
+
+Mit **Text anzeigen** blendest du die Liedtexte ein. Dann siehst du die Texte und, je nach Einstellung des Liedes, auch Akkorde.
+
+Solange **Text anzeigen** aktiv ist, ist die Reihenfolge nicht per Ziehen änderbar. Schalte die Textanzeige aus, wenn du die Liedreihenfolge anpassen möchtest.
+
+### Anzeige- und Vollbildaktionen
+
+Über die Symbole im Kopfbereich kannst du:
+
+- den Text vergrößern
+- den Text verkleinern
+- die Vollbildansicht öffnen oder schließen
+
+In der Vollbildansicht wird jedes Lied einzeln angezeigt. Zusätzlich siehst du die Uhrzeit und, wenn vorhanden, den nächsten Liedtitel. Mit den Pfeiltasten kannst du durch die Lieder wechseln.
+
+### Lied hinzufügen
+
+Bei unveröffentlichten Veranstaltungen erscheint unten **Lied hinzufügen...**. Dort kannst du ein Lied suchen und zur Veranstaltung hinzufügen.
+
+Das hinzugefügte Lied wird am Ende der aktuellen Reihenfolge eingefügt.
+
+### Aktionsleiste
+
+Je nach Berechtigung und Status siehst du diese Aktionen:
+
+- **Archivieren**
+- **Wiederherstellen**
+- **Veröffentlichen**
+- **Veröffentlichung zurückziehen**
+- **Teilen**
+- **CCLI**
+- **Ändern**
+- **Herunterladen**
+
+Unter **Herunterladen** stehen zwei Varianten:
+
+- **Ablauf für Lobpreisgruppe**
+- **Handout mit Copyright Infos**
+
+## Schritt-für-Schritt-Aktionen
+
+### Liedreihenfolge ändern
+
+1. Öffne eine unveröffentlichte eigene Veranstaltung.
+2. Stelle sicher, dass **Text anzeigen** ausgeschaltet ist.
+3. Greife ein Lied am Verschiebebereich.
+4. Ziehe es an die gewünschte Position.
+5. Lass es los.
+
+Die neue Reihenfolge wird für die Veranstaltung übernommen.
+
+### Lied hinzufügen
+
+1. Öffne eine unveröffentlichte eigene Veranstaltung.
+2. Gehe zum Feld **Lied hinzufügen...**.
+3. Öffne die Auswahl.
+4. Suche nach dem gewünschten Lied.
+5. Wähle das Lied aus.
+
+Das Lied erscheint anschließend in der Liedliste.
+
+### Tonart für ein Lied ändern
+
+1. Öffne eine unveröffentlichte Veranstaltung.
+2. Suche das Lied in der Liste.
+3. Klicke auf die angezeigte Tonart.
+4. Wähle die gewünschte Tonart aus.
+
+Die Änderung gilt für dieses Lied in dieser Veranstaltung.
+
+### Liedtext für diese Veranstaltung bearbeiten
+
+1. Öffne eine unveröffentlichte Veranstaltung.
+2. Klicke beim Lied auf **Lied für diese Veranstaltung bearbeiten**.
+3. Passe den Text an.
+4. Klicke auf **Speichern**.
+
+Mit **Verwerfen** verlässt du die Bearbeitung ohne Übernahme. Die Bearbeitung betrifft nur diese Veranstaltung, nicht den allgemeinen Liedbestand.
+
+### Lied aus der Veranstaltung entfernen
+
+1. Öffne eine unveröffentlichte Veranstaltung.
+2. Suche das Lied in der Liste.
+3. Klicke auf **Lied aus Veranstaltung entfernen**.
+
+Das Lied wird aus dieser Veranstaltung entfernt.
+
+### Veranstaltung veröffentlichen
+
+1. Prüfe Liedauswahl und Reihenfolge.
+2. Klicke auf **Veröffentlichen**.
+3. Die Veranstaltung wird als veröffentlicht markiert.
+
+Wenn es sich um eine öffentliche Veranstaltung mit CCLI-pflichtigen Liedern handelt, erscheint danach der Status **nicht gemeldet** und die Aktion **CCLI**.
+
+### Veröffentlichung zurückziehen
+
+1. Öffne eine veröffentlichte eigene Veranstaltung.
+2. Klicke auf **Veröffentlichung zurückziehen**.
+3. Die Veranstaltung wird wieder unveröffentlicht.
+
+Danach können Vorbereitungsschritte wieder bearbeitet werden.
+
+### Veranstaltung teilen
+
+1. Veröffentliche die Veranstaltung.
+2. Klicke auf **Teilen**.
+3. Es öffnet sich ein Dialog mit Link und QR-Code.
+4. Nutze **Teilen**, um den Link weiterzugeben, oder kopiere den angezeigten Link.
+5. Schließe den Dialog mit **Schließen**.
+
+Der Link führt zur Gastansicht der Veranstaltung.
+
+### CCLI-Meldung abschließen
+
+1. Veröffentliche eine öffentliche Veranstaltung.
+2. Wenn **CCLI** erscheint, klicke auf **CCLI**.
+3. Lies die Liste der CCLI-Titel und CCLI-Nummern.
+4. Öffne die Meldelinks zu den Titeln.
+5. Melde die Titel im CCLI-Portal.
+6. Klicke danach auf **Alle CCLI-Titel wurden gemeldet**.
+
+Die Veranstaltung wird anschließend als gemeldet markiert. Klicke nicht auf diese Bestätigung, bevor die Meldung wirklich erfolgt ist.
+
+### Veranstaltung archivieren
+
+1. Öffne eine eigene Veranstaltung.
+2. Klicke auf **Archivieren**.
+3. Lies den Hinweis im Dialog.
+4. Bestätige mit **Archivieren** oder brich mit **Abbrechen** ab.
+
+Archivierte Veranstaltungen verschwinden aus den normalen Listen. Du findest eigene archivierte Veranstaltungen wieder über den Filter **Archiviert** in der [Veranstaltungsliste](veranstaltungen-liste.md).
+
+### Veranstaltung wiederherstellen
+
+1. Aktiviere in der Veranstaltungsliste den Filter **Archiviert**.
+2. Öffne die archivierte Veranstaltung.
+3. Klicke auf **Wiederherstellen**.
+
+Die Veranstaltung erscheint danach wieder ohne Archiv-Filter.
+
+### Dokument herunterladen
+
+1. Öffne die Veranstaltung.
+2. Klicke auf **Herunterladen**.
+3. Wähle **Ablauf für Lobpreisgruppe**, wenn du einen Ablauf mit Liedtexten und Akkorden brauchst.
+4. Wähle **Handout mit Copyright Infos**, wenn du ein Handout ohne Akkorde, aber mit Copyright-Informationen brauchst.
+
+## Hinweise und Fehlervermeidung
+
+- Veröffentliche erst, wenn Datum, Veranstaltungstyp, Liedauswahl und Reihenfolge stimmen.
+- Ziehe die Veröffentlichung zurück, wenn du nachträglich größere Änderungen am Ablauf vornehmen musst.
+- Die CCLI-Meldung ist nur dann abgeschlossen, wenn die Titel tatsächlich im CCLI-Portal gemeldet wurden.
+- Bei öffentlichen Veranstaltungen mit CCLI-pflichtigen Liedern bleibt die Veranstaltung in **Meine Veranstaltungen** sichtbar, bis die Meldung abgeschlossen ist.
+- Archiviere nur Veranstaltungen, die im normalen Alltag nicht mehr gebraucht werden.
+- Prüfe vor dem Teilen, ob die Liedreihenfolge stimmt. Gäste sehen die geteilte Veranstaltung in der vorbereiteten Reihenfolge.
+- Wenn du die Reihenfolge nicht ändern kannst, ist entweder die Veranstaltung veröffentlicht oder **Text anzeigen** ist eingeschaltet.
+
+## Links
+
+- [Veranstaltungsliste](veranstaltungen-liste.md)
+- [Veranstaltung anlegen](veranstaltung-anlegen.md)
+- [Veranstaltung bearbeiten](veranstaltung-bearbeiten.md)
+- [Gastansicht](gastansicht.md)
+- [Berechtigungen und Rollen](../berechtigungen.md)