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.
75 lines
2.9 KiB
Markdown
75 lines
2.9 KiB
Markdown
# 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](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
|
|
|
|
## Stack
|
|
|
|
- [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
|
|
|
|
## 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](CLAUDE.md)), sync reale
|
|
ancora da implementare
|
|
- **Notifiche push**: convocazioni, promemoria allenamento/partita, turno palloni, esito finale
|
|
|
|
## Sviluppo
|
|
|
|
Package manager: **bun** ([installazione](https://bun.sh)).
|
|
|
|
```sh
|
|
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.
|