Changelog
All notable changes to this project will be documented in this file.
[1.6.1] 2026-11-11
- Aggiunto l'allegato del lavoratore: in `POST workers` e `PUT workers/{id}` il nuovo campo `file` accetta qualsiasi tipo di file (max 20 MB), salvato così com'è in `workers/files/{group_id}/{worker_id}` (nuove colonne `workers.file_path` e `workers.file_name`). Inviando `file` vuoto o `null` in modifica l'allegato viene eliminato. Nuovo endpoint `GET workers/{id}/download` per scaricarlo. La foto (`workers[photo]`) continua ad accettare solo immagini.
- Sistemato liste lavoratori da verbale per mostrare solo quelli effettivamente abilitati
[1.6.0] 2026-10-19
- Fix: `construction-reports/step-3` risponde ora `422 NO_PERSON_PRESENT` (senza salvare) se non è stata selezionata nessuna persona presente (personale di cantiere, lavoratori o altri soggetti), con un messaggio che chiede di selezionarne almeno una e indicare chi firma. Prima si poteva arrivare fino in fondo e la generazione finale (`step-8`) falliva con il fuorviante `NO_SIGNER_REQUIRED` ("almeno una persona tra quelle presenti deve essere indicata come firmante") anche se non c'era nessuna persona.
- Aggiunto endpoint `POST construction-reports/{job_id}/report-date` per salvare la data del verbale scelta dall'operatore (non futura): se non esiste un verbale aperto lo crea con quella data, altrimenti aggiorna la data di quello esistente (`409 REPORT_RESET` se il verbale è stato resettato). La data è quella riportata nel PDF/DOCX e usata per il nome della cartella generata sul server.
- Fix: la generazione finale di verbali (`construction-reports/step-8`) e giornali (`journals/step-8`) ora risponde `422 SIGNATURES_MISSING` se una persona indicata come firmante non ha ancora firmato, invece di produrre un documento senza la sua firma. La preview PDF espone `signatures_complete` e gli step 0, 1 e 3 del verbale e lo step 2 del giornale restituiscono le firme correnti (`signatures`), così il frontend può riallinearsi quando una firma viene rimossa perché la persona non è più obbligata a firmare.
- Aggiunta la permission `deposit-digital-signature` ("Firma digitale" → "deposita", assegnata al ruolo `admin`, gestibile dalla pagina ruoli): gli utenti con questa permission possono depositare la propria firma con `GET/POST/DELETE /api/user-signature` (la firma, disegnata o da immagine PNG/JPG max 2 MB, si invia sempre in base64 nel campo `file`). Nuovo campo `workers.user_id` per collegare un lavoratore a un utente. Per i lavoratori collegati a un utente con permission e firma depositata (e, nei verbali, anche per il personale di cantiere collegato tramite l'utente Sertec, `users.utente_grafite_id`, e per i soggetti aggiuntivi che coincidono con un lavoratore collegato), la firma viene applicata automaticamente lato server a giornale e verbale (al salvataggio dei lavoratori in `journals/step-2` e `construction-reports/step-1` e all'apertura di un documento ancora modificabile) senza sovrascrivere firme già presenti. Nello step 7 (`construction-reports/step-7`, `journals/step-7`) nuovi campi opzionali `use_saved_signature` (applica esplicitamente la firma depositata, `file` non obbligatorio) e `save_as_default` (deposita la firma tracciata nel profilo del firmatario, chiunque sia l'utente loggato, se il firmatario ha la permission e non ha già una firma depositata; `can_save_signature` dipende quindi dal firmatario e non da chi è loggato); il `show` dei verbali e `journals/entry/{id}` espongono per i lavoratori `saved_signature_available` e `can_save_signature`. Senza permission il comportamento resta invariato.
[1.5.0] 2026-10-05
- Aggiunta la possibilità di richiedere, per ogni entità dell'impresa (impresa, lavoratore, veicolo, macchinario, attrezzatura, prodotto chimico), documenti specifici per un cantiere e per una singola impresa: nuovo endpoint `POST jobs-groups/{job_group_id}/specific-documents` (nome, tipologia risorsa, scadenza, mesi di validità, obbligatorio). Il documento vale solo per l'impresa a cui viene richiesto, le altre imprese dello stesso cantiere non lo vedono e non ne sono influenzate; per richiederlo anche a un'altra impresa si ripete la richiesta su di lei (il documento già creato per il cantiere viene riusato). Compare in un elenco separato: `uploaded-documents/required-documents-for-job-group/...?job_specific_only=1` (la lista standard non lo include più) e `jobs/{job_id}/requirements?job_specific_only=1[&job_group_id=...]`. Il caricamento segue lo stesso flusso degli altri documenti e, se obbligatorio, incide sull'idoneità della sola impresa interessata (retrocessione automatica se manca l'upload approvato). Nuova colonna `job_required_documents.job_group_id` (nulla per i requisiti di catalogo) e `documenti_richiedibili.requested_for_job_id`.
- Fix: l'elenco delle offerte/commesse visibili a un'impresa (`offerte/associated-jobs`), il report settimanale imprese non conformi e il reminder giornaliero di scadenza documenti non tenevano conto dello stato di apertura/chiusura della commessa (`situazioneIncarico`): una commessa chiusa continuava a comparire in elenco e a generare notifiche/email come se fosse ancora attiva.
- Il verbale di sopralluogo (preview, PDF e DOCX finale) riporta ora, prima della sezione "Imprese/Personale presente in cantiere", la sezione "Soggetti presenti al sopralluogo" con le figure di cantiere selezionate allo Step 0.
- Aggiunta la gestione selettiva delle firme in verbali e giornali: negli step di selezione delle persone presenti (personale di cantiere, lavoratori, soggetti aggiuntivi) è ora possibile indicare, oltre alla presenza, chi tra i presenti deve effettivamente firmare (`need_signature`), perché non tutti i presenti sono tenuti a farlo. Lo step firme richiede ora la firma solo di chi è stato indicato come firmante. Se ci sono persone presenti è obbligatorio indicare almeno un firmante: il controllo considera insieme tutte le persone dei vari step e scatta sull'ultimo step di selezione (`construction-reports/step-3` per il verbale, `journals/step-2` per il giornale), che risponde `422 NO_SIGNER_REQUIRED` senza salvare. In più, senza firmanti lo step firme non risulta completato, la generazione di verbale/giornale risponde `422 NO_SIGNER_REQUIRED` e la preview resta visibile con `has_required_signer: false` e un `warning`. I record già esistenti prima di questa modifica sono stati marcati come firmanti, mantenendo il comportamento precedente (tutti dovevano firmare).
[1.4.1] 2026-09-30
- Fix: `notifications/get_list_for_user` rispondeva 500 (errore SQL 1064 su MariaDB) quando il frontend richiedeva tutte le notifiche con `itemsPerPage=-1`: veniva applicato un `OFFSET` senza `LIMIT`. Corretto nel pacchetto `companee/notifications`, dove la paginazione è ora applicata solo se `itemsPerPage > 0` (aggiornare il pacchetto a `v1.0.3`).
[1.4.0] 2026-09-21
- Aggiunta la possibilità per un'impresa appaltatrice collegata a un cantiere di invitare un'altra impresa senza poterla creare direttamente in anagrafica: l'invito viene salvato in una tabella temporanea (`jobs-groups-invitations`, CRUD + `/accept` + `/reject`) e, solo se accettato, l'impresa invitata diventa un'impresa vera già collegata alla commessa; se rifiutato va indicata una motivazione, salvata insieme a chi e quando. Nuovi permessi `invitation_groups` (invio invito e sezione destinatari notifiche) e `approve_jobs_groups` (accettazione/rifiuto), entrambi gestibili dalla pagina ruoli.
- Aggiunto endpoint `jobs/{job_id}/notification-settings` (GET/POST/PUT) per configurare, per singola commessa, gli indirizzi email destinatari delle notifiche su caricamento/commento documenti, imprese non conformi e inviti impresa.
- Aggiunto endpoint `job-groups/{jobId}/invite-eligibility` per sapere se l'utente loggato può invitare un'impresa su quel cantiere, e `groups-check-duplicate` per avvisare se un codice fiscale o una partita IVA sono già presenti in anagrafica. L'invio dell'invito è comunque bloccato lato server (422) se CF o P.IVA coincidono con un'impresa già esistente, non solo segnalato.
- Se l'email configurata come destinataria di una notifica (caricamento/commento documenti, imprese non conformi, inviti impresa) coincide con un utente attivo del sistema, ora riceve anche la notifica in home page oltre alla mail, non solo la mail come prima.
- Fix: chi ha invitato un'impresa non riceveva la notifica in home page quando l'invito veniva accettato o rifiutato (arrivava solo la mail, quando arrivava): la notifica veniva salvata con un tipo di utente diverso da quello con cui viene poi letta, quindi restava invisibile pur essendo a database. Corretta anche una notifica reale già salvata in modo errato.
- Il reset del verbale viene tracciato (`reset_by`, `reset_at`), sia dallo sblocco dell'anagrafica sia dal "Nuovo Verbale" della pagina verbali.
- Fix: se un verbale veniva resettato da un altro operatore, il browser fermo su uno step intermedio ricreava in silenzio un verbale vuoto e proseguiva la compilazione perdendo gli step già fatti. Gli step accettano ora `construction_report_id` e rispondono `409 REPORT_RESET` quando non corrisponde più al verbale aperto; il frontend avvisa e riporta la compilazione allo step iniziale.
- Fix: lo stepper dei verbali avanzava anche quando il salvataggio dello step falliva, perché l'esito della chiamata non veniva controllato. Stesso problema per le firme dello Step 7, che risultavano acquisite senza essere state salvate.
- Aggiunta la visibilità gerarchica delle imprese in una commessa: un'impresa capofila (leader in `jobs_groups`) vede ora in elenco imprese, dettaglio e albero gerarchico anche le imprese "sotto" di sé (dirette e transitive), e può vederne/gestirne i documenti caricati (upload, modifica, cancellazione, download, approvazione) come se fossero la propria. Le imprese "sotto" continuano a vedere solo se stesse.
[1.3.2] 2026-09-17
- Modificato destinatari invii notifiche per report settimanale documenti imprese e reminder giornaliero di documenti in scadenza
[1.3.1] 2026-09-16
- Aggiunto endpoint per pagina valutazione lavoro svolto da parte del cliente
[1.3.0] 2026-09-14
- Aggiunto nuovi endpoint per tab "Documenti generali di cantiere": `jobs/{job_id}/general-documents` upload/elenco/modifica/cancellazione di documenti generici (nome obbligatorio, descrizione opzionale, file di qualsiasi tipo) legati al cantiere, con tracciamento di chi ha caricato e quando e download. Permessi `view/add/edit/delete_construction_site_general_documents` (view a tutti i ruoli, scrittura solo ad admin, admin_grafite, operatore_sertec_admin).
- Aggiunto nuovo plugin companee/notifications.
- Aggiunta la possibilità di definire degli indirizzi email per le notifiche dell'offerta su caricamento e commento documenti e per il report settimanale sullo stato dei documenti
- Fix: `construction-reports/step-6` rispondeva 500 (`Duplicate entry` sull'indice unique `uuid`) quando il FE rispediva l'uuid di una foto già prenotata a database, cosa che avviene alla riapertura del verbale finché l'upload del file non è andato a buon fine.
- Ora la prenotazione esistente viene riusata (`withTrashed`, con ripristino se soft deleted) invece di essere ricreata, così lo step non resta bloccato a ogni tentativo di salvataggio.
- Stesso fix su `journals/step-6`, dove l'uuid non ha indice unique e il reinserimento creava un secondo allegato con lo stesso uuid: l'upload ne valorizzava uno solo e l'altro restava pendente, lasciando `step_6_completed` a false e bloccando la generazione del giornale.
[1.2.5] 2026-09-04
- Fix: le firme del personale di cantiere uscivano nel verbale senza nome né ruolo, perché cercate fra i soggetti aggiuntivi anziché fra il personale dello Step 0.
- Fix: la generazione di verbali e giornali viene bloccata se l'upload di foto o allegati non è ancora concluso, invece di produrre un documento privo di immagini.
- Fix: le foto prive di file non generano più celle vuote con la sola dicitura "Descrizione: -" al posto dell'immagine.
[1.2.4] 2026-09-04
- Fix: `.docx` dei verbali non apribili da Word — le entità HTML dell'editor (`à`) rendevano l'XML non valido; ora decodificate, con `<p>`/`<li>` resi come paragrafi ed elenchi.
- Fix: abilitato l'escaping XML nei `.docx` di verbali e giornali: una `&` nel testo corrompeva il documento.
[1.2.3] 2026-08-26
- Fix: campo testo verbali (`response_value`/`response_additional_info`) ampliato da `TEXT` a `LONGTEXT` per evitare troncamento quando l'editor HTML include immagini incollate; aggiunto controllo dimensione (30MB) con errore chiaro invece di crash SQL.
[1.2.2] 2026-08-24
- Fix: `getLavoroById` non applicava il filtro `gestione_cartella = 1`, permettendo di leggere l'anagrafica cantiere (`GET /jobs/{id}/site-detail`) anche di lavori non visibili nell'elenco `/commesse`. Allineato allo stesso filtro già usato per costruire l'elenco commesse.
- Aggiornato companee/core alla versione v2.1.2: il middleware di autenticazione non risponde più 401 su guasti non legati al token (database, cache, errori applicativi), che causavano il logout degli utenti con sessione valida; ora restituisce 503. Il refresh del token distingue il token già rinnovato da una chiamata concorrente (409) dalla sessione realmente scaduta (401), e le letture delle configurazioni di autenticazione non falliscono più se una chiave manca a database.
- Aggiunta la chiave `jwt.warning` in `config/jwt.php`: il valore di `JWT_WARNING` veniva ignorato e l'avviso di scadenza sessione usava un default errato, che avviava il rinnovo del token molto prima del necessario.
- Impostato `blacklist_grace_period` a 30 secondi: le chiamate API già in corso non vengono più rifiutate quando il token viene rinnovato.
[1.2.1] 2026-07-23
- Fix: colonna `phone` nelle imprese cambiata da `bigint` a `varchar(30)` per supportare numeri internazionali con prefisso.
- Aggiunto comando per ottimizzare foto pre-esistenti construction-reports:optimize-existing-media
- Ruolo "Assistente DL/CSE" non più obbligatorio nel personale di cantiere (`job_sites_roles.required` a false)
[1.2.0] 2026-07-16
- Ottimizzazione automatica delle immagini al momento dell'upload: introdotto `ImageOptimizationService` (GD) che ridimensiona le foto a max 1200px (lato lungo, JPEG q85) e le firme a max 800px (PNG). Applicato a tutti gli endpoint di upload del progetto: `offerte/uploadFoto`, `workers`, `chemical_products`, `equipment`, `uploaded-documents/upload`, verbali Step 6 (foto) e Step 7 (firme), giornali Step 6 (allegati immagine) e Step 7 (firme). File non-immagine (PDF, DOC, XLS, HEIC, RAW) passano invariati. Riduzione tipica: ~92% (es. 5.5 MB → 426 KB).
- Documenti cantiere — se si carica una nuova revisione di un documento già approvato, lo stato in elenco diventa arancione invece di restare verde, e l'idoneità dell'impresa si aggiorna di conseguenza a "idonea con integrazione" finché la revisione non viene evasa.
[1.1.0] 2026-07-08
- Aggiornato companee/core alla versione v2.0.14: fix log richieste in con file.
- Documenti cantiere — blocco salvataggio se la data di scadenza è già nel passato
- Aggiunto processo settimanale per notifica stato documenti imprese
- Gestito campi testo verbali con editor html
- Aggiunto tasto per scarico elenco utenti
[1.0.19] 2026-07-01
- Fixato timeout in produzione durante la generazione di PDF (verbali e giornali): le firme PNG ad alta risoluzione venivano processate pixel-per-pixel da dompdf causando il superamento del limite di 30 secondi. Le firme vengono ora convertite in JPEG (max 600px) prima del rendering.
- Notificato approvazione/rifiuto e aggiunta commento per documento
[1.0.18] 2026-06-25
- Ottimizzato generazione anteprima verbale
[1.0.17] 2026-06-18
- La rigenerazione del verbale sovrascrive sempre la versione precedente
- Implementato anteprima verbale
- Implementato anteprima giornale
- Aggiornato companee/core alla versione v2.0.10
- Fix validazione `itemsPerPage` per elenco tabelle: ora accetta il valore `-1` (nessuna paginazione, ritorna tutti le righe) oltre ai valori positivi.
[1.0.16] 2026-06-03
- Prodotti chimici — Scheda materiale: aggiunto campo opzionale per il caricamento della scheda di sicurezza. La chiamata ora accetta (pdf, jpg, jpeg, png, doc, docx, xls, xlsx — max 20 MB).
- Aggiunto step 6 per i giornali (Allegati): campo input per poter caricare allegati.
- Aggiunto step 7 per salvare le firme delle persone presenti.
- Aggiunto step 8 per i giornali (Generazione documento): alla conferma del frontend, il sistema genera un file PDF e un file DOCX del Giornale di Lavori con tutti i dati salvati (meteo, lavoratori, veicoli, descrizione lavori, allegati, firme) e li salva sul NAS nella cartella `07_Esecuzione_Lavori/01_DL/07_GDL/{data_iniziali}/`. Le firme vengono copiate nella sottocartella `firme/`.
[1.0.15] 2026-05-27
- Aggiunto step 5 per i giornali (Note e Osservazioni): campo testuale opzionale per annotazioni libere.
- Aggiunto upload file per attrezzature: le chiamate accettano file (pdf, jpg, jpeg, png, doc, docx, xls, xlsx — max 20MB).
[1.0.14] 2026-05-21
- Aggiornato pacchetto companee/core alla versione v2.0.5
[1.0.13] 2026-05-15
- Aggiunto step 4 per i giornali.
- Aggiunta gestione scadenze documenti per le imprese: possibilità di visualizzare tutte le scadenze dei documenti dell'impresa e delle sue risorse associate (lavoratori, veicoli, macchinari, attrezzature, prodotti chimici), con supporto per il recupero delle prossime 3 scadenze future
[1.0.12] 2026-05-04
- Fix dei filtri per le tabelle Verbali e Giornali
- Implementato step 2 e 3 Giornale
- Aggiunta documentazione API tramite Swagger (l5-swagger): configurazione, view dedicata e annotazioni sul controller base
- Implementata suite di test feature per le principali entità (gruppi cantiere, requisiti, dettagli cantiere, verbali, giornale, workers, veicoli, macchinari, attrezzature, prodotti chimici, documenti, committenti, offerte, utenti)
- Aggiunta view Blade per la visualizzazione del changelog e relativa route web
- Aggiornata pagina di benvenuto con riepilogo delle route disponibili
[1.0.0] 2026-04-31
- Implementazione sistema versionamento.