Configuracao

O QuoteNode e configurado atraves de variaveis de ambiente para a infraestrutura e atraves do painel administrativo para as definicoes de negocio.

Variaveis de ambiente

Definicoes principais

• DB_URL - string de ligacao PostgreSQL, por exemplo jdbc:postgresql://postgres:5432/quotenode
• DB_ENCRYPTION_KEY - chave de cifragem da aplicacao para dados sensiveis, incluindo credenciais SMTP cifradas
• TIMING_TOKEN_SECRET - segredo HMAC para protecao com timing tokens
• PUBLIC_LINK_PASSWORD_SESSION_SECRET - segredo de sessao para links publicos protegidos por password
• CORS_ALLOWED_ORIGINS - origens browser autorizadas para acesso a API
• DOMAIN - hostname publico quando usas o proxy Caddy integrado

Email (SMTP)

O QuoteNode suporta dois modelos de configuracao SMTP:

• Preferido para higiene de segredos: configurar SMTP em Settings > Email SMTP depois do primeiro login admin
• Fallback de infraestrutura: configurar o sender Spring predefinido por variaveis de ambiente

Na implementacao atual, as definicoes SMTP do tenant guardadas no painel sao persistidas em tenant_settings, e a password e cifrada antes de ser gravada. Quando essas definicoes existem, o QuoteNode usa-as com prioridade face ao sender baseado em variaveis de ambiente. Se nao existirem, a aplicacao recorre ao sender configurado no ambiente.

Usa variaveis de ambiente quando precisas de email preprovisionado antes do primeiro login, quando geres segredos de forma centralizada fora da aplicacao ou quando queres uma configuracao SMTP imutavel para toda a instancia.

Se mantiveres SMTP no painel administrativo, lembra-te de que a password cifrada continua dependente de DB_ENCRYPTION_KEY para desencriptacao e disaster recovery.

Variaveis SMTP de infraestrutura:

• SMTP_HOST
• SMTP_PORT
• SMTP_USERNAME
• SMTP_PASSWORD
• SMTP_AUTH
• SMTP_STARTTLS

Seguranca

• AUTH_SESSION_IDLE_TIMEOUT_MIN
• SECURITY_MAX_FAILED_LOGINS_SOFT
• SECURITY_MAX_FAILED_LOGINS_TEMP_LOCK
• SECURITY_TEMP_LOCK_MINUTES
• ENCRYPT_PII para cifragem AES-256-GCM de dados pessoais em repouso

Painel administrativo

Depois de iniciares sessao como administrador, vai a Settings para configurar:

Empresa e branding

• nome da empresa
• logo
• cor principal e cor de destaque
• morada, telefone e email da empresa
• dados legais e de registo

Defaults das propostas

• periodo de validade por defeito
• modo de preco por defeito
• moeda por defeito
• termos comerciais pre-preenchidos

Moedas e cambio

• moedas ativas
• origem da taxa FX
• moeda base para reporting

Configuracao de IVA

• grupos de IVA
• grupo de IVA por defeito

Notificacoes

Preferencias por utilizador para:

• canais in-app e email
• frequencia imediata ou resumo diario
• eventos como abertura, aceitacao, rejeicao, resposta, expiracao e PDF pronto

Email SMTP

Os administradores podem configurar SMTP diretamente na aplicacao:

• host, porto, username e password
• nome e email do remetente
• endereco reply-to
• toggles SMTP auth e STARTTLS
• modo sem email
• teste de ligacao antes de guardar

Utilizadores e roles

• Admin
• Manager
• Salesperson
• Viewer

Wizard de onboarding

No primeiro login, o administrador e guiado por um wizard passo a passo que cobre dados da empresa, upload do logo, configuracao SMTP e criacao inicial de utilizadores. O wizard pode ser reaberto a partir do painel de definicoes.