florian.wilde/Laufzettel
1
0
Fork 0
Code Issues 5 Pull Requests Actions 4 Packages Projects Releases 1 Wiki Activity
Files
abacad1cb7fb3d22c96e98041389f3364e20acf0
Laufzettel/docs/abnahme-mvp.md
T
Florian WildeandClaude Opus 5 abacad1cb7
Prüfung / pruefung (push) Canceled after 0s
Details
Prüfung / pruefung (pull_request) Canceled after 0s
Details
Prüfung / e2e (push) Canceled after 0s
Details
Prüfung / e2e (pull_request) Canceled after 0s
Details
feat(vorlagen): Versionierung, Unveraenderlichkeit und JSON-Austausch 
Eine veroeffentlichte Vorlagen-Version ist fuer immer unveraenderlich — daran
haengt, dass ein archivierter Lauf in zehn Jahren noch genau die Schritte zeigt,
mit denen er gestartet wurde. Die Regel steht deshalb zweimal: im Service, der
die verstaendliche Meldung gibt, und in der Datenbank, die die Garantie gibt.
Vier Trigger fangen Schreibzugriffe ab, die nicht durch den Service kommen —
Migrationen, psql, der Seed und ab Phase 4 die Connectoren — und versperren den
Rueckweg nach ENTWURF, der alles andere ausgehebelt haette.

- Service: anlegen, Kopfdaten bearbeiten, Entwurf als tiefe Kopie der letzten
  veroeffentlichten Version, speichern, veroeffentlichen, verwerfen,
  duplizieren, archivieren
- Hoechstens ein Entwurf je Vorlage, durchgesetzt vom partiellen Index; zwei
  gleichzeitige Klicks auf „Bearbeiten“ bekommen denselben Entwurf statt eines
  Fehlers
- Optimistisches Sperren ueber geaendertAm: wer auf einem ueberholten Stand
  speichert, wird abgewiesen statt die Arbeit des anderen spurlos zu ersetzen
- JSON-Export und -Import samt Format-Dokumentation; der Export ist nachsichtig,
  der Import streng
- src/lib/validierung.ts als einzige Zod-Quelle mit deutschen Meldungen, per
  ESLint-Regel erzwungen

Der unabhaengige Review fand drei Blocker, alle an der Mandantengrenze: der
Suchfilter brachte ein zweites OR mit und ueberschrieb die Kundenbedingung,
Historie und Aufbau einer Version filterten gar nicht. Zu queries/vorlagen.ts
gab es keinen Test — jetzt gibt es tests/vorlagen-sicht.test.ts.

428 Tests gruen (vorher 336).

Schliesst #009

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
2026-09-25 08:09:21 +02:00

5.3 KiB
Raw Blame History

Abnahmekriterien für den MVP (v0.1.0)

Diese Liste wird von #019 abschließend durchgegangen. Jeder Punkt ist entweder abgehakt oder hat ein Folge-Issue — nichts bleibt stillschweigend offen.

Betrieb

  • docker compose up startet App und Datenbank, Migrationen laufen automatisch
  • Seed läuft per dokumentiertem Befehl, nicht automatisch
  • Die Datenbank ist vom Host aus nicht erreichbar (nc -z localhost 5432 schlägt fehl), aus web schon
  • Der Proxmox-One-Liner rollt einen LXC aus, in dem die App läuft und PostgreSQL nur am Unix-Socket hört
  • Erneuter Aufruf des Skripts aktualisiert, ohne Daten oder Geheimnisse zu verlieren
  • shellcheck --severity=warning über alle Skripte ohne Befund
  • Läuft hinter einem Reverse Proxy ohne fest verdrahtete Adressen

Anmeldung und Rechte

  • Login per lokalem Konto funktioniert
  • OIDC ist konfigurierbar und für authentik dokumentiert, inkl. Gruppen für Rollen
  • Bei AUTH_LOCAL_ENABLED=false ist der lokale Login weg und der Endpunkt lehnt ab
  • Rollenrechte: jede Rolle gegen jede Aktion getestet, Prüfung ausschließlich serverseitig
  • Eine Rollenänderung greift ohne neue Anmeldung; ein deaktivierter Benutzer wird abgewiesen
  • Passwörter stehen nur als argon2-Hash in der Datenbank, nie in einer API-Antwort

Betriebsmodus

  • Hauptablauf läuft in INTERN ohne jede Kundenanzeige (Ausnahme: die Einstellungsseite und der Wechsel-Dialog zeigen die eigene Organisation — dort ist sie zu pflegen)
  • Hauptablauf läuft in DIENSTLEISTUNG mit Kundenwahl
  • Wechsel INTERN → DIENSTLEISTUNG übernimmt alle Daten auf den ersten Kunden
  • Wechsel zurück wird bei zwei nicht archivierten Kunden abgelehnt
  • Im Modus INTERN ignoriert die Service-Schicht eine mitgeschickte kundeId
  • Der Modus ist ohne Neustart umschaltbar, jeder Wechsel steht im Protokoll

Vorlagen

  • Veröffentlichte Version ist unveränderlich; „Bearbeiten“ erzeugt eine tiefe Kopie als Entwurf
  • Höchstens ein Entwurf je Vorlage
  • Veröffentlichen einer neuen Version verändert bestehende Läufe nicht
  • Export und anschließender Import ergeben eine inhaltsgleiche Vorlage
  • Unbekannte Platzhalter werden im Editor als Warnung angezeigt

Läufe und Archiv

  • Lauf ohne Mitarbeiter und ohne Gerät lässt sich starten, abschließen und archivieren
  • Abschließen scheitert, solange ein Pflichtschritt offen ist
  • NICHT_ZUTREFFEND und FEHLGESCHLAGEN verlangen eine Notiz
  • „Abschnitt als nicht zutreffend markieren“ setzt alle Schritte mit einer Notiz
  • Archiv-Schreibschutz greift für Kopfdaten, Schrittergebnisse und Kommentare
  • Nur ADMIN holt einen archivierten Lauf zurück, mit Protokoll-Eintrag
  • Im Archiv wird über Titel, Notizen, Werte und Kommentare gefunden
  • Druckansicht eines Laufs ist sauber und hell

Mitarbeiter, Geräte, QR

  • Mitarbeitersuche liefert standardmäßig nur aktive, Umschalter zeigt auch deaktivierte
  • Ein von der Geräteseite gestarteter Lauf hat den Besitzer vorbelegt
  • /t/LZ-7K3F9Q ohne Anmeldung führt nach dem Login auf die Geräteseite
  • „Vorlage zuweisen“ erzeugt einen OFFEN-Lauf, der unter „Zugewiesen“ erscheint; „Starten“ setzt IN_ARBEIT
  • Unregistrierter Tag → Registrierformular → Geräteseite; unbekannter Tag → Hinweis
  • tagCode: richtiges Alphabet, eindeutig, unveränderlich, nie wiederverwendet
  • Etikettendruck in beiden Layouts sauber; QR maschinell zurücklesbar

Platzhalter und Befehle

  • Onboarding: Vorname und Nachname eingeben → UPN, sam und Mail werden vorgeschlagen
  • Abteilung „Buchhaltung“ wählen → -Path "OU=Buchhaltung,…" und Gruppen G-Buchhaltung, G-Alle
  • Kopieren liefert exakt diesen Text, zeichengenau
  • „Jörg Müller-Lüdenscheid“ ergibt gültige Vorschläge (joerg.mueller-luedenscheid@…, jmuellerluedensch)
  • {{generiertes_passwort}} erscheint im Befehl, steht aber nicht in Datenbank, Druckansicht oder Protokoll
  • Werte mit Anführungszeichen werden für die jeweilige Shell korrekt maskiert
  • „Alle Befehle als Skript kopieren“ liefert die Schritte in richtiger Reihenfolge
  • Unbekannte Platzhalter bleiben stehen; ersetzte Werte sind HTML-escaped

Verzeichnis (LDAP)

  • Erster Abgleich legt Mitarbeiter an, zweiter aktualisiert sie ohne Duplikate
  • Entfernte oder deaktivierte Konten werden aktiv = false, nie gelöscht
  • {{ou}} wird korrekt aus dem dn abgeleitet
  • Das Bind-Passwort erscheint in keiner API-Antwort und keinem Log
  • Zwei gleichzeitige Abgleiche derselben Quelle: der zweite wird von der Sperre abgewiesen

Oberfläche

  • Am Handy kein horizontales Scrollen — bei 390 px auf allen Hauptseiten geprüft
  • Gestaltung nach Vorgabe: dunkel, ein Akzent, keine Emojis, keine Schatten, keine Verläufe
  • Version mit Git-SHA unten links

Projektorganisation

  • Issues für alle Phasen und MVP-Meilensteine existieren
  • CHANGELOG.md und docs/devlog.md sind gepflegt
  • v0.1.0 ist getaggt, Gitea-Release mit Changelog-Auszug
  • docs/anleitung/ vollständig mit Screenshots und als PDF
  • docs/screenshots/ enthält die Meilenstein-Bilder
  • pnpm lint && pnpm typecheck && pnpm test && pnpm pruefe:doku grün
Reference in New Issue View Git Blame Copy Permalink