Working Copy und Veröffentlichen für Anleitungen #106

Closed
opened 2026-11-05 11:50:53 +01:00 by miko · 1 comment
Owner

Part of #93

Bearbeitungen veröffentlichter Anleitungen gehen nicht mehr sofort live, sondern in eine Working Copy. Leser sehen weiterhin die zuletzt veröffentlichte Version, bis jemand „Veröffentlichen“ klickt.

Speichermodell

  • Die bestehenden Tabellen (Guide, Step, StepLine, StepImage, Annotation, CoverImage) werden zur Working Copy. Der Editor bleibt im Kern unverändert: Speichern pro Schritt, Optimistic Locking.
  • Jedes Veröffentlichen schreibt einen Snapshot als JSON in eine neue Tabelle GuideVersion. Gespeichert werden Zeitpunkt, veröffentlichende Person und eine optionale Änderungsnotiz aus dem Veröffentlichen-Dialog.
  • Versioniert wird nur Inhalt: Titel, Beschreibung, Sprache, Schritte inkl. Step Lines, Step Images und Annotationen, Cover Image, Difficulty/Estimated Duration (#92).
  • Struktur bleibt unversioniert und wirkt sofort: Kategorie, Visibility, Wiki Mode, Owner, Position.
  • Migration: Jede bereits veröffentlichte Anleitung bekommt eine erste Version aus ihrem aktuellen Stand.
  • Bilddateien werden erst gelöscht, wenn keine Version und keine Working Copy sie mehr referenziert. Heute werden sie beim Entfernen oder Neuzuschneiden sofort gelöscht (src/images/files.ts).

Verhalten

  • Jede Bearbeitung einer veröffentlichten Anleitung geht in die Working Copy. Ein „direkt live“-Speichern gibt es nicht.
  • Im Editor gibt es ein Badge „unveröffentlichte Änderungen“ und die Buttons Veröffentlichen (Dialog mit optionaler Notiz) und Verwerfen. Verwerfen setzt die Working Copy auf die letzte Version zurück.
  • Veröffentlichen hält die Working Copy genau zu diesem Zeitpunkt fest. Wer gleichzeitig einen Schritt offen hat, speichert danach einfach in die Working Copy weiter. Es gibt keinen Konflikt und keine Sperre.
  • Leseansicht, Druck/PDF, Kategorie-Grids, Media-Route lesen aus der zuletzt veröffentlichten Version, auch für Bearbeitende.
  • Bearbeitende sehen in der Leseansicht einen Hinweis „Es gibt unveröffentlichte Änderungen“ mit Link zur Vorschau der Working Copy.
  • Suche: Bei veröffentlichten Anleitungen wird nur der Text der veröffentlichten Version indexiert, auch für Bearbeitende. Nie veröffentlichte Drafts verhalten sich wie heute.
  • Attribution Line und „zuletzt bearbeitet“ zeigen Datum und Person der veröffentlichten Version, nicht updatedAt/updatedBy der Working Copy.
  • Zurückziehen (published → draft) lässt die Versionen unberührt. Erneutes Veröffentlichen erzeugt nur dann eine neue Version, wenn sich die Working Copy seit der letzten Version geändert hat; sonst wird die letzte Version wieder sichtbar.
  • Soft Delete behält die Versionen. Stellen Admins die Anleitung wieder her, ist die Historie vollständig wieder da.
  • Berechtigungen: Veröffentlichen und Verwerfen dürfen alle, die die Anleitung bearbeiten dürfen (Owner, Admins, Authors im Wiki Mode; ADR-0003).
  • Pages sind ausgenommen: Für sie gilt weiter ADR-0008, Änderungen sind sofort live.

Doku

  • Neue ADR „Readers see the latest version; edits go to the working copy“. Sie ersetzt ADR-0008, die dort als superseded markiert wird. Inhalt: das Speichermodell und warum Pages ausgenommen sind.
  • GLOSSARY.md:
    • Working Copy: der bearbeitbare Stand einer Anleitung. Avoid: Entwurf, pending changes.
    • Version: der unveränderliche Snapshot, der beim Veröffentlichen entsteht, mit Zeitpunkt, Person und optionaler Notiz. Avoid: Revision, Snapshot.
    • Draft bleibt der Status „noch nie veröffentlicht / zurückgezogen“.
Part of #93 Bearbeitungen veröffentlichter Anleitungen gehen nicht mehr sofort live, sondern in eine **Working Copy**. Leser sehen weiterhin die zuletzt veröffentlichte **Version**, bis jemand „Veröffentlichen“ klickt. ## Speichermodell - Die bestehenden Tabellen (Guide, Step, StepLine, StepImage, Annotation, CoverImage) werden zur **Working Copy**. Der Editor bleibt im Kern unverändert: Speichern pro Schritt, Optimistic Locking. - Jedes Veröffentlichen schreibt einen **Snapshot als JSON** in eine neue Tabelle `GuideVersion`. Gespeichert werden Zeitpunkt, veröffentlichende Person und eine optionale Änderungsnotiz aus dem Veröffentlichen-Dialog. - **Versioniert wird nur Inhalt**: Titel, Beschreibung, Sprache, Schritte inkl. Step Lines, Step Images und Annotationen, Cover Image, Difficulty/Estimated Duration (#92). - **Struktur bleibt unversioniert** und wirkt sofort: Kategorie, Visibility, Wiki Mode, Owner, Position. - **Migration**: Jede bereits veröffentlichte Anleitung bekommt eine erste Version aus ihrem aktuellen Stand. - **Bilddateien** werden erst gelöscht, wenn keine Version und keine Working Copy sie mehr referenziert. Heute werden sie beim Entfernen oder Neuzuschneiden sofort gelöscht (`src/images/files.ts`). ## Verhalten - **Jede** Bearbeitung einer veröffentlichten Anleitung geht in die Working Copy. Ein „direkt live“-Speichern gibt es nicht. - Im Editor gibt es ein Badge „unveröffentlichte Änderungen“ und die Buttons **Veröffentlichen** (Dialog mit optionaler Notiz) und **Verwerfen**. Verwerfen setzt die Working Copy auf die letzte Version zurück. - **Veröffentlichen** hält die Working Copy genau zu diesem Zeitpunkt fest. Wer gleichzeitig einen Schritt offen hat, speichert danach einfach in die Working Copy weiter. Es gibt keinen Konflikt und keine Sperre. - **Leseansicht, Druck/PDF, Kategorie-Grids, Media-Route** lesen aus der zuletzt veröffentlichten Version, auch für Bearbeitende. - Bearbeitende sehen in der Leseansicht einen Hinweis „Es gibt unveröffentlichte Änderungen“ mit Link zur Vorschau der Working Copy. - **Suche**: Bei veröffentlichten Anleitungen wird nur der Text der veröffentlichten Version indexiert, auch für Bearbeitende. Nie veröffentlichte Drafts verhalten sich wie heute. - **Attribution Line und „zuletzt bearbeitet“** zeigen Datum und Person der veröffentlichten Version, nicht `updatedAt`/`updatedBy` der Working Copy. - **Zurückziehen** (`published` → `draft`) lässt die Versionen unberührt. Erneutes Veröffentlichen erzeugt nur dann eine neue Version, wenn sich die Working Copy seit der letzten Version geändert hat; sonst wird die letzte Version wieder sichtbar. - **Soft Delete** behält die Versionen. Stellen Admins die Anleitung wieder her, ist die Historie vollständig wieder da. - **Berechtigungen**: Veröffentlichen und Verwerfen dürfen alle, die die Anleitung bearbeiten dürfen (Owner, Admins, Authors im Wiki Mode; ADR-0003). - **Pages** sind ausgenommen: Für sie gilt weiter ADR-0008, Änderungen sind sofort live. ## Doku - Neue ADR „Readers see the latest version; edits go to the working copy“. Sie ersetzt ADR-0008, die dort als *superseded* markiert wird. Inhalt: das Speichermodell und warum Pages ausgenommen sind. - GLOSSARY.md: - **Working Copy**: der bearbeitbare Stand einer Anleitung. _Avoid_: Entwurf, pending changes. - **Version**: der unveränderliche Snapshot, der beim Veröffentlichen entsteht, mit Zeitpunkt, Person und optionaler Notiz. _Avoid_: Revision, Snapshot. - **Draft** bleibt der Status „noch nie veröffentlicht / zurückgezogen“.
miko closed this issue 2026-11-05 13:31:46 +01:00
Author
Owner

Umgesetzt in !112 (feature/106-working-copy-and-publish). Hinweis: Die erste Version veröffentlichter Anleitungen entsteht beim Serverstart (ensureFirstVersions), nicht per SQL-Migration – siehe ADR-0020.

Umgesetzt in !112 (feature/106-working-copy-and-publish). Hinweis: Die erste Version veröffentlichter Anleitungen entsteht beim Serverstart (ensureFirstVersions), nicht per SQL-Migration – siehe ADR-0020.
Sign in to join this conversation.
No project
No assignees
1 participant
Notifications
Due date
The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Reference
MassiveDynamic/kataba#106
No description provided.