Gestionale amministrativo per PMI

Una fattura non finisce con un PDF

Una fattura arriva, genera una scadenza, viene pagata. Poi quel pagamento compare nell’estratto conto e deve trovare il suo posto nei conti dell’azienda. È un percorso quotidiano, fatto di informazioni che hanno senso soprattutto quando si riesce a collegarle.

Ho lavorato su questi collegamenti progettando un gestionale web per le piccole e medie imprese che riunisce fatture, documenti, scadenze e movimenti bancari. Ho seguito la progettazione e lo sviluppo della piattaforma, dalla struttura del database alle interfacce, fino alle integrazioni con i servizi esterni.

Seguire il filo, dal documento al pagamento

Il lavoro amministrativo attraversa più passaggi. La piattaforma comprende clienti e fornitori, fatture attive e passive, generazione XML per la fatturazione elettronica e integrazioni API. A questi si collegano costi e ricavi, scadenzario, registrazione dei pagamenti e prima nota.

La riconciliazione bancaria è uno dei punti in cui questi flussi si incontrano. Il sistema cerca corrispondenze tra movimenti e scadenze, utilizzando riferimenti delle fatture, importi e date. Le proposte possono essere esaminate e confermate dall’utente; giroconti e movimenti non riferiti a fatture richiedono una gestione distinta.

È qui che lo sviluppo diventa un lavoro di dettaglio: riconoscere un riferimento dentro una causale, distinguere una data da un numero di fattura, gestire una corrispondenza incompleta senza trasformarla in una certezza.

Il valore dell’AI integrata tramite API

Un documento contiene informazioni utili, ma spesso sono immerse in testo libero, tabelle o scansioni. Ho integrato l’AI tramite API per portare la lettura di questi contenuti dentro il gestionale: l’applicazione richiede l’analisi e ne elabora la risposta nel proprio flusso documentale.

Il valore aggiunto è il passaggio dal documento a informazioni strutturate. L’analisi può restituire elementi come oggetto, data, tipologia e categoria suggerita, che il software può organizzare e presentare. La lettura può partire dal testo estratto oppure ricorrere all’analisi visuale quando necessario.

Per chi lavora nell’amministrazione, l’obiettivo è ridurre le attività ripetitive di lettura e classificazione, mantenendo le informazioni nel contesto del gestionale. Il beneficio atteso nasce dall’integrazione: i risultati dell’AI diventano parte di un processo, anziché richiedere ogni volta un passaggio manuale tra strumenti separati.

Il mio lavoro comprende il collegamento alle API, la preparazione delle richieste, l’elaborazione delle risposte e la gestione dei casi in cui il servizio non restituisce un risultato utilizzabile. I controlli del software verificano la struttura dei dati ricevuti; l’accuratezza del contenuto richiede comunque attenzione. Formati non supportati e analisi non riuscite hanno percorsi espliciti di gestione manuale.

Questa è la competenza che il progetto mette in pratica: trasformare un servizio AI in una funzione applicativa, collegandolo ai dati, alle regole e alle esigenze operative dell’impresa.

Le tecnologie del progetto

Il backend è sviluppato in PHP con Laravel 12: qui trovano posto la logica amministrativa, l’accesso ai dati e le integrazioni. L’interfaccia usa React 18 e TypeScript, collegati al backend attraverso Inertia.js. Questa struttura permette di costruire schermate interattive mantenendo il coordinamento delle pagine nell’applicazione Laravel.

Tailwind CSS e i componenti shadcn/ui costituiscono la base dell’interfaccia; Vite gestisce la compilazione delle risorse frontend. La persistenza è basata su un database relazionale, con MySQL/MariaDB previsti dall’architettura del progetto.

Le integrazioni API collegano la piattaforma ai servizi esterni. Per l’elaborazione assistita dei documenti ho integrato le API OpenAI, mentre le code di lavoro Laravel permettono di eseguire attività come la classificazione documentale in background, con tentativi successivi e gestione degli errori.

Innovazione nelle operazioni di tutti i giorni

Le soluzioni più interessanti emergono quando le tecnologie lavorano sullo stesso problema concreto:

• Riconciliazione assistita: riferimenti, importi e date contribuiscono alla ricerca delle corrispondenze. Le proposte restano distinguibili dalle operazioni confermate.
• Scelte ricordate: il sistema prevede la memorizzazione di scelte di riconciliazione per riproporre associazioni nei movimenti successivi. È una memoria operativa basata su regole, non l’addestramento di un nuovo modello AI.
• Lettura documentale da testo e immagini: il flusso può combinare estrazione testuale e analisi visuale, con una gestione esplicita delle risposte non valide o dei formati che richiedono classificazione manuale.
• Elaborazioni in background: la classificazione dei documenti è affidata a lavori in coda, con stato dell’elaborazione e segnalazione degli insuccessi.

Per me, innovare in questo progetto significa collegare queste possibilità al lavoro amministrativo: dalla lettura di un documento alla proposta di un’associazione, fino alla decisione di chi utilizza il gestionale.

Più società, esigenze diverse

La piattaforma permette di passare tra le società a cui l’utente ha accesso. Comprende inoltre la gestione delle trasferte e dei rimborsi, con righe di spesa, allegati e stati di approvazione, e quella dei cespiti, con dati di acquisto e collegamenti ai documenti.

Sono funzioni che estendono il lavoro oltre la singola fattura, mantenendo il progetto vicino alle attività amministrative dell’impresa.

Il mio lavoro continua dopo il rilascio

Il gestionale è già utilizzato. Al progetto iniziale si affiancano manutenzione, aggiornamenti, gestione dell’ambiente server e assistenza alle imprese che lo usano.

Il mio contributo unisce quindi sviluppo software e gestione operativa: costruire i flussi, collegare i servizi e seguire la piattaforma anche quando entra nel lavoro di tutti i giorni.