Riscrivo il README per riflettere lo stato reale del repository

Il README precedente era la proposta iniziale del progetto (funzionalità desiderate, comandi npm). Lo sostituisco con stack, funzionalità effettivamente implementate e comandi bun corretti.
2026-08-28 13:17:44 +02:00
parent 49b6c8a7e9
commit eddee2ec44
1 changed files with 62 additions and 106 deletions
@@ -1,118 +1,74 @@
-# CRAP Volley Hub
+# CrAPP — CRAP Volley Hub

-CrAPP – App per CRAP Volley
+App mobile-first per la gestione della squadra amatoriale di pallavolo **CRAP Volley**:
+presenze, partite/allenamenti/eventi, scouting live, statistiche giocatori, badge,
+classifica CSI, notifiche push.

-Vorrei sviluppare un’app mobile per la squadra di pallavolo CRAP Volley, con nome CrAPP, disponibile per Android e iOS. L’obiettivo è creare un’app semplice da usare, moderna, bella da vedere e più coinvolgente rispetto a SportEasy, includendo anche funzionalità normalmente a pagamento in altre app.
-
-Funzionalità principali
-
-Gestione presenze/assenze
-
-Partite
-
-Allenamenti
-
-Eventi extra
-
-Stati rapidi: presente, assente, forse, in ritardo, indisponibile, infortunato
-
-Statistiche giocatori
-
-Presenze totali
-
-Presenze consecutive
-
-Gol/punti o altre statistiche specifiche della pallavolo
-
-MVP, migliori performance, medie stagione
-
-Statistiche partite
-
-Risultati
-
-Formazioni
-
-Andamento set
-
-Storico match
-
-Campionato in tempo reale
-
-Visualizzazione classifica e risultati
-
-Dati presi direttamente dal sito del CSI
-
-Aggiornamento automatico o importazione periodica
-
-Calendario squadra
-
-Allenamenti
-
-Partite
-
-Promemoria
-
-Vista mensile e lista eventi
-
-Profilo giocatore
-
-Foto
-
-Ruolo
-
-Statistiche personali
-
-Badge e obiettivi
-
-Idea di stile
-
-Interfaccia sportiva, pulita e moderna
-
-Molto mobile-first
-
-Design divertente, energico e più “premium”
-
-Inserire in seguito il logo della squadra
-
-Possibile uso di badge, livelli, premi e mini-gamification per rendere l’app più piacevole da usare
-
-Extra che sarebbe bello aggiungere
-
-Notifiche push per convocazioni e cambi orario
-
-Chat o bacheca squadra
-
-Report automatici dopo le partite
-
-Sondaggi rapidi per disponibilità
-
-Sezione “Best of the match”
-
-Obiettivi di gruppo per presenza e continuità
-
-Obiettivo finale
-
-Realizzare una app che non sia solo utile per la gestione della squadra, ma anche piacevole, coinvolgente e bella da usare ogni giorno.
-
-This project was built with [Lovable](https://lovable.dev).
+Progetto avviato con [Lovable](https://lovable.dev): i push su `main` sincronizzano l'editor
+Lovable, quindi si evita di riscrivere la history già pubblicata (niente force-push,
+rebase/amend/squash di commit già pushati).

 **Live app**: https://volley-cronos-app.lovable.app

-## Build with Lovable
+## Stack

-Continue developing this project in the [Lovable editor](https://lovable.dev/projects/8d07b0e4-6bd2-4a17-9dd2-bb2cf13f9f7c).
+- [TanStack Start](https://tanstack.com/start) (React 19, routing file-based) + Vite
+- Tailwind v4 + componenti shadcn/radix
+- [Supabase](https://supabase.com) (`@supabase/supabase-js`) per dati e auth
+- TanStack Query per la cache client

- **Ship faster**: describe what you want to build and Lovable handles the code.
- **Stay in sync**: every change made in Lovable is committed straight to this repository.
- **Full ownership**: this code is yours. Push to `main` on GitHub and your changes sync back into Lovable, ready for your next prompt.
+## Funzionalità

-## Development
+- **Presenze**: RSVP rapido (presente / assente / forse / in ritardo / infortunato) su ogni evento
+- **Eventi**: partite, allenamenti, eventi sociali, con calendario e lista
+- **Scouting live**: registrazione azioni punto-per-punto durante la partita (riservato agli
+  admin)
+- **Statistiche giocatori**: presenze totali/consecutive, badge, obiettivi squadra, medie pagelle
+- **Votazioni post-partita**: MVP, pagelle 1-10 tra compagni, voti "social"/goliardici
+- **Turno palloni**: rotazione automatica di chi porta i palloni, con promemoria push
+- **Classifica CSI**: al momento un dato demo hardcoded (vedi [CLAUDE.md](CLAUDE.md)), sync reale
+  ancora da implementare
+- **Notifiche push**: convocazioni, promemoria allenamento/partita, turno palloni, esito finale

-Prefer working locally? You need Node.js and npm — [install with nvm](https://github.com/nvm-sh/nvm#installing-and-updating).
+## Sviluppo
+
+Package manager: **bun** ([installazione](https://bun.sh)).

 ```sh
-git clone <this-repository-url>
-cd <repository-name>
-npm i
-npm run dev
+git clone https://github.com/ivancacciari1995-a11y/CRAPP.git
+cd CRAPP
+bun install
+bun run dev          # avvia il dev server su http://localhost:8080
 ```
+
+Serve un file `.env` con le credenziali Supabase (`VITE_SUPABASE_URL`,
+`VITE_SUPABASE_PUBLISHABLE_KEY`) ed eventualmente le chiavi `VAPID_*` per le notifiche push.
+
+Altri comandi:
+
+```sh
+bun run build        # build di produzione
+bun run build:dev    # build in modalità development
+bun run preview      # anteprima di una build
+bun run lint         # eslint .
+bun run format       # prettier --write .
+```
+
+Non è configurato un test runner.
+
+## Continuare da Lovable
+
+Il progetto resta modificabile anche dall'[editor Lovable](https://lovable.dev/projects/8d07b0e4-6bd2-4a17-9dd2-bb2cf13f9f7c):
+le modifiche fatte lì vengono committate direttamente su questo repository, e viceversa i push
+su `main` sincronizzano l'editor.
+
+## Portabilità
+
+Il progetto è pensato per restare deployabile su un normale server **Node.js + PostgreSQL**,
+senza dipendenze esclusive da Lovable Cloud — vedi [docs/PORTABILITA.md](docs/PORTABILITA.md)
+per lo stato attuale e le regole da rispettare.
+
+## Note per chi sviluppa con Claude Code
+
+Vedi [CLAUDE.md](CLAUDE.md) per architettura dettagliata, convenzioni del repo e vincoli di
+efficienza sul piano cloud a consumo.