Florian Wilde
0b5138d8bb
"Datensicherung pruefen" steht in vier der sieben mitgelieferten Vorlagen, wortgleich. Wer den Ablauf aendert, aendert ihn viermal -- oder dreimal und vergisst den vierten. Entschieden wie im Issue vorgeschlagen: ein Entwurf **verweist** auf eine veroeffentlichte Baustein-Fassung, und beim Veroeffentlichen der Vorlage setzt der Dienst deren Schritte als tiefe Kopie ein. Danach sieht ein Lauf weiterhin konkrete Schritte, und Schrittergebnis, Druckansicht und Archiv muessen nichts von Bausteinen wissen. Die Alternative -- Laeufe verweisen zur Laufzeit -- haette die Unveraenderlichkeit an einer zweiten Stelle durchsetzen muessen. Eine neue Fassung aendert damit keine veroeffentlichte Vorlagenversion und keinen laufenden Lauf. Sie wirkt in der naechsten veroeffentlichten Version; die Oberflaeche sagt das an zwei Stellen, weil man sonst Durchschlag erwartet. Vier Garantien liegen in der Datenbank, nicht nur im Dienst: hoechstens ein Entwurf je Baustein, eine veroeffentlichte Fassung ist unveraenderlich, der Weg zurueck zum Entwurf ist versperrt, und ein Abschnitt kann nur auf eine veroeffentlichte Fassung verweisen. Der Titel kommt aus dem Baustein, nicht aus dem Abschnitt der Vorlage: sonst muesste er in jeder Vorlage einzeln gepflegt werden, und zwei Vorlagen zeigten denselben Baustein unter verschiedenen Namen. Ein Export traegt die aufgeloesten Schritte, keinen Verweis -- eine Kennung aus dieser Installation bedeutet in einer anderen nichts. Das Durchklicken des gebauten Stands fand einen Fehler, den die Suite nicht gesehen haette: die Platzhalter-Schritte eines Baustein-Abschnitts haben keinen Titel, wurden aber mitgeschickt, und SchrittSchema wies den ganzen Entwurf ab. Behoben, mit Test und Gegenprobe. Der ganze Weg danach am gebauten Stand nachgemessen: Baustein anlegen, veroeffentlichen, einsetzen, Vorlage veroeffentlichen -- die Schritte stehen drin, mit Herkunft und Protokolleintrag. Closes #50
5.0 KiB
5.0 KiB
#030 M17 – Wiederverwendbare Bausteine
Status: erledigt Im Tracker: #50 Meilenstein: v0.2.0 Labels: phase-2, backend, frontend Geschätzt: 12 h Tatsächlich: 2 h 25 min
Ziel
„Datensicherung prüfen“ steht in vier der sieben Vorlagen, wortgleich. Wer den Ablauf ändert, ändert ihn heute viermal — oder dreimal und vergisst den vierten. Ein Baustein ist ein Abschnitt, den mehrere Vorlagen teilen.
Woran es hängt
Eine veröffentlichte VorlagenVersion ist unveränderlich. Das trägt die Nachvollziehbarkeit des
ganzen Archivs: ein Lauf zeigt auch in zehn Jahren genau die Schritte, die damals abgearbeitet
wurden. Ein Baustein, der sich ändert, darf das nicht antasten.
Zu entscheiden
- Baustein mit eigener Version, beim Veröffentlichen tief kopiert — Empfehlung. Ein
Entwurf verweist auf einen Baustein; beim Veröffentlichen löst der Dienst den Verweis in
echte Abschnitte und Schritte auf. Damit bleibt alles, was danach kommt, unberührt:
Lauf,Schrittergebnis, Druckansicht und Archiv sehen weiterhin konkrete Schritte und müssen nichts lernen. Die Alternative — Läufe verweisen zur Laufzeit auf den Baustein — hieße, dass die Unveränder- lichkeit an einer zweiten Stelle durchgesetzt werden muss, und dass jede Abfrage über Schritte zwei Wege kennen muss. Das ist der Preis für eine Bequemlichkeit, die niemand verlangt hat. - Was „Baustein aktualisieren“ für laufende Arbeiten bedeutet: nichts. Eine neue Baustein-Version wirkt erst in der nächsten veröffentlichten Vorlagenversion. Das muss die Oberfläche sagen, sonst erwartet man Durchschlag.
Aufgaben
- Modelle
BausteinundBausteinVersionmit denselben Regeln wie bei Vorlagen: höchstens ein Entwurf, veröffentlichte Version unveränderlich (Trigger, nicht nur Dienst) VorlagenAbschnittkann statt eigener Schritte einen Baustein nennen — nur im Entwurf- Veröffentlichen löst auf: tiefe Kopie der Baustein-Abschnitte und -Schritte in die Version, mit Vermerk, aus welchem Baustein und welcher Version sie stammen
- Editor: Baustein einfügen, als Einheit anzeigen, nicht Schritt für Schritt bearbeitbar; ein Hinweis nennt Baustein und Version
- Eigene Verwaltung für Bausteine, Recht
vorlagenBearbeiten(wer Vorlagen pflegt, pflegt Bausteine) - „Wo wird dieser Baustein benutzt“ — vor dem Ändern will man das wissen
- Anleitung Kapitel 04
Akzeptanzkriterien
- Test: eine neue Baustein-Version ändert keine veröffentlichte Vorlagenversion und keinen laufenden Lauf
- Test: die Druckansicht eines archivierten Laufs ist nach einer Baustein-Änderung Zeichen für Zeichen dieselbe
- Test: die nächste veröffentlichte Vorlagenversion enthält die neue Baustein-Version
- Test: ein Baustein lässt sich nicht löschen, solange eine Vorlage ihn im Entwurf nennt
- Test: Export und Import einer Vorlage mit Baustein ergeben eine inhaltsgleiche Vorlage — die Datei trägt die aufgelösten Schritte, keinen Verweis auf einen Baustein, den die andere Installation nicht hat
Beim Umsetzen dazugekommen
- Ein Baustein ist genau ein Abschnitt, nicht eine Gruppe davon. Das stand so im Auftrag („Abschnitte, die mehrere Vorlagen teilen“) und spart eine Verschachtelungsebene, die niemand gebraucht hätte.
- Der Verweis bleibt nach dem Veröffentlichen stehen und ist dann nur noch Herkunft. Welche der beiden Lesarten gilt, sagt der Status der Version — ein zweites Feld dafür wäre eine zweite Wahrheit. Die Seite eines Bausteins liest daraus „Wo er steckt“, mit der Fassung je Vorlage.
- Der Titel kommt aus dem Baustein, nicht aus dem Abschnitt der Vorlage. Sonst müsste man ihn in jeder Vorlage einzeln pflegen, und zwei Vorlagen zeigten denselben Baustein unter verschiedenen Namen.
- Vier Garantien liegen in der Datenbank, nicht nur im Dienst: höchstens ein Entwurf (partieller Index), eine veröffentlichte Fassung ist unveränderlich (Trigger), der Weg zurück zum Entwurf ist versperrt (Trigger), und ein Abschnitt kann nur auf eine veröffentlichte Fassung verweisen (Trigger). Beim Aufräumen der Testdaten hat der zweite sofort zugeschlagen — gut so.
- Das Durchklicken des gebauten Stands fand einen Fehler, den die Suite nicht gesehen hätte:
neuerBausteinAbschnittlegt Platzhalter-Schritte ohne Titel an, damit die Anzahl in der Karte stimmt.alsStrukturschickte sie mit, undSchrittSchemawies den ganzen Entwurf ab — das Speichern scheiterte. Behoben, mit Test und Gegenprobe. - Dabei habe ich zweimal mein eigenes Prüfskript für den Fehler gehalten: einmal griff ein zu
weiter
role=status-Selektor den falschen Text, einmal eine Prüfung nach dem Neuladen. Die Datenbank hat beides geklärt — sie ist der einzige Zeuge, der nicht lügt.