Compliance documentale e cantieri per un’impresa edile

Un’impresa edile deve verificare che fornitori, subappaltatori e operai abbiano tutti i documenti in regola e non scaduti (DURC, SOA, POS, Unilav, attestati dei corsi) per ogni cantiere.

Ruolo: Unico sviluppatore
Periodo: Luglio → settembre 2026
Stato: In staging, il cliente lo sta provando.
Stack: Laravel 13

Livewire 4 + Volt

Flux

Fortify

pdftotext

dompdf

php-imap

PHPUnit 12

Forge

Cosa ho costruito

Una piattaforma che raccoglie i documenti, li legge, controlla le scadenze e dice in ogni momento se un cantiere è in regola.

Documenti e scadenze

Archivio con scadenzario e flusso di verifica, con requisiti diversi per forma giuridica.
Lettura automatica: il sistema riconosce il tipo di documento, estrae data di emissione e scadenza e, se la scadenza non è scritta, applica le regole di legge italiane. DURC 120 giorni, visura 6 mesi, SOA 5 anni con verifica al terzo, F24 con festivi e Pasquetta.
Controlli incrociati: l’intestatario corrisponde al fornitore? I nomi degli operai dichiarati compaiono nel POS?

Fornitori e operai

Un portale in cui i fornitori caricano da soli i documenti, con registrazione tramite link valido 48 ore.
Operai con documenti e abilitazioni (gru, piattaforme, carrelli): un operaio scoperto blocca la conformità della sua ditta.
Import di circa 2.338 fornitori da Excel.

Cantieri

Conformità su tre livelli (impresa, cantiere, lavoratore) e un PDF che fotografa il cantiere, pronto per le ispezioni.
Timbratura da telefono con controllo GPS: fuori dal raggio del cantiere non si timbra.
DDT importati da soli dalla casella email e PEC ogni 5 minuti, con il fornitore riconosciuto dalla partita IVA.

Amministrazione

Import dei movimenti bancari dal tracciato ufficiale CBI.
Lettura dei PDF delle paghe e della Cassa Edile, con i costi ripartiti per cantiere.
Generatore di contratti di subappalto a clausole selezionabili.

Le sfide

Riconoscere i documenti senza AI

Niente modelli di intelligenza artificiale: testo estratto dal PDF e regole deterministiche, che danno sempre lo stesso risultato e si possono verificare una per una.

Le ho validate su 21 PDF reali del cliente: 10 su 10 riconosciuti e nessun falso positivo, anche sulle scansioni passate da OCR.

Sette round con il cliente

Ogni round di feedback è diventato una lista di punti chiusi e verificati in staging, fino alla versione che il cliente sta provando adesso.

In numeri

10/10 documenti riconosciuti sui PDF reali, zero falsi positivi

291 test automatici

46 commit, tutti miei

7 round di feedback col cliente

~2.338 fornitori importati