florian.wilde/Laufzettel
1
0
Fork 0
Code Issues 5 Pull Requests Actions 4 Packages Projects Releases 1 Wiki Activity

Phase 1: MVP #1

New Issue
Closed
opened 2026-09-24 20:44:38 +00:00 by florian.wilde · 0 comments
florian.wilde commented 2026-09-24 20:44:38 +00:00
Owner
Copy Link
Copy Source

Status: erledigt
Meilenstein: v0.1.0
Labels: phase-1
Geschätzt: 148 h Tatsächlich: 35 h 20 min

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.

Quelle: docs/issues/001-epic-phase-1-mvp.md — dort gepflegt, hierher gespiegelt.

Abgeschlossen am 2026-09-26 mit v0.1.0. Vierzehn Meilensteine in 35 h 20 min, 1131 Vitest-Tests und 198 Ende-zu-Ende-Abläufe grün, 60 von 61 Abnahmekriterien abgehakt. Offen bleibt allein der Lauf des Proxmox-Einzeilers auf einem echten PVE-Host (#38) — hier stand keiner zur Verfügung.

**Status:** erledigt **Meilenstein:** v0.1.0 **Labels:** phase-1 **Geschätzt:** 148 h **Tatsächlich:** 35 h 20 min ## 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 - [x] #005 M0 – Gerüst, Prozess, Design-Token - [x] #006 M1 – Datenmodell - [x] #007 M2 – Auth, Rollen, Benutzer - [x] #008 M3 – Betriebsmodus und Kunden - [x] #009 M4 – Vorlagen-Versionierung im Service - [x] #010 M5 – Vorlagen-Editor - [x] #011 M6 – Mitarbeiter, Abteilungen, Geräte - [x] #012 M7 – Platzhalter, Namensregeln, Escaping - [x] #013 M8 – Läufe: Service und Abarbeitung - [x] #014 M9 – QR-Tags, Geräteseite, Etiketten, Scanner - [x] #015 M10 – Dashboard und Archiv - [x] #016 M11 – Verzeichnis und LDAP-Abgleich - [x] #017 M12 – Seed der sieben Vorlagen - [x] #018 M13 – E2E-Tests, Anleitung, PDF - [x] #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: - [x] `docker compose up` startet App und Datenbank, Migrationen laufen automatisch, Datenbank von außen nicht erreichbar - [x] Proxmox-One-Liner rollt einen lauffähigen LXC aus, erneuter Aufruf aktualisiert - [x] Lokaler Login funktioniert, OIDC für authentik dokumentiert - [x] Lauf ohne Mitarbeiter und ohne Gerät: starten, abschließen, archivieren - [x] Hauptablauf in beiden Betriebsmodi, Moduswechsel in beiden Richtungen nach Regel - [x] LDAP-Abgleich gegen Testcontainer: anlegen, aktualisieren, deaktivieren - [x] Veröffentlichte Vorlagenversion unveränderlich, Archiv schreibgeschützt - [x] `{{generiertes_passwort}}` nirgends persistiert - [x] Am Handy kein horizontales Scrollen - [x] `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. --- Quelle: `docs/issues/001-epic-phase-1-mvp.md` — dort gepflegt, hierher gespiegelt. --- **Abgeschlossen am 2026-09-26** mit [v0.1.0](https://git.wilde-server.de/florian.wilde/Laufzettel/releases/tag/v0.1.0). Vierzehn Meilensteine in 35 h 20 min, 1131 Vitest-Tests und 198 Ende-zu-Ende-Abläufe grün, 60 von 61 Abnahmekriterien abgehakt. Offen bleibt allein der Lauf des Proxmox-Einzeilers auf einem echten PVE-Host (#38) — hier stand keiner zur Verfügung.
florian.wilde added this to the v0.1.0 milestone 2026-09-24 20:44:38 +00:00
florian.wilde added the phase-1 label 2026-09-24 20:44:38 +00:00
Sign in to join this conversation.
No Branch/Tag Specified
Branches Tags
Labels
Clear labels
backend
Datenmodell, Services, Queries
 bug
Fehler
 docs
README, Anleitung, Devlog, Changelog
 frontend
Oberflaeche, Komponenten, Design
 infra
Docker, Compose, Proxmox, CI, Release
 phase-1
Phase 1 – MVP
 phase-2
Phase 2 – SCIM, Graph, Bausteine, Anhaenge
 phase-3
Phase 3 – PDF-Protokoll, bedingte Schritte, Freigabe
 phase-4
Phase 4 – Aktionen, Connectors, REST-API
 security
Rechte, Geheimnisse, Datenschutz
 test
Vitest, Playwright, Testdaten
No labels phase-1
Milestone
No items
No Milestone v0.1.0
Projects
Clear projects
No projects
Assignees
Clear assignees
florian.wilde (Florian Wilde)
No Assignees
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: florian.wilde/Laufzettel#1