feat(seed): mitgelieferte Vorlagen am Schluessel erkennen (#42)

docs/issues/021-stabiler-schluessel-vorlagen.md

@@ -1,11 +1,11 @@
 # #021 Stabiler Schlüssel für Seed-Vorlagen
 
-**Status:** offen
+**Status:** erledigt
 **Im Tracker:** [#32](https://git.wilde-server.de/florian.wilde/Laufzettel/issues/32) — die Zählung dort schließt Pull Requests ein und läuft deshalb auseinander
 **Meilenstein:** v0.2.0
 **Labels:** phase-2, backend
 
-**Geschätzt:** 2 h   **Tatsächlich:** –
+**Geschätzt:** 2 h   **Tatsächlich:** 55 min
 
 ## Ziel
 
@@ -15,17 +15,19 @@ Geräteseite doppelt. Aufgefallen im Review zu [#017](017-seed-sieben-vorlagen.m
 
 ## Aufgaben
 
-- [ ] Ein optionales Feld `schluessel` im [Austauschformat](../vorlagen-format.md) — gedacht für
+- [x] Ein optionales Feld `seedSchluessel` im [Austauschformat](../vorlagen-format.md) — **nicht**
+      `schluessel` wie hier geplant: so heißt im Format schon das Feld einer Variablen, und zwei
+      Dinge gleichen Namens in derselben Datei wären eine Lesefalle — gedacht für
       mitgelieferte Vorlagen, nicht für die Oberfläche; beim Import **nicht** übernommen, damit eine
       eingespielte Kopie nicht den Platz des Originals einnimmt
-- [ ] `Vorlage.seedSchluessel` mit partiellem eindeutigen Index (nur wo gesetzt)
-- [ ] Der Seed sucht über den Schlüssel und fällt auf den Namen zurück, solange noch keiner gesetzt
+- [x] `Vorlage.seedSchluessel` mit partiellem eindeutigen Index (nur wo gesetzt)
+- [x] Der Seed sucht über den Schlüssel und fällt auf den Namen zurück, solange noch keiner gesetzt
       ist — eine bestehende Installation darf beim ersten Lauf danach keine Dubletten bekommen
-- [ ] Dokumentieren, was der Schlüssel **nicht** tut: er macht eine Vorlage nicht unveränderlich und
+- [x] Dokumentieren, was der Schlüssel **nicht** tut: er macht eine Vorlage nicht unveränderlich und
       erlaubt dem Seed nicht, eine bearbeitete Vorlage zu überschreiben
 
 ## Akzeptanzkriterien
 
-- [ ] Test: umbenannte Seed-Vorlage, zweiter Seed-Lauf legt keine zweite an
-- [ ] Test: zweiter Lauf erzeugt keine zweite `GeraetetypVorlage`-Zeile
-- [ ] Test: eine über den Import eingespielte Kopie bekommt **keinen** Schlüssel
+- [x] Test: umbenannte Seed-Vorlage, zweiter Seed-Lauf legt keine zweite an
+- [x] Test: zweiter Lauf erzeugt keine zweite `GeraetetypVorlage`-Zeile
+- [x] Test: eine über den Import eingespielte Kopie bekommt **keinen** Schlüssel

docs/issues/027-e2e-reste-vorlagen.md

@@ -0,0 +1,35 @@
+# #027 Die Editor-Abläufe lassen ihre Vorlagen stehen
+
+**Status:** offen
+**Im Tracker:** –
+**Meilenstein:** v0.2.0
+**Labels:** phase-2, test
+**Geschätzt:** 1 h   **Tatsächlich:** –
+
+## Ziel
+
+In der Entwicklungsdatenbank stehen über hundert Vorlagen mit Namen wie
+`ZZ E2E Editor 1790324192596 C`. Die Ende-zu-Ende-Abläufe legen sie an und räumen sie nicht weg; bei
+jedem Lauf kommen drei dazu.
+
+Aufgefallen beim Nachsehen zu [#021](021-stabiler-schluessel-vorlagen.md), als eine Abfrage über
+`Vorlage` statt sieben Zeilen über hundert lieferte.
+
+Das ist kein Schaden an den Tests — das `ZZ`-Präfix sortiert sie ans Ende, und jeder Ablauf legt
+seine eigenen an. Es ist ein Schaden an allem, was **danach** in dieselbe Datenbank sieht: die
+Vorlagenliste in der Oberfläche, Screenshots, und jede Abfrage von Hand. Bei einem Fehler, der
+„0 Treffer“ oder „zu viele Treffer“ heißt, kostet das Zeit.
+
+## Aufgaben
+
+- [ ] Die Abläufe unter `tests/e2e/`, die Vorlagen anlegen, räumen sie in einem Nachlauf wieder weg —
+      über ihr Präfix, nicht über gemerkte Kennungen (ein abgebrochener Lauf merkt sich nichts)
+- [ ] Dasselbe für Geräte, Personen und Läufe prüfen, die die Abläufe anlegen
+- [ ] Einmalig aufräumen: die vorhandenen Reste aus der Entwicklungsdatenbank entfernen
+- [ ] Prüfen, ob ein Nachlauf das überhaupt leisten kann — ein Ablauf, der mitten im Lauf scheitert,
+      darf den Nachlauf nicht überspringen
+
+## Akzeptanzkriterien
+
+- [ ] Nach `pnpm test:e2e` steht in `Vorlage` keine Zeile mit `ZZ E2E`
+- [ ] Ein abgebrochener Lauf lässt ebenfalls nichts stehen

docs/issues/README.md

@@ -25,10 +25,11 @@ Diese Dateien sind die Quelle; `pnpm issues:sync` spiegelt sie in den Gitea-Trac
 | #018 | [M13 – E2E-Tests, Anleitung, PDF](018-e2e-anleitung-pdf.md) | erledigt | v0.1.0 | 14 h | 2 h 15 min |
 | #019 | [M14 – Betriebswege und Release v0.1.0](019-betrieb-release.md) | erledigt | v0.1.0 | 10 h | 5 h 25 min |
 | #020 | [Vorgesetzter auch für von Hand angelegte Personen](020-vorgesetzter-manuell.md) | offen | v0.2.0 | 3 h | – |
-| #021 | [Stabiler Schlüssel für Seed-Vorlagen](021-stabiler-schluessel-vorlagen.md) | offen | v0.2.0 | 2 h | – |
+| #021 | [Stabiler Schlüssel für Seed-Vorlagen](021-stabiler-schluessel-vorlagen.md) | erledigt | v0.2.0 | 2 h | 55 min |
 | #022 | [Schnellstart je Gerätetyp pflegen](022-schnellstart-pflegen.md) | offen | v0.2.0 | 3 h | – |
 | #023 | [Protokoll ansehen](023-protokoll-ansicht.md) | offen | v0.2.0 | 4 h | – |
 | #024 | [Proxmox-Einzeiler auf einem echten PVE-Host gegenprüfen](024-proxmox-echtlauf.md) | offen | v0.2.0 | 2 h | – |
 | #025 | [Healthcheck gibt die rohe Datenbankfehlermeldung heraus](025-gesundheit-fehlermeldung.md) | erledigt | v0.2.0 | 1 h | 25 min |
 | #026 | [Zwei Konventionen präzisieren, die strenger klingen als sie gemeint sind](026-konventionen-praezisieren.md) | erledigt | v0.2.0 | 1 h | 20 min |
-| | **Summe** | | | **152 h** | **36 h 05 min** |
+| #027 | [Die Editor-Abläufe lassen ihre Vorlagen stehen](027-e2e-reste-vorlagen.md) | offen | v0.2.0 | 1 h | – |
+| | **Summe** | | | **153 h** | **37 h 00 min** |

docs/vorlagen-format.md

@@ -104,6 +104,7 @@ Platzhaltern. **JSON kennt keine Kommentare** — die Zeilen mit `//` müssen vo
 | -------------- | -------- | ------------------------------------------------------------------------------- |
 | `format`       | Pflicht  | Fassung des Austauschformats. Derzeit `1`; ein anderer Wert wird abgewiesen.     |
 | `name`         | Pflicht  | Name der Vorlage, nicht leer. Namen sind **nicht** eindeutig.                    |
+| `seedSchluessel` | optional | **Nur für mitgelieferte Vorlagen.** Siehe unten — beim Import verfällt das Feld. |
 | `beschreibung` | optional | Ein bis zwei Sätze, was die Vorlage abdeckt.                                     |
 | `kategorie`    | optional | Freitext, gruppiert die Vorlagenliste (etwa `Onboarding`).                       |
 | `schlagworte`  | optional | Liste nicht leerer Texte; Standard `[]`.                                         |
@@ -230,3 +231,33 @@ Das Feld `format` ist die Fassung des Formats, nicht die der Anwendung. Es gilt:
   der die Hälfte versteht und die andere Hälfte still verwirft, wäre schlimmer als ein Fehlschlag.
 
 Die Zahl steht als `FORMAT_VERSION` in `src/lib/vorlagen-format.ts` an genau einer Stelle.
+
+## `seedSchluessel` — nur für mitgelieferte Vorlagen
+
+Die sieben Vorlagen, die Laufzettel mitbringt, tragen in ihrer Datei ein zusätzliches Feld:
+
+```json
+{ "format": 1, "name": "PC Neuinstallation", "seedSchluessel": "pc-neuinstallation" }
+```
+
+Daran erkennt der Seed sie wieder. Vorher ging das über den **Namen** — und wer eine mitgelieferte
+Vorlage umbenannte, bekam beim nächsten Seed-Lauf eine zweite, samt doppeltem Schnellstart auf der
+Geräteseite (#021).
+
+**Was der Schlüssel nicht tut:**
+
+- Er macht eine Vorlage **nicht unveränderlich.** Umbenennen, umbauen, archivieren — alles bleibt
+  erlaubt. Der Seed erkennt sie danach wieder und lässt sie in Ruhe.
+- Er erlaubt dem Seed **nicht**, eine bearbeitete Vorlage zu überschreiben. Gibt es die Vorlage, legt
+  er nichts an und ändert nichts. Das war vorher so und bleibt so.
+- Er ist **keine Kennung über Installationen hinweg.** Zwei Installationen haben für dieselbe
+  mitgelieferte Vorlage denselben Schlüssel, aber verschiedene `id`s — der Schlüssel sagt nur
+  „diese Zeile stammt aus dem Seed“.
+
+**Beim Import verfällt das Feld.** Wer eine mitgelieferte Vorlage exportiert und wieder einspielt,
+bekommt eine gewöhnliche Vorlage ohne Schlüssel. Das ist Absicht: die Kopie soll nicht den Platz des
+Originals einnehmen, sonst hielte der Seed sie dafür und würde das Original ein zweites Mal anlegen.
+Der Export schreibt das Feld deshalb auch nicht — ein Feld, das beim Einlesen verfällt, verwirrt nur.
+
+Eigene Vorlagen brauchen den Schlüssel nicht und sollten ihn nicht bekommen. Er ist eindeutig, wo er
+gesetzt ist; eine zweite Vorlage mit demselben Schlüssel weist die Datenbank ab.