Instalação

O QuoteNode funciona como contentores Docker. Numa implementação normal não precisas de instalar Java, Node.js, PostgreSQL nem Gotenberg no anfitrião. A decisão principal é de onde a aplicação ficará acessível: apenas do teu portátil, da rede do escritório (LAN) ou da internet pública.

Cada guia instala um pacote de versão: um ficheiro Compose que executa as imagens testadas da versão, fixadas por digest. Nada é compilado na tua máquina, e cada instalação de uma versão usa as mesmas imagens. As imagens das versões são construídas para anfitriões x86 de 64 bits (linux/amd64).

Escolhe o modo de implementação

Topologia	Endereço	Ligações públicas de propostas	Ligações nos e-mails	HTTPS	Utilização prevista
Portátil/local	http://localhost	apenas na mesma máquina	inúteis para clientes externos	não	teste/demonstração
Windows na LAN	http://<ip-do-pc> ou DNS local	apenas clientes da LAN	apenas destinatários internos	opcional/interno	teste no escritório
Servidor Linux na LAN	http://<ip-do-servidor> ou DNS local	apenas clientes LAN/VPN	internas, salvo se acessíveis	opcional/interno	equipa comercial interna
Servidor público Ubuntu (VPS)	domínio público + HTTPS	funcionam para os clientes	funcionam com SMTP e domínio configurados	obrigatório	produção beta
Portainer/QNAP/NAS	interface Docker própria do anfitrião	depende de encaminhamento/NAT/domínio	depende de encaminhamento/SMTP	obrigatório para ligações de clientes	utilização avançada doméstica/PME
Coolify	domínio público + proxy gerido	funcionam para os clientes	funcionam com SMTP e domínio configurados	gerido pelo Coolify	a implementação pública mais simples

Guias de instalação

• Portátil local — avaliação rápida numa só máquina.
• Servidor Windows na LAN — Docker Desktop num PC acessível na rede do escritório.
• Servidor Linux na LAN — Docker Engine num servidor interno ou numa VM.
• Servidor público Ubuntu — domínio público, HTTPS, SMTP, cópias de segurança e noções de firewall.
• Coolify — pacote de versão num recurso Docker Compose do Coolify, atrás do seu proxy.
• Portainer, QNAP ou NAS — indicações avançadas para plataformas com interface Docker.
• Atualizar o QuoteNode — passar ao pacote de versão seguinte e reverter em segurança.

Referências comuns

• Variáveis de ambiente da implementação — variáveis mínimas para os guias de instalação.
• Resolução de problemas de instalação — problemas comuns com ligações, CORS, SMTP, DNS e perda de segredos.
• Referência de variáveis de ambiente — catálogo completo de variáveis.
• Cópias de segurança e recuperação — estratégia de cópias de segurança e restauro.
• Opções de implementação — visão geral ao nível da arquitetura.

Antes de publicar ligações

O QuoteNode gera ligações públicas de propostas, ligações para as preferências de notificação e e-mails. Estas ligações só funcionam para destinatários que conseguem aceder ao mesmo endereço que o navegador utiliza.

• Uma ligação gerada em http://localhost só funciona na mesma máquina.
• Uma ligação gerada em http://192.168.x.x só funciona para pessoas nessa LAN ou VPN.
• Uma ligação gerada em https://crm.example.com só funciona publicamente com DNS, HTTPS, encaminhamento do proxy e firewall corretamente configurados.
• O envio de e-mails exige SMTP. A transferência manual do PDF e a partilha manual de uma ligação pública não.

Recursos mínimos

Implementação	RAM	CPU	Disco
Avaliação / utilização individual	2 GB	1 núcleo	10 GB SSD
Equipa pequena	4 GB	2 núcleos	20 GB SSD
Ambiente beta mais amplo	8 GB	4 núcleos	50 GB SSD

São valores iniciais prudentes. Catálogos grandes, geração frequente de PDF, muitas cópias de segurança e imagens de produtos aumentam as necessidades de disco e memória.

Os limites dos contentores, o ajuste de RAM/CPU e como evitar a falta de memória estão descritos em Recursos do sistema.