DECEMPIONS – README V1
======================

ARCHITETTURA SCELTA
-------------------
Questa V1 è stata costruita per restare gratis e semplice da pubblicare.

Stack:
- Frontend: HTML + CSS + JavaScript statici
- Hosting: Vercel / Netlify / GitHub Pages
- Database cloud: Supabase (opzionale, ma consigliato)
- Fallback locale: localStorage del browser

REQUISITI COPERTI IN QUESTA V1
------------------------------
1. Web app apribile da URL browser
2. Nome tool: Decempions
3. Tema grafico ispirato all'atmosfera Champions, ma originale
4. Viewer pubblico
5. Editor separati
6. Inserimento partita manuale
7. Stagioni
8. Sessioni serali manuali
9. Classifica stagione
10. Classifica serata
11. Ranking normalizzato
12. Ranking ELO
13. Statistiche
14. Storico partite
15. Modifica ed eliminazione partite per editor
16. Giocatori con attiva/disattiva
17. Modalità gratis anche senza Supabase

LIMITI VOLUTI DI QUESTA V1
--------------------------
1. OCR automatico non incluso nella V1
2. Upload foto presente solo come allegato facoltativo
3. Login reale disponibile solo se configuri Supabase Auth
4. Senza Supabase i dati restano nel browser locale del dispositivo

STRUTTURA FILE
--------------
index.html
static/css/styles.css
static/js/app.js
static/js/storage.js
static/js/calculations.js
static/js/utils.js
static/js/config.example.js
static/js/config.js
sql/supabase_schema.sql
README.txt

COME AVVIARLA IN LOCALE
-----------------------
Metodo semplice:
1. estrai lo zip
2. apri la cartella
3. lancia un server statico

Opzione Python:
python -m http.server 8080

Poi apri:
http://localhost:8080

Opzione VS Code:
usa estensione Live Server

COME PUBBLICARLA GRATIS
-----------------------
Metodo consigliato:
1. crea account GitHub
2. carica la cartella su un repository
3. crea account Vercel oppure Netlify
4. collega il repository
5. pubblica il sito

URL finale esempio:
https://decempions.vercel.app

COME ATTIVARE SUPABASE
----------------------
1. crea account Supabase
2. crea un nuovo progetto
3. apri SQL Editor
4. esegui il file sql/supabase_schema.sql
5. copia URL progetto e anon key
6. apri static/js/config.js
7. sostituisci con:

export const CONFIG = {
  supabaseUrl: "https://TUO-PROGETTO.supabase.co",
  supabaseAnonKey: "TUA_ANON_KEY",
  enableSupabase: true,
};

8. ripubblica o ricarica il sito

COME FUNZIONA SENZA SUPABASE
----------------------------
Se enableSupabase resta false:
- l'app usa localStorage
- hai dati demo iniziali
- il login editor demo è simulato
- ottima per test, mockup e prototipo veloce

COME FUNZIONA CON SUPABASE
--------------------------
Con Supabase attivo:
- dati condivisi tra dispositivi
- login reale editor
- viewer pubblici
- editor autenticati
- match persistenti nel cloud

RUOLI
-----
Viewer:
- vede tutto
- non modifica nulla

Editor:
- inserisce partite
- modifica partite
- elimina partite
- crea stagioni
- apre sessioni
- gestisce giocatori

NOTA IMPORTANTE SUI RUOLI SUPABASE
----------------------------------
Per rendere un utente editor devi:
1. creare l'utente in Supabase Auth
2. inserire il suo user_id in public.user_roles con role = 'editor'

FORMULA RANKING NORMALIZZATO
----------------------------
Score =
- 50% punti per partita
- 30% win rate
- 20% differenza reti per partita

Se un giocatore ha meno di 3 partite appare come:
"campione ridotto"

ELO
---
- rating iniziale: 1000
- K-factor: 32
- aggiornamento a ogni partita
- separato dalla classifica stagione

CLASSIFICA STAGIONE
-------------------
Ordinamento:
1. punti
2. differenza reti
3. gol fatti
4. scontri diretti
5. percentuale vittorie
6. media punti partita

SESSIONI
--------
La sessione serale è manuale:
- la apri dal pannello Stagioni e sessioni
- tutte le partite possono essere agganciate a quella sessione
- la classifica serata usa le partite della sessione

MODIFICA PARTITE
----------------
Dallo Storico:
- Modifica porta il match nel form Nuova partita
- Elimina rimuove il match
- in local mode viene scritto audit log locale

CHECK RAPIDO PRIMA DEL DEPLOY
-----------------------------
1. provare apertura index.html tramite server statico
2. verificare creazione giocatore
3. verificare creazione stagione
4. verificare apertura sessione
5. verificare inserimento match
6. verificare classifica aggiornata
7. verificare ranking normalizzato
8. verificare ranking ELO
9. verificare storico e modifica

CONSIGLIO PRATICO
-----------------
Per partire subito:
- usa la modalità locale
- fai vedere il prototipo agli amici
- poi attiva Supabase quando vuoi dati condivisi via URL

DECEMPIONS
----------
Football nights deserve a real league.