davide
eddee2ec44
Il README precedente era la proposta iniziale del progetto (funzionalità desiderate, comandi npm). Lo sostituisco con stack, funzionalità effettivamente implementate e comandi bun corretti.
CrAPP — CRAP Volley Hub
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.
Progetto avviato con Lovable: 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
Stack
- TanStack Start (React 19, routing file-based) + Vite
- Tailwind v4 + componenti shadcn/radix
- Supabase (
@supabase/supabase-js) per dati e auth - TanStack Query per la cache client
Funzionalità
- 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), sync reale ancora da implementare
- Notifiche push: convocazioni, promemoria allenamento/partita, turno palloni, esito finale
Sviluppo
Package manager: bun (installazione).
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:
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:
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 per lo stato attuale e le regole da rispettare.
Note per chi sviluppa con Claude Code
Vedi CLAUDE.md per architettura dettagliata, convenzioni del repo e vincoli di efficienza sul piano cloud a consumo.