sendewerk/docs/RELEASE_NOTES.md

# Release Notes

## 0.7.1 - Bedienung und Live-Korrekturen

Veröffentlicht am 25. Oktober 2026, Korrekturstand 26. Oktober 2026

- Live-Abschnittszeiten übernehmen geänderte Plandauern. Frühere erledigte oder
  übersprungene Pieces können offiziell wiederaufgenommen werden, ohne ihre
  Abschnittslaufzeit oder die Gesamtzeit zurückzusetzen (#1).
- Mobiler Live-Ablauf, lange Metadaten und Sendungskarten halten ihre verfügbare
  Breite ein. Der Ablauf bleibt als fokussierbares Sheet bedienbar (#3, #5, #13).
- „Noch vorzubereiten“ speichert Status und Aufwand an der konkreten Einplanung,
  priorisiert aktive Sendungen nach Termin und verlinkt mit den Themenicons direkt
  in den Usage-Editor. Vorbereitende Originale können regulär eingeplant werden;
  Mehrfachverwendungen bleiben unabhängig (#6, #15).
- Fundus- und Usage-Editor unterscheiden Text, Nur Bild, Linkvorschau und Video
  durch kontextsensitive Eingaben und passende Vorschauen (#8).
- Gast- und historische Abschnitte besitzen klar gepolsterte äußere Glaskarten.
  Die Freigabeverwaltung liegt direkt vor dem Werkzeugkatalog; der gemeinsame
  Dialog und seine Formfelder folgen ohne nativen Doppelrahmen dem Sendewerk-
  Design. Einmalige Links lassen sich kopieren und sicher ersetzen (#11, #12).
- Die Iconsuche ist nach dem Öffnen sofort sichtbar und fokussiert (#14).
- RSS-Feeds und technische Zugänge verwenden in der Verwaltung kompakte
  Hinzufügen-Einstiege und dieselbe visuelle Listenlogik wie der Werkzeugkatalog.
- Mobiles Live-Sheet und Backdrop sind am Viewport verankert. Viewport-Fit,
  Standalone-Metadaten und Web-App-Manifest aktivieren iOS-Safe-Areas; ein echter
  Safari-/Home-Bildschirm-Test bleibt mangels Gerät offen (#3, #13).
- Paket, Lockdatei und Cloudron-Manifest tragen Version `0.7.1`. Migration
  `0019_usage_preparation.sql` ergänzt additive Usage-Snapshots. 60
  Verhaltenstests und 19 Chromium-Abläufe sind
  erfolgreich; echtes Safari und die installierte Webapp auf iOS bleiben offen.

## 0.7.0 - RSS-Import und externe Assistenz

Veröffentlicht am 25. Oktober 2026

- Barkeeper verwalten RSS-/Atom-Feeds mit Intervall und Standardkategorie;
  sichere manuelle und geplante Abrufe laufen fehlerisoliert.
- Neue Beiträge landen in einem getrennten Auswahlbereich im Eingang. Erst eine
  bewusste Übernahme erzeugt Pieces, während dauerhaftes Verwerfen, Herkunft,
  Kategorien und Dublettenschutz erhalten bleiben.
- Abrufe sperren interne Ziele und begrenzen Ports, Redirects, Laufzeit,
  Antwortgröße und Eintragszahl. Fremdes Feed-HTML wird zu Text bereinigt.
- Die versionierte REST-API `/api/v1` liest und ändert Pieces, Sendungen und
  Einplanungen über getrennte technische Lese- oder Schreibzugänge.
- Technische Tokens werden nur einmal gezeigt und gehasht gespeichert. Widerruf,
  Audit-Ereignisse, Revisionen und persistente Idempotenz schützen Änderungen.
- `/api/v1/openapi.json` beschreibt die Schnittstelle für externe Clients.
  Sendewerk bleibt ohne KI nutzbar; eine konkrete ChatGPT-/Codex-Anbindung ist
  weiterhin offen.
- Migration `0018_rss_and_api.sql` ergänzt Feed-, Zugangs-, Audit- und
  Idempotenzdaten. Paket, Lockdatei und Cloudron-Manifest tragen Version `0.7.0`.

## 0.6.1 - Redaktionelle Wartung

Veröffentlicht am 25. Oktober 2026

- Live-Countdowns übernehmen geänderte Abschnittsplanzeiten, ohne Laufzeit zu verlieren; die mobile Regie gruppiert ihre Kopfaktionen robuster und zeigt den Ablauf als oberstes Sheet.
- Mobile Formularfelder und die Iconsuche vermeiden iOS-Fokuszoom; Sendungskarten und Gastansicht erhalten klarere Abstände.
- Pieces führen optionalen Vorbereitungsaufwand, die Sendungsübersicht bündelt offene Vorbereitung und Abschnitte speichern kopierbare Twitch-Tags.
- Präsentationen können ein ausdrücklich gewähltes Bild ohne Begleittext ausgeben; Originale und Sendungsfassungen bleiben getrennte Snapshots.
- Lesefreigaben öffnen in Sendung, Verwaltung und Live-Regie über denselben Dialog.
- Migration `0017_maintenance_fields.sql` ergänzt ausschließlich optionale, rückwärtskompatible Felder.

## 0.6.0 - Abschluss, Archiv und Freigaben

Veröffentlicht am 25. Oktober 2026

Sendewerk 0.6.0 trennt das wiederaufnehmbare Ende eines Live-Laufs vom
unveränderlichen redaktionellen Abschluss. Abgeschlossene Sendungen erhalten
eine stabile Historie, liegen im Archiv und können als neuer Entwurf dupliziert
werden. Barkeeper geben genau eine geplante, laufende oder historische Sendung
über widerrufbare, optional passwortgeschützte Leselinks frei.

### Abschluss und Historie

- Ein Abschlussdialog zeigt gesendete, übersprungene und offene Pieces getrennt
  und bietet ausschließlich gesendete Originale zur bewussten Archivierung an.
- Finalisierung ist transaktional und idempotent. Übersprungene Pieces und die
  Reservebank werden nicht als gesendet verbucht.
- Usage-Texte, Relationen, Kategorien und tatsächliche Zeiten bleiben nach dem
  Abschluss stabil, auch wenn Fundus-Originale oder Kataloge später wechseln.
- Historische Sendungen sind intern nur lesbar. Die Duplikation erzeugt einen
  unabhängigen Entwurf mit offenen Pieces und ohne früheren Lauf- oder
  Freigabezustand.

### Archiv und Freigaben

- Das Archiv zeigt abgeschlossene Sendungen neben archivierten und gelöschten
  Pieces und bietet die Duplikation direkt an.
- Barkeeper erstellen Leselinks direkt in der Sendungsbearbeitung oder zentral
  in der Verwaltung für Ablauf, Moderation oder vollständige Recherche, optional
  mit Passwort und Ablaufzeit.
- Noch nicht abgeschlossene Sendungen zeigen Gästen beim nächsten Aufruf den
  aktuellen Plan. Nach dem Abschluss bleibt derselbe Link auf dem stabilen
  historischen Stand.
- Freigaben lassen sich in nach Sendung gruppierten Verwaltungskarten bearbeiten
  und endgültig löschen; Passwortänderungen beenden vorhandene Gast-Sitzungen.
- Tokens und Gast-Sitzungen liegen nur gehasht vor; Passwörter verwenden
  Argon2id und Fehlversuche sind begrenzt.
- Gastseiten projizieren genau eine Sendung. Private Originaldaten, Nutzer,
  interne IDs und Felder außerhalb des gewählten Umfangs werden nicht geliefert.
- Direkte Medienaufrufe prüfen dieselbe Freigabe, Passwortsitzung, Ablaufzeit und
  den Widerruf erneut und erlauben nur das freigegebene Präsentationsmedium.

### Technik und Prüfung

- Migration `0015_completion_archive_and_shares.sql` übernimmt bestehende
  abgeschlossene Sendungen und ergänzt Finalisierung, Historie,
  Duplikationsbefehle, Freigaben, Gast-Sitzungen und
  Passwortversuchsbegrenzung.
- Migration `0016_shares_for_active_shows.sql` erhält vorhandene Freigaben und
  erweitert ihre Referenz auf alle Sendungszustände.
- Paket, Lockdatei und Cloudron-Manifest tragen gemeinsam Version `0.6.0`.
- 52 Verhaltenstests und 18 Chromium-Abläufe decken den bisherigen Umfang sowie
  Abschluss, Archiv und anonyme Lesefreigaben ab.

## 0.5.12 - Live-Regie und Sendungskalender

Veröffentlicht am 24. Oktober 2026

Sendewerk 0.5.12 macht aus der privaten Live-Steuerung eine kompakte Regieansicht
für Vollbild, Smartphone und kleine Desktopfenster neben OBS oder Firebot. Die
Sendungsübersicht erhält zusätzlich eine kontobezogen gespeicherte Listen- und
Kalenderansicht. Die öffentliche heinzlive-Ausgabe und die gespeicherten
Livezustände bleiben technisch getrennt.

### Highlights

- Ausgabe, Gesamtzeit, Abschnittszeit und Menü tragen in der Live-Kopfleiste
  jetzt die passenden lokalen Classic-Regular-Icons. Pause beziehungsweise
  Fortsetzen ist zusätzlich als direkter Iconbutton neben der Abschnittszeit
  erreichbar.
- Die Live-Regie verwendet die gesamte Fensterfläche ohne normale
  App-Seitenleiste, mobilen App-Header oder Bottomnavigation.
- Zwei kompakte Kopfzeilen halten Abschnitt, „Danach“, Menü, Ausgabe,
  Abschnittscountdown und Ablauf gleichzeitig erreichbar. Der Sendungsname ist
  in das Menü gewandert.
- Lange Abschnitts- und Folgetitel bleiben einzeilig gekürzt und lassen sich per
  Klick oder Tastatur vollständig aufklappen, ohne benachbarte Bedienelemente zu
  überlagern.
- Moderation und Ablauf bleiben auch bei einem nur 900 × 450 Pixel großen
  Desktopfenster nebeneinander. Lange Inhalte scrollen innerhalb ihrer
  Arbeitsfläche; Kopf- und Aktionszeile bleiben sichtbar.
- Niedrige Desktopfenster verdichten Abstände und Bedienleisten anhand der
  verfügbaren Höhe, ohne Text oder die gesamte Oberfläche zu skalieren.
- Die feste Fußleiste ist auf „Zurück“, „Präsentieren“, „Überspringen“ und
  „Erledigen & weiter“ reduziert. Das nächste Piece steht in der Kopfzeile, das
  Leeren der Präsentation direkt am Ausgabezustand.
- Auf dem Smartphone öffnet „Ablauf · Piece X/Y“ den Ablauf als separates Sheet,
  während das aktuelle Piece die Hauptfläche bleibt. Fokusführung, Escape und
  der Wechsel zurück auf eine breite Ansicht schließen den Modalzustand sauber.

### Moderation und Materialien

- Interner Titel, Einleitung, Moderationsstichpunkte und Überleitung erscheinen
  in klarer Lesereihenfolge. Leere Bereiche werden weggelassen.
- Recherche, Quellen, Werkzeuge und eigene Notizen sind kompakt beschriftet und
  werden nur bei Bedarf geöffnet.
- Die Prompter-Schriftgröße bleibt einstellbar und wird weiterhin lokal
  gespeichert. Texte werden nicht automatisch verkleinert.
- Piece-Position, Piece-Titel und Zeit stehen in einer gemeinsamen kompakten
  Kopfzeile; dadurch beginnt die Einleitung weiter oben.

### Ablauf und Liveverhalten

- Pause und Fortsetzen steuern Piece-, Abschnitts- und Gesamtzeit gemeinsam und
  zählen Pausen auch nach Reload oder Navigation nicht mit.
- Gelaufene Gesamtzeit und geschätzte Restzeit lassen sich direkt umschalten;
  die Auswahl bleibt lokal erhalten. Ungeplante verbleibende Abschnitte sind
  sichtbar, ohne Abschnitts- und Piece-Dauern doppelt zu zählen.
- Abschnitts- und Gesamtzeit lassen sich getrennt nach Bestätigung zurücksetzen.
  Ablaufposition, Piece-Status, Restplanung und Präsentation bleiben dabei
  unverändert.
- Sendungen lassen sich ausdrücklich vorbereiten, starten, pausieren und
  beenden. Nach dem Ende sind „Lauf fortsetzen“ und „Neuer Durchlauf“ getrennte
  Aktionen; offene Pieces werden beim Beenden nicht automatisch erledigt.
- Abschnitte sind kompakt aufklappbar; der aktuelle Abschnitt ist geöffnet und
  das aktive Piece bleibt in der Ablaufspalte sichtbar.
- Pieces kennzeichnen tatsächliches Live-Piece, lokal betrachtetes Piece und
  ausgegebenes Piece getrennt. Jeder Eintrag lässt sich zur Betrachtung wählen,
  einschließlich des ersten Eintrags.
- Die Reserve bleibt zusammengeklappt erreichbar. Dauerhafte Sortierpfeile und
  die separate große „Als Nächstes“-Karte entfallen; Umsortieren bleibt über
  eine kompakte Aktion am jeweiligen Eintrag erreichbar.
- Die lokal gespeicherte Leseposition gehört zum jeweiligen Piece. Eine direkte
  Auswahl beginnt daher oben, ohne die Position des vorherigen Textes zu erben.
- „Zurück“ und direkte Ablaufwahl verändern weder aktuelles Live-Piece noch
  Erledigungsstatus, Timer oder Ausgabe. Bei einem nur betrachteten früheren
  Piece bleiben Überspringen und Erledigen gesperrt. Nur „Präsentieren“ oder
  „Präsentation leeren“ verändert die öffentliche Ausgabe.
- Abschnittstimer, tatsächliche Laufzeiten, Livefortschritt und Wiederaufnahme
  verwenden unverändert die vorhandenen persistenten Zustände.
- „Live-Stand wiederaufnehmen“ erscheint nur bei einem tatsächlich
  unterbrochenen Ablauf, nicht während eines aktiven Pieces.

### Einstellungen

- Ausgabekanal verbinden, Schlüssel erneuern, Kanal trennen, Theme wechseln,
  Zeiten ein-/ausblenden und „Zur Planung“ bleiben im Regiemenü erreichbar.
- Das Regiemenü erscheint als viewportgebundenes Popover sicher über den
  Glasflächen. Es bleibt in kleinen Fenstern scrollbar erreichbar und schließt
  mit Escape oder Außenklick; der Fokus kehrt zum Menüauslöser zurück.

### Interaktion

- „Interaktion“ ergänzt Piece und Sendungsfassung als optionales privates
  Markdownfeld zwischen Moderationsstichpunkten und Überleitung.
- Vorlagen, Duplikate, Einplanungen und die bewusste Aktualisierung aus dem
  Fundus übernehmen das Feld jeweils als unabhängigen Snapshot.
- Die private Live-Regie zeigt das Feld nur bei Inhalt. Die öffentliche
  heinzlive-Ausgabe übernimmt es nicht.

### Sendungsübersicht

- Sendungskarten bleiben auf kleinen Bildschirmen kompakt: Status, Titel und
  Termin stehen neben den horizontal angeordneten Abschnitts- und Zeitangaben,
  statt die Karte durch vollständiges Stapeln unnötig zu erhöhen.
- „Liste | Kalender“ schaltet zwischen der bekannten Sendungsliste und einer
  Monatsansicht um; die Auswahl bleibt am angemeldeten Konto gespeichert.
- Auf dem Desktop zeigt ein vollständiges Montag-bis-Sonntag-Raster alle Termine
  des Monats. Mehrere Sendungen pro Tag bleiben vollständig sichtbar und nach
  Uhrzeit sortiert.
- Auf dem Smartphone wird derselbe Monat als chronologische Agenda dargestellt.
  Vorheriger Monat, nächster Monat und der Sprung zu heute bleiben erreichbar.
- Die Gruppierung verwendet `Europe/Berlin`. Sendungen ohne Startzeit stehen in
  einem eigenen Bereich und verschwinden weder aus Liste noch Kalender.
- Der Kalender ist eine Navigationsansicht. Termine werden weiterhin nur über
  die bestehende Sendungsbearbeitung geändert; Termin-Drag-and-drop wurde nicht
  ergänzt.

### Update und Kompatibilität

- `0012_show_overview_view.sql` ergänzt ausschließlich die kontobezogene
  Listen-/Kalenderpräferenz mit dem sicheren Standardwert `list`.
- Es ist keine Änderung der Konfiguration erforderlich.
- `0013_live_controls_and_interaction.sql` ergänzt das private Interaktionsfeld
  und persistente Gesamtzeitintervalle. Bestehende Piece-Laufintervalle werden
  als Gesamtzeit übernommen.
- Bestehende Sendungen, Livezustände, Abschnittstimer, Ausgabekanäle und
  Präsentationssnapshots bleiben erhalten.
- Paket, Lockdatei und Cloudron-Manifest tragen gemeinsam Version `0.5.12`.

### Prüfung

- Die ergänzte Iconleiste, Pause/Fortsetzen und die kompakte Sendungskarte wurden
  gezielt in Chromium bei 670 × 450, 390 × 700 und 656 × 400 Pixeln geprüft.
  Typprüfung, sechs Live-Verhaltenstests und Produktionsbuild sind erfolgreich.
- Die vollständige Matrix wurde für diese Ergänzung nicht erneut ausgeführt; die
  folgenden Gesamtnachweise stammen vom vorherigen 0.5.12-Stand.
- 44 Unit- und Verhaltenstests sowie 17 Chromium-E2E-Abläufe sind erfolgreich.
- Die Live-Regie wurde bei 1440 × 900, 900 × 450, 670 × 450 und 390 × 700 Pixeln
  mit langen Titeln, sichtbarem Regiemenü, unabhängigen Scrollflächen und
  mobilem Ablauf-Sheet geprüft; der Kalender zusätzlich bei 1440 × 1000 und
  390 × 844 Pixeln.
- Reales OBS, echte YouTube-/TikTok-Wiedergabe und Safari auf einem iOS-Gerät
  standen nicht zur Verfügung.

## 0.5.11 - Verwaltungskorrektur

Veröffentlicht am 23. Oktober 2026

- Der Dialog „Werkzeug hinzufügen“ bleibt beim Aufruf der Verwaltungsseite
  wieder zuverlässig geschlossen.
- Der Dialog erscheint erst, wenn ein neues Werkzeug angelegt oder ein
  bestehendes Werkzeug bearbeitet wird.
- Die Iconauswahl unter „Inhaltliche Zuordnung“ bleibt auf Desktop und
  Smartphone vollständig im sichtbaren Browserbereich.
- Die Korrektur gilt gleichermaßen für Desktop- und Smartphone-Ansichten und
  verändert keine vorhandenen Werkzeuge oder Zuordnungen.

## 0.5.10 - Editor-Erlebnis

Veröffentlicht am 23. Oktober 2026

Sendewerk 0.5.10 beschleunigt die tägliche Redaktionsarbeit und schärft die
Grenze zwischen privaten Medien und der öffentlichen Präsentation. Titel,
Themen, Werkzeuge und Präsentationsbilder lassen sich direkter bearbeiten; die
wichtigsten Listen und Dialoge benötigen auf Desktop und Smartphone weniger
Platz. Bestehende Sendungsfassungen bleiben bei späteren Änderungen am Fundus
stabil.

### Highlights

- Titel von Fundus- und Sendungsfassungen lassen sich direkt in der jeweiligen
  Ansicht ändern. Die Bedienung funktioniert auch vollständig per Tastatur.
- Themen und Werkzeuge verwenden kompakte, durchsuchbare Auswahlflächen. Der
  Werkzeugkatalog folgt nun demselben Bedienmuster wie die Themenverwaltung.
- Für Themen, Werkzeuge, Navigation und Aktionen stehen 3.671 lokal
  bereitgestellte Classic-Regular-Icons zur Verfügung. Zur Laufzeit werden
  keine Icons von externen Diensten geladen.
- Präsentationsbilder werden bewusst aus den aktiven Piece-Medien gewählt und
  beim Einplanen in die Sendungsfassung übernommen. Private Uploads werden nicht
  allein durch das Hochladen öffentlich.
- Pieces lassen sich wiederherstellbar löschen. Bereits vorbereitete
  Sendungsfassungen und ihre Medien-Snapshots bleiben dabei erhalten.
- Die heinzlive-Ausgabe kann ausdrücklich geleert werden. Im leeren Zustand ist
  sie vollständig transparent und zeigt auch keinen Verbindungsstatus.

### Redaktion und Verwaltung

- Der Werkzeugkatalog entspricht der Themenverwaltung: kompakte Glasfläche,
  Icon, Name, Status und Bearbeitungsaktion statt dauerhaft offener Formulare.
- Anlegen und Bearbeiten eines Werkzeugs verwenden denselben responsiven Dialog
  für Name, Start-URL, Beschreibung, Icon, passende Formate und Aktivstatus.
- Die Formatzuordnung nutzt dieselbe durchsuchbare Mehrfachauswahl wie andere
  Zuordnungen. Deaktivierte Werkzeuge und bestehende Piece-Zuordnungen bleiben
  erhalten.
- Fundus, Eingang, Archiv, Vorlagen und Sendungsansichten sind kompakter und
  bleiben per Klick, Touch und Tastatur bedienbar.

### Pieces und Präsentation

- Präsentationsbilder werden ausdrücklich aus aktiven Piece-Medien ausgewählt
  und unveränderlich an Sendungsfassungen kopiert.
- Entfernte Medien bleiben für bestehende Sendungsfassungen verfügbar, werden
  aber nicht mehr für neue Einplanungen angeboten.
- Pieces können wiederherstellbar gelöscht werden. Offene, nie live gelaufene
  Verwendungen und Abschnitte lassen sich unter geschützten Bedingungen
  entfernen.
- Themenicons werden zusammen mit der jeweiligen Sendungsfassung gespeichert.
  Spätere Änderungen an Thema, Werkzeug oder Original-Piece verändern eine
  vorbereitete Sendung weiterhin nur nach ausdrücklicher Aktualisierung aus dem
  Fundus.

### Live-Ausgabe

- Eine leere heinzlive-Ausgabe ist vollständig transparent und zeigt weder
  Renderer noch Verbindungsstatus.
- Eine aktive Präsentation lässt sich unabhängig vom aktuell laufenden Piece
  leeren.

### Update und Kompatibilität

- `0010_editor_experience.sql` ergänzt Themenicons, Medien-Snapshots und Soft
  Delete.
- `0011_tool_icons.sql` ergänzt persistente Werkzeugicons mit einem sicheren
  Standardwert. Werkzeug-IDs, Formatbeziehungen, Piece-Zuordnungen und
  Deaktivierungszustände bleiben erhalten.
- Die Migrationen laufen beim nächsten Serverstart automatisch. Vor dem Update
  sollte wie üblich eine konsistente Sicherung der SQLite-Datenbank und des
  Upload-Verzeichnisses angelegt werden.
- Für dieses Release sind keine manuellen Datenkonvertierungen und keine
  Änderungen an der Konfiguration erforderlich.

### Prüfung

- 40 Unit- und Verhaltenstests sowie 16 Chromium-E2E-Abläufe erfolgreich.
- Werkzeugverwaltung, Iconauswahl und Piece-Werkzeugauswahl wurden zusätzlich
  bei 1280 × 720 und 390 × 844 Pixeln visuell mit der Themenverwaltung
  verglichen.
- Reales OBS, echte YouTube-/TikTok-Wiedergabe und Safari auf einem iOS-Gerät
  standen nicht zur Verfügung.

### Noch nicht enthalten

Der Abschluss und die Archivierung vollständiger Sendungen, externe
Lesefreigaben, RSS-Import und API gehören zu späteren Etappen und sind nicht Teil
von 0.5.10.