Florian WildeandClaude Opus 5
49ce06f206
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>
49 lines
2.6 KiB
Markdown
49 lines
2.6 KiB
Markdown
# #001 Phase 1: MVP
|
||
|
||
**Status:** in Arbeit
|
||
**Meilenstein:** v0.1.0
|
||
**Labels:** phase-1
|
||
**Geschätzt:** – **Tatsächlich:** –
|
||
|
||
## Ziel
|
||
|
||
Eine selbst gehostete Checklisten-App für wiederkehrende IT-Arbeiten: versionierte Vorlagen, daraus gestartete Läufe, im Team abgearbeitet, abgeschlossen und unveränderlich archiviert. Ein Lauf hängt optional an einem Mitarbeiter und optional an einem Gerät, woraus im Archiv eine Historie je Gerät und je Mitarbeiter entsteht. Einstieg über QR-Aufkleber mit unveränderlichem `tagCode`. Zwei Betriebsmodi (`INTERN`, `DIENSTLEISTUNG`) in einem Codepfad, zwei Betriebswege (gehärteter Compose-Stack, nativer LXC per One-Liner).
|
||
|
||
## Untergeordnete Issues
|
||
|
||
- [ ] #005 M0 – Gerüst, Prozess, Design-Token
|
||
- [ ] #006 M1 – Datenmodell
|
||
- [ ] #007 M2 – Auth, Rollen, Benutzer
|
||
- [ ] #008 M3 – Betriebsmodus und Kunden
|
||
- [ ] #009 M4 – Vorlagen-Versionierung im Service
|
||
- [ ] #010 M5 – Vorlagen-Editor
|
||
- [ ] #011 M6 – Mitarbeiter, Abteilungen, Geräte
|
||
- [ ] #012 M7 – Platzhalter, Namensregeln, Escaping
|
||
- [ ] #013 M8 – Läufe: Service und Abarbeitung
|
||
- [ ] #014 M9 – QR-Tags, Geräteseite, Etiketten, Scanner
|
||
- [ ] #015 M10 – Dashboard und Archiv
|
||
- [ ] #016 M11 – Verzeichnis und LDAP-Abgleich
|
||
- [ ] #017 M12 – Seed der sieben Vorlagen
|
||
- [ ] #018 M13 – E2E-Tests, Anleitung, PDF
|
||
- [ ] #019 M14 – Betriebswege und Release v0.1.0
|
||
|
||
## Akzeptanzkriterien
|
||
|
||
Die vollständige Liste steht in `docs/abnahme-mvp.md` und wird von #019 abschließend geprüft. Kern:
|
||
|
||
- [ ] `docker compose up` startet App und Datenbank, Migrationen laufen automatisch, Datenbank von außen nicht erreichbar
|
||
- [ ] Proxmox-One-Liner rollt einen lauffähigen LXC aus, erneuter Aufruf aktualisiert
|
||
- [ ] Lokaler Login funktioniert, OIDC für authentik dokumentiert
|
||
- [ ] Lauf ohne Mitarbeiter und ohne Gerät: starten, abschließen, archivieren
|
||
- [ ] Hauptablauf in beiden Betriebsmodi, Moduswechsel in beiden Richtungen nach Regel
|
||
- [ ] LDAP-Abgleich gegen Testcontainer: anlegen, aktualisieren, deaktivieren
|
||
- [ ] Veröffentlichte Vorlagenversion unveränderlich, Archiv schreibgeschützt
|
||
- [ ] `{{generiertes_passwort}}` nirgends persistiert
|
||
- [ ] Am Handy kein horizontales Scrollen
|
||
- [ ] `v0.1.0` getaggt, Anleitung mit Screenshots und als PDF
|
||
|
||
## Entscheidungen
|
||
|
||
- **Deutsch im Code.** Auch Prisma-Modelle, Felder und Enum-Werte sind deutsch, Umlaute ASCII-gefaltet. Abweichung vom Auftragstext, bewusst zugunsten der Einheitlichkeit mit ProxLedger. Verbindliche Namensabbildung in `CLAUDE.md`.
|
||
- **Kein Auth.js.** v5 ist dauerhaft Beta und im Wartungsmodus, der Prisma-Adapter deckt Prisma 7 nicht ab. Stattdessen `openid-client` + `jose` wie in ProxLedger.
|