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 18 ou superior. E o unico motor de base de dados suportado. A instancia PostgreSQL corre como contentor ao lado da aplicacao.

Licenciamento e preços

QuoteNode é mesmo gratuito?

A edição Free é gratuita para sempre e não requer cartão de crédito. Inclui CRM, workflow de propostas, geração de PDF, links públicos, relatórios, integração SMTP e controlos de segurança para até 3 contas de utilizador licenciadas. A limitação é o badge “Powered by QuoteNode” nas páginas públicas de propostas e nos PDFs.

O que inclui a licença Pro?

Pro aumenta o limite de contas de utilizador licenciadas e remove o badge “Powered by QuoteNode” enquanto a licença paga está ativa ou em período de graça. O produto pago público é apenas Pro: 20 EUR/mês até 3 contas licenciadas, 15 EUR/mês por cada conta adicional ou 200 EUR/ano base mais 150 EUR/ano por conta adicional.

Posso comprar uma licença paga?

O checkout pago ainda não está ativo. Começa com Free para uma avaliação real e contacta [email protected] se precisares de uma licença Pro antecipada. Quando o checkout self-service estiver ativo, a Paddle tratará de pagamentos, faturas, renovações, cancelamento e aumentos de contas.

Como funciona tecnicamente a licença?

QuoteNode usa ficheiros de licença assinados com Ed25519 e verificados totalmente offline. Nenhum servidor externo de licenças é contactado em runtime. As licenças pagas não usam chaves do fornecedor de pagamentos dentro da app instalada.

O que acontece se eu não renovar a licença?

A funcionalidade normal da app continua. Depois do período de graça, o badge “Powered by QuoteNode” volta nas superfícies de cliente e fica um pequeno lembrete de renovação na UI. Sem bloqueios, sem modo só de leitura e sem eliminação de dados.

Posso passar de Free para Pro mais tarde?

Sim. Carrega um novo ficheiro de licença assinado no ecrã de licença da administração. Não é necessária migração de dados nem reinstalação.

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 usar o QuoteNode para geração de leads?

Sim. O QuoteNode suporta ofertas abertas — links públicos não vinculados a um cliente específico. Podes partilhá-los no teu website, nas redes sociais ou em materiais impressos. Quando um visitante está interessado, preenche um breve formulário de pedido de informação (email, telefone, opcionalmente nome da empresa e mensagem). Cada pedido gera uma notificação de lead para o comercial. O visitante não precisa de criar uma conta nem de se registar.

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.

Faturas proforma

O QuoteNode pode gerar faturas proforma?

Sim, durante a beta o QuoteNode inclui um modulo experimental de proforma para criar pedidos formais de pagamento a partir de snapshots de propostas aceites. Usa-o como documento operacional, nao como substituto de software contabilistico, fiscal ou de faturacao legal.

Posso usar uma proforma como fatura fiscal?

Nao assumas isso. Regras fiscais, numeracao, IVA e arquivo variam por jurisdicao. O operador da instalacao deve validar os requisitos locais antes de usar documentos gerados em processos externos.

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. Os backups são cifrados por omissão com age. O par de chaves é gerado durante a configuração inicial e o kit de recuperação contém a identidade privada necessária para desencriptação. Isto é recomendado se guardares backups em cloud storage de terceiros. Consulta o guia Backup e Recuperação para mais detalhes.

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 18. 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.