Falscher Dateipfad in fünf Migrationskommentaren #25

Closed
opened 2026-08-23 16:56:07 +00:00 by florian.wilde · 3 comments
Owner

Problem

Fünf Migrationen tragen einen Warnhinweis, der auf die Quelle der
Trigramm-Indizes verweist:

Die stammen aus prisma/sql/suche.sql …

Diese Datei gibt es nicht. Richtig ist prisma/sql/volltextsuche.sql.

Betroffen:

  • 20260822160000_passkey_anmeldung
  • 20260823000500_zahlungsgruppe_geklaert
  • 20260823062000_buchung_vertragszahlung
  • 20260823102500_schreibvorlage
  • 20260823153000_ansprechpartner

Warum das ärgerlich ist

Der Kommentar steht genau dort, wo jemand ihn liest, der die nächste
Migration erzeugt und wissen will, warum Zeilen zu streichen sind. Ein
falscher Pfad schickt ihn ins Leere — und der Hinweis verliert seine
Wirkung.

Was ich will

Pfad in allen fünf Dateien korrigieren. Angewendete Migrationen im
Nachhinein zu ändern ist normalerweise heikel; hier betrifft es
ausschließlich Kommentarzeilen, die Prisma nicht auswertet. Die
Prüfsumme in _prisma_migrations bezieht sich auf den Dateiinhalt —
deshalb vorher prüfen, ob migrate deploy danach noch zufrieden ist,
und im Zweifel nur die noch nicht ausgelieferten Dateien anfassen.

Akzeptanzkriterien

  • Kein Verweis auf prisma/sql/suche.sql mehr im Repository
  • npx prisma migrate status meldet keine veränderten Migrationen
  • Falls doch: Korrektur nur in einem Kommentar an einer Stelle
    (etwa prisma/migrations/README.md), statt die Dateien anzufassen

Hinweis

Hängt inhaltlich an #24 — wenn der Wrapper den Kopfkommentar künftig
erzeugt, sollte er den richtigen Pfad nennen.

Angelegt auf Zuruf im Chat, nicht aus dem Dashboard — bitte in Nebula
nachtragen.

## Problem Fünf Migrationen tragen einen Warnhinweis, der auf die Quelle der Trigramm-Indizes verweist: > Die stammen aus `prisma/sql/suche.sql` … Diese Datei gibt es nicht. Richtig ist `prisma/sql/volltextsuche.sql`. Betroffen: - `20260822160000_passkey_anmeldung` - `20260823000500_zahlungsgruppe_geklaert` - `20260823062000_buchung_vertragszahlung` - `20260823102500_schreibvorlage` - `20260823153000_ansprechpartner` ## Warum das ärgerlich ist Der Kommentar steht genau dort, wo jemand ihn liest, der die nächste Migration erzeugt und wissen will, warum Zeilen zu streichen sind. Ein falscher Pfad schickt ihn ins Leere — und der Hinweis verliert seine Wirkung. ## Was ich will Pfad in allen fünf Dateien korrigieren. Angewendete Migrationen im Nachhinein zu ändern ist normalerweise heikel; hier betrifft es ausschließlich Kommentarzeilen, die Prisma nicht auswertet. Die Prüfsumme in `_prisma_migrations` bezieht sich auf den Dateiinhalt — deshalb vorher prüfen, ob `migrate deploy` danach noch zufrieden ist, und im Zweifel nur die noch nicht ausgelieferten Dateien anfassen. ## Akzeptanzkriterien - [ ] Kein Verweis auf `prisma/sql/suche.sql` mehr im Repository - [ ] `npx prisma migrate status` meldet keine veränderten Migrationen - [ ] Falls doch: Korrektur nur in einem Kommentar an einer Stelle (etwa `prisma/migrations/README.md`), statt die Dateien anzufassen ## Hinweis Hängt inhaltlich an #24 — wenn der Wrapper den Kopfkommentar künftig erzeugt, sollte er den richtigen Pfad nennen. _Angelegt auf Zuruf im Chat, nicht aus dem Dashboard — bitte in Nebula nachtragen._
florian.wilde added the in-arbeit label 2026-08-23 17:27:00 +00:00
florian.wilde started working 2026-08-23 17:27:24 +00:00
Author
Owner

🤖 Claude Code hat mit der Umsetzung begonnen.

  • Branch: fix/25-migrationspfad
  • Verstanden als: Der Verweis prisma/sql/suche.sql in fünf Migrationskommentaren geht ins Leere; richtig ist volltextsuche.sql.
  • Geplantes Vorgehen:
    • Zuerst klären, ob Prisma die Prüfsumme angewendeter Migrationen überwacht. Wenn ja, werden die Dateien nicht angefasst, sondern der Hinweis wandert an eine Stelle, die man ohnehin liest.
    • Ausgangslage ist festgehalten: prisma migrate status meldet gerade „Database schema is up to date", sechs Migrationen. Nach der Änderung muss dieselbe Meldung kommen.
    • Zusätzlich prüfen, dass kein weiterer Verweis auf den falschen Pfad im Repository steht.

Zeiterfassung läuft.

🤖 **Claude Code hat mit der Umsetzung begonnen.** - Branch: `fix/25-migrationspfad` - Verstanden als: Der Verweis `prisma/sql/suche.sql` in fünf Migrationskommentaren geht ins Leere; richtig ist `volltextsuche.sql`. - Geplantes Vorgehen: - Zuerst klären, ob Prisma die Prüfsumme angewendeter Migrationen überwacht. Wenn ja, werden die Dateien **nicht** angefasst, sondern der Hinweis wandert an eine Stelle, die man ohnehin liest. - Ausgangslage ist festgehalten: `prisma migrate status` meldet gerade „Database schema is up to date", sechs Migrationen. Nach der Änderung muss dieselbe Meldung kommen. - Zusätzlich prüfen, dass kein weiterer Verweis auf den falschen Pfad im Repository steht. Zeiterfassung läuft.
florian.wilde worked for 3 minutes 2026-08-23 17:30:56 +00:00
Author
Owner

🚀 Umgesetzt und nach main übernommen.

  • Merge-Commit: 4aed982
  • Pull Request: #30 (gemergt)
  • Gesamtaufwand: 00:04

Was geändert wurde

  • In allen fünf Migrationen zeigt der Herkunftshinweis jetzt auf
    prisma/sql/volltextsuche.sql.
  • Dazu eine Zeile, die auf das Werkzeug aus #24 verweist — die
    Kommentare rieten bisher nur zum Nachsehen, obwohl es das Problem
    inzwischen selbst löst.

Zur Frage, ob man angewendete Migrationen anfassen darf

Vor der Änderung nachgestellt: Prisma speichert je Migration eine
Prüfsumme in _prisma_migrations. Nach dem Bearbeiten weicht sie
nachweislich ab —

gespeichert: a7d6730acd42773bc522789b0886e95dcc89eb2e27864b3968ee02fe3c3e2d35
Datei jetzt: 2c95fc775e3687bd9dc34a0a2b4456ac434e045dee9c2ac83e62bfebecc30bc4

— und migrate status wie migrate deploy bleiben trotzdem zufrieden.
Genau diese Lage entsteht auch auf dem Server beim nächsten Update.

Offener Nachweis: Der Test lief ohne ausstehende Migration. #21
bringt eine mit; dort prüfe ich, ob deploy auch dann nicht stolpert.
Falls doch, nehme ich diese Änderung zurück und lege den Hinweis in eine
prisma/migrations/README.md. Ich melde das Ergebnis hier nach.

So prüfst du es

  1. git switch main && git pull
  2. grep -rn "sql/suche.sql" prisma/
    Erwartet: kein Treffer.
  3. npx prisma migrate status
    Erwartet: „Database schema is up to date!"

Weder Changelog noch Version — reine Kommentaränderung.

🚀 **Umgesetzt und nach `main` übernommen.** <!-- claude-status branch: fix/25-migrationspfad merge: 4aed982 pr: 30 zeit_sekunden: 212 --> - Merge-Commit: `4aed982` - Pull Request: #30 (gemergt) - Gesamtaufwand: 00:04 **Was geändert wurde** - In allen fünf Migrationen zeigt der Herkunftshinweis jetzt auf `prisma/sql/volltextsuche.sql`. - Dazu eine Zeile, die auf das Werkzeug aus #24 verweist — die Kommentare rieten bisher nur zum Nachsehen, obwohl es das Problem inzwischen selbst löst. **Zur Frage, ob man angewendete Migrationen anfassen darf** Vor der Änderung nachgestellt: Prisma speichert je Migration eine Prüfsumme in `_prisma_migrations`. Nach dem Bearbeiten weicht sie nachweislich ab — ``` gespeichert: a7d6730acd42773bc522789b0886e95dcc89eb2e27864b3968ee02fe3c3e2d35 Datei jetzt: 2c95fc775e3687bd9dc34a0a2b4456ac434e045dee9c2ac83e62bfebecc30bc4 ``` — und `migrate status` wie `migrate deploy` bleiben trotzdem zufrieden. Genau diese Lage entsteht auch auf dem Server beim nächsten Update. **Offener Nachweis:** Der Test lief ohne ausstehende Migration. #21 bringt eine mit; dort prüfe ich, ob `deploy` auch dann nicht stolpert. Falls doch, nehme ich diese Änderung zurück und lege den Hinweis in eine `prisma/migrations/README.md`. Ich melde das Ergebnis hier nach. **So prüfst du es** 1. `git switch main && git pull` 2. `grep -rn "sql/suche.sql" prisma/` Erwartet: kein Treffer. 3. `npx prisma migrate status` Erwartet: „Database schema is up to date!" Weder Changelog noch Version — reine Kommentaränderung.
florian.wilde removed the in-arbeit label 2026-08-23 17:32:23 +00:00
Author
Owner

✅ Nachtrag: Der offene Nachweis ist erbracht.

Beim Umsetzen von #21 entstand die erste ausstehende Migration, seit
die fünf Kommentare geändert wurden — also genau die Lage, die ich hier
noch prüfen wollte.

npx prisma migrate deploy

The following migration(s) have been applied:
migrations/
  └─ 20260823193832_betreuer_anschrift/

deploy hat die neue Migration angewendet und über die fünf abweichenden
Prüfsummen kein Wort verloren. Damit ist auch der Server-Fall
abgedeckt: Beim nächsten Update laufen dort dieselben geänderten Dateien
mit einer ausstehenden Migration zusammen.

Kein Rückbau nötig, die prisma/migrations/README.md bleibt aus.

✅ **Nachtrag: Der offene Nachweis ist erbracht.** Beim Umsetzen von #21 entstand die erste **ausstehende** Migration, seit die fünf Kommentare geändert wurden — also genau die Lage, die ich hier noch prüfen wollte. ``` npx prisma migrate deploy The following migration(s) have been applied: migrations/ └─ 20260823193832_betreuer_anschrift/ ``` `deploy` hat die neue Migration angewendet und über die fünf abweichenden Prüfsummen kein Wort verloren. Damit ist auch der Server-Fall abgedeckt: Beim nächsten Update laufen dort dieselben geänderten Dateien mit einer ausstehenden Migration zusammen. Kein Rückbau nötig, die `prisma/migrations/README.md` bleibt aus.
Sign in to join this conversation.
1 Participants
Notifications
Total Time Spent: 3 minutes
florian.wilde
3 minutes
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: florian.wilde/betreuungs-cockpit#25