Perguntas frequentes
Geral
O que e o QuoteNode?
O QuoteNode e uma plataforma CRM e de propostas self-hosted para equipas de vendas B2B e B2C. Fornece gestao de clientes, criacao profissional de propostas, geracao de PDF com marca, links publicos rastreaveis e analitica comercial, tudo a correr na tua propria infraestrutura.
Para quem e o QuoteNode?
O QuoteNode foi concebido para freelancers, consultores, pequenas agencias e empresas de media dimensao que criam e enviam propostas aos seus clientes. E particularmente adequado para organizacoes que precisam de propriedade dos dados, documentos para clientes com marca propria e um workflow comercial estruturado.
Em que e que o QuoteNode difere das plataformas CRM SaaS?
O QuoteNode e self-hosted e single-tenant. Os teus dados ficam no teu servidor. Nao existe base de dados partilhada, vendor lock-in, mensalidade recorrente ou dependencia de servicos externos. Tu controlas a infraestrutura, os backups e o perimetro de acesso.
Deploy e infraestrutura
O que preciso para correr o QuoteNode?
Um servidor com Docker Engine 24.0+, 2 GB de RAM (4 GB recomendados) e um SSD com pelo menos 10 GB livres. O QuoteNode e distribuido como contentores Docker e e instalado com Docker Compose.
Posso correr o QuoteNode no meu portatil para avaliacao?
Sim. A configuracao Docker Compose funciona em qualquer maquina com Docker instalado: Linux, macOS ou Windows (WSL2). E assim que a maioria dos utilizadores avalia o QuoteNode antes de o colocar em producao.
O QuoteNode requer acesso a internet?
Nao. O QuoteNode funciona totalmente offline. Sem telemetria, sem callbacks de analytics e sem servidor de licencas externo. As unicas ligacoes de saida sao as que configuras explicitamente (SMTP para envio de email e, opcionalmente, fontes de taxas de cambio).
Posso fazer deploy do QuoteNode atras de uma firewall corporativa?
Sim. O QuoteNode foi concebido para ambientes air-gapped e redes restritas. Nao tem dependencias externas em runtime.
Que base de dados usa o QuoteNode?
PostgreSQL 16 ou superior. E o unico motor de base de dados suportado. A instancia PostgreSQL corre como contentor ao lado da aplicacao.
Licenciamento e precos
O QuoteNode e mesmo gratuito?
A edicao Freelancer e gratuita para sempre e nao requer cartao de credito. Inclui todas as funcionalidades principais — criacao de propostas, geracao de PDF, links publicos, gestao de clientes e analitica — para ate 3 utilizadores. A unica limitacao e o selo “Powered by QuoteNode” nas paginas publicas de propostas e nos PDF.
O que inclui a licenca paga?
As edicoes pagas (Pro, Business, Enterprise) acrescentam limites de utilizadores mais altos, capacidade white-label (remocao do selo “Powered by”), templates avancados, suporte prioritario e garantias SLA. Consulta a pagina de Precos para mais detalhes.
Como funciona tecnicamente o licenciamento?
O QuoteNode usa ficheiros de licenca assinados com Ed25519 e verificados totalmente offline. Nenhum servidor externo e contactado. As licencas pagas sao anuais: se uma licenca expirar, todas as funcionalidades continuam a funcionar normalmente. A unica alteracao e a apresentacao do selo “Powered by QuoteNode” nas superficies voltadas para o cliente e de um pequeno lembrete na interface. Sem bloqueios, sem modo apenas de leitura, sem funcionalidades desativadas.
O que acontece se eu nao renovar a licenca?
Nada deixa de funcionar. A tua instancia continua a correr com funcionalidade total. A taxa anual financia o desenvolvimento continuo; nao e um interruptor de bloqueio. Quando quiseres, renovas para remover o selo. Se num ano precisares de poupar, isso tambem e suportado.
Posso passar de Freelancer para Pro mais tarde?
Sim. Podes fazer upgrade em qualquer altura aplicando um novo ficheiro de licenca. Nao e necessaria migracao de dados nem reinstalacao.
Propostas e workflow
Quanto tempo demora a criar uma proposta?
A maioria das propostas pode ser criada em 2-5 minutos. Selecionas um cliente, adicionas produtos do teu catalogo (com regras automaticas de preco), configuras o template e envias. O sistema trata automaticamente dos calculos de IVA, conversao de moeda e geracao do PDF.
Os meus clientes podem ver propostas sem criar conta?
Sim. Cada proposta pode ser partilhada por link publico. O cliente ve uma pagina responsive totalmente personalizada e pode aceitar, responder ou recusar sem qualquer registo.
As propostas sao rastreadas?
Sim. O sistema regista quando um cliente abre o link publico, descarrega o PDF, responde, aceita ou rejeita. Vez o numero de aberturas, timestamps e o pais do cliente (via GeoIP) diretamente no detalhe da proposta.
Posso criar propostas em varias moedas?
Sim. O QuoteNode suporta varias moedas com conversao automatica de taxas de cambio. Podes definir uma moeda diferente por proposta. Os relatorios de pipeline convertem todos os valores para a tua moeda base para reporting unificado.
O que acontece quando uma proposta expira?
O estado da proposta muda para “Expirada” e o link publico mostra um aviso de expiracao. Podes clonar a proposta expirada com um clique para criar uma nova versao com um novo periodo de validade.
Seguranca
Como sao protegidos os dados do cliente nos links publicos?
Os links publicos usam tokens aleatorios criptograficamente fortes de 256 bits. Apenas o hash SHA-256 e guardado na base de dados. Os links podem ser protegidos por palavra-passe, limitados por taxa e revogados em qualquer momento. A deteccao de bots ajuda a impedir abusos automatizados.
O QuoteNode tem trilho de auditoria?
Sim. Cada mutacao no sistema e registada num log de auditoria append-only: quem alterou o que, quando e a partir de que endereco IP. O log e imutavel: nenhuma entrada pode ser editada ou apagada, nem pelos administradores.
O QuoteNode suporta autenticacao de dois fatores?
Sim. A autenticacao de dois fatores baseada em TOTP e suportada para todos os utilizadores e pode ser imposta aos administradores.
Dados e backups
Como sao geridos os backups?
O QuoteNode inclui um sistema de backup integrado. Um worker dedicado executa uma tarefa agendada (por defeito: diariamente as 2:00) que cria um dump completo da base de dados e arquiva todos os ficheiros carregados e os PDF gerados. Os backups sao armazenados localmente e podem tambem ser enviados para armazenamento remoto via rclone.
Posso descarregar um backup para o meu computador?
Sim. Os administradores podem descarregar os ficheiros de backup diretamente a partir do painel de administracao (Settings > Backup). Basta clicar no botao de download de qualquer backup com sucesso.
Posso cifrar os meus backups?
Sim. Define a variavel de ambiente BACKUP_GPG_RECIPIENT com um ID de chave GPG. Tanto o dump da base de dados como o arquivo de ficheiros serao cifrados antes do armazenamento. Isto e recomendado se guardares backups em cloud storage de terceiros.
Como restauro a partir de um backup?
Usa o script restore.sh incluido no repositorio. Para uma instalacao existente executa ./restore.sh backup-file.tar.gz. Para um servidor novo (disaster recovery) executa ./restore.sh --fresh-install backup-file.tar.gz. O script trata automaticamente do restauro da base de dados, da recuperacao de ficheiros e do arranque da aplicacao. Consulta a wiki Backup e recuperacao para o guia completo.
O que acontece se eu me esquecer de fazer backups?
Se os backups automaticos estiverem ativos (recomendado), o sistema faz backup diariamente sem qualquer acao manual. O painel de administracao mostra um aviso se nao tiver sido registado nenhum backup com sucesso nas ultimas 48 horas. Tambem podes iniciar um backup manual a qualquer momento a partir do painel admin.
Durante quanto tempo os backups sao mantidos?
Por defeito, os 7 backups com sucesso mais recentes sao mantidos localmente. Os ficheiros mais antigos sao apagados automaticamente apos cada backup bem-sucedido. Os backups remotos (enviados via rclone) seguem as politicas de ciclo de vida do teu fornecedor de armazenamento.
Tecnico
Que stack tecnologica usa o QuoteNode?
Backend: Java 25 com Spring Boot 4. Frontend: Vue 3 com Vite, PrimeVue 4 e Tailwind CSS 4. Base de dados: PostgreSQL 16. Geracao de PDF: Gotenberg (baseado em Chromium). Reverse proxy: Caddy 2 com HTTPS automatico.
Como sao geridas as migracoes da base de dados?
O QuoteNode usa Flyway para gestao do schema. As migracoes correm automaticamente no arranque do backend. As migracoes existentes nunca sao modificadas; as alteracoes de schema sao sempre aditivas.
Posso personalizar o template PDF da proposta?
Sim. O sistema de templates suporta colunas configuraveis (SKU, imagens, descricoes, descontos), varios modos de apresentacao de preco (NET/GROSS/desagregacao completa), imagens de produto, condicoes comerciais personalizadas e a marca da tua empresa.
Como funciona a geracao de PDF?
O backend renderiza um documento HTML a partir do snapshot da proposta usando templates Thymeleaf e depois envia-o para o Gotenberg (um contentor baseado em Chromium) para conversao em PDF pronto a imprimir. As propostas pequenas sao geradas de forma sincrona (menos de 3 segundos); as grandes usam processamento assincrono em segundo plano com notificacao quando ficam prontas.