feat(schnellstart): Kacheln je Geraetetyp in der Oberflaeche pflegen (#44)

docs/anleitung/03-qr-tags.md

@@ -136,8 +136,9 @@ sofort anfangen? Was war schon?
   den Fall, dass der Aufkleber abgerissen ist.
 - **Zugewiesen** — was an diesem Gerät wartet. Ein offener Lauf hat den Knopf **Starten**: er setzt
   ihn auf „in Arbeit“ und führt hinein. Ein laufender hat **Weiter**, ein fertiger **Ansehen**.
-- **Schnellstart** — eine Kachel je Vorlage, die für diesen Gerätetyp hinterlegt ist. Ein Tipp legt
-  den Lauf mit diesem Gerät und seinem Besitzer an und beginnt ihn, ohne eine einzige Eingabe.
+- **Schnellstart** — eine Kachel je Vorlage, die für diesen Gerätetyp hinterlegt ist (gepflegt unter
+  **Verwaltung → Schnellstart**, siehe Kapitel 07). Ein Tipp legt den Lauf mit diesem Gerät und
+  seinem Besitzer an und beginnt ihn, ohne eine einzige Eingabe.
   Steht auf der Kachel „fragt noch nach Angaben“, führt sie stattdessen in den Start-Dialog — dort
   sind Gerät und Person schon vorbelegt.
 - **Vorlage zuweisen** — für später oder für jemand anderen: Vorlage, **Techniker (optional)**,

docs/anleitung/04-vorlagen.md

@@ -231,9 +231,9 @@ den Fall, dass jemand eine Vorlage von Hand schreiben oder ein Skript dafür bau
 ## Vorlagen einem Gerätetyp zuordnen
 
 Damit auf der Geräteseite ein **Schnellstart** erscheint, muss für den Gerätetyp eine Vorlage
-hinterlegt sein — etwa „PC Neuinstallation“ für den Typ PC. Diese Zuordnung wird beim Einrichten der
-Anwendung gesetzt und lässt sich in der Oberfläche noch nicht ändern; wende dich dafür an die
-Person, die Laufzettel betreibt.
+hinterlegt sein — etwa „PC Neuinstallation“ für den Typ PC. Gepflegt wird das unter
+**Verwaltung → Schnellstart**; das verlangt die Rolle Administrator und ist in Kapitel 07
+beschrieben.
 
 Ohne Zuordnung bleibt der Schnellstart leer, und das ist kein Mangel: unter **Vorlage zuweisen**
 steht auf der Geräteseite jede Vorlage, die zu diesem Gerät passt, und der Start-Dialog kennt sie

docs/anleitung/07-admin.md

@@ -88,6 +88,33 @@ Aufkleber sonst ins Leere zeigen würden. Steht dort „APP_URL ist nicht gesetz
 noch nicht gedruckt werden“, muss das erst beim Betrieb der Anwendung eingetragen werden. **Drucke
 vorher keine Etiketten.**
 
+## Schnellstart je Gerätetyp
+
+Auf der Seite eines Geräts stehen oben die Vorlagen, die dort am häufigsten gebraucht werden — ein
+Klick, und der Lauf steht. Welche das sind, wird unter **Verwaltung → Schnellstart** festgelegt, je
+Gerätetyp getrennt.
+
+Zu jedem Gerätetyp steht dort die Liste in der Reihenfolge, in der die Kacheln erscheinen. Mit den
+Pfeilen wird umsortiert, mit dem **×** entfernt, und über **Vorlage hinzufügen** kommt eine dazu.
+Nach jeder Änderung steht „nicht gespeichert“ daneben, bis **Speichern** gedrückt ist — die
+Reihenfolge wandert als Ganzes in die Datenbank, nicht Zeile für Zeile.
+
+Drei Dinge, die hier anders sind als erwartet:
+
+- **Zur Auswahl stehen nur veröffentlichte, nicht archivierte Vorlagen.** Ein Entwurf taugt nicht:
+  aus ihm lässt sich kein Lauf starten, die Kachel täte also nichts.
+- **Eine archivierte Vorlage verschwindet von selbst** aus dem Schnellstart. Niemand muss hier
+  aufräumen, nachdem eine Vorlage weggelegt wurde.
+- **Eine Vorlage, die nur für einen Kunden gilt**, lässt sich zuweisen und wird mit dem Kundennamen
+  gezeigt. Sie erscheint trotzdem nur bei den Geräten dieses Kunden.
+
+**Ein leerer Schnellstart ist kein Mangel.** Unter **Vorlage zuweisen** steht auf der Geräteseite
+jede Vorlage, die zu diesem Gerät passt, und der Start-Dialog kennt sie ohnehin alle.
+
+Sobald hier einmal gespeichert wurde, hält sich der Seed heraus: die mitgelieferten Vorgaben werden
+danach nicht mehr nachgelegt. Das ist gewollt — eine entfernte Kachel soll nicht beim nächsten
+Einrichtungslauf zurückkommen.
+
 ## Betriebsmodus umstellen
 
 ![Der Bestätigungsdialog für den Moduswechsel mit den Folgen](bilder/admin-moduswechsel-desktop.png)

docs/issues/022-schnellstart-pflegen.md

@@ -1,10 +1,10 @@
 # #022 Schnellstart je Gerätetyp pflegen
 
-**Status:** offen
+**Status:** erledigt
 **Im Tracker:** [#34](https://git.wilde-server.de/florian.wilde/Laufzettel/issues/34)
 **Meilenstein:** v0.2.0
 **Labels:** phase-2, frontend, backend
-**Geschätzt:** 3 h   **Tatsächlich:** –
+**Geschätzt:** 3 h   **Tatsächlich:** 1 h 10 min
 
 ## Ziel
 
@@ -18,17 +18,44 @@ den Schnellstart, konnte aber nicht sagen, wer ihn einrichtet.
 
 ## Aufgaben
 
-- [ ] Admin-Seite (oder ein Abschnitt unter Admin → Einstellungen): je Gerätetyp eine sortierbare
-      Liste der Vorlagen, die dort erscheinen sollen
-- [ ] Nur **veröffentlichte**, nicht archivierte Vorlagen zur Auswahl; die Reihenfolge ist die
+- [x] Eigene Seite **Verwaltung → Schnellstart** (kein Abschnitt unter Einstellungen: acht Gerätetypen
+      mit je einer Liste sind zu viel für eine Seite, die schon den Moduswechsel trägt)
+- [x] Nur **veröffentlichte**, nicht archivierte Vorlagen zur Auswahl; die Reihenfolge ist die
       Reihenfolge der Kacheln (`position`)
-- [ ] Recht `verwaltung`, Änderung ins `Protokoll`
-- [ ] Der Seed legt die Vorgaben weiter an, überschreibt aber nie eine im Betrieb geänderte
+- [x] Recht `verwaltung`, Änderung ins `Protokoll`
+- [x] Der Seed legt die Vorgaben weiter an, überschreibt aber nie eine im Betrieb geänderte
       Zuordnung — dieselbe Regel wie für alles andere im Seed
-- [ ] Anleitung Kapitel 03 und 07 nachziehen
+- [x] Anleitung Kapitel 03 und 07 nachziehen
 
 ## Akzeptanzkriterien
 
-- [ ] Test: eine zugewiesene Vorlage erscheint als Kachel auf der Geräteseite des passenden Typs
-- [ ] Test: eine archivierte Vorlage verschwindet aus dem Schnellstart, ohne dass jemand aufräumt
-- [ ] Test: `LESER` und `TECHNIKER` dürfen nicht ändern
+- [x] Test: eine zugewiesene Vorlage erscheint als Kachel auf der Geräteseite des passenden Typs
+- [x] Test: eine archivierte Vorlage verschwindet aus dem Schnellstart, ohne dass jemand aufräumt
+- [x] Test: `LESER` und `TECHNIKER` dürfen nicht ändern
+
+## Beim Umsetzen dazugekommen
+
+- **Die Reihenfolge läuft über Hoch und Runter, nicht über Drag & Drop.** Der Vorlagen-Editor
+  benutzt dnd-kit, weil dort hundert Schritte in Abschnitten liegen; hier sind es zwei bis vier
+  Kacheln, und zwei Knöpfe sind am Handy verlässlicher als eine Ziehgeste neben einer scrollenden
+  Seite.
+- **`Einstellung.schnellstartGepflegt` als Marke.** Eine fehlende Zeile in `GeraetetypVorlage` sagt
+  nicht, ob sie noch nie da war oder bewusst entfernt wurde — ohne Marke käme eine entfernte Kachel
+  beim nächsten Seed-Lauf zurück. Gesetzt wird sie **auch bei unverändert gespeicherter Liste**: das
+  Speichern selbst ist die Aussage „ich pflege das jetzt“.
+- **Gespeichert wird die ganze Liste, nicht Zeile für Zeile.** `position` kommt aus der Reihenfolge
+  des Formulars; zwei Wahrheiten über die Reihenfolge gäbe es sonst.
+- **Das Durchklicken des gebauten Stands hat einen echten Fehler gefunden**, den die Suite nicht
+  gesehen hätte: die Umsortierung wurde nicht gespeichert. Altdaten tragen mehrere Zeilen auf
+  `position` 0 — der Seed zählt je Vorgabe von 0, und ein Beispielskript legte eine zweite dazu. Bei
+  gleicher Position ist die Reihenfolge in Postgres nicht festgelegt, und das Lesemodell gab die
+  Zeilen anders zurück als der Dienst. Der Vergleich „unverändert" hielt die Umsortierung deshalb
+  für einen Leerlauf: die Marke wurde gesetzt, geschrieben wurde nichts. Behoben durch einen
+  eindeutigen Tiebreak (`position`, dann `vorlageId`) in **beiden** Abfragen.
+- Dabei fiel auf, dass ich die Ursache zuerst falsch benannt hatte: eine zusätzliche Prüfung auf
+  aufeinanderfolgende Positionen behebt den Fehler **nicht** (Gegenprobe gefahren, Tests blieben
+  grün). Sie zieht nur alte Positionen gerade; der Kommentar sagt das jetzt so, und ein eigener Test
+  deckt genau das ab.
+- Zwei der drei Akzeptanzkriterien waren schon durch `tests/geraeteseite.test.ts` gedeckt — die
+  Kachel am passenden Typ und das Verschwinden einer archivierten Vorlage. Das stand bei
+  [#014](014-qr-tags-geraeteseite.md) schon richtig im Leseweg; gefehlt hat nur die Pflege.

docs/issues/README.md

@@ -26,10 +26,10 @@ Diese Dateien sind die Quelle; `pnpm issues:sync` spiegelt sie in den Gitea-Trac
 | #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) | erledigt | v0.2.0 | 3 h | 1 h 20 min |
 | #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 | – |
+| #022 | [Schnellstart je Gerätetyp pflegen](022-schnellstart-pflegen.md) | erledigt | v0.2.0 | 3 h | 1 h 10 min |
 | #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 |
 | #027 | [Die Editor-Abläufe lassen ihre Vorlagen stehen](027-e2e-reste-vorlagen.md) | offen | v0.2.0 | 1 h | – |
-| | **Summe** | | | **153 h** | **38 h 20 min** |
+| | **Summe** | | | **153 h** | **39 h 30 min** |