Configuracion

QuoteNode se configura mediante variables de entorno para la infraestructura y mediante el panel administrativo para los ajustes del negocio.

Variables de entorno

Ajustes principales

• DB_URL - cadena de conexion de PostgreSQL, por ejemplo jdbc:postgresql://postgres:5432/quotenode
• DB_ENCRYPTION_KEY - clave de cifrado de la aplicacion usada para datos sensibles, incluidas las credenciales SMTP cifradas guardadas en la configuracion del tenant
• TIMING_TOKEN_SECRET - secreto HMAC para la proteccion con timing tokens
• PUBLIC_LINK_PASSWORD_SESSION_SECRET - secreto de sesion para enlaces publicos protegidos por contrasena
• CORS_ALLOWED_ORIGINS - origenes de navegador permitidos para acceder a la API
• DOMAIN - nombre de host publico cuando se usa el proxy Caddy integrado

Correo (SMTP)

QuoteNode soporta dos modelos de configuracion SMTP:

• Preferido para la higiene de secretos: configurar SMTP en Settings > Email SMTP despues del primer inicio de sesion de administrador.
• Fallback de infraestructura: configurar el remitente Spring Mail por defecto mediante variables de entorno.

En la implementacion actual del backend, la configuracion SMTP del tenant introducida en el panel administrativo se guarda en tenant_settings, y la contrasena se cifra antes de persistirse. Cuando existen ajustes SMTP del tenant, QuoteNode los usa con preferencia frente al remitente definido por variables de entorno. Si el SMTP del tenant no esta configurado, la aplicacion recurre al remitente basado en variables de entorno.

Usa variables de entorno cuando necesites un correo completamente preaprovisionado antes del primer login, cuando gestiones secretos de forma centralizada fuera de la aplicacion o cuando quieras una unica configuracion SMTP inmutable para toda la instancia.

Si mantienes SMTP en el panel administrativo, recuerda que la contrasena cifrada sigue dependiendo de DB_ENCRYPTION_KEY para el descifrado y la recuperacion ante desastres.

Variables SMTP a nivel de infraestructura:

• SMTP_HOST - nombre del servidor SMTP
• SMTP_PORT - puerto SMTP, normalmente 587 para TLS
• SMTP_USERNAME - usuario de autenticacion SMTP
• SMTP_PASSWORD - contrasena de autenticacion SMTP
• SMTP_AUTH - activa la autenticacion SMTP (true / false)
• SMTP_STARTTLS - activa STARTTLS (true / false)

Seguridad

• AUTH_SESSION_IDLE_TIMEOUT_MIN - tiempo de inactividad de sesion en minutos
• SECURITY_MAX_FAILED_LOGINS_SOFT - umbral de intentos fallidos antes de la defensa progresiva suave
• SECURITY_MAX_FAILED_LOGINS_TEMP_LOCK - umbral de intentos fallidos antes del bloqueo temporal
• SECURITY_TEMP_LOCK_MINUTES - duracion del bloqueo temporal
• ENCRYPT_PII - activa el cifrado AES-256-GCM a nivel de columna para datos personales en la base de datos (true / false, por defecto false). Cuando esta activado, nombres, correos, telefonos y NIF/NIP de clientes quedan cifrados en reposo. Requiere DB_ENCRYPTION_KEY. Consulta Security para mas detalles y trade-offs.

Panel administrativo

Una vez iniciada la sesion como administrador, ve a Settings para configurar:

Empresa y branding

• Company name - se muestra en ofertas, PDF y correos
• Logo - PNG o SVG usado en cabeceras de oferta, PDF y pagina publica de la oferta
• Primary color y accent color - aplicados a ofertas, PDF y pagina publica
• Company address, phone, email - visibles en pies de oferta y condiciones comerciales
• Registration details - NIP, KRS, tribunal de registro, mostrados en el pie del PDF

Valores por defecto de ofertas

• Default validity period - cuantos dias son validas las nuevas ofertas, por defecto 30
• Default price mode - NET, GROSS o NET+VAT+GROSS
• Default currency - moneda base para nuevas ofertas
• Trading terms - condiciones de pago, garantia y entrega, rellenadas por defecto en cada nueva oferta

Monedas y tipos de cambio

• Enabled currencies - monedas disponibles para ofertas
• FX rate source - entrada manual o automatica, con integracion NBP/ECB planificada
• Base currency - usada para reportes de pipeline y conversion multimoneda

Configuracion de IVA

• VAT groups - define los tipos de IVA disponibles, por ejemplo 23%, 8%, 5%, 0% o exento
• Default VAT group - aplicado a nuevos productos y lineas personalizadas

Notificaciones

Preferencias por usuario para cada tipo de evento:

• Canales: in-app, email o ambos
• Frecuencia: inmediata, resumen diario o desactivada
• Eventos: oferta abierta, aceptada, rechazada, respondida, a punto de vencer o PDF listo

Email SMTP

Los administradores pueden configurar SMTP directamente en la aplicacion:

• Host, port, username, and password
• Sender name and sender email
• Reply-to address
• SMTP auth / STARTTLS toggles
• Work without email para equipos que envian mensajes fuera de QuoteNode
• Connection test antes de guardar

Si ya hay una contrasena almacenada, la interfaz la mantiene enmascarada y permite sustituirla o borrarla de forma explicita.

Usuarios y roles

• Admin - acceso total a todos los ajustes y datos
• Manager - puede ver todas las ofertas y reportes, y gestionar el equipo
• Salesperson - puede gestionar sus propios clientes y ofertas
• Viewer - acceso de solo lectura a los datos asignados

Asistente de onboarding

En el primer inicio de sesion, el administrador es guiado por un asistente paso a paso que cubre datos de empresa, subida del logo, configuracion SMTP y creacion inicial de usuarios. Se puede volver a abrir desde el panel de ajustes.