Una società sportiva che smette di vivere su WhatsApp
A.S.D. Prato Calcio a 5 — "I Lanieri" — gestiva tesseramenti, convocazioni, quote e comunicazioni con gli strumenti che si usano di solito: messaggi, fogli di calcolo e buona volontà. Il progetto nasce per mettere tutto in un posto solo.
Risultati misurati
1
monorepo: sito, API, gestionale e app
8
ambiti completati nel primo rilascio
RBAC
permessi per ruolo: dirigenti, staff, atleti
Stripe
quote e pagamenti online
01 — Contesto
Ogni cosa in uno strumento diverso
Il sito, quando c'era, raccontava la squadra ma non serviva a farla funzionare. I tesseramenti stavano su carta, le quote si inseguivano a voce, le convocazioni passavano da gruppi di messaggi dove le informazioni si perdono in mezz'ora.
Una società sportiva dilettantistica non ha un ufficio IT: qualunque strumento le si dia deve funzionare da telefono e non richiedere formazione.
02 — Approccio
Un monorepo e un ordine di costruzione dichiarato
Il lavoro è stato diviso in ambiti numerati — infrastruttura, database, accessi e permessi, API, sito pubblico, gestionale, pagamenti, e poi app, eventi, streaming e social — con lo stato di ciascuno scritto nero su bianco nel repository.
Così, a metà strada, chiunque apra il progetto sa cosa è finito e cosa no. Il primo rilascio ha chiuso gli ambiti che rendono la piattaforma utilizzabile davvero: senza accessi, permessi e pagamenti, il resto sarebbe stato solo una vetrina.
03 — Soluzione
Cosa comprende la piattaforma
Sito pubblico
Squadre, calendario, risultati e notizie: la faccia della società verso l'esterno.
Area gestionale
Tesserati, staff, convocazioni e documenti, con permessi diversi per ruolo.
Pagamenti
Quote e iscrizioni incassate online, con lo stato visibile a chi le deve e a chi le controlla.
App e servizi in arrivo
App nativa per i tesserati, vendita eventi, dirette streaming e automazione social: ambiti pianificati e dichiarati.
04 — Dentro il codice
Cinquantatré documenti accanto a cinquecento sorgenti
Il monorepo tiene insieme quattro pacchetti condivisi — configurazione, database, tipi comuni e libreria di interfaccia — e tre applicazioni: l'API, il sito e l'app mobile. Le parti comuni stanno in mezzo, così una regola sui tesserati è scritta una volta e vale per tutte e tre.
La cosa meno comune sono i cinquantatré documenti in markdown che accompagnano il codice: lo stato di ogni ambito, le decisioni prese e il piano di quelli ancora da fare. In un progetto che cresce per fasi, e che un domani potrebbe passare di mano, la documentazione non è un extra — è ciò che rende il lavoro continuabile.
C'è anche uno strumento dedicato al tesseramento verso la federazione: la parte più noiosa dell'anno sportivo, quella che finora si faceva a mano un atleta alla volta.
05 — Risultato
Una base su cui continuare
La piattaforma è arrivata al primo rilascio completo con infrastruttura, database, accessi, API, sito, gestionale e pagamenti verificati. Gli ambiti restanti — app mobile, eventi, streaming, social — sono pianificati con lo stesso metodo: uno alla volta, dichiarando cosa è pronto e cosa no.
