Opcoes de deployment

O QuoteNode suporta varios modelos de deployment, todos baseados em contentores Docker. Escolhe a topologia decidindo quem precisa de abrir a aplicacao e os links publicos de propostas.

Caminhos recomendados

Cenario	Guia recomendado
Avaliacao num computador	Portatil local
Teste interno em Windows	Servidor LAN Windows
Servidor Linux interno	Servidor LAN Linux
Beta publica no teu VPS	Servidor publico Ubuntu
Beta publica com proxy/UI de deploy geridos	Coolify
Plataforma Docker UI/NAS existente	Portainer, QNAP ou NAS

A pagina curta de escolha e o Guia de instalacao. Usa Troubleshooting de instalacao para problemas de URL, CORS, DNS, SMTP e perda de segredos.

Topologia de producao

Um deployment publico normalmente tem esta forma:

Internet
  │
  ▼
Reverse proxy HTTPS publico
  └── servico frontend
        ├── aplicacao Vue estatica
        └── rotas /api e /offer para backend

Backend -> PostgreSQL
Backend -> Gotenberg para geracao PDF
Backup worker -> PostgreSQL e ficheiros persistentes

O Coolify fornece o reverse proxy HTTPS publico. O stack Docker Compose standard de producao tambem pode correr o seu proprio proxy Caddy interno.

Servicos

Contentor	Objetivo
frontend	Serve a aplicacao Vue e encaminha trafego do browser.
backend	API Java / Spring Boot, logica de negocio, links publicos e orquestracao PDF.
postgres	Base de dados PostgreSQL.
gotenberg	Servico de conversao HTML para PDF.
backup-worker	Backups agendados de base de dados e ficheiros.

Dados persistentes

Dado	Porque importa
Volume PostgreSQL	Base de dados principal.
Volume uploads	Imagens de produto, logotipos e anexos CRM.
Volume PDF	Documentos PDF gerados.
Volume backup	Arquivos locais antes de copia offsite.
Volume GeoIP	Base MaxMind opcional.

Faz backup de .env separadamente dos volumes Docker. A DB_ENCRYPTION_KEY em .env e necessaria para decifrar campos sensiveis.

Metadados de release e verificacoes de atualizacao

O QuoteNode pode mostrar um aviso apenas a administradores quando existe uma release upstream mais recente.

• Manifesto publico: https://quotenode.dev/releases/latest.json
• Flag frontend: VITE_RELEASE_CHECK_ENABLED
• URL override frontend: VITE_RELEASE_MANIFEST_URL

Isto e separado da verificacao de reload frontend por instalacao:

• /app-version.json responde: “esta instalacao fez deploy de um bundle frontend mais recente”.
• releases/latest.json responde: “existe uma release QuoteNode upstream mais recente”.

Deploys offline ou privados podem desativar a verificacao upstream ou aponta-la para um mirror interno.

Variaveis de ambiente

Para variaveis focadas em instalacao, consulta Variaveis de ambiente de deployment. Para o catalogo completo, consulta Referencia de variaveis de ambiente.

Notas de seguranca

• Deploys publicos exigem HTTPS.
• CORS_ALLOWED_ORIGINS deve corresponder exatamente a origem do browser.
• LICENSE_SKIP_SIGNATURE_CHECK deve estar ausente ou false em deployments reais.
• Nao exponhas PostgreSQL, Gotenberg ou backup-worker publicamente.
• Reverse proxies devem preservar headers de IP cliente para logs de seguranca e protecoes de links publicos.