Eine Sammlung wird erst nützlich, wenn ihre Daten belastbar sind.
Eine private, API-first Sammlungsplattform für Pokémon-TCG-Karten – mit Katalog, Varianten, Wunschlisten, Preisverlauf und lokalem OCR-Scanner.
- Projekt
- Cardfolio
- Rolle
- Produktkonzeption, Architektur und Entwicklung
- Status
- In Entwicklung
- System
- React · Fastify · PostgreSQL · OCR · API-first
Systemansichten
Case Study
01
Ausgangslage
Sammelkarten werden schnell unübersichtlich, wenn Katalogdaten, Varianten, Sprache, Zustand, Besitz, Wunschlisten und Preisverläufe nur lose nebeneinander liegen. Eine Sammlung braucht ein Modell, das diese Unterschiede als fachliche Daten behandelt – nicht als Freitext.
02
Aufgabe und eigene Rolle
Produktkonzeption, Systemarchitektur und Entwicklung einer privaten, API-first Plattform: vom Domänenmodell und Sicherheitskonzept bis zu Web-Oberfläche, Synchronisation und Scanner-Workflow.
- Fachmodell für Karten, Sets, Varianten und Besitzpositionen
- Getrennte Schichten für Katalog, private Sammlung und Preisverlauf
- Lokaler OCR-Scanner für die schnelle Erfassung
03
Wichtigste Entscheidungen
Cardfolio trennt öffentliche Referenzdaten strikt von privaten Sammlungsdaten. Preiswerte bleiben zeitlich und nach Herkunft getrennt; eine fehlende Bewertung wird nicht als Preis von null interpretiert. So bleiben Daten nachvollziehbar, auch wenn Kataloge oder Anbieter sich ändern.
04
System und Datenflüsse
Ein React-Client greift über eine dokumentierte API auf einen modularen Monolithen zu. PostgreSQL hält Katalog-, Sammlungs- und Preisdaten getrennt; ein Worker verarbeitet Synchronisationen und Preisaktualisierungen. Der Scanner verarbeitet die Kameravorschau lokal und überträgt nur den erkannten Text zur Katalogsuche.
05
Qualität, Sicherheit und Betrieb
Ratenlimits, Eingabevalidierung, JWT-Absicherung, Audit- und Synchronisationsprotokolle sowie Migrations- und Backup-Strategien gehören zur Produktarchitektur. Private Daten werden nicht von Katalog-Synchronisationen überschrieben.
06
Grenzen und nächster Ausbau
Cardfolio ist ein persönliches Sammlungswerkzeug; Marktpreise sind unverbindliche Indikatoren. Der Funktionsumfang wird gezielt aus persönlicher Nutzung weiterentwickelt, statt eine generische Plattform für jede denkbare Sammlung zu versprechen.
Nächster Schritt
Klingt das nach deinem System?
Im Systemcheck klären wir, was in deinem Fall wirklich nötig ist – und was nicht.