TCG Vault - Trading Card Game Collection Management with OCR Scanning
7463551065
🏗️ User Settings System: - Create comprehensive Settings page with tabbed interface - Move OCR configuration from modal to dedicated settings tab - Add API endpoints for user preferences (GET/PUT) - Store settings in database user_preferences table with ocr_settings column - Add Settings link to navbar user dropdown ⚙️ Settings Features: - General tab: default view, items per page, theme, animations - AI OCR tab: service selection, API keys, confidence threshold - Privacy tab: public collections/decks defaults - Real-time API key testing for OpenAI and Ollama - Persistent storage in database instead of localStorage 🔄 Integration: - Remove old OCRSettings modal from Scanner page - Add Settings route to App.tsx routing - Update navbar with Settings link in user dropdown - Prepare for AI OCR service to read from user preferences Next: Update AI OCR service to use saved user preferences instead of localStorage |
||
|---|---|---|
| api | ||
| backend | ||
| public | ||
| scripts | ||
| src | ||
| .gitignore | ||
| .npmrc | ||
| ALL-VERCEL-SETUP.md | ||
| deploy-vercel-all.sh | ||
| deploy-vercel.sh | ||
| deploy.sh | ||
| deployment-guide.md | ||
| DEPLOYMENT.md | ||
| DUAL_VIEW_SYSTEM.md | ||
| GAME_FEATURES.md | ||
| GRADIENT_BORDERS_GUIDE.md | ||
| package-lock.json | ||
| package.json | ||
| postcss.config.js | ||
| README.md | ||
| tailwind.config.js | ||
| tsconfig.json | ||
| vercel.json | ||
| VISUAL_EFFECTS_GUIDE.md | ||
TCG Vault - Trading Card Collection Manager
A comprehensive trading card database system with OCR scanning, AI-powered deck building, and real-time pricing.
Features
🃏 Complete Card Database
- Store and organize your entire trading card collection
- Track card conditions, quantities, and locations
- Support for multiple TCG formats (Magic: The Gathering, Pokémon, Yu-Gi-Oh!, etc.)
📸 OCR Card Scanning
- Scan physical cards using your camera or smartphone
- Automatic card recognition and data extraction
- Bulk scanning support for efficient collection entry
🤖 AI-Powered Features
- Intelligent deck building recommendations based on your collection
- Natural language queries for searching your database
- Meta analysis and card synergy suggestions
💰 Real-time Pricing
- Live price tracking from multiple sources
- Collection valuation and price alerts
- Historical price charts and market trends
🎨 Modern Web Interface
- Responsive design for desktop and mobile
- Drag-and-drop deck building
- Advanced filtering and search capabilities
Tech Stack
- Backend: Python FastAPI with SQLAlchemy ORM
- Database: SQLite (production-ready, can scale to PostgreSQL)
- Frontend: React with TypeScript and Tailwind CSS
- OCR: OpenCV + Tesseract with cloud vision APIs
- AI: OpenAI GPT integration for intelligent features
- Pricing: TCGPlayer and MTGJSON API integration
Quick Start
-
Backend Setup:
cd backend pip install -r requirements.txt uvicorn main:app --reload -
Frontend Setup:
cd frontend npm install npm start -
Database Initialize:
python backend/init_db.py
Project Structure
tcg-vault/
├── backend/ # FastAPI backend
│ ├── app/
│ │ ├── models/ # SQLAlchemy models
│ │ ├── routers/ # API route handlers
│ │ ├── services/ # Business logic
│ │ └── utils/ # Utilities (OCR, AI, pricing)
│ ├── tests/ # Backend tests
│ └── requirements.txt
├── frontend/ # React frontend
│ ├── src/
│ │ ├── components/
│ │ ├── pages/
│ │ ├── services/ # API clients
│ │ └── utils/
│ └── package.json
├── docs/ # Documentation
└── docker-compose.yml # Container orchestration
Development
This project is designed for easy development and deployment. See the individual README files in backend/ and frontend/ for detailed setup instructions.
Contributing
- Fork the repository
- Create a feature branch
- Make your changes
- Add tests
- Submit a pull request
License
MIT License - feel free to use this project for your own collection management needs!