Drafty i wersje

Każda edycja w edytorze przechodzi przez system wersjonowania zaprojektowany tak, żebyś nigdy nie stracił pracy przez zawieszoną kartę albo żal. Trzy warstwy:

1. Action log — każda mikro-edycja w bieżącej sesji (Undo / Redo).
2. Working copy (draft) — autozapisany snapshot niezapisanych zmian, przywracalny po crashu karty.
3. Revisions — zapisane snapshoty (autozapisane albo ręczne), przywracalne w dowolnej chwili.

Wszystkie trzy żyją w panelu History po prawej stronie edytora.

Panel History

Trzy zakładki wewnątrz panelu History:

• Actions — chronologiczny log edycji w bieżącej sesji.
• Working copy — autozapisany draft niezapisanych zmian.
• Versions — zapisane wersje (snapshoty) sceny.

Panel wystawia też globalne buttony Undo / Redo, które matchują Ctrl/Cmd+Z / Ctrl/Cmd+Shift+Z.

Zakładka Actions

Każda edycja pojawia się jako wiersz: Add layer, Remove layer, Move layer, Resize layer, Edit properties, Reorder layers, Resize canvas, Lock / Unlock / Show / Hide layer, Edit effects, Shift keyframe range, Convert to Scene / Smart Object, Decompose scene, Convert container type, Enter / Exit scene, Add / Remove / Duplicate slide, Update timeline marker, Flip horizontal / vertical.

Kliknij dowolny wpis, żeby do niego doscrollować; użyj Undo / Redo żeby przejść krokami. Clear history czyści log sesji (nie wpływa na zapisane wersje).

Working copy (draft)

Podczas edycji plugin zapisuje working copy w skonfigurowanym autosave interval (domyślnie 30 s — zobacz Instalacja). Working copy należy do twojego użytkownika admin + tej sceny.

Przywracanie po crashu

Jeśli zamknąłeś kartę bez zapisu i wracasz, strona szczegółów pokazuje banner:

Unsaved working copy detected — Znaleźliśmy autozapisany working copy tej sceny, który jest nowszy niż ostatni zapis. Przywróć go, żeby kontynuować od miejsca, w którym skończyłeś, albo odrzuć, żeby zachować zapisaną wersję.

Dwa buttony:

• Restore working copy — ładuje draft do edytora. Potem musisz kliknąć Save, żeby zapisać go jako prawdziwą scenę. Dopóki nie zapiszesz, zapisana wersja na dysku jest nietknięta.
• Discard working copy — usuwa draft, zachowuje zapisaną wersję.

W panelu History zakładka Working copy pokazuje te same affordances plus:

• Last auto-saved — timestamp.
• Buttony Restore working copy / Discard.

Ręczne odrzucenie

Kliknięcie Discard wywołuje prompt: “Discard working copy? This permanently deletes the auto-saved working copy. Any unsaved edits captured by it will be lost.” Potwierdź przez Discard (albo Keep it żeby przerwać).

Wersje (zakładka Versions)

Zakładka Versions pokazuje zapisane snapshoty sceny w odwrotnej kolejności chronologicznej. Każdy wiersz ma:

• Timestamp — kiedy snapshot został utworzony.
• Source — Auto-saved snapshot albo Manual save.
• Restore this version — ładuje snapshot do edytora (i tak musisz kliknąć Save żeby zapisać).

Tworzenie snapshotu ręcznie

W toolbarze panelu History kliknij Create snapshot now. Snapshot bieżącego stanu jest dodany do listy Versions. Toast: “Snapshot saved to version history.”

Używaj ręcznych snapshotów przed ryzykownymi edycjami (np. przed usunięciem wielu warstw albo aplikowaniem destrukcyjnej operacji na osi czasu).

Automatyczne snapshoty

Oprócz autozapisów draftu (które się nadpisują), plugin okresowo promuje snapshoty do logu wersji, więc masz historię, a nie tylko jedną “ostatnią working copy”. Częstotliwość zależy od aktywności i globalnych ustawień retencji.

Przywracanie wersji

Kliknij Restore this version na dowolnym wierszu wersji. Edytor przełącza się na stan snapshotu. Toast: “Version restored — review the changes and click Save to keep them.”

Przywrócenie nie nadpisuje od razu zapisanej sceny — możesz porównać przywrócony stan z tym co miałeś, zdecydować że to nie to, czego chcesz, i kliknąć Undo żeby cofnąć. Zapis dzieje się dopiero gdy klikniesz Save w toolbarze.

Reguły retencji

Wersje są usuwane automatycznie przez zaplanowane zadanie. Dwa limity, oba konfigurowalne w Settings → Plugins → P2Lab Stage → Editor / Revisions:

• Maximum revisions per stage — 25 / 50 / 100 / 200 (domyślnie 50). Powyżej tego limitu najstarsze wersje są usuwane jako pierwsze.
• Revisions retention — 7 / 14 / 30 / 60 / 90 dni (domyślnie 30). Snapshoty starsze niż to są usuwane podczas czyszczenia.

Wersja jest usuwana gdy któreś z ograniczeń zostanie przekroczone. Bieżąca working copy (draft) jest wyłączona — jest nadpisywana tylko przez następny autozapis albo odrzucana explicite.

Co nie jest wersjonowane

System draft / revision przechwytuje treść sceny (warstwy, sceny, slajdy, animacje, ustawienia). Nie przechwytuje:

• Powiązań targetowania (kategorie, produkty, producenci, kanały, reguły, grupy klientów, strony CMS).
• Pól Trigger / frequency / schedule z zakładki Overview.
• Statystyk — eventy akumulują się niezależnie od wersjonowania.

Te wartości zmieniają się znacznie rzadziej i przez inne UI, więc używają normalnej historii transakcji bazy Shopware zamiast własnego strumienia snapshotów.

Gdzie dalej

• Pierwsze kroki → Instalacja — konfiguracja autosave interval i retencji wersji.
• Edytor — przegląd — gdzie panel History żyje w layoucie edytora.