Magic Collection

Eine private Plattform für dich und deine Freunde, um eure Magic: The Gathering Sammlungen zu importieren, zu durchsuchen und zu filtern. Bilder werden live von Scryfall geladen.

Tech-Stack

• Next.js 14 (App Router) – Frontend & API-Routen
• Supabase – Auth (E-Mail/Passwort) + Postgres-Datenbank
• Scryfall API – Kartendaten & Bilder (kostenlos, kein Key nötig)
• Tailwind CSS – Styling

Funktionen

• Sammlung: Karten importieren (Scryfall-Abgleich), filtern nach Name, Farbe, Typ, Seltenheit

• Commander Decks: eigene Decks anlegen, Commander setzen, Kartenliste importieren

• Automatische Deck-Analyse: erkennt Anzahl Länder, Ramp, Removal, Kartenziehen, Board Wipes, Mana-Kurve und Verstöße gegen die Farbidentität des Commanders – und gibt konkrete Verbesserungsvorschläge aus

• Freunde: Freundschaftsanfragen per E-Mail, erst nach gegenseitiger Bestätigung sichtbar

• "Freund besitzt diese Karte": In jeder Deckliste wird angezeigt, welcher Freund eine Karte bereits besitzt (z. B. um sie sich zu leihen) – ohne dass ihr je die komplette Sammlung des anderen einsehen könnt

• Cardmarket-Preise in €: Werden automatisch über Scryfall mitgeliefert (Scryfall bezieht seine EUR-Preise direkt von Cardmarket) – keine eigene Cardmarket-Anbindung nötig. Gesamtwert von Sammlung und Decks wird live berechnet, ein Button aktualisiert die Preise auf den aktuellen Stand

• Trades mit Historie: Karten mit bestätigten Freunden handeln. Beim Annehmen wandern die Karten automatisch und geprüft zwischen den Sammlungen. Jeder Trade bleibt mit Werten und Status als Verlauf sichtbar

• Wertverlauf: Gesamtwert der Sammlung und Preis einzelner Karten über die Zeit als Diagramm – die Daten entstehen bei jedem Preis-Update

• CSV-Import & -Export: Sammlung per CSV aus Moxfield/Archidekt/Deckbox importieren und als CSV exportieren

• Wunschliste: gesuchte Karten sammeln; es wird angezeigt, welcher Freund eine Wunschkarte besitzt

• Deck-Baubarkeit: pro Deck sehen, welche Karten du aus deiner Sammlung schon hast und welche (zu welchem Preis) dir noch fehlen

• Mana-Kurve & Farbverteilung: grafische Deckauswertung zusätzlich zur Textanalyse, plus Deckwert-Verlauf

• Sammlungs-Freigabe: einzelnen Freunden read-only Zugriff auf die eigene Sammlung geben

• Leih-Tracking: festhalten, wem du welche Karte geliehen hast

• Trade-Balance: bei jedem Trade wird die Wertdifferenz beider Seiten angezeigt

• Foto-Import (OCR): Karte fotografieren → der Name wird im Browser per Tesseract.js ausgelesen, gegen Scryfall abgeglichen und nach deiner Bestätigung importiert (/scan). Läuft ohne Kosten auf dem Gerät; funktioniert am besten bei gutem Licht und gerader Aufnahme.

• Kartenvorschläge: pro Deck schlägt die App passende Karten aus Scryfall vor – gefiltert nach Farbidentität des Commanders und den schwächsten Kategorien (Removal/Ramp/Draw/Board Wipe). Basiert vollständig auf Scryfall-Daten.

• Kartenverwaltung ohne Import: In der Sammlung eine Karte antippen, um Menge zu ändern, Foil umzustellen oder sie zu entfernen.

• Deck bearbeiten: Deck umbenennen, Commander tauschen, einzelne Karten entfernen und ganze Decks löschen.

• Account-Verwaltung (/account): Passwort ändern, E-Mail-Adresse ändern (mit Bestätigungslink), abmelden.

• Power-Level / Commander-Bracket: pro Deck eine Einstufung ins offizielle 5-Stufen-System (Beta) – regelbasiert auf der Game-Changers-Liste von Scryfall (is:gamechanger), inkl. Begründung und erkannten Game Changern. Zwei-Karten- Combos werden bewusst noch nicht automatisch erkannt.

• Kartendetails: Zustand (NM–DMG) und Sprache pro Karte, im Karten-Editor einstellbar und im CSV-Export enthalten.

• Set-Fortschritt (/sets): pro Set, wie viele verschiedene Karten du besitzt, mit Fortschrittsbalken (Gesamtzahl je Set von Scryfall).

• Deck-Kategorien: Deckkarten werden automatisch nach Rolle gruppiert (Länder, Ramp, Removal, Board Wipe, Kartenziehen, Kreaturen, Sonstiges).

• Set-Filter & Sortierung in der Sammlung (Name, Manawert, Preis, Set).

• Playtester / Goldfishing: pro Deck eine Testhand ziehen, Mulligan (London) und nachziehen – mit Länder-Zähler und Mulligan-Hinweisen. Reine Frontend- Simulation zum Prüfen der Manakurve (Commander bleibt in der Command Zone).

• Zustandsbereinigte Bewertung: der Sammlungswert berücksichtigt den Kartenzustand (NM 100 %, LP 90 %, MP 75 %, HP 60 %, DMG 40 %) – zentral in lib/valuation.ts, überall dieselbe Rechnung (Anzeige + Cron-Snapshots).

• Zwei-Karten-Combos im Bracket: kuratierte Liste bekannter Combos (Thassa's Oracle + Demonic Consultation u. v. m.) hebt Decks auf mindestens Bracket 3 und wird in der Begründung ausgewiesen.

• Bulk-Aktionen: in der Sammlung „Auswählen" antippen, mehrere Karten markieren und gemeinsam löschen.

• Optimistische Oberfläche: Änderungen an Karten (Menge, Foil, Zustand, Sprache, Löschen) erscheinen sofort; bei Serverfehlern wird zurückgerollt.

• Kartenvorschau: im Karten-Editor das Bild antippen für eine Großansicht.

• Nächtlicher Preis-Cron: aktualisiert Preise für alle Nutzer und schreibt tägliche Wert-Snapshots (Sammlung & Decks) – so wird der Verlauf tagesgenau.

Nächtlicher Preis-Cron

vercel.json richtet einen täglichen Cron ein, der /api/cron/prices aufruft. Voraussetzungen (in Vercel als Environment-Variablen setzen):

• SUPABASE_SERVICE_ROLE_KEY – der service_role-Key aus Supabase (umgeht RLS; niemals ins Frontend/Repo committen).
• CRON_SECRET – ein frei gewähltes Geheimnis. Vercel sendet es automatisch als Authorization: Bearer <CRON_SECRET> an den Cron-Endpunkt.

Der Job aktualisiert Kartenpreise für alle Nutzer über den Scryfall-Batch- Endpoint und schreibt die Tages-Snapshots für Sammlungs- und Deckwerte.

This is the beginning of the README. Read the rest at the original. Read the full README ↗