Fix #27: Datenbankbefehle benennen, welcher Rückfragen stellt #31

Merged
florian.wilde merged 1 commits from fix/27-db-befehle into main 2026-08-23 17:36:07 +00:00
Owner

Neuer Abschnitt Die Datenbankbefehle in der README: alle sieben Befehle mit Zweck und der Angabe, welcher interaktiv ist. Es ist genau einer — db:migrate.

Dazu zwei Ungenauigkeiten in der README behoben, die mir dabei aufgefallen sind:

  • Die Ersteinrichtung rief npx prisma migrate dev --name fundament auf, obwohl es dafür npm run setup gibt. Das war der Ausgangspunkt der Verwirrung.
  • Der Hinweis unter Betriebswissen, die SQL-Skripte seien von Hand anzustoßen, galt nur für die Ersteinrichtung — beim Aktualisieren erledigt update.sh das mit. Steht jetzt dabei.

db:migrate bleibt bestehen: Der interaktive Ablauf hat seinen Platz, etwa um eine verkorkste Entwicklungsdatenbank zurückzusetzen. Er ist nur nicht mehr der Standardweg — dafür gibt es seit #24 den Wrapper.

docs/INSTALLATION.md brauchte nichts: Sie nennt für den Server bereits denselben Weg wie scripts/update.sh (node node_modules/prisma/build/index.js db execute).

Nur Dokumentation. 647 Unit-Tests grün, Lint sauber.

Closes #27

Neuer Abschnitt **Die Datenbankbefehle** in der README: alle sieben Befehle mit Zweck und der Angabe, welcher interaktiv ist. Es ist genau einer — `db:migrate`. Dazu zwei Ungenauigkeiten in der README behoben, die mir dabei aufgefallen sind: - Die Ersteinrichtung rief `npx prisma migrate dev --name fundament` auf, obwohl es dafür `npm run setup` gibt. Das war der Ausgangspunkt der Verwirrung. - Der Hinweis unter *Betriebswissen*, die SQL-Skripte seien von Hand anzustoßen, galt nur für die Ersteinrichtung — beim Aktualisieren erledigt `update.sh` das mit. Steht jetzt dabei. `db:migrate` bleibt bestehen: Der interaktive Ablauf hat seinen Platz, etwa um eine verkorkste Entwicklungsdatenbank zurückzusetzen. Er ist nur nicht mehr der Standardweg — dafür gibt es seit #24 den Wrapper. `docs/INSTALLATION.md` brauchte nichts: Sie nennt für den Server bereits denselben Weg wie `scripts/update.sh` (`node node_modules/prisma/build/index.js db execute`). Nur Dokumentation. 647 Unit-Tests grün, Lint sauber. Closes #27
florian.wilde added 1 commit 2026-08-23 17:35:56 +00:00
"npm run db:migrate" ist "prisma migrate dev" und damit interaktiv: Es
fragt nach einem Namen und bietet an, die Datenbank zurueckzusetzen. In
einem Skript, in der CI oder aus einem Agenten heraus bleibt es haengen.
Aus dem Namen ging das nicht hervor, also lief man einmal hinein.

- Neuer Abschnitt in der README mit allen sieben Datenbankbefehlen,
  wofuer sie da sind und welcher Rueckfragen stellt. Es ist genau einer.
- Der uebliche Weg fuer eine Schemaaenderung steht als Dreizeiler
  daneben - ueber den Wrapper aus #24, nicht ueber migrate dev.
- Die Ersteinrichtung in der README rief "npx prisma migrate dev --name
  fundament" auf, obwohl es dafuer "npm run setup" gibt. Das war der
  Ausgangspunkt der Verwirrung; jetzt steht dort der eine Befehl.
- Der Hinweis unter "Betriebswissen", die SQL-Skripte seien von Hand
  anzustossen, galt nur fuer die Ersteinrichtung. Beim Aktualisieren
  erledigt update.sh das mit - jetzt steht das dabei.

"db:migrate" bleibt bestehen. Der interaktive Ablauf hat seinen Platz,
etwa um eine verkorkste Entwicklungsdatenbank zurueckzusetzen; er ist
nur nicht mehr der Standardweg.

Refs #27
florian.wilde merged commit 5022a97a6f into main 2026-08-23 17:36:07 +00:00
Sign in to join this conversation.
No Reviewers
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: florian.wilde/betreuungs-cockpit#31