Domande frequenti

Generale

Che cos’e QuoteNode?

QuoteNode e una piattaforma CRM e di preventivazione self-hosted per team di vendita B2B e B2C. Offre gestione clienti, creazione professionale di offerte, generazione di PDF brandizzati, link pubblici tracciabili e analytics commerciali, tutto eseguito sulla tua infrastruttura.

A chi si rivolge QuoteNode?

QuoteNode e pensato per freelance, consulenti, piccole agenzie e aziende di medie dimensioni che creano e inviano offerte ai clienti. E particolarmente adatto a organizzazioni che vogliono proprieta dei dati, documenti rivolti al cliente con branding dedicato e un workflow commerciale strutturato.

In cosa QuoteNode e diverso dalle piattaforme CRM SaaS?

QuoteNode e self-hosted e single-tenant. I tuoi dati restano sul tuo server. Non esiste database condiviso, vendor lock-in, canone mensile o dipendenza da servizi esterni. Tu controlli l’infrastruttura, i backup e il perimetro di accesso.

Deployment e infrastruttura

Cosa serve per eseguire QuoteNode?

Un server con Docker Engine 24.0+, 2 GB di RAM (4 GB consigliati) e un SSD con almeno 10 GB liberi. QuoteNode viene distribuito come container Docker e si installa tramite Docker Compose.

Posso eseguire QuoteNode sul mio laptop per valutarlo?

Si. La configurazione Docker Compose funziona su qualsiasi macchina con Docker installato: Linux, macOS o Windows (WSL2). E cosi che la maggior parte degli utenti valuta QuoteNode prima del deployment in produzione.

QuoteNode richiede accesso a internet?

No. QuoteNode funziona interamente offline. Nessuna telemetria, nessun callback di analytics, nessun server di licenze esterno. Le uniche connessioni in uscita sono quelle che configuri esplicitamente (SMTP per l’invio email e, facoltativamente, fonti per i tassi di cambio).

Posso distribuire QuoteNode dietro un firewall aziendale?

Si. QuoteNode e progettato per ambienti air-gapped e reti ristrette. Non ha dipendenze esterne a runtime.

Quale database usa QuoteNode?

PostgreSQL 16 o successivo. E l’unico motore database supportato. L’istanza PostgreSQL gira come container accanto all’applicazione.

Licenze e prezzi

QuoteNode e davvero gratuito?

L’edizione Freelancer e gratuita per sempre e non richiede carta di credito. Include tutte le funzionalita principali — creazione offerte, generazione PDF, link pubblici, gestione clienti e analytics — per fino a 3 utenti. L’unico limite e il badge “Powered by QuoteNode” sulle pagine pubbliche delle offerte e nei PDF.

Cosa include la licenza a pagamento?

Le edizioni a pagamento (Pro, Business, Enterprise) aggiungono limiti utenti piu alti, capacita white-label (rimozione del badge “Powered by”), template avanzati, supporto prioritario e garanzie SLA. Consulta la pagina Prezzi per i dettagli.

Come funziona tecnicamente la licenza?

QuoteNode usa file di licenza firmati con Ed25519 e verificati interamente offline. Nessun server esterno viene contattato. Le licenze a pagamento sono annuali: se una licenza scade, tutte le funzionalita continuano a funzionare normalmente. L’unico cambiamento e la comparsa del badge “Powered by QuoteNode” sulle superfici rivolte al cliente e di un piccolo promemoria nell’interfaccia. Nessun blocco, nessuna modalita sola lettura, nessuna funzionalita disabilitata.

Cosa succede se non rinnovo la licenza?

Non si rompe nulla. La tua istanza continua a funzionare con tutte le funzionalita. La quota annuale sostiene lo sviluppo continuo: non e un kill switch. Quando vuoi, rinnovi per rimuovere il badge. Se un anno hai bisogno di risparmiare, e supportato esplicitamente.

Posso passare da Freelancer a Pro in seguito?

Si. Puoi fare upgrade in qualsiasi momento applicando un nuovo file di licenza. Non e necessaria alcuna migrazione dati o reinstallazione.

Offerte e workflow

Quanto tempo serve per creare un’offerta?

La maggior parte delle offerte puo essere creata in 2-5 minuti. Selezioni un cliente, aggiungi prodotti dal catalogo (con regole di prezzo automatiche), configuri il template e invii. Il sistema gestisce automaticamente calcoli IVA, conversione di valuta e generazione PDF.

I miei clienti possono vedere le offerte senza creare un account?

Si. Ogni offerta puo essere condivisa tramite un link pubblico. Il cliente vede una pagina responsive completamente brandizzata e puo accettare, rispondere o rifiutare senza registrarsi.

Le offerte sono tracciate?

Si. Il sistema traccia quando un cliente apre il link pubblico, scarica il PDF, risponde, accetta o rifiuta. Vedi numero di aperture, timestamp e paese del cliente (via GeoIP) direttamente nella scheda dell’offerta.

Posso creare offerte in piu valute?

Si. QuoteNode supporta piu valute con conversione automatica dei tassi di cambio. Puoi impostare una valuta diversa per ogni offerta. I report pipeline convertono tutti i valori nella tua valuta base per un reporting unificato.

Cosa succede quando un’offerta scade?

Lo stato dell’offerta passa a “Scaduta” e il link pubblico mostra un avviso di scadenza. Puoi clonare l’offerta scaduta con un clic per creare una nuova versione con un nuovo periodo di validita.

Sicurezza

Come sono protetti i dati cliente sui link pubblici?

I link pubblici usano token casuali crittograficamente robusti a 256 bit. Nel database viene memorizzato solo l’hash SHA-256. I link possono essere protetti da password, limitati nel rate e revocati in qualsiasi momento. Il rilevamento bot aiuta a bloccare gli abusi automatizzati.

QuoteNode ha un audit trail?

Si. Ogni mutazione del sistema viene registrata in un audit log append-only: chi ha cambiato cosa, quando e da quale indirizzo IP. Il log e immutabile: nessuna voce puo essere modificata o eliminata, nemmeno dagli amministratori.

QuoteNode supporta l’autenticazione a due fattori?

Si. L’autenticazione a due fattori basata su TOTP e supportata per tutti gli utenti e puo essere resa obbligatoria per gli amministratori.

Dati e backup

Come vengono gestiti i backup?

QuoteNode include un sistema di backup integrato. Un worker dedicato esegue un job pianificato (predefinito: ogni giorno alle 2:00) che crea un dump completo del database e archivia tutti i file caricati e i PDF generati. I backup sono conservati localmente e possono anche essere caricati su storage remoto tramite rclone.

Posso scaricare un backup sul mio computer?

Si. Gli amministratori possono scaricare gli archivi di backup direttamente dal pannello di amministrazione (Settings > Backup). Basta fare clic sul pulsante di download di qualsiasi backup riuscito.

Posso cifrare i backup?

Si. Imposta la variabile d’ambiente BACKUP_GPG_RECIPIENT con un ID chiave GPG. Sia il dump del database sia l’archivio dei file verranno cifrati prima dello storage. E consigliato se conservi i backup su cloud storage di terze parti.

Come si ripristina da un backup?

Usa lo script restore.sh incluso nel repository. Per un’installazione esistente esegui ./restore.sh backup-file.tar.gz. Per un server nuovo (disaster recovery) esegui ./restore.sh --fresh-install backup-file.tar.gz. Lo script gestisce automaticamente il ripristino del database, il recupero dei file e l’avvio dell’applicazione. Consulta la wiki Backup e ripristino per la guida completa.

Cosa succede se dimentico di fare backup?

Se i backup automatici sono abilitati (consigliato), il sistema esegue un backup giornaliero senza alcuna azione manuale. Il pannello di amministrazione mostra un avviso se non e stato registrato alcun backup riuscito nelle ultime 48 ore. Puoi anche avviare un backup manuale in qualsiasi momento dal pannello admin.

Per quanto tempo vengono conservati i backup?

Per impostazione predefinita, gli ultimi 7 backup riusciti vengono mantenuti localmente. I file piu vecchi vengono eliminati automaticamente dopo ogni backup completato con successo. I backup remoti (caricati tramite rclone) seguono le policy di lifecycle del tuo provider di storage.

Tecnico

Quale stack tecnologico usa QuoteNode?

Backend: Java 25 con Spring Boot 4. Frontend: Vue 3 con Vite, PrimeVue 4 e Tailwind CSS 4. Database: PostgreSQL 16. Generazione PDF: Gotenberg (basato su Chromium). Reverse proxy: Caddy 2 con HTTPS automatico.

Come vengono gestite le migrazioni del database?

QuoteNode usa Flyway per la gestione dello schema. Le migrazioni vengono eseguite automaticamente all’avvio del backend. Le migrazioni esistenti non vengono mai modificate: i cambiamenti di schema sono sempre additivi.

Posso personalizzare il template PDF dell’offerta?

Si. Il sistema di template supporta colonne configurabili (SKU, immagini, descrizioni, sconti), piu modalita di visualizzazione dei prezzi (NET/GROSS/dettaglio completo), immagini prodotto, condizioni commerciali personalizzate e il branding della tua azienda.

Come funziona la generazione del PDF?

Il backend rende un documento HTML a partire dallo snapshot dell’offerta usando template Thymeleaf, quindi lo invia a Gotenberg (un container basato su Chromium) per convertirlo in un PDF pronto per la stampa. Le offerte piccole vengono generate in modo sincrono (meno di 3 secondi); quelle grandi usano elaborazione asincrona in background con notifica quando sono pronte.