florian.wilde/Laufzettel
1
0
Fork 0
Code Issues 5 Pull Requests Actions 4 Packages Projects Releases 1 Wiki Activity
Files
10e272654f9af64417ea56c52ac9a3284aaa0c42
Laufzettel/docs/issues/019-betrieb-release.md
T
Florian WildeandClaude Opus 5 10e272654f
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(doku): Anleitung, PDF und Ende-zu-Ende-Abnahme 
Neun Kapitel unter docs/anleitung/ fuer Technik und Verwaltung, mit 35
Bildern aus `pnpm docs:screenshots` und einem Fehlerbehebungskapitel aus
echten Meldungen. `pnpm docs:pdf` macht daraus 72 Seiten A4 — hell
gedruckt, mit Deckblatt, Inhaltsverzeichnis und Seitenzahlen, ohne neue
Abhaengigkeit.

Die Ablaeufe pruefen ihre Voraussetzungen, bevor der erste startet:
antwortet ein gebauter Stand, steht der Seed-Bestand, und liest der
Server dieselbe Datenbank wie der Testprozess. Jeder Ablauf legt an, was
er braucht, und raeumt es weg. Vier neue kommen dazu: Hauptablauf,
Onboarding mit Vergleich der Zwischenablage, Rollen und 390 px auf
achtzehn Seiten.

Drei Fehler kamen dabei heraus. Das Projekt „handy" pruefte 412 px statt
der verlangten 390. Ein angemeldeter Benutzer ohne Recht erfuhr nie,
warum er abgewiesen wurde — die Meldung stand auf einer Seite, die ihn
sofort weiterleitet; jetzt gibt es /kein-zugriff. Und der
Verzeichnis-Ablauf schrieb die Attributzuordnung der ersten vorhandenen
Quelle um, in einer echten Installation also der produktiven.

101 Ablaeufe in INTERN und 97 in DIENSTLEISTUNG, beide ohne Fehlschlag.

Closes #18

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

3.3 KiB
Raw Blame History

#019 M14 – Betriebswege und Release v0.1.0

Status: offen Meilenstein: v0.1.0 Labels: phase-1, infra, docs Geschätzt: 10 h Tatsächlich: –

Ziel

Zwei erprobte Wege in den Betrieb und ein sauberes erstes Release.

Aufgaben

  • deploy/install.sh: native Installation auf Debian 13 — PostgreSQL 17 mit listen_addresses = '' (nur Unix-Socket), Node 24 aus dem NodeSource-Repo, corepack/pnpm, Dienstnutzer laufzettel ohne Login, Quellcode nach /opt/laufzettel, pnpm install, pnpm build, prisma migrate deploy, prisma db seed

  • Geheimnisse im Zielsystem erzeugen: APP_SECRET per openssl rand -base64 48, Zufallspasswörter für Datenbank und Admin; Ablage in /etc/laufzettel/laufzettel.env mit Modus 0600 und Eigentümer root

  • laufzettel.service: systemd-Unit für den Next-standalone-Server, User=laufzettel, EnvironmentFile=, NoNewPrivileges=yes, ProtectSystem=strict, PrivateTmp=yes, Restart=on-failure

  • Erneuter Aufruf aktualisiert statt neu anzulegen: git pull, pnpm build, migrate deploy, systemctl restart; Geheimnisse und Daten bleiben

  • deploy/proxmox/laufzettel.sh: One-Liner für die Proxmox-Shell — set -Eeuo pipefail, trap mit Zeilennummer, farbige Ausgabe, Spinner, Prüfung auf PVE 8/9 und root

  • whiptail-Dialog Standard gegen Erweitert; Standard: nächste freie CTID, Hostname laufzettel, Debian 13, 2 Kerne, 2 GB RAM, 8 GB Platte, unprivilegiert, DHCP auf vmbr0

  • Debian-Vorlage bei Bedarf per pveam holen, pct create, starten, deploy/install.sh im Container ausführen

  • --dry-run: gibt alle pct-Aufrufe nur aus, ohne etwas anzulegen

  • Abschlussbildschirm: URL, Admin-Kennung, erzeugtes Passwort, Hinweis auf Reverse Proxy und docs/betrieb/

  • docs/betrieb/: inbetriebnahme.md, proxmox.md, reverse-proxy.md, authentik.md, sicherung.md (pg_dump über den Dienstnamen bzw. den Unix-Socket)

  • Prüfliste für den Lauf auf echtem Proxmox, da ich den pct-Teil hier nicht ausführen kann

  • docs/abnahme-mvp.md abschließend durchgehen, Review-Agent gegen alle Kriterien, Befunde als Issues

  • Devlog-Phasenzusammenfassung: Gesamtstunden, Stunden je Meilenstein, größte Zeitfresser, Abweichung vom Plan

  • CHANGELOG.md für v0.1.0 mit Datum, Version in package.json, Tag v0.1.0, Gitea-Release mit Changelog-Auszug, Anleitung als PDF beigelegt

  • Die Anleitung als PDF (pnpm docs:pdf) dem Gitea-Release als Datei beilegen — im Repo liegt sie nicht, sie entsteht aus den Kapiteln und Bildern

Akzeptanzkriterien

  • docker run --rm debian:13 mit deploy/install.sh installiert vollständig durch: Postgres läuft, Migration und Seed gelaufen, Dienst antwortet auf /api/gesundheit
  • Im nativen Weg lauscht PostgreSQL auf keinem TCP-Port (ss -ltn zeigt 5432 nicht)
  • Ein zweiter Lauf von deploy/install.sh aktualisiert und löscht keine Daten
  • bash deploy/proxmox/laufzettel.sh --dry-run gibt einen plausiblen, vollständigen pct create-Aufruf aus
  • shellcheck --severity=warning über alle Skripte ohne Befund
  • Im Compose-Weg ist die Datenbank vom Host nicht erreichbar, aus web schon
  • pnpm pruefe:doku grün, v0.1.0 getaggt und als Gitea-Release veröffentlicht
  • Alle Kriterien aus docs/abnahme-mvp.md abgehakt oder als Folge-Issue erfasst
Reference in New Issue View Git Blame Copy Permalink