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
1.**Backend Setup**:
```bash
cd backend
pip install -r requirements.txt
uvicorn main:app --reload
```
2.**Frontend Setup**:
```bash
cd frontend
npm install
npm start
```
3.**Database Initialize**:
```bash
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
1. Fork the repository
2. Create a feature branch
3. Make your changes
4. Add tests
5. Submit a pull request
## License
MIT License - feel free to use this project for your own collection management needs!
