davideandClaude Sonnet 5.5
8f25143aa5
- Spezza il registro delle decisioni in docs/decisions/DD-XXX.md, con indice - Ripulisce DATABASE.md dalla storia delle migration e aggiunge la sezione Lettura - Riduce PROJECT_STATE.md a una pagina; la procedura di allestimento passa in OPERATIONS.md - Aggiunge OPERATIONS.md, GLOSSARIO.md, trappole note e checklist in ARCHITECTURE.md - Sintetizza la copertura test di badge.md e documenta docs/archive - Allinea AGENTS.md, README.md e la regola Cursor (tolto l'obbligo di develop, in contrasto con DD-019) Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
60 lines
1.8 KiB
Markdown
60 lines
1.8 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 typecheck # controllo dei tipi TypeScript
|
|
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
|
|
|
|
Per far partire l'app servono `SUPABASE_URL`, `SUPABASE_PUBLISHABLE_KEY`, `VITE_SUPABASE_URL` e
|
|
`VITE_SUPABASE_PUBLISHABLE_KEY`. L'elenco completo (service role, VAPID, SMTP del worker) sta in
|
|
[docs/OPERATIONS.md](docs/OPERATIONS.md).
|
|
|
|
## 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).
|