SAL SUITE

Help completo

Manuale operativo dettagliato di tutte le funzioni della web app SAL Premium.

Accesso Crea account

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.

ModuloScopoQuando usarlo
DashboardVista sintetica di account, lavori recenti ed esportazioni incluse.Subito dopo il login.
LavoriArchivio dei lavori gestiti dall’utente. Ogni lavoro è separato.Per aprire, creare o consultare più lavori.
Dati lavoroAnagrafica contrattuale: committente, impresa, importi, ribasso, ritenuta.Prima della contabilità.
Elenco prezziVoci di prezzo da usare nelle misure.Prima del libretto misure.
Import prezziImportazione da Excel o XML, con anteprima e template Excel.Quando hai un prezzario esterno.
Libretto misureQuantità eseguite, formule e descrizioni.Durante l’avanzamento.
Registro contabilitàValorizzazione economica automatica delle misure.Per controllare importi e misure aperte.
SALGenerazione stato avanzamento lavori progressivo.Alla data di liquidazione/acconto.
Export WordDownload Word dei SAL per tutti gli account autorizzati.Quando il documento deve essere consegnato o archiviato.

2. Accesso riservato Newsletter Professional

La web app è gratuita e riservata agli iscritti alla Newsletter Professional. La registrazione autonoma e, se attivato, il login utente vengono consentiti solo quando l’email risulta abilitata all’accesso riservato. Gli account admin e superadmin sono esclusi dal controllo per consentire installazione, assistenza e gestione tecnica.

Il sistema aggiorna l’archivio accessi riservati tramite un servizio interno, normalizza gli indirizzi in minuscolo e usa una cache locale protetta per ridurre tempi di risposta e dipendenza dalla rete.

SituazioneComportamento
Email abilitataL’account utente può essere creato e può accedere.
Email abilitata ma profilo non creatoIl login informa che occorre creare il profilo utente sulla suite e mostra il collegamento alla registrazione.
Email abilitata ma password errataIl login informa che l’utente è abilitato e mostra sia il collegamento alla creazione profilo sia il recupero password.
Email non abilitataIl login e la registrazione informano che il servizio gratuito è riservato agli iscritti e mostrano il collegamento di iscrizione.
Servizio accessi riservati non raggiungibile ma cache presenteIl sistema usa l’ultima cache disponibile.
Servizio accessi riservati non raggiungibile e nessuna cacheLa creazione account utente viene bloccata per evitare accessi non consentiti.
Account admin/superadminIl controllo è escluso per non bloccare amministrazione e manutenzione.

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.

RegolaEffetto pratico
Separazione per utenteUn utente non può aprire lavori di altri utenti.
Separazione per lavoroLe misure di un lavoro non entrano nei SAL di un altro lavoro.
AdminPuò consultare e gestire tutti i lavori.
Stato lavoroAperto, 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.

CampoDescrizione
Titolo lavoroNome identificativo del lavoro/cantiere/commessa.
CommittenteSoggetto per cui si eseguono i lavori.
Impresa appaltatriceImpresa che esegue le opere.
Importo contrattuale lavoriImporto base del contratto. È usato come riferimento e controllo.
Oneri sicurezza complessiviImporto totale sicurezza previsto contrattualmente.
Ribasso lavori %Percentuale applicata ai lavori lordi nel calcolo SAL.
Ritenuta %Percentuale trattenuta sul netto corrente.
DateInizio 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.

ColonnaObbligatoriaNote
CodiceSìIdentificativo della voce, per esempio 01.01.001.
DescrizioneSìDescrizione tecnica della lavorazione.
UnitàSìm, m², m³, kg, cad, h, a corpo, ecc.
Prezzo unitarioSìNumero con virgola o punto decimale; non inserire simboli valuta.
CategoriaNoRaggruppamento: scavi, calcestruzzi, finiture, impianti, ecc.

Modalità importazione

ModalitàEffetto
Aggiorna e aggiungiSe il codice esiste, aggiorna descrizione, unità, prezzo e categoria. Se non esiste, crea una nuova voce.
Sostituisci elencoElimina 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

VoceFormula
Lavori lordi correntiSomma delle misure incluse nel SAL corrente.
Ribasso lavoriLavori lordi correnti × ribasso %.
Lavori nettiLavori lordi correnti - ribasso.
Sicurezza correnteImporto inserito manualmente nel SAL, non ribassato.
Netto prima ritenutaLavori netti + sicurezza corrente.
RitenutaNetto prima ritenuta × ritenuta %.
Netto liquidabileNetto 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.

FunzioneEffetto
Esporta WordIl pulsante è sempre attivo per gli account autorizzati e il download viene registrato nei log.
StampaLa stampa della vista SAL è disponibile direttamente dalla pagina del SAL.
Account sospeso o scadutoL’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.

AzioneEffetto
Nuovo utenteCrea un account, previa verifica email se il ruolo è utente.
ModificaCambia nome, email, ruolo, stato, scadenza accesso e note.
Funzioni premium incluseLe esportazioni Word e le funzioni premium sono attive per tutti gli utenti autorizzati.
SospendiBlocca l’accesso senza cancellare dati e lavori.
AttivaRiabilita un account sospeso.
ResetGenera 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

MisuraImplementazione
Password hashUso di password_hash() e password_verify().
Reset passwordToken casuale con hash salvato nel database, scadenza e uso singolo.
CSRFToken nei form sensibili.
SessioniCookie HttpOnly, SameSite Lax, Secure se HTTPS, rigenerazione ID al login.
Brute forceBlocco temporaneo dopo tentativi falliti.
Storage protetto.htaccess in app/, storage/, backup, cache e log.
Separazione datiOgni lavoro è associato all’utente proprietario.
Export WordDisponibile per tutti gli account autorizzati, con registrazione evento nei log.
Audit logRegistrazione 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.

Leggi il testo completo

20. Risoluzione problemi

ProblemaCausa probabileSoluzione
Registrazione bloccata anche con email correttaCache accessi riservati da aggiornare.Admin → Impostazioni → Aggiorna ora accessi riservati.
Impossibile aggiornare archivio accessi riservatiallow_url_fopen disattivato, cURL assente, rete server bloccata o servizio accessi riservati non raggiungibile.Verificare impostazioni hosting e riprovare l’aggiornamento.
Email reset non arrivaPHP mail() non attivo o mittente non coerente con dominio.Usare test email in Admin → Impostazioni e mittente del dominio.
Import Excel fallisceFile .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 vociTracciato con nomi campo non riconosciuti.Convertire in XML semplice o Excel con colonne standard.
Misura non modificabileMisura già inclusa in un SAL.È corretto: il blocco preserva la contabilità.
Impossibile sostituire elenco prezziEsistono misure collegate alle voci.Usare modalità aggiorna/aggiungi oppure creare un nuovo lavoro.