Skip to content

vanohj/vantaggio-statistico

Β 
Β 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

72 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

🎰 Vantaggio Statistico

Casino Strategy Platform - Una piattaforma avanzata per strategie di casinΓ² che guida i giocatori attraverso decisioni statisticamente informate per massimizzare il potenziale di vincita.

πŸš€ Stato del Progetto

🎯 FASE 1: FOUNDATION + AUTH MODULE COMPLETATA (v0.2.0)

La base architetturale della piattaforma Γ¨ implementata e il modulo Auth Γ¨ completamente funzionante. Database cloud configurato, authentication Clerk integrata, deploy automatico attivo su Vercel.

βœ… Caratteristiche Implementate

  • πŸ—οΈ Architettura Modulare: Bounded contexts completamente indipendenti
  • πŸ” Auth Module Completo: Clerk + database sync + React hooks
  • 🌐 Cloud-First Setup: Vercel + Neon + Environment variables
  • πŸ—„οΈ Database Cloud: 14 tabelle su Neon PostgreSQL funzionanti
  • ⚑ Deploy Automatico: GitHub β†’ Vercel integration attiva
  • πŸ”— Contratti Stabili: Interfacce standardizzate tra moduli
  • 🎨 Design Casino Premium: Sistema di design luxury implementato
  • πŸ“± Responsive & Mobile-First: Ottimizzato per gaming mobile

πŸ› οΈ Stack Tecnologico

Frontend & Backend

  • Next.js 15 con App Router e TypeScript
  • Tailwind CSS con design system casino-themed
  • Framer Motion per animazioni premium
  • React Hook Form + Zod per validazione

Database & Backend Services

  • PostgreSQL con Prisma ORM
  • Clerk.com per autenticazione
  • Stripe per pagamenti e subscriptions
  • Vercel per hosting e deploy

Architettura

  • Clean Architecture (Domain, Application, Infrastructure)
  • Ports & Adapters per modularitΓ 
  • Event-Driven per comunicazione tra moduli
  • Result/Option Types per gestione errori

πŸ“ Struttura del Progetto

src/ β”œβ”€β”€ modules/ # Bounded Contexts (Moduli) β”‚ β”œβ”€β”€ auth/ # Autenticazione e gestione utenti β”‚ β”œβ”€β”€ permissions/ # RBAC e pacchetti β”‚ β”œβ”€β”€ games/ # Tipi di gioco (Roulette, Blackjack) β”‚ β”œβ”€β”€ methods/ # Metodi di betting (Fibonacci, Martingale) β”‚ β”œβ”€β”€ sessions/ # Gestione sessioni di gioco β”‚ β”œβ”€β”€ analytics/ # Dashboard e reportistica β”‚ └── payments/ # Subscriptions e billing β”œβ”€β”€ shared/ # Codice condiviso β”‚ β”œβ”€β”€ domain/ # Tipi e contratti condivisi β”‚ β”œβ”€β”€ infrastructure/ # Utilities e configurazioni β”‚ └── ui/ # Componenti UI riutilizzabili └── app/ # Next.js App Router 

🎯 Moduli Implementati (Contratti)

1. AUTH MODULE

  • Integrazione Clerk per autenticazione
  • Sync utenti con database locale
  • Gestione sessioni e profili

2. PERMISSIONS MODULE

  • Sistema granulare di permessi
  • Pacchetti Free e Premium
  • Access control per features

3. GAMES MODULE

  • Roulette Europea (implementata)
  • Configurazioni gioco estensibili
  • Validazione risultati di gioco

4. METHODS MODULE

  • Interfaccia Standardizzata per tutti i metodi:
    interface MethodInput/MethodOutput
  • Fibonacci (Free tier)
  • Martingale, Paroli, D'Alembert (Premium)

5. SESSIONS MODULE

  • Creazione e gestione sessioni
  • Tracking bets e progressioni
  • Pause/Resume functionality

6. ANALYTICS MODULE

  • Dashboard utente personalizzate
  • Performance tracking per metodi
  • Export dati in vari formati

7. PAYMENTS MODULE

  • Integrazione Stripe completa
  • Subscription management
  • Webhook processing

🎨 Design System Casino

Palette Colori

  • Casino Gold: #ffb700 - Lusso e prestigio
  • Casino Green: #16a34a - Tavolo da gioco
  • Casino Red: #dc2626 - Accent dinamici
  • Casino Dark: Gradienti scuri per profonditΓ 

Componenti Premium

  • CasinoCard: Cards luxury con glassmorphism
  • MoneyDisplay: Formattazione italiana valuta
  • RouletteWheel: Ruota animata interattiva

Animazioni

  • Hover effects sottili
  • Transizioni fluide 300ms
  • Effetti glow per elementi premium
  • Spin animations per roulette

πŸ—„οΈ Database Schema

Moduli Principali

  • Users: Gestione utenti e Clerk sync
  • Packages/Permissions: Sistema RBAC
  • GameTypes/Methods: Configurazioni gioco
  • Sessions/Bets: Tracking gameplay
  • Subscriptions/Payments: Billing Stripe

Features

  • Relazioni ottimizzate per performance
  • Enums TypeScript-safe per status
  • JSON fields per configurazioni flessibili
  • Audit trails per compliance

πŸš€ Cloud-First Development Setup

Opzione 1: GitHub Codespaces (Raccomandato)

# 1. Apri GitHub repository # 2. Clicca "Code" β†’ "Codespaces" β†’ "Create codespace" # 3. L'ambiente si configura automaticamente con devcontainer.json # 4. Esegui i comandi di setup: npm install npm run db:generate npm run dev # Server automaticamente su porta forwarded

Opzione 2: Vercel Development

# 1. Collega repository a Vercel # 2. Deploy automatico ad ogni push su main # 3. Ambiente identico a produzione # 4. Live URL immediato

πŸ”§ Comandi Disponibili

# Sviluppo Cloud npm run dev # Server sviluppo (auto-forwarded in Codespaces) npm run build # Build produzione (identico a Vercel) npm run lint # Controllo codice npm run type-check # Verifica TypeScript # Database Cloud (Neon) npm run db:generate # Genera Prisma client npm run db:push # Aggiorna schema su Neon npm run db:seed # Popola dati iniziali npm run db:studio # Prisma Studio (forwarded port 5555) npm run db:test # Test connessione database # Auth Module npm run auth:test # Test completo Auth Module integration # Testing & CI/CD npm test # Test (eseguiti anche in GitHub Actions) npm run test:watch # Test in watch mode npm run test:coverage # Report coverage # Cloud Testing curl https://vantaggio-statistico.vercel.app/api/health # Health check produzione

🌐 Cloud Infrastructure

Live URLs

  • Production: https://vantaggio-statistico.vercel.app βœ… LIVE
  • Preview: Auto-generato per ogni PR
  • Codespaces: Port forwarding automatico
  • Health Check: https://vantaggio-statistico.vercel.app/api/health

Services Integrati

  • Database: Neon PostgreSQL serverless βœ… CONFIGURED
  • Auth: Clerk.com authentication βœ… CONFIGURED
  • Payments: Stripe integration (da configurare)
  • CI/CD: GitHub Actions β†’ Vercel βœ… ACTIVE
  • Development: GitHub Codespaces

Environment Variables (Vercel)

βœ… Database

DATABASE_URL=postgresql://neondb_owner:***@ep-blue-wind-aglvi6rb-pooler.c-2.eu-central-1.aws.neon.tech/neondb?sslmode=require # Environments: Production, Preview, Development

βœ… Clerk Authentication

NEXT_PUBLIC_CLERK_PUBLISHABLE_KEY=pk_test_*** CLERK_SECRET_KEY=sk_test_*** # Environments: Production, Preview, Development

βœ… App Configuration

NEXT_PUBLIC_APP_URL=https://vantaggio-statistico.vercel.app # Environments: Production (diverso per Preview/Dev) NEXTAUTH_SECRET=production-super-secure-secret-*** # Environments: Production, Preview, Development

βœ… Feature Flags

NEXT_PUBLIC_ENABLE_ANALYTICS=true # Environments: Production, Preview NEXT_PUBLIC_ENABLE_PREMIUM_FEATURES=true # Environments: Production, Preview, Development

Cloud Setup Status

  • βœ… Vercel Project: Configurato e collegato a GitHub
  • βœ… Environment Variables: 7 variabili configurate
  • βœ… Automatic Deployment: Attivo su push main
  • βœ… Database Connection: Neon PostgreSQL connesso
  • βœ… Authentication: Clerk integration ready
  • ⚠️ Stripe: Da configurare per payments

πŸ“Š Metriche di Successo - Fase 1

βœ… Architettura

  • Moduli 100% indipendenti
  • Zero dipendenze dirette tra bounded contexts
  • Contratti stabili e documentati
  • Clean Architecture implementata

βœ… UI/UX

  • Design casino premium implementato
  • Componenti responsive e touch-friendly
  • Animazioni fluide e realistiche
  • Sistema colori coerente

βœ… Database

  • Schema completo per tutti i moduli
  • Seed data per sviluppo
  • Ottimizzazioni performance
  • Type safety completa

πŸ”„ Prossimi Passi (Fase 2)

Week 3-5: Game Engine & Auth Implementation

  1. Implementazione Auth Module con Clerk
  2. Sistema Permissions granulare
  3. Roulette Engine funzionante
  4. Metodo Fibonacci operativo

PrioritΓ 

  • Configurazione environment variabili
  • Setup database su Neon
  • Integrazione Clerk authentication
  • Primo metodo betting funzionante

πŸ‘₯ Team Development

Questo progetto segue una architettura modulare rigorosa dove ogni sviluppatore puΓ² lavorare su moduli indipendenti senza conflitti.

Regole Architetturali

  • ZERO dipendenze dirette tra moduli
  • Comunicazione SOLO tramite contratti
  • Event-driven per operazioni asincrone
  • Ports & Adapters per integrazioni esterne

🎰 Vantaggio Statistico - Where Mathematics Meets Casino Strategy

Powered by Next.js 15, TypeScript, and Premium Casino UX Design# Force redeploy Dom 19 Ott 2025 02:11:50 CEST

Deploy trigger Lun 20 Ott 2025 09:34:28 CEST

About

Casino strategy platform with statistical advantage

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages

  • TypeScript 98.0%
  • CSS 1.1%
  • JavaScript 0.9%