Vai al contenuto
← Tutti i progetti

SDS Manager

Una web app in cui ogni azienda ha il suo spazio su un sottodominio dedicato: catalogo dei prodotti chimici con numero CAS, schede di sicurezza in PDF con versioni e lingue, e un'analisi automatica che a ogni caricamento manda il documento a Claude su AWS Bedrock e ne estrae i pittogrammi GHS. Laravel 13 e Inertia con React e TypeScript, tre ruoli e nessuna registrazione pubblica. È ancora in sviluppo.

LaravelPHPInertia.jsReactTypeScriptTailwind CSSPostgreSQLAWS BedrockPest
Screenshot di SDS Manager

La sfida che ho risolto

Tutte le aziende vivono nello stesso database, quindi un solo filtro dimenticato basterebbe a mostrare a un'azienda le schede di un'altra. Invece di affidarmi alla disciplina, ho reso l'isolamento automatico: un middleware riconosce l'azienda dal sottodominio, un global scope di Eloquent aggiunge il filtro a ogni query sui modelli dell'azienda e un trait compila da solo il tenant_id a ogni inserimento. Una suite di test dedicata prova a leggere i dati di un'altra azienda e verifica che non ci riesca.

Perché è nato

Chi lavora con prodotti chimici deve avere le schede di dati di sicurezza (SDS) aggiornate e a portata di mano: decine di PDF per prodotto, fornitore, versione e lingua, che di solito finiscono sparsi fra cartelle condivise e allegati email. SDS Manager le raccoglie in un unico archivio per azienda, collegato al catalogo dei prodotti, e aggiunge la parte noiosa che nessuno vuole fare a mano: leggere ogni scheda per capire quali pericoli segnala.

Ogni azienda (tenant) ha il proprio sottodominio — acme.dominio.app — con i suoi utenti, i suoi prodotti e i suoi documenti; il pannello del super-admin vive invece sul dominio principale. Il progetto è ancora in sviluppo e non è online: gli screenshot vengono da un’installazione locale con dati di prova.

L’analisi con l’IA

Quando un admin carica il PDF di una scheda, il file finisce in una cartella riservata all’azienda e parte un job in coda. Il job invia il documento a Claude 3 Haiku su AWS Bedrock, nella regione di Francoforte così che i dati restino in Europa, e gli chiede una sola cosa: l’elenco dei pittogrammi GHS presenti, in formato JSON. La risposta viene poi filtrata sull’enum dei nove pittogrammi validi, così un codice inventato dal modello non arriva mai nel database.

Ogni documento attraversa gli stati pending → processing → completed (o failed): il job riprova fino a tre volte con attese crescenti e salva l’errore se non ce la fa. Nell’interfaccia un badge interroga lo stato ogni tre secondi con l’hook useHttp di Inertia 3, quindi i pittogrammi compaiono sulla pagina del prodotto senza ricaricare. Se serve, un admin può rilanciare l’analisi con un clic.

Ruoli e accessi

Non esiste una registrazione pubblica. Il super-admin crea le aziende e i loro amministratori; l’admin di un’azienda gestisce prodotti, schede e dipendenti; il dipendente può consultare e scaricare le schede ma non modificarle. I ruoli sono un enum PHP sul modello utente, i permessi sono Gate e Policy di Laravel, senza pacchetti esterni. Gli account dei dipendenti nascono con una password casuale che nessuno conosce e con l’obbligo di sceglierne una al primo accesso. Anche il login è legato al dominio: su un sottodominio entra soltanto chi appartiene a quell’azienda, sul dominio principale soltanto il super-admin.

Screenshot

Il catalogo prodotti con pittogrammi e stato delle schede Il catalogo prodotti: numero CAS, pittogrammi rilevati e stato della scheda per ogni prodotto.

La pagina di un prodotto con i pittogrammi GHS La pagina di un prodotto: i pittogrammi rilevati dall’IA e lo storico delle versioni della scheda.

L’archivio delle schede con lo stato dell’analisi L’archivio delle schede: fornitore, lingua e stato dell’analisi, che si aggiorna da solo.

Il dettaglio di una scheda di sicurezza Il dettaglio di una scheda, con il risultato dell’analisi e il pulsante per rilanciarla.

La gestione dei dipendenti La gestione dei dipendenti dell’azienda, con ruoli e inviti.

Il pannello del super-admin con le aziende Il pannello del super-admin, sul dominio principale: un’azienda per riga, attivabile e disattivabile.

La modifica di un’azienda La modifica di un’azienda: nome, sottodominio, dominio opzionale e il suo amministratore.

Tecnologie usate

Il backend è Laravel 13 su PHP 8.3, con Fortify per l’autenticazione (recupero password e verifica in due passaggi comprese) e il database PostgreSQL. Il frontend è un’app React 19 in TypeScript servita con Inertia.js 3: niente API REST da mantenere a parte, le pagine ricevono i dati direttamente dai controller. Wayfinder genera funzioni TypeScript tipizzate per ogni rotta Laravel, così un link verso una rotta che non esiste più diventa un errore di compilazione. L’interfaccia è in Tailwind CSS 4 con componenti Radix, e l’IA passa dall’SDK AWS per PHP.

I test sono scritti con Pest: autenticazione per azienda, isolamento fra tenant, upload e download delle schede, transizioni di stato del job e un test del parser delle risposte dell’IA con il client Bedrock simulato.