teefayb/claude-code-setup-demo

Datenmodell ändern: $ARGUMENTS

Gespeicherte Daten befinden sich in JSON-Dateien, die bereits auf den Maschinen von Teammitgliedern und auf dem Server existieren, daher muss jede Änderung alte Dateien lesen, ohne sie zu beschädigen.

Schritte

1. Lesen Sie src/lib/links/schema.ts, src/lib/links/store.ts und data/seed.json.
2. Entscheiden Sie, ob die Änderung additiv (neues optionales Feld mit Standardwert) oder bahnbrechend (Umbenennung, Entfernung, neues Pflichtfeld, Typänderung) ist.
   • Additiv: Fügen Sie das Feld mit .optional() oder .default(...) zu linkSchema hinzu, und zu linkInputSchema, wenn Benutzer es setzen können. Keine Versionserhöhung.
   • Bahnbrechend: Erhöhen Sie das version-Literal der Datendatei (z. B. 1 → 2). Behalten Sie das alte Schema als dataFileV1Schema und fügen Sie eine upgradeV1toV2(data)-Funktion in store.ts hinzu, die load() anwendet, wenn es eine v1-Datei liest. Überschreiben Sie niemals Dateien beim Lesen; der nächste save() schreibt v2.
3. Aktualisieren Sie data/seed.json auf die neue Form.
4. Aktualisieren Sie die Benutzeroberfläche nur, wenn die Aufgabe dies verlangt.
5. Tests in src/lib/links/store.test.ts:
   • Das neue Feld durchläuft createLink und listLinks.
   • Bei bahnbrechenden Änderungen: Schreiben Sie eine v1-Datei in den temporären Datenpfad und stellen Sie sicher, dass listLinks() aktualisierte Links zurückgibt, und dass ein folgendes createLink eine v2-Datei speichert.
6. Führen Sie npm run check und npm run build aus.
7. Geben Sie in Ihrer Zusammenfassung an, ob die Änderung additiv oder bahnbrechend war und was mit vorhandenen Datendateien passiert.