Geraeteformular zum Anlegen und Bearbeiten ergaenzen

Schliesst die letzte offene Luecke aus Phase 1. Bis dahin liessen sich Geraete
nur ueber den Import erfassen — fuer einen Bestand richtig, fuer ein einzelnes
nachbeschafftes Geraet umstaendlich.

Neu:
- /geraete/neu und /geraete/<id>/bearbeiten, beide ueber dieselbe Komponente
- Die Lagerung ist ein Umschalter statt zweier Auswahlfelder. Standort und
  Fahrzeug schliessen sich aus; so kann der Fehler gar nicht erst entstehen,
  den die Datenbank sonst abweisen wuerde. Beim Wechsel des Fahrzeugs wird die
  Raumangabe zurueckgesetzt.
- Prueftermin und Lebensdauerende werden beim Tippen vorgerechnet, mit
  denselben Funktionen wie auf dem Server. Beim Speichern rechnet der Server
  erneut und behaelt das letzte Wort.
- Gibt es nur einen Standort, ist er beim Anlegen vorbelegt.
- Knopf "Neues Geraet" in der Liste, "Bearbeiten" auf der Detailseite

Behoben:
- Das Formular stuerzte beim ersten Rechnen ab. Die Vorgabewerte lagen in einem
  "use client"-Modul und wurden von einer Server-Komponente importiert; dort
  kommt nur eine Client-Referenz an, kein Objekt, und das Spreaden ergibt lauter
  undefined. Die Werte liegen jetzt in geraet-formular-werte.ts ohne
  "use client".
- Das Sternchen an Pflichtfeldern wurde von Sprachausgaben mitgelesen
  ("Bezeichnung Stern"). Es traegt jetzt aria-hidden; dass ein Feld ausgefuellt
  werden muss, sagt bereits das required-Attribut.
- Fehlermeldungen in Formularen sind eindeutig ansteuerbar. Next.js haengt
  einen eigenen Routen-Ansager mit der Rolle "alert" in jede Seite.

Tests:
- 7 neue Playwright-Tests zum Formular, darunter die Lagerungsregel und die
  Fristenvorschau
- Zwei davon laufen nicht unter Touch-Emulation: Chromium nimmt dort keine
  zeichenweise Eingabe in Datumsfelder an. Begruendet uebersprungen, die
  Rechnung selbst deckt qr-und-fristen.test.ts ab.
- Insgesamt 104 Unit-Tests und 56 E2E-Tests gruen

Anleitung, Changelog, Devlog, Aufwandsschaetzung und Roadmap fortgeschrieben.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
This commit is contained in:
Florian Wilde
2026-09-03 09:20:30 +02:00
co-authored by Claude Opus 5
parent 47b8e36a38
commit 1744403620
26 changed files with 1237 additions and 22 deletions
+59 -1
View File
@@ -12,7 +12,65 @@ Die aufgewendete Zeit wandert nach jedem Abschnitt in die Spalte
|---|---:|---:|---|
| Phase 0 — Fundament | 1:00 h | 1 | 03.09.2026 |
| Phase 1 — Stammdaten | 1:15 h | 1 | 03.09.2026 |
| **Summe** | **2:15 h** | **2** | |
| Phase 1 — Nachtrag Geräteformular | 0:50 h | 1 | 03.09.2026 |
| **Summe** | **3:05 h** | **3** | |
---
## 2026-09-03 · Phase 1 — Nachtrag: Geräteformular
**08:30 – 09:20 · 0:50 h**
### Was entstanden ist
Die letzte offene Lücke aus Phase 1: ein Formular zum Anlegen und Bearbeiten
eines einzelnen Geräts. Bis dahin konnte man Geräte nur über den Import
erfassen — für einen Bestand richtig, für den einen nachbeschafften Gerät
umständlich.
| Datei | Inhalt |
|---|---|
| `components/stammdaten/geraet-formular.tsx` | das Formular, geteilt von Anlegen und Bearbeiten |
| `components/stammdaten/geraet-formular-werte.ts` | Typ und Vorgabewerte, bewusst ohne `"use client"` |
| `components/ui/textarea.tsx` | fehlender Baustein |
| `app/(app)/geraete/neu/page.tsx` | Anlegen |
| `app/(app)/geraete/[id]/bearbeiten/page.tsx` | Bearbeiten |
| `tests/e2e/geraet-formular.spec.ts` | 7 Tests |
### Entscheidungen
**Die Lagerung ist ein Umschalter, keine zwei Auswahlfelder.** Standort und
Fahrzeug schließen sich aus. Zwei nebeneinanderstehende Felder laden dazu ein,
beide zu füllen; die Datenbank weist das ab, aber eine Fehlermeldung nach dem
Absenden ist schlechter als ein Formular, in dem der Fehler gar nicht möglich
ist. Beim Wechsel des Fahrzeugs wird der Geräteraum geleert — er gehört zum
Fahrzeug.
**Die Fristen werden schon beim Tippen vorgerechnet.** Wer ein Prüfintervall
einträgt, sieht sofort, wann die nächste Prüfung fällig wird. Gerechnet wird
mit denselben Funktionen wie auf dem Server; beim Speichern rechnet der Server
erneut und behält das letzte Wort. Die Vorschau ist Anzeige, keine Quelle.
**Bei nur einem Standort wird er vorbelegt.** Das ist bei den meisten Wehren
der Fall, und ein Pflichtfeld weniger ist ein Klick weniger.
### Wo es gehakt hat
| Problem | Ursache | Lösung |
|---|---|---|
| Formular stürzte beim ersten Rechnen ab | `LEERES_GERAET` lag im `"use client"`-Modul; eine Server-Komponente bekommt beim Import nur eine Client-Referenz, das Spreaden ergibt `undefined` | Werte in ein eigenes Modul ohne `"use client"` |
| E2E fand die Felder nicht | `getByLabel` vergleicht den Text des `<label>`, nicht den zugänglichen Namen — am Pflichtfeld steht dort ein Sternchen | Tests suchen über die Rolle; das Sternchen bekam zusätzlich `aria-hidden`, weil es sonst vorgelesen wird |
| `fill()` blieb bei Datumsfeldern wirkungslos | Chromium nimmt bei `input[type=date]` keinen gesetzten Wert über `fill()` an | Datum wird getippt, wie es ein Mensch auch täte |
| Zwei Tests scheiterten unter Touch-Emulation | dort öffnet Chromium den Auswähler des Betriebssystems statt Zeichen anzunehmen | begründet übersprungen; die Rechnung selbst deckt der Unit-Test ab |
| Anmeldung im Screenshot-Skript lief ins Zeitlimit | bei kaltem `.next` übersetzt `next dev` die Route erst beim ersten Aufruf | Zeitlimit von 20 auf 90 Sekunden |
### Nachweise
- `npm run typecheck` — ohne Ausgabe
- `npm run test` — 104 Tests grün
- `npm run test:e2e` — 56 grün, 2 begründet übersprungen
- `npm run build` — 19 Routen
- Testgeräte aus dem E2E-Lauf wurden aus der Entwicklungsdatenbank entfernt
---