2026-08-07 15:36:02 +02:00
|
|
|
# CrAPP 🏐
|
2026-08-06 08:36:47 +02:00
|
|
|
|
2026-08-07 15:36:02 +02:00
|
|
|
CrAPP è una Progressive Web App sviluppata per digitalizzare completamente la gestione di una squadra di pallavolo.
|
2026-08-06 08:36:47 +02:00
|
|
|
|
2026-08-07 15:36:02 +02:00
|
|
|
## Funzionalità principali
|
2026-08-06 08:36:47 +02:00
|
|
|
|
2026-08-07 15:36:02 +02:00
|
|
|
- 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)
|
2026-08-06 08:36:47 +02:00
|
|
|
|
2026-08-07 15:36:02 +02:00
|
|
|
## Stack tecnologico
|
2026-08-06 08:36:47 +02:00
|
|
|
|
2026-09-05 12:42:55 +02:00
|
|
|
React 19, TypeScript, TanStack Start (SSR), Vite 8, Tailwind CSS 4, motion, vaul,
|
2026-09-04 23:14:55 +02:00
|
|
|
Supabase (PostgreSQL, Auth, Storage), Vercel, GitHub. Dettagli in
|
|
|
|
|
[docs/ARCHITECTURE.md](docs/ARCHITECTURE.md).
|
2026-08-06 08:36:47 +02:00
|
|
|
|
2026-08-07 15:36:02 +02:00
|
|
|
## Avvio locale
|
2026-08-06 08:36:47 +02:00
|
|
|
|
2026-09-04 23:14:55 +02:00
|
|
|
Le dipendenze si installano con **bun** (`bun.lock`):
|
2026-08-07 15:36:02 +02:00
|
|
|
|
|
|
|
|
```bash
|
2026-09-04 23:14:55 +02:00
|
|
|
bun install
|
|
|
|
|
npm run dev # http://localhost:8080
|
2026-08-07 15:36:02 +02:00
|
|
|
```
|
|
|
|
|
|
2026-09-04 23:14:55 +02:00
|
|
|
## 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)).
|
2026-08-07 15:36:02 +02:00
|
|
|
|
|
|
|
|
## Deploy
|
|
|
|
|
|
2026-09-04 23:14:55 +02:00
|
|
|
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).
|
2026-08-07 15:36:02 +02:00
|
|
|
|
|
|
|
|
## Variabili d'ambiente
|
|
|
|
|
|
|
|
|
|
Il progetto richiede le seguenti variabili:
|
|
|
|
|
|
|
|
|
|
- `SUPABASE_URL`
|
|
|
|
|
- `SUPABASE_PUBLISHABLE_KEY`
|
|
|
|
|
- `VITE_SUPABASE_URL`
|
|
|
|
|
- `VITE_SUPABASE_PUBLISHABLE_KEY`
|
|
|
|
|
|
2026-09-11 14:58:09 +02:00
|
|
|
Solo per lo sviluppo locale con PocketBase al posto di Supabase (vedi
|
|
|
|
|
[docs/PORTABILITA.md](docs/PORTABILITA.md)):
|
|
|
|
|
|
|
|
|
|
- `VITE_POCKETBASE_URL` / `POCKETBASE_URL` — `http://127.0.0.1:8090` con
|
|
|
|
|
`docker-compose.pocketbase.yml`
|
|
|
|
|
- `POCKETBASE_SUPERUSER_EMAIL` / `POCKETBASE_SUPERUSER_PASSWORD` — credenziali del
|
|
|
|
|
superuser creato al primo avvio, usate solo dalle route server che oggi usano
|
|
|
|
|
`supabaseAdmin`
|
|
|
|
|
|
2026-09-04 23:14:55 +02:00
|
|
|
## Documentazione
|
2026-08-07 15:36:02 +02:00
|
|
|
|
2026-09-04 23:14:55 +02:00
|
|
|
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).
|
