Help completo
Manuale operativo dettagliato di tutte le funzioni della web app SAL Premium.
Indice rapido
1. Panoramica della web app
SAL Premium gestisce lavori, elenco prezzi, misure, registro contabilità e stati avanzamento lavori. Questa versione non include il giornale dei lavori. Il flusso è lineare: crei il lavoro, carichi o importi l’elenco prezzi, inserisci le misure, controlli il registro contabilità e generi i SAL progressivi.
| Modulo | Scopo | Quando usarlo |
|---|---|---|
| Dashboard | Vista sintetica di account, lavori recenti ed esportazioni incluse. | Subito dopo il login. |
| Lavori | Archivio dei lavori gestiti dall’utente. Ogni lavoro è separato. | Per aprire, creare o consultare più lavori. |
| Dati lavoro | Anagrafica contrattuale: committente, impresa, importi, ribasso, ritenuta. | Prima della contabilità. |
| Elenco prezzi | Voci di prezzo da usare nelle misure. | Prima del libretto misure. |
| Import prezzi | Importazione da Excel o XML, con anteprima e template Excel. | Quando hai un prezzario esterno. |
| Libretto misure | Quantità eseguite, formule e descrizioni. | Durante l’avanzamento. |
| Registro contabilità | Valorizzazione economica automatica delle misure. | Per controllare importi e misure aperte. |
| SAL | Generazione stato avanzamento lavori progressivo. | Alla data di liquidazione/acconto. |
| Export Word | Download Word dei SAL per tutti gli account autorizzati. | Quando il documento deve essere consegnato o archiviato. |
3. Registrazione account utente
La registrazione autonoma è disponibile dalla pagina Crea account. L’utente deve inserire nome, email usata per l’iscrizione alla Newsletter Professional e password. La password minima è di 10 caratteri.
Se l’email non risulta abilitata, viene mostrato il messaggio che l’accesso è riservato agli iscritti alla Newsletter Professional e viene proposto il link di iscrizione. L’account non viene creato e nessun dato viene scritto nel database.
Gli account creati dalla registrazione autonoma sono account utente, attivi e con funzioni premium incluse. L’amministratore può sospenderli o impostare una scadenza accesso dal pannello utenti.
4. Recupero password
Il recupero password non invia mai la vecchia password. Il sistema genera un token casuale, salva solo l’hash del token nel database e invia un link temporaneo tramite funzione PHP mail(), senza SMTP. Il link dura 60 minuti e può essere usato una sola volta.
Per privacy, la pagina di recupero mostra sempre un messaggio generico: se l’indirizzo è presente nel sistema, arriverà il link. In questo modo non si rivela pubblicamente se una email è registrata o meno.
5. Dashboard
La dashboard è la pagina iniziale dopo il login. Mostra KPI premium su valore contrattuale, lavori misurati, netto liquidabile, importi da contabilizzare, lavori aperti, SAL emessi e stato account. Per admin aggiunge indicatori aggregati su utenti, accessi, lavori, backup e SAL.
Dalla dashboard sono disponibili azioni rapide: Nuovo lavoro, che crea un lavoro reale salvato nel database, Tutti i lavori, Carica demo funzionale e Help completo.
6. Gestione di più lavori per utente
Ogni utente può creare e gestire più lavori. I dati di un lavoro non si mescolano con quelli degli altri: elenco prezzi, misure, registro e SAL sono collegati al singolo lavoro. Gli utenti normali vedono solo i propri lavori; gli amministratori possono vedere tutti i lavori e assegnarli a un proprietario.
| Regola | Effetto pratico |
|---|---|
| Separazione per utente | Un utente non può aprire lavori di altri utenti. |
| Separazione per lavoro | Le misure di un lavoro non entrano nei SAL di un altro lavoro. |
| Admin | Può consultare e gestire tutti i lavori. |
| Stato lavoro | Aperto, chiuso o sospeso. Lo stato è informativo e aiuta l’archiviazione. |
7. Dati lavoro
La scheda lavoro contiene le informazioni contrattuali usate nei calcoli del SAL. Il ribasso percentuale viene applicato ai lavori, mentre gli oneri sicurezza inseriti nel SAL non vengono ribassati. La ritenuta percentuale viene applicata al netto corrente prima della liquidazione.
| Campo | Descrizione |
|---|---|
| Titolo lavoro | Nome identificativo del lavoro/cantiere/commessa. |
| Committente | Soggetto per cui si eseguono i lavori. |
| Impresa appaltatrice | Impresa che esegue le opere. |
| Importo contrattuale lavori | Importo base del contratto. È usato come riferimento e controllo. |
| Oneri sicurezza complessivi | Importo totale sicurezza previsto contrattualmente. |
| Ribasso lavori % | Percentuale applicata ai lavori lordi nel calcolo SAL. |
| Ritenuta % | Percentuale trattenuta sul netto corrente. |
| Date | Inizio e fine prevista del lavoro. |
8. Elenco prezzi
L’elenco prezzi contiene le voci economiche usate nelle misure. Ogni voce ha codice, descrizione, unità di misura, prezzo unitario e categoria. Puoi inserire le voci manualmente oppure importarle da Excel o XML.
Il codice voce è il riferimento principale: in importazione, se una voce con lo stesso codice esiste già nello stesso lavoro, può essere aggiornata invece di duplicata.
9. Import elenco prezzi da Excel o XML
La sezione Importa prezzi permette di caricare elenchi prezzi da Excel .xlsx o XML. Prima di salvare puoi usare Anteprima senza salvare, che mostra le prime voci riconosciute senza scrivere nulla nel database.
Template Excel scaricabile
Dalla pagina import o dalla sezione elenco prezzi è disponibile il pulsante Scarica template Excel. Il template contiene il foglio Elenco prezzi già strutturato con intestazioni corrette e righe di esempio. Puoi cancellare le righe di esempio, inserire le tue voci dalla riga 2 e ricaricare il file nella web app.
| Colonna | Obbligatoria | Note |
|---|---|---|
| Codice | Sì | Identificativo della voce, per esempio 01.01.001. |
| Descrizione | Sì | Descrizione tecnica della lavorazione. |
| Unità | Sì | m, m², m³, kg, cad, h, a corpo, ecc. |
| Prezzo unitario | Sì | Numero con virgola o punto decimale; non inserire simboli valuta. |
| Categoria | No | Raggruppamento: scavi, calcestruzzi, finiture, impianti, ecc. |
Modalità importazione
| Modalità | Effetto |
|---|---|
| Aggiorna e aggiungi | Se il codice esiste, aggiorna descrizione, unità, prezzo e categoria. Se non esiste, crea una nuova voce. |
| Sostituisci elenco | Elimina le voci esistenti e importa il nuovo elenco, ma solo se il lavoro non contiene misure. È bloccata se esistono misure collegate. |
Import XML
L’importatore XML riconosce campi e attributi equivalenti a codice, descrizione, unità, prezzo e categoria. È flessibile per XML semplici; tracciati regionali o gestionali molto complessi potrebbero richiedere un adattamento preliminare.
10. Libretto misure
Il libretto misure registra le quantità eseguite. Ogni misura è collegata a una voce dell’elenco prezzi. Si inseriscono data, voce, quantità, formula e descrizione. La formula è descrittiva e permette di ricostruire il calcolo; la quantità è il valore numerico effettivamente usato nel registro contabilità.
Le misure non ancora incluse in un SAL sono modificabili ed eliminabili. Dopo la generazione del SAL, le misure incluse vengono bloccate per mantenere coerenza contabile.
11. Registro contabilità
Il registro contabilità mostra tutte le misure valorizzate con il prezzo unitario della relativa voce. Per ogni riga calcola quantità × prezzo unitario. Mostra quali misure sono già collegate a un SAL e quali risultano ancora aperte.
Il registro è una vista di controllo e non richiede inserimenti manuali: deriva automaticamente da elenco prezzi e libretto misure.
12. Stati Avanzamento Lavori - SAL
Il modulo SAL genera uno stato avanzamento lavori alla data indicata. Il sistema include tutte le misure non ancora contabilizzate con data uguale o precedente alla data SAL. Le misure incluse vengono collegate al SAL e bloccate.
Calcolo economico
| Voce | Formula |
|---|---|
| Lavori lordi correnti | Somma delle misure incluse nel SAL corrente. |
| Ribasso lavori | Lavori lordi correnti × ribasso %. |
| Lavori netti | Lavori lordi correnti - ribasso. |
| Sicurezza corrente | Importo inserito manualmente nel SAL, non ribassato. |
| Netto prima ritenuta | Lavori netti + sicurezza corrente. |
| Ritenuta | Netto prima ritenuta × ritenuta %. |
| Netto liquidabile | Netto prima ritenuta - ritenuta. |
Il SAL è progressivo: il sistema conserva sia gli importi correnti sia i progressivi lavori e sicurezza rispetto ai SAL precedenti.
13. Esportazioni Word incluse
Dalla vista di un SAL è disponibile Esporta Word per tutti gli account autorizzati. Il file generato è un documento .doc basato su HTML compatibile con Word. Include dati lavoro, soggetti, riepilogo economico, misure incluse e aree firma.
La web app resta gratuita e riservata agli iscritti alla Newsletter Professional, ma le funzioni premium sono attive per tutti: non serve alcuna abilitazione manuale da parte dell’amministratore.
| Funzione | Effetto |
|---|---|
| Esporta Word | Il pulsante è sempre attivo per gli account autorizzati e il download viene registrato nei log. |
| Stampa | La stampa della vista SAL è disponibile direttamente dalla pagina del SAL. |
| Account sospeso o scaduto | L’utente non può accedere alla web app finché l’account non viene riattivato o prorogato. |
14. Esempio demo non salvato
Il pulsante Carica demo funzionale apre un lavoro completo fittizio con le stesse sezioni operative dei lavori reali: dati lavoro, elenco prezzi, import Excel/XML, libretto misure, registro contabilità, SAL, vista SAL, export Word e stampa.
La demo può essere modificata, ma solo in sessione: nessuna modifica viene scritta nel database dei lavori reali, nessun lavoro reale viene creato e nessun dato reale viene sovrascritto. Il pulsante Reset demo ripristina i dati dimostrativi iniziali.
15. Profilo utente
La pagina profilo permette di cambiare la propria password. Il sistema richiede la password attuale e la nuova password due volte. La password viene salvata solo come hash.
16. Pannello admin: utenti
Il pannello utenti permette agli amministratori di creare, modificare, sospendere, riattivare account e inviare reset password. Tutti gli account autorizzati hanno le funzioni premium incluse. Gli account con ruolo utente sono soggetti al controllo Newsletter Professional. Gli account admin e superadmin non sono soggetti a tale controllo.
| Azione | Effetto |
|---|---|
| Nuovo utente | Crea un account, previa verifica email se il ruolo è utente. |
| Modifica | Cambia nome, email, ruolo, stato, scadenza accesso e note. |
| Funzioni premium incluse | Le esportazioni Word e le funzioni premium sono attive per tutti gli utenti autorizzati. |
| Sospendi | Blocca l’accesso senza cancellare dati e lavori. |
| Attiva | Riabilita un account sospeso. |
| Reset | Genera token e invia link di reset via PHP mail(). |
17. Backup
Il modulo backup crea una copia del database SQLite. Se sul server è disponibile ZipArchive, il backup può essere compresso; altrimenti viene salvata una copia del database. I backup sono registrati nella tabella dedicata e si scaricano dal pannello admin.
È presente anche un backup automatico giornaliero al primo accesso, configurabile dalle impostazioni. Prima di aggiornare la web app o modificare file importanti è consigliato creare un backup manuale.
18. Impostazioni
Le impostazioni permettono di configurare nome app, URL pubblico, mittente email, notifiche automatiche, durata predefinita utenti creati da admin, backup automatico, pagina di iscrizione, cache accessi riservati, verifica al login ed esportazioni incluse.
Email senza SMTP su Aruba
L’invio email usa la funzione PHP mail(). È consigliato usare un mittente del dominio, per esempio noreply@tuodominio.it. Il parametro envelope sender -f può migliorare la consegna su alcuni hosting, ma se crea problemi può essere disattivato.
Esportazioni incluse
Le esportazioni Word dei SAL sono attive per tutti gli utenti autorizzati. Non esiste una scadenza separata per le esportazioni: vale solo lo stato generale dell’account.
Accesso riservato
Nelle impostazioni si controllano pagina di iscrizione, durata cache, registrazione autonoma e verifica al login. Il pulsante Aggiorna ora accessi riservati forza l’aggiornamento della cache.
19. Sicurezza applicativa
| Misura | Implementazione |
|---|---|
| Password hash | Uso di password_hash() e password_verify(). |
| Reset password | Token casuale con hash salvato nel database, scadenza e uso singolo. |
| CSRF | Token nei form sensibili. |
| Sessioni | Cookie HttpOnly, SameSite Lax, Secure se HTTPS, rigenerazione ID al login. |
| Brute force | Blocco temporaneo dopo tentativi falliti. |
| Storage protetto | .htaccess in app/, storage/, backup, cache e log. |
| Separazione dati | Ogni lavoro è associato all’utente proprietario. |
| Export Word | Disponibile per tutti gli account autorizzati, con registrazione evento nei log. |
| Audit log | Registrazione accessi, reset, backup, import, template ed esportazioni. |
Disclaimer, condizioni d’uso e manleva
SAL SUITE è una web app gratuita di supporto operativo, fornita così com’è. Non si dà assistenza gratuita al prodotto gratuito. La web app non sostituisce la valutazione professionale dell’utente, non costituisce consulenza legale, tecnica, fiscale o contabile e non garantisce la conformità automatica dei documenti prodotti a contratti, capitolati, norme, prassi o richieste di committenti e amministrazioni.
Ogni utente deve verificare dati inseriti, formule, prezzi unitari, ribassi, ritenute, oneri sicurezza, SAL ed esportazioni prima di usarli, trasmetterli o archiviarli come documentazione professionale. La demo è solo dimostrativa e non salva dati reali. Eventuali difficoltà operative, verifiche dei calcoli, personalizzazioni, configurazioni o valutazioni sull’idoneità dei documenti restano a carico dell’utente. Eventuale assistenza può essere erogata, a discrezione di Moira Mantovani o del geom. Benni Paolo, esclusivamente a pagamento e previo accordo tra le parti.
Alla registrazione e, per gli account già esistenti, al primo accesso dopo l’aggiornamento, il sistema richiede l’accettazione del disclaimer, delle condizioni d’uso e della manleva. L’accettazione viene registrata con data, data di aggiornamento del testo, indirizzo IP e browser.
20. Risoluzione problemi
| Problema | Causa probabile | Soluzione |
|---|---|---|
| Registrazione bloccata anche con email corretta | Cache accessi riservati da aggiornare. | Admin → Impostazioni → Aggiorna ora accessi riservati. |
| Impossibile aggiornare archivio accessi riservati | allow_url_fopen disattivato, cURL assente, rete server bloccata o servizio accessi riservati non raggiungibile. | Verificare impostazioni hosting e riprovare l’aggiornamento. |
| Email reset non arriva | PHP mail() non attivo o mittente non coerente con dominio. | Usare test email in Admin → Impostazioni e mittente del dominio. |
| Import Excel fallisce | File .xls, intestazioni modificate o ZipArchive non disponibile. | Scaricare il template Excel, compilare le righe e salvare in .xlsx; in alternativa usare XML. |
| Import XML non riconosce voci | Tracciato con nomi campo non riconosciuti. | Convertire in XML semplice o Excel con colonne standard. |
| Misura non modificabile | Misura già inclusa in un SAL. | È corretto: il blocco preserva la contabilità. |
| Impossibile sostituire elenco prezzi | Esistono misure collegate alle voci. | Usare modalità aggiorna/aggiungi oppure creare un nuovo lavoro. |