Files
Laufzettel/docs/issues/017-seed-sieben-vorlagen.md
T
Florian WildeandClaude Opus 5 49ce06f206
Prüfung / pruefung (push) Canceled after 0s
Prüfung / e2e (push) Canceled after 0s
feat: Projektgerüst, gehärteten Betriebsstand und Prozess aufsetzen
Legt die Grundlage, auf der alle weiteren Meilensteine nur noch Fachlichkeit
ergänzen: Next 16 mit App Router und TypeScript strict, Tailwind 4, Prisma 7,
Vitest 5, Playwright, ESLint, Prettier und die Hooks für Lint und Commits.

Zwei Dinge sind bewusst so gebaut und durch Tests festgehalten:

Die Datenbank ist im Betriebsstand von außen nicht erreichbar. Sie hat kein
ports:-Mapping und hängt allein im Netz "intern", das ohne Gateway läuft; nur
"web" kommt zusätzlich nach draußen. tests/betriebsstand.test.ts schlägt an,
falls ein Port-Mapping zurückkehrt. Geprüft, nicht behauptet: docker compose up
startet den Stack, 5432 ist vom Host aus zu, aus "web" offen.

pnpm pruefe:doku hält Dokumentation und Code zusammen — Version im Changelog,
Issue-Dateien gegen ihre Übersicht, keine Verweise auf fehlende Dateien, keine
fehlenden Bilder. Das Skript wurde gegen vier eingebaute Fehler gegengeprüft.

Drei Versions-Obergrenzen sind nötig und in CLAUDE.md begründet: eslint bleibt
auf 9.x, weil eslint-plugin-react keinen Nachfolger für eslint 10 hat und das
Regelwerk sonst beim Laden abbricht; typescript bleibt auf 6.0.x, weil
typescript-eslint TypeScript 7 noch nicht unterstützt; prisma ist exakt auf
7.10.0 gepinnt, weil sein latest-Tag auf einen 8.0-RC zeigt, der von
@prisma/client aber nicht.

Auth.js entfällt entgegen der ursprünglichen Vorgabe: v5 steht dauerhaft auf
Beta, das Projekt ist im Wartungsmodus und sein Prisma-Adapter deckt Prisma 7
nicht ab. Stattdessen openid-client und jose, wie in ProxLedger.

Dieser erste Commit geht direkt auf main, weil es noch keinen Branch gibt, von
dem abzuzweigen wäre. Ab #006 läuft jedes Issue über einen eigenen Branch.

Closes #5

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
2026-09-24 23:33:49 +02:00

3.0 KiB
Raw Blame History

#017 M12 – Seed der sieben Vorlagen

Status: offen Meilenstein: v0.1.0 Labels: phase-1, backend Geschätzt: 8 h Tatsächlich: –

Ziel

Die App ist nach dem Seed fachlich sofort brauchbar: sieben vollständige, fachlich korrekte Vorlagen als veröffentlichte Version 1.

Aufgaben

  • Vorlage 1 „PC Neuinstallation" (Client), Variablen os_version, join_typ; Abschnitte Vorbereitung, Installation, Einbindung, Software, Sicherheit, Benutzer, Abschluss
  • Vorlage 2 „Mitarbeiter-Onboarding" (Benutzer), Variablen konto_typ, vorname, nachname, upn, sam, mail, abteilung, ou, gruppen, eintrittsdatum, vorgesetzter; beide Konto-Abschnitte (AD und Entra ID), weil bedingte Abschnitte erst Phase 3 sind
  • Vorlage 3 „Mitarbeiter-Offboarding" (Benutzer), Variablen austrittsdatum, ou_gesperrt, postfach_verbleib, vertreter
  • Vorlage 4 „Server-Inbetriebnahme Windows-VM" (Server), Variablen vmid, ip_adresse, vlan, rolle, os_version
  • Vorlage 5 „Firewall-Rollout OPNsense" (Netzwerk), Variablen wan_typ, lan_netz, vpn_typ
  • Vorlage 6 „Monatlicher Patchday" (Wartung), Variable monat
  • Vorlage 7 „Backup-Restore-Test" (Wartung), Variablen system, restore_typ
  • Alle Schritte wortgetreu nach Auftrag mit Typ, Pflichtkennzeichen und konfig; die im Auftrag genannten Hilfetexte übernehmen, die übrigen fachlich korrekt und kurz ergänzen
  • 5 Mitarbeiter, darunter „Maria Huber", m.huber@firma.example, sam mhuber, Abteilung Buchhaltung, Vorgesetzte „Petra Klein"
  • 3 Abteilungen: Buchhaltung → OU=Buchhaltung,OU=Benutzer,DC=firma,DC=local mit Gruppen G-Buchhaltung, G-Alle; Vertrieb; IT
  • Eine deaktivierte Verzeichnisquelle als Beispielkonfiguration
  • Geräte PC-001 (PC, LZ-7K3F9Q, Besitzerin Maria Huber) und NB-001 (Notebook, LZ-M2XH4T), dazu 5 unregistrierte Tags
  • GeraetetypVorlage: PC und NOTEBOOK → „PC Neuinstallation"; SERVER → „Server-Inbetriebnahme Windows-VM" und „Backup-Restore-Test"; FIREWALL → „Firewall-Rollout OPNsense"
  • SEED_MODE=DIENSTLEISTUNG (Alias SERVICE) erzeugt stattdessen „Musterfirma GmbH" (MUS) und „Bäckerei Reiter" (REI) mit je einer Person, einer Abteilung und einem Gerät
  • Alles idempotent über upsert mit stabilen Schlüsseln

Akzeptanzkriterien

  • pnpm db:seed zweimal hintereinander: keine Fehler, keine Duplikate, keine geänderten Zeilen
  • Alle sieben Vorlagen liegen als VEROEFFENTLICHT, Version 1 vor
  • Im Onboarding-Lauf steht im Schritt „Konto anlegen" der vollständige New-ADUser-Befehl mit Name, UPN, -Path "OU=Buchhaltung,OU=Benutzer,DC=firma,DC=local" und der Gruppen-Befehl mit G-Buchhaltung, G-Alle
  • SEED_MODE=SERVICE erzeugt MUS-PC-001 gemäß Hostname-Regel {kundenkuerzel}-PC-{nnn}
  • Die Beispiel-Verzeichnisquelle ist deaktiviert und löst keinen Abgleich aus
  • Kein Seed-Datensatz enthält ein Klartext-Passwort außer dem Admin-Passwort aus der Umgebung, und das nur als argon2-Hash