Marketplace e-commerce per la distribuzione automatizzata di chiavi digitali di videogiochi. Consegna istantanea garantita in meno di 5 secondi dal pagamento.
Progetto didattico full-stack basato sullo stack tecnologico definito nella documentazione ufficiale del progetto: Laravel 11 + React 18 + Inertia.js + TailwindCSS + MariaDB/SQLite.
| Layer | Tecnologia |
|---|---|
| Frontend | React 18, Inertia.js, TailwindCSS |
| Backend | Laravel 11, PHP 8.3 |
| Database | MariaDB 12 (configurazione predefinita) |
| Auth | Laravel Breeze (email/password), middleware admin |
| Pagamenti | Stripe + PayPal (placeholder UI) + modalità Demo |
| Build tool | Vite 6 |
- Home page in stile gaming con hero, sezioni "In evidenza", "Migliori offerte", "Nuove uscite"
- Catalogo con filtri per piattaforma, genere, prezzo, "solo offerte" + ordinamento (popolarità, prezzo, novità, rating)
- Pagina prodotto con galleria, trailer YouTube, requisiti di sistema, recensioni
- Carrello persistente in sessione + applicazione codici sconto (
WELCOME10,SUMMER20,INSTANT5,BLACKFRIDAY) - Pagine statiche: Chi siamo, FAQ, Contatti
- Registrazione, login, recupero password (Breeze)
- Dashboard personale con tile (Ordini, Wishlist, Supporto, Profilo)
- Checkout con scelta metodo di pagamento (Stripe/PayPal/Demo)
- Consegna istantanea: assegnazione automatica chiave dal pool al pagamento confermato
- Storico ordini con visualizzazione chiave (mostra/copia/nasconde) e ticket di sostituzione
- Wishlist con possibilità di rimozione rapida
- Recensioni verificate (solo dopo acquisto)
- Sistema ticket per chiavi non funzionanti
- Pannello dashboard con statistiche (ricavi, ordini, utenti, chiavi)
- Lista ultimi ordini e prodotti con stock basso
- Alert per ticket aperti
Le tabelle rispecchiano lo schema fisico del PDF di progetto:
platforms(Steam, Epic, GOG, Origin, Battle.net, PSN, Xbox, Nintendo eShop)genres(Action, RPG, FPS, Strategy, Sports, ...)products(catalogo giochi conprice,original_price,release_date,rating_avg)keys_stock(pool delle chiavi con statoavailable/reserved/sold/invalid)orders+order_items(conkey_idcollegata alla chiave erogata)wishlists(conprice_alert)reviews(converified_purchase)tickets(legati aorder_item_id)discount_codes(conusage_limiteexpires_at)
Migrations in database/migrations/, seeder in database/seeders/.
- PHP 8.3 (installato via winget:
winget install PHP.PHP.8.3) - Composer 2.x (installato in
%LOCALAPPDATA%\Composer) - Node.js 20+ e npm
- MariaDB 12 (installato via winget:
winget install MariaDB.Server)
composer install
npm installAvvia il client MariaDB e crea il database:
CREATE DATABASE IF NOT EXISTS instantkey
CHARACTER SET utf8mb4
COLLATE utf8mb4_unicode_ci;Copia .env.example in .env e imposta le credenziali del DB:
DB_CONNECTION=mariadb
DB_HOST=127.0.0.1
DB_PORT=3306
DB_DATABASE=instantkey
DB_USERNAME=root
DB_PASSWORD=instantkey # la password scelta in fase di installazioneGenera la chiave dell'app:
php artisan key:generatephp artisan migrate:fresh --seedQuesto comando crea le tabelle e popola:
- 2 utenti:
admin@instantkey.test/password(admin)demo@instantkey.test/password(utente normale)
- 8 piattaforme + 14 generi
- 20 videogiochi con copertine, trailer, descrizioni
- 25 chiavi disponibili per ogni gioco (500 chiavi totali nel pool)
- 4 codici sconto funzionanti
npm run buildphp artisan serveApri il browser su http://127.0.0.1:8000.
Modalità sviluppo (hot reload): in un secondo terminale esegui
npm run deve poiphp artisan servenel primo.
| Ruolo | Password | |
|---|---|---|
| Admin | admin@instantkey.test |
password |
| Utente | demo@instantkey.test |
password |
Codici sconto demo: WELCOME10 (-10%), SUMMER20 (-20%), INSTANT5 (-5€), BLACKFRIDAY (-30%).
Il cuore del progetto è la pipeline di consegna chiave automatizzata implementata in app/Services/KeyDeliveryService.php:
- L'utente conferma il pagamento (
POST /checkout). CheckoutControllerapre una transazione DB, crea l'Ordere gliOrderItems(senza chiave assegnata).- Si simula la conferma del pagamento (Stripe/PayPal/Demo).
KeyDeliveryService::deliverKeys()blocca conlockForUpdate()una chiave dal pool, la marca comesold, e collegakey_idall'OrderItem. Se il pool è esaurito, l'intera transazione rollback.- L'utente viene reindirizzato sulla pagina ordine dove può copiare la chiave.
In caso di chiave non funzionante, il TicketController permette all'utente di aprire un ticket; KeyDeliveryService::replaceKey() può assegnare una nuova chiave dal pool.
InstantKey/
├── app/
│ ├── Http/Controllers/ # Catalog, Product, Cart, Checkout, Order, Wishlist, Review, Ticket, Admin
│ ├── Http/Middleware/ # EnsureUserIsAdmin, HandleInertiaRequests
│ ├── Models/ # Product, KeyStock, Order, OrderItem, ...
│ └── Services/ # CartService, KeyDeliveryService
├── database/
│ ├── migrations/ # 11 migrations (incluso is_admin su users)
│ └── seeders/ # PlatformSeeder, GenreSeeder, ProductSeeder, DiscountCodeSeeder
├── resources/
│ ├── css/app.css # Tailwind + utility classes (.btn-primary, .card, .game-card, ...)
│ ├── js/
│ │ ├── Components/ # GameCard
│ │ ├── Layouts/ # SiteLayout (header gaming + footer), GuestLayout
│ │ └── Pages/ # Home, Catalog, Products, Cart, Checkout, Orders, Wishlist, Tickets, Admin, Auth, Profile
│ └── views/app.blade.php
├── routes/
│ ├── web.php # Tutte le route applicative
│ └── auth.php # Route Breeze (login, register, ...)
├── tailwind.config.js # Config con palette brand/accent + dark mode forzata
└── vite.config.js
Conforme alla documentazione, le seguenti feature sono previste ma non implementate (perché esulano dalle Fasi 1-2 del progetto didattico):
- 2FA TOTP (Laravel Fortify)
- Login OAuth Google/Steam (Laravel Socialite)
- Integrazione Stripe/PayPal reale (al momento sono placeholder UI; il flusso "demo" è funzionante)
- Notifiche email transazionali via Mailgun/SendGrid
- Meilisearch + Laravel Scout per ricerca full-text
- Code di lavoro (Laravel Queues + Supervisor)
- Cache Redis
- Pannello admin completo (CRUD prodotti/chiavi/ordini)
- Pipeline CI/CD GitHub Actions
# Reset completo del database con dati demo
php artisan migrate:fresh --seed
# Aggiungi più chiavi a uno specifico prodotto via tinker
php artisan tinker
>>> App\Models\KeyStock::factory()->count(50)->create(['product_id' => 1]);
# Pulizia cache
php artisan optimize:clear
# Lista route
php artisan route:list
# Build production
npm run build
# Dev server con hot reload
npm run devProgetto didattico realizzato per il corso di sviluppo web full-stack. Architettura, scelte tecnologiche e schema DB derivati dal documento INSTANT_KEY — Documentazione Finale.