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, workflow di prodotto e listino, creazione professionale di offerte, generazione di PDF brandizzati, link pubblici tracciabili, workflow board, asset cliente e analytics commerciali — tutto in esecuzione sulla tua infrastruttura.
A chi si rivolge QuoteNode?
QuoteNode e progettato per freelance, consulenti, piccole agenzie e aziende di medie dimensioni che creano e inviano offerte ai clienti. E particolarmente adatto a organizzazioni che hanno bisogno di proprieta dei dati, documenti rivolti al cliente con branding, lavoro commerciale strutturato e operazioni self-hosted.
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, nessuna mescolanza di tenant SaaS, nessun metering di utilizzo e nessuna dipendenza da servizi runtime esterni. Tu controlli l’infrastruttura, i backup, il DNS, il TLS e il perimetro di accesso.
Deployment e infrastruttura
Cosa serve per eseguire QuoteNode?
Una macchina con Docker e Docker Compose v2, minimo 2 GB di RAM (4 GB consigliati) e storage SSD. QuoteNode viene distribuito come container Docker e puo essere deployato localmente, in una LAN, su un server Ubuntu pubblico, tramite Coolify o tramite Docker UI avanzate come Portainer.
Vedi Opzioni di installazione.
Posso eseguire QuoteNode sul mio laptop per testarlo?
Si. La configurazione Docker Compose funziona su qualsiasi macchina con Docker installato, inclusi Linux, macOS e Windows con Docker Desktop/WSL2. Questo e utile per valutazione, dati demo e training.
Le installazioni su laptop usano solitamente localhost. I link pubblici delle offerte generati da localhost funzionano solo sulla stessa macchina, quindi non sono adatti alla condivisione con clienti esterni.
Posso eseguire QuoteNode per un team aziendale senza esporlo a internet?
Si. Un deployment LAN puo usare un indirizzo IP server, un nome DNS locale o un hostname solo VPN. I link pubblici delle offerte funzioneranno solo per gli utenti che possono raggiungere quell’indirizzo interno. Questo e un buon modello per prove interne e team vendite su rete chiusa.
Vedi Installazione LAN Windows e Installazione LAN Linux.
Qual e il percorso di deployment pubblico piu semplice?
Per l’uso beta pubblico, usa un dominio reale, HTTPS, SMTP e un reverse proxy o una piattaforma di deployment gestita. Il percorso piu friendly per l’operatore e solitamente Coolify con il file di deployment Docker Compose.
Vedi Deployment Coolify e Server WAN Ubuntu.
QuoteNode richiede accesso a internet?
No. QuoteNode puo operare in reti ristrette. Nessuna telemetria, nessun callback di analytics e nessun server di licenze esterno sono richiesti. L’accesso in uscita e necessario solo per i servizi che configuri, come SMTP, storage di backup remoto, fonti FX, download GeoIP o controlli del manifest di rilascio pubblico.
Quale database usa QuoteNode?
PostgreSQL e il motore database supportato. Nella configurazione standard Docker Compose, PostgreSQL gira come container affiancato all’applicazione.
Licenze e prezzi
QuoteNode è davvero gratuito?
L’edizione Free è gratuita per sempre e non richiede carta di credito. Include CRM, workflow offerte, generazione PDF, link pubblici, report, integrazione SMTP e controlli di sicurezza per fino a 3 account utente licenziati. Il limite è il badge “Powered by QuoteNode” sulle pagine pubbliche delle offerte e nei PDF.
Cosa include la licenza Pro?
Pro aumenta il limite degli account utente licenziati e rimuove il badge “Powered by QuoteNode” mentre la licenza a pagamento è attiva o nel periodo di grazia. Il prodotto pubblico a pagamento è solo Pro: 20 EUR/mese fino a 3 account licenziati, 15 EUR/mese per ogni account aggiuntivo o 200 EUR/anno base più 150 EUR/anno per account aggiuntivo.
Posso acquistare una licenza a pagamento?
Il checkout a pagamento non è ancora attivo. Inizia con Free per una valutazione reale e contatta [email protected] se hai bisogno di una licenza Pro anticipata. Quando il checkout self-service sarà attivo, Paddle gestirà pagamenti, fatture, rinnovi, cancellazione e aumenti di account.
Come funziona tecnicamente la licenza?
QuoteNode usa file di licenza firmati Ed25519 e verificati interamente offline. Nessun server di licenza esterno viene contattato a runtime. Le licenze a pagamento non usano chiavi del provider di pagamento dentro l’app installata.
Cosa succede se non rinnovo la licenza?
La normale funzionalità dell’app continua. Dopo il periodo di grazia, il badge “Powered by QuoteNode” ritorna sulle superfici cliente e resta un piccolo promemoria di rinnovo nella UI. Nessun blocco, nessuna modalità sola lettura e nessuna cancellazione dei dati.
Posso passare da Free a Pro più tardi?
Sì. Carica un nuovo file di licenza firmato nella schermata licenza dell’amministrazione. Non servono migrazione dati o reinstallazione.
Offerte e workflow
Quanto tempo serve per creare un’offerta?
La maggior parte delle offerte puo essere creata in pochi minuti una volta che clienti, prodotti e template sono configurati. Seleziona un cliente o un flusso ad audience aperta, aggiungi prodotti dal catalogo, scegli le impostazioni commerciali, rivedi i totali e prepara il link pubblico o il PDF.
I miei clienti possono vedere le offerte senza creare un account?
Si. Ogni offerta inviata puo essere condivisa tramite un link pubblico. Il cliente vede una pagina responsive brandizzata e puo accettare, rispondere o rifiutare senza registrazione.
Perche il mio link offerta pubblico non funziona per un cliente?
Il link deve puntare a un indirizzo che il cliente puo raggiungere. I link generati con localhost funzionano solo sulla stessa macchina. I link LAN funzionano solo all’interno di quella LAN o VPN. Per i clienti esterni, effettua il deploy di QuoteNode dietro un dominio pubblico con HTTPS e assicurati che CORS_ALLOWED_ORIGINS, le impostazioni URL frontend, DNS e le regole firewall corrispondano al vero entrypoint pubblico.
Vedi Risoluzione problemi installazione.
Ho bisogno di SMTP per usare i link pubblici?
No. SMTP e richiesto solo per la consegna email dall’applicazione. Puoi comunque generare un link pubblico o un PDF e condividerlo manualmente tramite un altro canale. I link email inviati dall’applicazione richiedono una configurazione SMTP corretta.
Le offerte sono tracciate?
Si. Il sistema traccia aperture, download, risposte, accettazioni e rifiuti dei link pubblici. A seconda della configurazione, puo anche mostrare attivita a livello di paese tramite GeoIP e notificare il proprietario delle visite di ritorno.
Posso usare QuoteNode per la generazione di lead?
Si. QuoteNode supporta le offerte ad audience aperta: link pubblici non vincolati a un cliente specifico al momento della bozza. I visitatori possono compilare un modulo di richiesta leggero con i dettagli di contatto, creando una notifica di lead per il commerciale.
Posso creare offerte in piu valute?
Si. QuoteNode supporta piu valute e conversione dei tassi di cambio. I report della pipeline possono convertire i valori nella valuta base del workspace per un reporting unificato.
Cosa succede quando un’offerta scade?
Lo stato dell’offerta cambia in Scaduta e il link pubblico mostra un avviso di scadenza. Puoi clonare o rinnovare un’offerta per preparare una nuova versione con un nuovo periodo di validita.
QuoteNode include una deal pipeline?
Si. La deal pipeline e un workflow in stile Kanban per le opportunita, con stage configurabili e link a clienti e documenti. E controllata dalle impostazioni operative del tenant.
QuoteNode include una task board?
Si. La task board aiuta gli utenti a gestire i follow-up e il lavoro collegato ai deal in colonne Kanban. E controllata dalle impostazioni operative del tenant.
Cosa sono gli asset cliente?
Gli asset cliente sono record per equipaggiamento, dispositivi, abbonamenti, prodotti installati o altri articoli di proprieta del cliente che contano per il lavoro di vendita e servizio. Possono archiviare date, stato, eventi di servizio, allegati e promemoria.
Fatture proforma
QuoteNode emette fatture proforma?
QuoteNode include un modulo fattura proforma sperimentale durante la beta. Puo generare un documento proforma dallo snapshot di un’offerta accettata, con termini di pagamento, riferimento pagamento, coordinate bancarie, download PDF e tracciamento dello stato.
Una fattura proforma di QuoteNode e una fattura fiscale?
No. Il modulo proforma e un workflow operativo di richiesta pagamento. Non e software contabile e non sostituisce sistemi di fatturazione fiscale, VAT, fiscale o elettronica. Gli operatori sono responsabili della verifica dei requisiti legali e contabili locali prima di usare documenti proforma generati con i clienti.
Dovrei abilitare le fatture proforma in produzione?
Usa il modulo con cautela durante la beta. Trattalo come sperimentale e verifica il layout generato, la formulazione, la numerazione, le implicazioni fiscali e l’handoff contabile prima di inviarlo ai clienti.
Sicurezza
Come sono protetti i dati cliente sui link pubblici?
I link pubblici usano token crittograficamente casuali. Solo l’hash SHA-256 e memorizzato nel database. I link possono essere protetti da password/PIN, rate-limited, verificati via email per destinatari nominati e revocati in qualsiasi momento. Il rilevamento bot aiuta a prevenire 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 e non puo essere modificato dagli amministratori.
QuoteNode supporta l’autenticazione a due fattori?
Si. L’autenticazione a due fattori basata su TOTP e supportata per gli utenti e puo essere imposta per gli amministratori.
Dati e backup
Come vengono gestiti i backup?
QuoteNode include un backup worker che puo eseguire backup pianificati di database e file. I backup sono archiviati localmente e possono opzionalmente essere caricati su storage remoto tramite rclone.
Cosa devo proteggere in .env?
Proteggi tutti i segreti, specialmente DB_PASSWORD, DB_ENCRYPTION_KEY, TIMING_TOKEN_SECRET e PUBLIC_LINK_PASSWORD_SESSION_SECRET. Se la cifratura a livello applicativo e abilitata, perdere DB_ENCRYPTION_KEY puo rendere i dati cifrati irrecuperabili.
Posso scaricare un backup sul mio computer?
Si. Gli amministratori possono scaricare archivi di backup dall’area admin di backup quando i download di backup sono abilitati.
Posso cifrare i backup?
Si. I backup possono essere cifrati prima dello storage quando le impostazioni GPG sono configurate. Questo e consigliato quando si archiviano backup al di fuori del server.
Come si ripristina da un backup?
Usa la procedura di restore documentata in Backup e ripristino. Testa sempre i restore prima di far affidamento su una policy di backup.
Tecnico
Quale stack tecnologico usa QuoteNode?
Backend: Java 26 con Spring Boot 4. Frontend: Vue 3 con Vite, PrimeVue 4 e Tailwind CSS 4. Database: PostgreSQL. Generazione PDF: Gotenberg/Chromium. Reverse proxy: Caddy o un proxy fornito dall’operatore.
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 additivi.
Posso personalizzare il template PDF dell’offerta?
Si. Il sistema di template supporta layout di documento configurabili, famiglie di template, tabelle prodotto, sezioni di contenuto, variabili, immagini, branding e tipi di documento separati.
Come funziona la generazione del PDF?
Il backend renderizza un documento HTML dallo snapshot dell’offerta o del documento operativo, quindi lo invia a Gotenberg per la conversione in PDF. I PDF generati sono archiviati dall’applicazione e possono essere scaricati dal workflow rilevante.