unknownandClaude Opus 5
e52557b4bf
Vier neue Kapitel in der Anleitung (mehrere Sammler, Preise, Erinnerungen, Dubletten) mit vier automatisch erzeugten Bildern, Changelog 0.3.0 samt der bewusst weggelassenen BrickLink-Anbindung, Roadmap abgehakt und um einen offenen Ausblick ergaenzt, Devlog mit Zeiten und Stolpersteinen. Dazu zwei Korrekturen aus dem Testlauf: Der Zeitplan fuer Erinnerungen liess sich nicht aus Next' instrumentation.ts starten - die Datei wird auch fuer die Edge-Runtime uebersetzt, und das native SQLite-Modul bricht dort den Build. Er startet jetzt aus dem Healthcheck heraus, den der Container ohnehin alle 30 Sekunden aufruft, und zusaetzlich aus dem App-Layout; der Aufruf ist idempotent. Der Screenshot-Lauf waehlte ploetzlich die falschen Kacheln aus: Der neue Sammler-Umschalter benutzt ebenfalls aria-pressed. Die Auswahlkacheln tragen jetzt ein eigenes data-set-card. Ausserdem raeumen die Testskripte einen Container weg, den ein abgebrochener Lauf zurueckgelassen hat - sonst blockiert er den Port. Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
201 lines
8.7 KiB
Markdown
201 lines
8.7 KiB
Markdown
# Changelog
|
|
|
|
Alle nennenswerten Aenderungen an Bricktrack werden hier festgehalten.
|
|
|
|
Das Format folgt [Keep a Changelog](https://keepachangelog.com/de/1.1.0/),
|
|
die Versionierung [Semantic Versioning](https://semver.org/lang/de/).
|
|
|
|
## [Unreleased]
|
|
|
|
## [0.3.0] - 2026-09-07
|
|
|
|
Phase 3: mehrere Kinder, Wertentwicklung, Erinnerungen und ein Schutz vor
|
|
doppelten Katalogeintraegen.
|
|
|
|
### Hinzugefuegt
|
|
|
|
**Mehrere Sammler**
|
|
- Der Katalog bleibt gemeinsam, Sammlung und Wunschlisten gehoeren je einem
|
|
Sammler. "Hat er das schon?" beantwortet damit die Frage fuer *ihn*: ein Set,
|
|
das nur die Schwester besitzt, faellt fuer den Bruder unter "fehlt noch".
|
|
- Umschalter in Katalog und Sammlung, Farbmarkierung je Sammler, Zuordnung im
|
|
Sammlungseintrag und je Wunschliste.
|
|
- Solange es nur einen Sammler gibt, ist davon nichts zu sehen - die App
|
|
bleibt genauso einfach wie vorher.
|
|
|
|
**Preisbeobachtung**
|
|
- Notierte Preise je Set mit Betrag, Zustand, Datum, Quelle und Notiz.
|
|
- Wertentwicklung gegen die UVP, in der Sammlung als Kachel "Aktueller Wert".
|
|
|
|
**Erinnerungen**
|
|
- E-Mail an den Besitzer, wenn der Termin einer Wunschliste naeher rueckt und
|
|
noch Wuensche offen sind - standardmaessig 14 Tage vorher, hoechstens einmal
|
|
pro Woche je Liste.
|
|
- Verwaltungsseite mit Verbindungstest, Testnachricht und sofortiger Pruefung.
|
|
- Ohne SMTP-Konfiguration bleibt die Funktion vollstaendig aus.
|
|
|
|
**Dublettenpruefung**
|
|
- Vor dem Anlegen eines Sets warnt die App vor gleicher Setnummer beim
|
|
gleichen Hersteller, sehr aehnlichem Namen und gleicher Nummer bei einem
|
|
anderen Hersteller - mit Link zum Verdaechtigen und der Moeglichkeit,
|
|
trotzdem anzulegen.
|
|
|
|
### Geaendert
|
|
|
|
- Die Migration legt einen Sammler "Sammlung" an und ordnet ihm alle
|
|
vorhandenen Sammlungseintraege und Wunschlisten zu. Umbenennen unter
|
|
Verwaltung -> Sammler.
|
|
- Der Smoke-Test laeuft gegen das Docker-Image statt gegen den Dev-Server.
|
|
|
|
### Nicht umgesetzt
|
|
|
|
- Der BrickLink-Preisfuehrer war im Plan als optional vermerkt und wurde
|
|
bewusst weggelassen: OAuth1 mit einer pro Nutzer registrierten Anwendung ist
|
|
viel Apparat fuer eine Zahl, die sich in zehn Sekunden eintippen laesst. Das
|
|
Feld "Wo" nimmt jede Quelle auf, die Datenstruktur bleibt offen.
|
|
|
|
## [0.2.0] - 2026-09-07
|
|
|
|
Phase 2: die Handgriffe, die den Alltag schneller machen.
|
|
|
|
### Hinzugefuegt
|
|
|
|
**Lego-Import (Rebrickable)**
|
|
- Auf "Neues Set" reicht die Setnummer von der Packung: Name, Jahr, Teile,
|
|
Minifiguren und Thema werden uebernommen, das Bild lokal gespeichert.
|
|
- Hersteller und Thema werden bei Bedarf angelegt, ein Oberthema inklusive.
|
|
- Alle Aufrufe laufen serverseitig. Ohne `REBRICKABLE_API_KEY` bleibt der
|
|
Import sichtbar, aber abgeschaltet - von Hand anlegen geht unveraendert.
|
|
|
|
**Barcode-Scanner**
|
|
- Knopf im Katalog: Strichcode mit der Handykamera scannen. Ist das Set
|
|
bekannt, oeffnet es sich; sonst das Formular mit ausgefuellter EAN.
|
|
- Jeder Code wird gegen seine Pruefziffer geprueft; dekodiert wird im
|
|
Browser, nichts verlaesst das Geraet.
|
|
|
|
**Fehlteile**
|
|
- Fehlende Teile je Sammlungseintrag mit Teilenummer, Farbe, Anzahl und
|
|
Notiz, abhakbar wenn nachgekauft.
|
|
- Die Vollstaendigkeit pflegt sich daraus selbst: der erste offene Eintrag
|
|
setzt "Teile fehlen", der letzte erledigte zurueck auf "vollstaendig".
|
|
|
|
**Einladungen**
|
|
- Der Admin erzeugt Registrierungslinks, die genau einmal funktionieren,
|
|
optional an eine E-Mail-Adresse gebunden, mit waehlbarer Rolle und
|
|
Gueltigkeit. In der Datenbank liegt nur der Hash des Tokens.
|
|
|
|
**Export und Import**
|
|
- Alles als ZIP (Daten plus hochgeladene Dateien), nur die Daten als JSON,
|
|
die Sammlung als CSV mit Semikolon und BOM fuer deutsches Excel.
|
|
- Import ersetzt die Anwendungsdaten in einer Transaktion, nur fuer
|
|
Administratoren und nur nach getipptem ERSETZEN.
|
|
- Nicht im Export: Konten, Passwoerter, Passkeys, Reservierungen und
|
|
Teilen-Links.
|
|
|
|
**PWA**
|
|
- Manifest, Icons und Service Worker: installierbar auf dem Startbildschirm,
|
|
mit Verknuepfungen zu "Fehlende Sets" und zur Sammlung.
|
|
- Einmal geladene Seiten bleiben ohne Verbindung lesbar; Set-Bilder und
|
|
Build-Dateien kommen aus dem Cache. Beim Abmelden wird der Cache geraeumt.
|
|
|
|
### Geaendert
|
|
|
|
- `src/env.ts` behandelt leere Werte wie nicht gesetzt: ein `BASE_URL=` in der
|
|
`.env` fuehrte bisher zum Start-Abbruch statt zum Standardwert.
|
|
- Unit-Tests koennen jetzt auch Server-Module laden (`server-only` wird in der
|
|
Testumgebung durch ein leeres Modul ersetzt).
|
|
|
|
### Bekannte Einschraenkungen
|
|
|
|
- Rebrickable liefert keine Anleitungsdateien. Der Import legt stattdessen
|
|
einen Link auf die LEGO-Serviceseite zur Setnummer an.
|
|
- Der Barcode-Scanner braucht wie Passkeys HTTPS.
|
|
- Beim Import wandern Wunschlisten an den importierenden Admin und sind
|
|
zunaechst nicht geteilt.
|
|
|
|
## [0.1.0] - 2026-09-07
|
|
|
|
Erste lauffaehige Fassung: Phase 1 vollstaendig, im Docker-Stack verifiziert.
|
|
|
|
### Hinzugefuegt
|
|
|
|
**Anmeldung**
|
|
- Registrierung des ersten Nutzers, der damit Administrator wird; danach ist
|
|
die Registrierung geschlossen.
|
|
- Anmeldung per E-Mail und Passwort oder per Passkey (WebAuthn), inklusive
|
|
Conditional UI, wo der Browser sie unterstuetzt.
|
|
- Passkey-Verwaltung unter "Konto": beliebig viele Geraete, umbenennen,
|
|
loeschen.
|
|
- Rate-Limiting auf den Login-Endpunkten, in der Datenbank abgelegt und damit
|
|
neustartfest.
|
|
|
|
**Katalog**
|
|
- Set-Katalog mit Kachelansicht, Suche ueber Setnummer, Name und EAN sowie
|
|
Filtern nach Hersteller, Thema, Jahr und Besitzstatus.
|
|
- Sets anlegen und bearbeiten, mit Bild-Upload oder Bild-URL.
|
|
- Set-Detailseite mit Metadaten, Anleitungen, Fotos und Sammlungseintraegen.
|
|
- Anleitungen als PDF-Upload mit eingebautem pdf.js-Viewer oder als externer
|
|
Link; mehrere Anleitungen je Set.
|
|
- Eigene Fotos je Set, am Handy direkt aus der Kamera.
|
|
|
|
**Sammlung**
|
|
- Uebersicht aller besessenen Sets mit Filtern nach Status, Vollstaendigkeit,
|
|
Standort und Hersteller.
|
|
- Statistik-Kacheln: Anzahl Sets, Teile gesamt, Wert nach UVP, fehlende Sets,
|
|
sowie die Aufteilung nach Hersteller.
|
|
- Sammlungseintraege mit Status, Zustand, Standort, Kaufdatum, Kaufpreis und
|
|
"geschenkt von".
|
|
|
|
**Wunschlisten**
|
|
- Ansicht "Fehlende Sets" mit Mehrfachauswahl: langes Druecken startet die
|
|
Auswahl, die Aktionsleiste uebernimmt sie in eine bestehende oder neue
|
|
Wunschliste. Dubletten und bereits besessene Sets werden uebersprungen und
|
|
im Ergebnis benannt.
|
|
- Wunschlisten mit Prioritaet, Reihenfolge, Anlass, Termin und Hinweistext.
|
|
- Bereich "Aus fehlenden Sets hinzufuegen" auf der Wunschlisten-Seite,
|
|
vorgefiltert auf Sets, die noch nicht drauf sind.
|
|
- Oeffentliche Ansicht unter /w/[shareToken] ohne Anmeldung; Besucher
|
|
reservieren mit ihrem Namen und erhalten einen Storno-Link.
|
|
- Ueberraschungsmodus: der Besitzer sieht nur "reserviert", nicht von wem.
|
|
- Erfuellte Wuensche werden automatisch markiert, sobald das Set in der
|
|
Sammlung landet, und verschwinden aus der oeffentlichen Ansicht.
|
|
- Share-Token laesst sich neu erzeugen; der alte Link ist danach tot.
|
|
|
|
**Stammdaten**
|
|
- Hersteller, Themen (mit Unterthemen) und Standorte (schachtelbar) verwalten.
|
|
|
|
**Betrieb**
|
|
- Docker-Stack: Multi-Stage-Build mit standalone-Output, non-root Nutzer,
|
|
Healthcheck unter /api/health, ein Service und ein Bind-Mount auf ./data.
|
|
- Migrationen laufen bei jedem Containerstart automatisch.
|
|
- update.sh mit Sicherung, Build, Healthcheck und automatischem Rollback.
|
|
- Seed-Skript mit 3 Herstellern, 6 Themen, 10 Sets, 4 Sammlungseintraegen und
|
|
einer Wunschliste.
|
|
- Dokumentation: Schnellstart inklusive Nginx-Proxy-Manager-Konfiguration,
|
|
bebilderte Anleitung, README, Roadmap und Devlog.
|
|
|
|
### Sicherheit
|
|
|
|
- Serverseitige Validierung aller Eingaben mit zod.
|
|
- Uploads auf PDF, JPEG, PNG und WebP begrenzt, geprueft an den Magic Bytes
|
|
statt am gemeldeten MIME-Typ; Dateinamen erzeugt immer der Server.
|
|
- Oeffentliche Wunschlisten-Routen nutzen ausschliesslich den Share-Token und
|
|
geben nichts ausserhalb der Wunschliste preis; die Seite ist noindex.
|
|
- Storno- und Einladungs-Token liegen nur als SHA-256-Hash in der Datenbank.
|
|
- Session-Cookies httpOnly, sameSite=lax und im Betrieb secure.
|
|
- Anleitungs-PDFs und eigene Fotos sind nur mit Session abrufbar; oeffentlich
|
|
sind allein die Set-Bilder, die die geteilte Wunschliste braucht.
|
|
|
|
### Bekannte Einschraenkungen
|
|
|
|
- Der Katalog enthaelt nur, was von Hand angelegt wurde. Der Import ueber
|
|
Rebrickable kommt in 0.2.0.
|
|
- Weitere Konten sind noch nicht moeglich; Einladungslinks kommen in 0.2.0.
|
|
- Unter Windows scheitert `pnpm build` an fehlenden Symlink-Rechten. Der
|
|
Docker-Build unter Linux ist davon nicht betroffen.
|
|
|
|
[Unreleased]: https://git.wilde-server.de/florian.wilde/bricktrack/compare/v0.3.0...HEAD
|
|
[0.3.0]: https://git.wilde-server.de/florian.wilde/bricktrack/releases/tag/v0.3.0
|
|
[0.2.0]: https://git.wilde-server.de/florian.wilde/bricktrack/releases/tag/v0.2.0
|
|
[0.1.0]: https://git.wilde-server.de/florian.wilde/bricktrack/releases/tag/v0.1.0
|