From eddee2ec4478222aa31b8fd63812eaad508b0ed6 Mon Sep 17 00:00:00 2001 From: Davide Grilli Date: Fri, 28 Aug 2026 13:17:44 +0200 Subject: [PATCH] Riscrivo il README per riflettere lo stato reale del repository MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Il README precedente era la proposta iniziale del progetto (funzionalità desiderate, comandi npm). Lo sostituisco con stack, funzionalità effettivamente implementate e comandi bun corretti. --- README.md | 168 ++++++++++++++++++++---------------------------------- 1 file changed, 62 insertions(+), 106 deletions(-) diff --git a/README.md b/README.md index 6510c88..c799104 100644 --- a/README.md +++ b/README.md @@ -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 -cd -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.