Se qualcosa non va¶
composer require si ferma con un conflitto su brick/math¶
Il Web Push tira dentro web-token/jwt-library, che tiene brick/math a ^0.17, mentre un'applicazione
Laravel appena creata ha la 0.18. Installa con -W, così composer può retrocedere quell'unica dipendenza
indiretta:
Aprendo / arriva un 500: Route [login] not defined¶
In modalità server chi non è autenticato viene mandato alla rotta login dell'applicazione ospite, e
un'applicazione Laravel installata senza starter kit non ce l'ha: il redirect solleva un'eccezione invece di
mostrare un modulo. Aggiungi un flusso di autenticazione (uno starter kit di Laravel, Breeze, Fortify o una tua
rotta chiamata login) e accedi. Su una macchina fidata puoi anche saltare del tutto l'autenticazione con
GRIGLIA_MODE=local, che rende le liste globali: non esporre mai quella modalità in rete.
La board è senza stili, o il trascinamento non fa niente¶
Gli asset non sono al loro posto. In modalità precompiled lancia
php artisan vendor:publish --tag=griglia-assets --force; in modalità vite controlla @source e i due
import nel tuo app.css / app.js, poi npm run build. Vedi
Asset front-end.
Una rotta nuova o una config cambiata vengono ignorate¶
Configurazione o rotte in cache:
Niente si aggiorna dal vivo fra i dispositivi¶
Non c'è un broadcaster configurato, oppure il canale privato non è autorizzato. Imposta le variabili
REVERB_* / VITE_REVERB_*, ricompila gli asset front-end e aggiungi il canale App.Models.User.{id} a
routes/channels.php. La board funziona anche senza — solo senza aggiornamento dal vivo.
Il Web Push non arriva mai¶
- Genera le chiavi (
php artisan webpush:vapid) e aggiungiHasPushSubscriptionsal tuo modello utente. - Abilita il dispositivo in Impostazioni → Notifiche, dove il pannello di diagnostica mostra permesso, service worker e stato della sottoscrizione.
- Su iOS le notifiche funzionano solo quando l'app è stata aggiunta alla schermata Home.
griglia:docs-build dice che manca MkDocs¶
Installa la catena di strumenti (pip install -r requirements-docs.txt — Material più il plugin i18n che
serve al sito bilingue) oppure compila con Docker: --docker. Vedi
Costruire questo sito.
Gli allegati danno 404¶
Tieni GRIGLIA_ATTACHMENTS_VIA_CONTROLLER=true (il default) e controlla che GRIGLIA_ATTACHMENTS_DISK indichi
un disco configurato e scrivibile (local di default). Per il disco privato di default il symlink di storage
non serve e non viene usato.