davideandClaude Opus 5
26bacbf700
DD-021 (molle interrompibili con motion) e DD-022 (l'app è solo chiara) motivano le due scelte che un domani sembreranno arbitrarie: perché è entrata una libreria di animazione dopo averne tolte 45, e perché il tema scuro è stato cancellato invece che completato. DD-021 riporta il numero misurato e scomodo: il bundle client cresce da 267 a 308 KB gzip. Togliere dipendenze mai importate non lo riduce, perché il tree-shaking già le escludeva; il guadagno è sulle 50 dipendenze dirette che diventano 21. ARCHITECTURE e README non descrivevano più lo stack reale (Radix/shadcn) e la sezione UI ignorava la primitiva Card e il sistema di molle. Tolto anche `hooks/` dall'albero del progetto: la cartella non esiste più. Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
62 lines
1.6 KiB
Markdown
62 lines
1.6 KiB
Markdown
# CrAPP 🏐
|
|
|
|
CrAPP è una Progressive Web App sviluppata per digitalizzare completamente la gestione di una squadra di pallavolo.
|
|
|
|
## Funzionalità principali
|
|
|
|
- Gestione squadra
|
|
- Gestione presenze
|
|
- Calendario allenamenti e partite
|
|
- Scout Live
|
|
- Badge e gamification
|
|
- Statistiche
|
|
- Notifiche intelligenti
|
|
- Gestione amministrativa
|
|
- AI per la pianificazione degli allenamenti (in sviluppo)
|
|
|
|
## Stack tecnologico
|
|
|
|
React 19, TypeScript, TanStack Start (SSR), Vite 8, Tailwind CSS 4, motion, vaul,
|
|
Supabase (PostgreSQL, Auth, Storage), Vercel, GitHub. Dettagli in
|
|
[docs/ARCHITECTURE.md](docs/ARCHITECTURE.md).
|
|
|
|
## Avvio locale
|
|
|
|
Le dipendenze si installano con **bun** (`bun.lock`):
|
|
|
|
```bash
|
|
bun install
|
|
npm run dev # http://localhost:8080
|
|
```
|
|
|
|
## Comandi
|
|
|
|
```bash
|
|
npm run build # build di produzione
|
|
npm run lint # eslint (include prettier)
|
|
npm run test # test unit; npm run test:all per la suite completa
|
|
```
|
|
|
|
Chi aggiunge o modifica una funzione scrive anche il test e lo lascia verde
|
|
([test/README.md](test/README.md)).
|
|
|
|
## Deploy
|
|
|
|
Deploy automatico su Vercel a ogni push su `main`, che è anche il branch di lavoro corrente.
|
|
`develop` pubblica un Preview Deployment, ma oggi è indietro rispetto a `main`. Su quale branch
|
|
committare lo decide chi sviluppa (DD-019).
|
|
|
|
## Variabili d'ambiente
|
|
|
|
Il progetto richiede le seguenti variabili:
|
|
|
|
- `SUPABASE_URL`
|
|
- `SUPABASE_PUBLISHABLE_KEY`
|
|
- `VITE_SUPABASE_URL`
|
|
- `VITE_SUPABASE_PUBLISHABLE_KEY`
|
|
|
|
## Documentazione
|
|
|
|
Indice in [docs/README.md](docs/README.md). Le regole per gli assistenti AI stanno in
|
|
[AGENTS.md](AGENTS.md), lo stato corrente del lavoro in [PROJECT_STATE.md](PROJECT_STATE.md).
|