davide/CRAPP
1
0 Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

Docs: file di supporto in ARCHITECTURE e riga Codice nelle decisioni

Browse Source 
Cita con percorso completo i 28 file di src/ che nessun documento nominava e
aggiunge la riga Codice a 21 decisioni, ricavata dai file che le citano.

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
This commit is contained in:
davideandClaude Sonnet 5.5 committed 2026-11-15 18:55:46 +01:00
1 parent f9c6263662
commit 4c8791fa2c
22 files changed
+68 -21
Download Patch File Download Diff File Expand all files Collapse all files

No files matched your search

docs/ARCHITECTURE.md
+26
View File
@@ -30,6 +30,32 @@ test/ suite di test (unit, integration, end-to-end)
docs/ documentazione ufficiale
```
### File di supporto
I file che i documenti dei moduli non citano, con il loro scopo:
| File | Cosa fa |
| ------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| `src/routes/__root.tsx` | Radice delle route: meta, viewport (`viewport-fit=cover` per le safe area su iOS) e layout comune |
| `src/routes/benvenuto.tsx` | Ingresso dopo il login: si arriva solo da loggati e con uno slot collegato (DD-011) |
| `src/routes/api/public/keepalive.ts` | Lettura minima chiamata dal Cron di Vercel per evitare la pausa del progetto Supabase free tier |
| `src/routes/api/public/apri-sondaggio.ts` | Avviso «sondaggio pre-partita aperto», lanciato da un admin dalla pagina partita |
| `src/routes/api/public/notifica-personalizzata.ts` | Messaggio push libero a un giocatore o a tutti, con storico in-app (M17) |
| `src/routes/api/public/notifiche-attive.ts` | Elenco dei giocatori con almeno un dispositivo iscritto alle push (solo admin) |
| `src/lib/notifiche-attive.server.ts`, `src/lib/notifiche-admin.ts` | Lato server dell'elenco sopra; hook client dell'elenco e dell'invio push libero |
| `src/lib/eventi-visibili.ts` | Gli eventi che l'utente corrente può vedere (calendario, home, elenco) |
| `src/lib/presenze-mese-core.ts` | Calcolo puro della percentuale di presenze dell'ultimo mese, separato dagli hook |
| `src/lib/error-capture.ts`, `src/lib/error-page.ts` | Cattura dell'errore lato server e pagina di errore statica |
| `src/lib/utils.ts` | `cn()`: unisce classi CSS condizionali risolvendo i conflitti di Tailwind |
| `src/integrations/supabase/types.ts` | Tipi generati dallo schema: non si modificano a mano |
| `src/integrations/supabase/auth-attacher.ts`, `src/integrations/supabase/auth-middleware.ts`, `src/integrations/supabase/client.server.ts` | File generati: il browser allega il token alle chiamate server, il server le autentica; `client.server.ts` ha il client con service role. Non si modificano a mano |
| `src/integrations/supabase/client-nuove-tabelle.ts` | Accesso tipizzato alle tabelle che `types.ts` generato non include ancora |
| `src/components/crapp/Avatar.tsx`, `src/components/crapp/BottomNav.tsx`, `src/components/crapp/BarraSottosezioni.tsx` | Foto del giocatore (con ricarica forzata), barra di navigazione a 4 voci, sottosezioni con pannello animato |
| `src/components/crapp/ProfiloAmministrativo.tsx` | Campi del profilo condivisi tra giocatore e dashboard admin (DD-017) |
| `src/components/crapp/ScoutReport.tsx` | Lettura dello scout di una partita: squadra, set per set, dettaglio per giocatore |
| `src/components/motion/Barra.tsx`, `src/components/motion/Numero.tsx`, `src/components/motion/Reveal.tsx` | Barra di avanzamento a molla, contatore animato, comparsa graduale all'ingresso nel viewport |
| `src/components/ui/drawer.tsx`, `src/components/ui/sonner.tsx` | Le due primitive shadcn in uso (drawer di vaul e toast) |
## Punti fermi
- **Routing**: file-based in `src/routes/`. `src/routeTree.gen.ts` è **generato**, non si