Troubleshooting

Risoluzione problemi

La sessione resta in stato "pending"

Causa: Il queue worker non è in esecuzione.

Soluzione: Verificare che il worker sia attivo:

php artisan queue:listen

Errore 401 Unauthorized

Causa: API key mancante o errata.

Soluzione: Verificare che l'header X-API-Key sia presente e contenga la chiave corretta configurata nel file .env.

La sessione va in stato "failed"

Possibili cause:

• Errore nella comunicazione con l'API Google Gemini
• Formato dei dati non valido per il template selezionato
• Timeout nella risposta del modello AI

Soluzione: Controllare i log dell'applicazione:

tail -f storage/logs/laravel.log

Errore 422 sulla richiesta di ingest

Causa: Dati di input non conformi alla validazione.

Soluzione: Verificare che:

• Il campo template contenga un valore valido
• Il campo products sia un array non vuoto
• I parametri specifici del template siano presenti (es. source_lang e target_lang per translate)

File PDF rifiutati

Causa: Il file supera il limite di 20MB o non è in formato PDF.

Soluzione: Verificare dimensione e formato del file. Solo file .pdf con MIME type application/pdf sono accettati.