Initial independent version of CrAPP

2026-08-06 08:36:47 +02:00
commit 330669176d
167 changed files with 24096 additions and 0 deletions
@@ -0,0 +1,31 @@
+# Obiettivi di squadra: sezione in Squadra + widget in home
+
+## Stato attuale
+
+Al momento c'è un solo "obiettivo di squadra" ed è hardcoded nella home (`src/routes/index.tsx`, riga 136): **"90% di presenze ad agosto"** con una barra finta all'82%. Non esiste uno schema dati né una sezione dedicata, e non è collegato a calendario, presenze o statistiche. Le voci "obiettivi" nelle descrizioni di Squadra e Profilo si riferiscono ai badge individuali, non a obiettivi di squadra.
+
+## Cosa faccio
+
+1. **Modello dati locale** in `src/lib/crapp-data.ts`
+  - Nuovo tipo `ObiettivoSquadra`: id, titolo, descrizione, target, valore attuale, unità, scadenza (opzionale), icona.
+  - Array `obiettiviSquadra` con gli obiettivi demo della stagione.
+2. **Sezione "Obiettivi di squadra" dentro la scheda Squadra** (`src/routes/squadra.tsx`)
+  - Nuova sezione con la lista completa degli obiettivi: barra di progresso, percentuale, stato (in corso / completato).
+  - Ordinati con gli obiettivi in corso in cima e i completati in fondo.
+  - Nessuna nuova rotta e nessuna modifica al bottom nav.
+3. **Widget home dinamico** (`src/routes/index.tsx`)
+  - Sostituisce l'obiettivo hardcoded: mostra sempre il primo obiettivo in corso preso dalla lista.
+  - Progresso calcolato dai dati reali dove possibile (es. presenze derivate dagli eventi).
+4. **Obiettivi demo iniziali**
+  - 90% di presenze ad agosto (collegato agli eventi di agosto).
+  - 70% di risposte entro 24h nel prossimo mese.
+  - Prima vittoria del campionato (collegato allo storico match).
+  - 5 vittorie in campionato (collegato allo storico match).
+  - 10 vittorie in campionato (collegato allo storico match).
+  - 1 evento di squadra al mese (pizzata, ecc.).
+
+## Cosa non cambia
+
+- Resta un prototipo offline: i dati restano in `src/lib/crapp-data.ts`.
+- I badge individuali restano come sono in `src/lib/badges.ts` e nella rosa di `src/routes/squadra.tsx`.
+- Bottom nav e rotte invariate.
@@ -0,0 +1,58 @@
+# Rendere CrAPP operativa: migrazione dal prototipo al Cloud
+
+## Stato attuale
+
+L'app è un prototipo UI con alcune funzioni già collegate a Lovable Cloud:
+
+- Già sul Cloud: voti MVP (`mvp_voti`), iscrizioni push (`push_subscriptions`), sessioni scout (`scout_sessioni`), turni palloni (`turni_palloni`).
+- Ancora in locale come dati demo: rosa giocatori, calendario eventi, storico partite, classifica CSI, statistiche individuali, presenze/assenze, badge.
+
+## Cosa serve per renderla operativa
+
+1. **Rosa e profili giocatori sul database**
+   - Creare tabella `profiles` (o `giocatori`) con nome, numero maglia, ruolo, data di nascita, foto profilo.
+   - Collegare ogni riga all'utente autenticato corrispondente.
+   - Rimuovere la rosa statica da `src/lib/crapp-data.ts` e caricarla dal backend.
+
+2. **Autenticazione reale**
+   - Sostituire la semplice selezione "Chi sei?" in `localStorage` con login email/password o OAuth (Google).
+   - Ogni giocatore accede con le proprie credenziali e vede solo i propri dati modificabili.
+   - Necessaria per garantire che uno scout o un voto MVP provenga davvero da quel giocatore.
+
+3. **Calendario eventi persistente**
+   - Tabella `eventi` con tipo, titolo, data, ora, luogo, avversario, casa/fuori.
+   - Tabella `presenze` (evento_id, giocatore_id, stato, aggiornato_il).
+   - I compleanni possono restare derivati dalla data di nascita dei giocatori.
+
+4. **Statistiche e badge dinamici**
+   - Tabella `statistiche` o `azioni_scout` (evento_id, giocatore_id, tipo azione, valore, creato_il).
+   - I badge vengono calcolati in tempo reale dalle statistiche accumulate, senza valori fissi in `crapp-data.ts`.
+
+5. **Scout live collegato ai dati reali**
+   - Le azioni registrate in `scout.tsx` devono scrivere sulle tabelle eventi/statistiche.
+   - Mantenere il lock di modifica singolo e l'attivazione solo il giorno della partita.
+
+6. **Classifica CSI**
+   - Tabella `classifica` aggiornata manualmente da un admin o importata dal sito CSI quando disponibile.
+   - Per ora nessuna API CSI ufficiale: si inserisce a mano o si copia/incolla.
+
+7. **Notifiche push definitive**
+   - Verificare che i cron job inviino correttamente i promemoria palloni.
+   - Aggiungere notifiche per conferma eventi, promemoria presenze, MVP votabile.
+
+8. **Ruoli e permessi**
+   - Definire chi può creare/modificare eventi (capitano/admin).
+   - Chi può fare scout (designato per partita).
+   - Chi può modificare i turni palloni (tutti, come da tua richiesta).
+
+## Cosa resta salvato nel Cloud
+
+Sì: tutto ciò che viene scritto sulle tabelle Lovable Cloud/Supabase resta salvato online e condiviso tra tutti i dispositivi.
+
+I dati demo in `src/lib/crapp-data.ts` invece no: sono file statici, quindi ogni aggiornamento dell'app li sovrascrive e ogni telefono li vede identici.
+
+## Decisioni da prendere insieme
+
+- Vuoi abilitare login email/password per ogni giocatore, o preferisci mantenere la selezione "Chi sei?" senza password per semplicità?
+- Chi gestirà inserimento eventi e aggiornamento classifica: solo alcuni o tutta la squadra?
+- Vuoi procedere per fasi (prima rosa + calendario + presenze, poi statistiche) o tutto insieme?
@@ -0,0 +1,23 @@
+# Ridimensionamento badge nella lista squadra
+
+## Obiettivo
+Rendere i badge accanto al nome del giocatore nella lista squadra più compatti e meno invasivi, mantenendo lo stile stilizzato (icone Lucide colorate per grado) e lasciando la scheda espansa con una dimensione leggibile.
+
+## Modifiche previste
+
+1. **Lista squadra (`src/routes/squadra.tsx`)**
+   - Ridurre le icone badge sbloccati mostrate accanto al nome da `h-4 w-4` (16px) a `h-3 w-3` (12px).
+   - Mantenere il massimo di 3 badge visibili e il contatore `+N` con testo ridotto a `text-[9px]` per armonizzare.
+   - Lasciare invariati avatar, nome, ruolo ed età.
+
+2. **Scheda giocatore espansa (`src/routes/squadra.tsx`)**
+   - Portare le icone badge dalla dimensione attuale a `h-4 w-4` (16px), leggibili ma non troppo grandi.
+   - Mantenere card, colori per grado (bronzo/argento/oro) e testi descrittivi.
+
+3. **Verifica**
+   - Controllare la preview su `/squadra` per confermare che i badge in lista siano discreti e la scheda espansa rimanga leggibile.
+   - Eseguire build per assicurarsi che non ci siano errori di tipo o stile.
+
+## Cosa non cambia
+- Colori dei gradi, soglie badge, logica di sblocco e votazione MVP.
+- Layout generale della pagina e bottom navigation.
@@ -0,0 +1,11 @@
+# Rimuovere placeholder "Livello 7" dal Profilo
+
+## Obiettivo
+Eliminare il testo statico "Livello 7" dalla scheda profilo, dato che non è collegato a nessun calcolo reale e l'utente preferisce toglierlo per ora.
+
+## Modifica
+- `src/routes/profilo.tsx`: rimuovere il paragrafo `<p className="font-display text-2xl leading-none">Livello 7</p>` (riga 116) e, se necessario, riallineare il layout circostante per evitare spazi vuoti strani.
+
+## Verifica
+- Build senza errori.
+- Preview della pagina Profilo: nessun riferimento a "Livello" visibile.
@@ -0,0 +1,34 @@
+# Selezione giocatore al primo avvio
+
+Aggiungere un flusso di onboarding che chiede "Chi sei?" la prima volta che l'app viene aperta, memorizzando la scelta in `localStorage`. Il profilo e la home si aggiorneranno automaticamente in base al giocatore selezionato.
+
+## Cosa cambia
+
+1. **Nuovo store `src/lib/user-store.ts`**
+   - Persiste in `localStorage` l'`id` del giocatore scelto.
+   - Espone `useGiocatoreCorrente()` che restituisce il giocatore selezionato o `null`.
+   - Espone `impostaGiocatore(id)` e `resetGiocatore()`.
+
+2. **Nuova route `/benvenuto`**
+   - Schermata full-screen con logo, titolo "Benvenuto in CrAPP" e lista scrollabile della rosa.
+   - Ogni riga mostra iniziali, nome, ruolo e numero maglia.
+   - Al tap su un giocatore, lo store viene aggiornato e l'utente viene portato a `/`.
+   - Non mostra la bottom navigation.
+
+3. **Reindirizzamento condizionato in `__root.tsx`**
+   - Se non è ancora stato selezionato un giocatore, qualunque route apre `/benvenuto`.
+   - Dopo la scelta, l'app funziona normalmente.
+
+4. **Sostituzione di `giocatoreCorrente` con `useGiocatoreCorrente()`**
+   - Aggiornare `src/routes/index.tsx` per salutare il giocatore selezionato e mostrarne le statistiche rapide.
+   - Aggiornare `src/routes/profilo.tsx` per renderlo il profilo personale del giocatore scelto.
+
+5. **Cambio utente dalle impostazioni**
+   - In `src/routes/profilo.tsx`, aggiungere una voce "Cambia giocatore" che resetta la selezione e porta a `/benvenuto`.
+
+## Note tecniche
+
+- `localStorage` viene letto solo lato client, usando `useSyncExternalStore` per evitare mismatch di hydration.
+- La rosa reale è già presente in `src/lib/crapp-data.ts` (`giocatori`).
+- La costante esportata `giocatoreCorrente` verrà rimossa; i componenti consumeranno il nuovo hook.
+- Nessun backend richiesto: resta un prototipo locale.
@@ -0,0 +1,42 @@
+# Turno palloni nel calendario + promemoria
+
+Aggiungere a ogni allenamento/partita un incaricato dei palloni, condiviso tra tutti, con rotazione automatica proposta dall'app e promemoria (in-app e push).
+
+## Cosa vedrà la squadra
+
+- **Riga "Palloni" su ogni evento** (allenamento e partita) nella card del calendario e in Home: avatar + nome dell'incaricato, oppure "Da assegnare".
+- **Chiunque può cambiarlo**: tocco sulla riga, si apre la lista della rosa, si sceglie il nome. La modifica è immediata e visibile a tutti.
+- **Proposta automatica a rotazione**: l'app suggerisce chi non ha ancora fatto il turno di recente (o è stato meno volte incaricato). Il suggerimento è solo una proposta: resta sempre modificabile.
+- **Storico turni** nella scheda squadra/giocatore: quante volte ciascuno ha portato i palloni.
+- **Due promemoria per l'incaricato**:
+  1. il giorno stesso dell'evento in cui li deve **prendere** a fine allenamento/partita;
+  2. il giorno dell'evento successivo, per ricordargli di **riportarli**.
+- I promemoria arrivano come banner ben visibile in Home e, per chi attiva le notifiche, come notifica push sul telefono.
+
+## Impostazione tecnica
+
+**Backend (Lovable Cloud)**
+- Attivazione di Lovable Cloud.
+- Tabella `eventi` (spostando i dati demo attuali su database) o, in alternativa minima, tabella `turni_palloni` con `evento_id`, `giocatore_id`, `aggiornato_da`, `aggiornato_il`. Scelgo la seconda per limitare il refactor: gli eventi restano in `crapp-data.ts` finché non si passa a calendario dinamico.
+- Tabella `push_subscriptions` (giocatore_id, endpoint, chiavi) per le notifiche.
+- Grant espliciti + RLS: lettura e scrittura aperte a tutti gli utenti dell'app (nessun login previsto oggi → policy per `anon` limitate a queste tabelle, nessun dato personale sensibile).
+- Server functions in `src/lib/palloni.functions.ts`: `getTurni`, `setTurno`, `suggerisciTurno`.
+
+**Frontend**
+- Nuovo componente `TurnoPalloni` usato in `EventoCard` e in Home.
+- Lettura via TanStack Query (`ensureQueryData` nel loader, `useSuspenseQuery` nel componente), invalidazione dopo la modifica.
+- Banner promemoria in Home basato su data odierna + evento successivo, mostrato solo al giocatore selezionato in `user-store`.
+
+**Notifiche push**
+- Service worker dedicato al messaging (separato dalla PWA esistente), chiavi VAPID salvate come secret.
+- Schermata in Profilo: "Attiva notifiche palloni" con richiesta di permesso.
+- Invio schedulato tramite un endpoint `src/routes/api/public/promemoria-palloni.ts` protetto da secret, richiamato una volta al giorno da un job pianificato (pg_cron).
+- Nota: su iPhone le notifiche push funzionano solo se l'app è installata dalla schermata Home.
+
+## Ordine di lavoro
+
+1. Attivare Lovable Cloud e creare tabelle + policy.
+2. Server functions + UI del turno palloni (assegnazione manuale condivisa).
+3. Rotazione automatica suggerita + storico turni.
+4. Banner promemoria in-app.
+5. Notifiche push + job giornaliero.
@@ -0,0 +1,5 @@
+{
+  "schemaVersion": 1,
+  "template": "tanstack_start_ts_current",
+  "revision": "tanstack_start_ts_current-9e5645c506e5"
+}