https://github.com/redsign77/cards-api-php
Laravel based Cards Forge API
https://github.com/redsign77/cards-api-php
Last synced: 5 days ago
JSON representation
Laravel based Cards Forge API
- Host: GitHub
- URL: https://github.com/redsign77/cards-api-php
- Owner: RedSign77
- Created: 2025-07-18T06:26:04.000Z (7 months ago)
- Default Branch: main
- Last Pushed: 2025-12-24T11:44:56.000Z (about 2 months ago)
- Last Synced: 2025-12-26T02:09:38.669Z (about 2 months ago)
- Language: PHP
- Size: 5.03 MB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
Awesome Lists containing this project
README
# Cards Forge API
A comprehensive REST API for managing trading cards, decks, games, and creators. Built with Laravel 12 and Filament 3.0 admin panel, featuring a complete marketplace system with multi-currency support.
## Features
- **Game Management** - Create and manage trading card games
- **Card System** - Flexible card creation with dynamic JSON fields
- **Deck Building** - Build and organize decks within games
- **User Authentication** - Sanctum-based API authentication
- **Admin Panel** - Powerful Filament 3.0 admin interface
- **Marketplace** - Buy and sell physical cards with multi-currency support
- **Activity Logging** - Track user actions and system events
- **Email Notifications** - Automated notifications for key events
- **Excel Import/Export** - Bulk data operations
- **Image Management** - Avatar and card image uploads
## Tech Stack
- **Backend:** Laravel 12 (PHP 8.2+)
- **Admin Panel:** Filament 3.0
- **Authentication:** Laravel Sanctum
- **Frontend:** Vite + Tailwind CSS 4.0
- **Database:** SQLite (default) / MySQL
- **Queue:** Laravel Queue with database driver
- **File Storage:** Laravel public disk
## Requirements
- PHP 8.2 or higher
- Composer
- Node.js & npm
- SQLite or MySQL
## API Documentation
### Authentication
**Register User**
```http
POST /api/user/register
Content-Type: application/json
{
"name": "John Doe",
"email": "john@example.com",
"password": "password",
"password_confirmation": "password"
}
```
**Login**
```http
POST /api/user/login
Content-Type: application/json
{
"email": "john@example.com",
"password": "password"
}
```
### API Endpoints (v1)
All v1 endpoints require authentication via Sanctum token:
```http
Authorization: Bearer {token}
```
- `GET|POST /api/v1/games` - Games management
- `GET|POST /api/v1/cardtypes` - Card types management
- `GET|POST /api/v1/cards` - Cards management
- `GET|POST /api/v1/decks` - Decks management
## Admin Panel
Access the admin panel at `/admin` after logging in with supervisor credentials.
**Features:**
- Resource management (Games, Cards, Decks, Users)
- Shopping cart and marketplace
- Order management (buyer/seller views)
- Activity logging
- Excel import/export
- System statistics dashboard
## Marketplace
The platform includes a complete marketplace system:
- Multi-currency support with real-time conversion
- Shopping cart with 30-minute reservation system
- Order lifecycle management
- Buyer/seller confirmation workflow
- Shipping address management
## Configuration
### Email Notifications
Configure email settings in `.env`:
```env
MAIL_ENABLED=true
MAIL_ADMIN_ADDRESS=admin@example.com
```
### Scheduled Tasks
Add to your crontab:
```bash
* * * * * cd /path-to-project && php artisan schedule:run >> /dev/null 2>&1
```
## License
All rights reserved. Copyright Webtech-solutions 2025.
## Support
For issues and feature requests, please use the [GitHub issue tracker](https://github.com/RedSign77/cards-api-php/issues).