CollectR

Die intelligente Multi-Sphere Sammlungsplattform für leidenschaftliche Sammler

Spheres • Features • Installation • Tech Stack • Roadmap

🌟 Was ist CollectR?

CollectR ist eine moderne, datenschutzfreundliche Multi-Sphere Plattform zur Verwaltung deiner wertvollsten Sammlungen. Mit spezialisierten "Spheres" für verschiedene Sammelgebiete bietet CollectR maßgeschneiderte Tools für TCG, Gaming, Dokumente, Geologie und mehr.

Sphere-Konzept

CollectR organisiert sich in spezialisierte Spheres (Sphären), von denen jede optimiert ist für spezifische Sammelkategorien:

┌─────────────────────────────────────────────────────────────┐
│                    CollectR HUB (🏠)                        │
│              Universal Collection Manager                    │
└───────────┬─────────────────────────────────────────────────┘
            │
    ┌───────┴────────┬─────────┬──────────┬──────────┐
    │                │         │          │          │
┌───▼───┐  ┌────▼────┐  ┌────▼────┐  ┌──▼──┐  ┌───▼────┐
│  TCG  │  │ Gaming  │  │Official │  │ Geo │  │  Shop  │
│  🎴   │  │   🎮    │  │   📜    │  │ ⛏️  │  │  🛒    │
└───────┘  └─────────┘  └─────────┘  └─────┘  └────────┘

🎯 Spheres

🎴 CollectorsphereTCG

Trading Card Game Platform

Die ultimative Plattform für TCG-Sammler mit Unterstützung für:

Pokémon TCG - Typ-Matchup Chart, Deck Builder, Meta Decks, Preis-Scanner
Yu-Gi-Oh! - Combo Database, Banlist Checker, Deck Profiles
Magic: The Gathering - Commander Deck Builder, Mana Curve, Format Checker

Features:

✅ Card Scanner mit AI-Erkennung (Kamera, Upload, Barcode)
✅ Live-Preisabfragen von pokemontcg.io, YGOPRODeck, Scryfall
✅ Deck Builder für alle Games
✅ Grading-System Integration (PSA, BGS)
✅ Collection Value Tracking
✅ Hot Cards Detection (High Value/Grade Cards)

🎮 CollectorssphereGAMING

Video Game Collection Manager

Multi-Platform Gaming Hub für:

PlayStation (PS1-PS5, PSP/Vita) - Trophy Tracking, Digital Library Sync
Xbox (OG-Series X/S) - Achievement Tracking, Game Pass Integration
Nintendo (NES-Switch) - Complete Collection Tracker, eShop Prices
PC Gaming (Steam, Epic, GOG) - Multi-Platform Sync, Playtime Stats
Retro Gaming - Cartridge Grading, Sealed Game Tracker

Features:

✅ Game Scanner (Barcode & Cover Recognition)
✅ Price Tracking über alle Plattformen
✅ Wishlist Manager mit Price Alerts
✅ Platform-spezifische Stats
⏳ Trophy/Achievement Sync (geplant)

📜 CollectorssphereOFFICIAL

Documents & Certificates Manager

Professionelle Verwaltung für:

Urkunden & Zertifikate - Bildungsabschlüsse, Zertifizierungen
Verträge - Arbeitsverträge, Mietverträge, Versicherungen
Ausweise & Pässe - Sicheres Dokumenten-Management
Steuer & Finanzen - Steuerbescheide, Kontoauszüge
Medizinische Dokumente - Impfausweise, Arztbriefe

Features:

✅ OCR Text-Erkennung für Dokumenten-Suche
✅ Secure Vault mit Verschlüsselung
✅ Ablaufdatum-Erinnerungen
✅ PDF-Generierung & Export
✅ Notarielle Beglaubigung Tracking

⛏️ CollectorssphereGEO

Geology & Archaeology Platform

Spezialisiert auf:

Mineralien - Mohshärte-DB, Fundort-Tracking, Chemische Formel
Fossilien - Zeitalter-Bestimmung, Arten-Identifikation, Echtheitsprüfung
Kristalle - Kristallsystem, Reinheitsgrad, Heilstein-Eigenschaften
Meteoriten - Klassifikation, Fundgeschichte, Nickel-Gehalt
Artefakte - Datierung, Kulturzuordnung, Provenienz

Features:

✅ Specimen Scanner mit Foto-Erkennung
✅ GPS-basiertes Fundort-Tracking mit Karten
✅ Labor-Daten & Zertifikate-Management
✅ Wissenschaftliche Klassifikation
⏳ AI-gestützte Mineralien-Identifikation (geplant)

🛒 CollectorssphereSHOP

Marketplace & Sales Platform

Komplette E-Commerce Lösung:

Inventory Management - Lagerbestand, SKU, Varianten
Pricing & Costing - Einkaufs-/Verkaufspreise, Marge-Kalkulation
Seller Tools - eBay/Etsy Integration, Bulk-Upload
Sales Analytics - Umsatz, Bestseller, ROI-Tracking
Shipping Management - Versandkosten, Tracking-Nummern

Features:

✅ Multi-Channel Listing (eBay, Etsy, Vinted)
✅ Automated Pricing (Market-basiert)
✅ Profit Calculator
✅ Customer Management
⏳ Inventory Sync (geplant)

✨ Core Features

Universal Platform Features

Feature	Beschreibung
Multi-Sphere Architecture	Spezialisierte Tools für jede Sammelkategorie
Cross-Platform	Web, Desktop, Mobile - automatische Synchronisation
Universal Search	Sphere-übergreifende Suche
Flexible Attributes	8+ Attributtypen: Text, Nummer, Tags, Checkbox, Datum, Link, Währung
Barcode Scanner	Unterstützt EAN-13, EAN-8, UPC-A, UPC-E, Code-128, QR

Dashboard & Analytics

+─────────────────────────────────────────────────────────+
│  CollectR Dashboard                                     │
├─────────────┬─────────────┬─────────────┬───────────────┤
│ 5 Spheres   │ 847 Items   │ €25,430     │ 18 Categories │
│ Active      │ Total       │ Total Value │ Across All    │
├─────────────────────────────────────────────────────────┤
│                                                         │
│  [Sphere Distribution]    [Value by Category]          │
│                                                         │
│  [Top Items]              [Recent Activity]            │
│   1. Charizard VMAX        - Card added to TCG         │
│   2. PS5 Sealed            - Game added to Gaming      │
│   3. Amethyst Geode        - Mineral added to Geo      │
+─────────────────────────────────────────────────────────+

Import & Export

Format	Import	Export	Bemerkung
CSV	✅	✅	Alle Spheres
JSON	✅	✅	Mit Metadaten
PDF	❌	✅	Export-Listen
Excel	⏳	⏳	Geplant

🛠️ Tech Stack

Kategorie	Technologie	Version
Framework	Next.js	15 (App Router)
Sprache	TypeScript	5.0+ (strict)
Styling	Tailwind CSS	4.0
Backend	Supabase	PostgreSQL 15
Auth	Supabase Auth	SSR + JWT
PWA	next-pwa	5.6
React	React	19
Hosting	Vercel	Edge Runtime

Architektur

┌────────────────────────────────────────────────────────┐
│                    Frontend Layer                      │
│  ┌──────────┐  ┌──────────┐  ┌──────────┐            │
│  │ Next.js  │  │  React   │  │Tailwind  │            │
│  │   15     │  │    19    │  │  CSS 4   │            │
│  └────┬─────┘  └────┬─────┘  └──────────┘            │
│       │             │                                  │
│       └─────────────┼──────────────┐                  │
│                     │              │                  │
│  ┌──────────────────▼──────────────▼────────────┐    │
│  │         Sphere-Specific Components            │    │
│  │  TCG • Gaming • Official • Geo • Shop        │    │
│  └───────────────────┬───────────────────────────┘    │
└──────────────────────┼────────────────────────────────┘
                       │
┌──────────────────────▼────────────────────────────────┐
│                  API Layer                            │
│  ┌─────────────────────────────────────────────┐     │
│  │         Supabase Client (SSR)               │     │
│  │    Auth • Database • Storage • Realtime     │     │
│  └──────────────────┬──────────────────────────┘     │
└────────────────────┼──────────────────────────────────┘
                     │
┌────────────────────▼──────────────────────────────────┐
│                 Backend Services                      │
│  ┌────────────────────────────────────────────┐      │
│  │              Supabase                      │      │
│  │  PostgreSQL • Auth • Storage • Functions   │      │
│  └────────────────────────────────────────────┘      │
│                                                       │
│  ┌────────────────────────────────────────────┐      │
│  │           External APIs                    │      │
│  │  PokémonTCG • YGOPRODeck • Scryfall        │      │
│  │  OpenLibrary • Discogs • CoinGecko         │      │
│  └────────────────────────────────────────────┘      │
└───────────────────────────────────────────────────────┘

🚀 Installation

Voraussetzungen

Node.js 18+
npm, yarn oder pnpm
Supabase Account

1. Repository klonen

git clone https://github.com/westside0106/CollectR.git
cd CollectR

2. Abhängigkeiten installieren

npm install

3. Umgebungsvariablen

Erstelle eine .env.local Datei:

# Supabase (erforderlich)
NEXT_PUBLIC_SUPABASE_URL=https://your-project.supabase.co
NEXT_PUBLIC_SUPABASE_ANON_KEY=your-anon-key

# APIs (optional - für erweiterte Features)
NEXT_PUBLIC_CURRENCYLAYER_API_KEY=your-key
NEXT_PUBLIC_GNEWS_API_KEY=your-key
DISCOGS_TOKEN=your-token

4. Datenbank einrichten

Führe die SQL-Migrationen in deinem Supabase Dashboard aus:

Gehe zu SQL Editor in Supabase
Führe die Migrations aus supabase/migrations/ aus

5. Entwicklungsserver starten

npm run dev

Öffne http://localhost:3000

📁 Projektstruktur

CollectR/
├── src/
│   ├── app/                    # Next.js App Router
│   │   ├── (hub)/              # Main Hub
│   │   │   └── hub/page.tsx
│   │   ├── (tcg)/              # TCG Sphere
│   │   │   └── tcg/
│   │   │       ├── page.tsx
│   │   │       ├── scanner/
│   │   │       ├── prices/
│   │   │       ├── deck-builder/
│   │   │       ├── pokemon/
│   │   │       ├── yugioh/
│   │   │       └── magic/
│   │   ├── (gaming)/           # Gaming Sphere
│   │   │   └── gaming/
│   │   │       ├── page.tsx
│   │   │       ├── scanner/
│   │   │       ├── prices/
│   │   │       └── playstation/
│   │   ├── (official)/         # Official Sphere
│   │   │   └── official/page.tsx
│   │   ├── (geo)/              # Geo Sphere
│   │   │   └── geo/page.tsx
│   │   ├── (shop)/             # Shop Sphere
│   │   │   └── shop/page.tsx
│   │   ├── collections/        # Universal Collections
│   │   ├── api/                # API Routes
│   │   └── page.tsx            # Dashboard
│   │
│   ├── components/             # React Components
│   │   ├── layout/
│   │   ├── TCGCardScanner.tsx
│   │   ├── BarcodeScanner.tsx
│   │   ├── AddToCollectionModal.tsx
│   │   └── ...
│   │
│   ├── hooks/                  # Custom Hooks
│   │   ├── useTCGStats.ts
│   │   ├── useGamingStats.ts
│   │   └── useGeoStats.ts
│   │
│   ├── lib/
│   │   ├── supabase/           # Supabase Client
│   │   └── themes/
│   │       └── sphere-themes.ts # Sphere Theme System
│   │
│   └── types/                  # TypeScript Types
│
├── public/
│   ├── brand/                  # Brand Assets
│   │   ├── collectr-hero.png
│   │   └── collectr-r.png
│   └── icons/                  # PWA Icons
│
├── middleware.ts               # Auth Middleware
└── next.config.ts              # Next.js Config

🎨 Sphere Theme System

Jede Sphere hat ein eigenes, konsistentes Design-System:

// sphere-themes.ts
export const SPHERE_THEMES = {
  tcg: {
    emoji: '🎴',
    name: 'CollectorsphereTCG',
    colors: {
      primary: '#dc2626',      // Red
      gradient: 'from-red-600 to-amber-500'
    }
  },
  gaming: {
    emoji: '🎮',
    name: 'CollectorssphereGAMING',
    colors: {
      primary: '#7c3aed',      // Violet
      gradient: 'from-violet-600 to-pink-600'
    }
  },
  // ... weitere Spheres
}

🗺️ Roadmap

✅ Phase 1: Core Platform (Erledigt)

✅ Phase 2: TCG Features (Erledigt)

🔄 Phase 3: Gaming Features (In Arbeit)

📋 Phase 4: Geo Features (Geplant)

Basic Specimen Management
Category System (Minerals, Fossils, Crystals, etc.)
GPS Location Tracking mit Maps
Lab Data & Certificates
AI Mineral Identification
3D Specimen Viewer

🛒 Phase 5: Shop Features (Geplant)

🚀 Phase 6: Advanced Features (Geplant)

AI Image Recognition (alle Spheres)
Blockchain Verification (High-Value Items)
AR Viewer (3D Models)
Community Features
Public Collections & Sharing

🔧 Scripts

npm run dev      # Entwicklungsserver (localhost:3000)
npm run build    # Produktions-Build
npm run start    # Produktions-Server
npm run lint     # ESLint ausführen
npm run type-check # TypeScript Type-Checking

🤝 Mitwirken

Beiträge sind willkommen!

Fork das Repository
Erstelle einen Feature-Branch (git checkout -b feature/amazing-feature)
Committe deine Änderungen (git commit -m 'Add amazing feature')
Push zum Branch (git push origin feature/amazing-feature)
Öffne einen Pull Request

📄 Lizenz

MIT License - siehe LICENSE für Details.

🙏 Danksagung

Besonderer Dank an:

Supabase - Backend as a Service
PokémonTCG API - Pokémon Card Data
YGOPRODeck - Yu-Gi-Oh! API
Scryfall - Magic: The Gathering API
Open Library - Book Database
Discogs - Music Database
Vercel - Hosting Platform

Made with ❤️ for collectors worldwide

GitHub • Issues • Discussions

Name		Name	Last commit message	Last commit date
Latest commit History 273 Commits
.vscode		.vscode
backups		backups
public		public
scripts		scripts
src		src
supabase		supabase
.gitignore		.gitignore
AGENTS.md		AGENTS.md
BRAND_VOICE.md		BRAND_VOICE.md
GRADING_FEATURE.md		GRADING_FEATURE.md
HANDOVER.md		HANDOVER.md
Icon		Icon
README.md		README.md
TCG_FEATURES_COMPLETE.md		TCG_FEATURES_COMPLETE.md
TCG_PRICE_API.md		TCG_PRICE_API.md
eslint.config.mjs		eslint.config.mjs
middleware.ts		middleware.ts
next-env.d.ts		next-env.d.ts
next.config.ts		next.config.ts
package-lock.json		package-lock.json
package.json		package.json
postcss.config.mjs		postcss.config.mjs
tsconfig.json		tsconfig.json
tsconfig.tsbuildinfo		tsconfig.tsbuildinfo

westside0106/CollectR

Folders and files

Latest commit

History

Repository files navigation

CollectR

🌟 Was ist CollectR?

Sphere-Konzept

🎯 Spheres

🎴 CollectorsphereTCG

🎮 CollectorssphereGAMING

📜 CollectorssphereOFFICIAL

⛏️ CollectorssphereGEO

🛒 CollectorssphereSHOP

✨ Core Features

Universal Platform Features

Dashboard & Analytics

Import & Export

🛠️ Tech Stack

Architektur

🚀 Installation

Voraussetzungen

1. Repository klonen

2. Abhängigkeiten installieren

3. Umgebungsvariablen

4. Datenbank einrichten

5. Entwicklungsserver starten

📁 Projektstruktur

🎨 Sphere Theme System

🗺️ Roadmap

✅ Phase 1: Core Platform (Erledigt)

✅ Phase 2: TCG Features (Erledigt)

🔄 Phase 3: Gaming Features (In Arbeit)

📋 Phase 4: Geo Features (Geplant)

🛒 Phase 5: Shop Features (Geplant)

🚀 Phase 6: Advanced Features (Geplant)

🔧 Scripts

🤝 Mitwirken

📄 Lizenz

🙏 Danksagung

About

Topics

Resources

Uh oh!

Stars

Watchers

Forks

Releases

Packages 0

Uh oh!

Contributors 3

Uh oh!

Languages

Packages