Preguntas frecuentes

General

Que es QuoteNode?

QuoteNode es una plataforma CRM y de presupuestos self-hosted para equipos de ventas B2B y B2C. Proporciona gestion de clientes, creacion profesional de ofertas, generacion de PDF con marca, enlaces publicos trazables y analitica comercial, todo ello ejecutandose en tu propia infraestructura.

Para quien esta pensado QuoteNode?

QuoteNode esta disenado para freelancers, consultores, pequenas agencias y empresas medianas que crean y envian ofertas a sus clientes. Encaja especialmente bien en organizaciones que necesitan propiedad sobre sus datos, documentos para clientes con su marca y un workflow comercial estructurado.

En que se diferencia QuoteNode de los CRM SaaS?

QuoteNode es self-hosted y single-tenant. Tus datos permanecen en tu servidor. No hay base de datos compartida, ni dependencia del proveedor, ni cuota mensual, ni dependencia de servicios externos. Tu controlas la infraestructura, las copias de seguridad y el perimetro de acceso.

Despliegue e infraestructura

Que necesito para ejecutar QuoteNode?

Un servidor con Docker Engine 24.0+, 2 GB de RAM (4 GB recomendados) y un SSD con al menos 10 GB libres. QuoteNode se distribuye como contenedores Docker y se despliega con Docker Compose.

Puedo ejecutar QuoteNode en mi portatil para probarlo?

Si. La configuracion con Docker Compose funciona en cualquier equipo con Docker instalado: Linux, macOS o Windows (WSL2). Asi es como la mayoria de usuarios evalua QuoteNode antes de desplegarlo en produccion.

QuoteNode necesita acceso a internet?

No. QuoteNode funciona completamente offline. Sin telemetria, sin callbacks de analitica y sin servidor externo de licencias. Las unicas conexiones salientes son las que configuras de forma explicita (SMTP para correo y, opcionalmente, fuentes de tipos de cambio).

Puedo desplegar QuoteNode detras de un firewall corporativo?

Si. QuoteNode esta disenado para entornos air-gapped y redes restringidas. No tiene dependencias externas en tiempo de ejecucion.

Que base de datos usa QuoteNode?

PostgreSQL 16 o superior. Es el unico motor de base de datos soportado. La instancia de PostgreSQL se ejecuta como contenedor junto a la aplicacion.

Licencias y precios

QuoteNode es realmente gratis?

La edicion Freelancer es gratuita para siempre y no requiere tarjeta de credito. Incluye todas las funcionalidades principales — creacion de ofertas, generacion de PDF, enlaces publicos, gestion de clientes y analitica — para hasta 3 usuarios. La unica limitacion es la insignia “Powered by QuoteNode” en las paginas publicas de ofertas y en los PDF.

Que incluye la licencia de pago?

Las ediciones de pago (Pro, Business, Enterprise) anaden limites de usuario mas altos, capacidad white-label (eliminar la insignia “Powered by”), plantillas avanzadas, soporte prioritario y garantias SLA. Consulta la pagina de Precios para mas detalles.

Como funciona tecnicamente la licencia?

QuoteNode utiliza archivos de licencia firmados con Ed25519 y verificados por completo offline. No se contacta ningun servidor externo. Las licencias de pago son anuales: si una licencia expira, todas las funcionalidades siguen funcionando con normalidad. El unico cambio es la aparicion de la insignia “Powered by QuoteNode” en las superficies orientadas al cliente y un pequeno recordatorio en la interfaz. Sin bloqueos, sin modo solo lectura, sin funciones deshabilitadas.

Que ocurre si no renuevo la licencia?

No se rompe nada. Tu instancia sigue funcionando con toda su funcionalidad. La cuota anual financia el desarrollo continuo; no es un interruptor destructivo. Cuando quieras, renuevas para eliminar la insignia. Si un ano necesitas ahorrar, tambien esta contemplado.

Puedo actualizar de Freelancer a Pro mas adelante?

Si. Puedes actualizar en cualquier momento aplicando un nuevo archivo de licencia. No se requiere migracion de datos ni reinstalacion.

Ofertas y workflow

Cuanto se tarda en crear una oferta?

La mayoria de ofertas se pueden crear en 2 a 5 minutos. Seleccionas un cliente, anades productos desde tu catalogo (con reglas de precio automaticas), configuras la plantilla y envias. El sistema se encarga automaticamente del calculo del IVA, la conversion de moneda y la generacion del PDF.

Pueden mis clientes ver ofertas sin crear una cuenta?

Si. Cada oferta puede compartirse mediante un enlace publico. El cliente ve una pagina responsive totalmente personalizada y puede aceptar, responder o rechazar sin registrarse.

Las ofertas se pueden rastrear?

Si. El sistema registra cuando el cliente abre el enlace publico, descarga el PDF, responde, acepta o rechaza. Ves el numero de aperturas, marcas de tiempo y el pais del cliente (via GeoIP) directamente en el detalle de la oferta.

Puedo crear ofertas en varias divisas?

Si. QuoteNode admite multiples monedas con conversion automatica de tipos de cambio. Puedes definir una divisa diferente por oferta. Los informes del pipeline convierten todos los valores a tu moneda base para un reporting unificado.

Que ocurre cuando una oferta caduca?

El estado de la oferta pasa a “Expirada” y el enlace publico muestra un aviso de vencimiento. Puedes clonar la oferta expirada con un clic para crear una nueva version con un nuevo periodo de validez.

Seguridad

Como se protegen los datos del cliente en los enlaces publicos?

Los enlaces publicos usan tokens aleatorios criptograficamente fuertes de 256 bits. Solo se almacena el hash SHA-256 en la base de datos. Los enlaces pueden protegerse con contrasena, limitarse por tasa y revocarse en cualquier momento. La deteccion de bots ayuda a impedir abusos automatizados.

QuoteNode tiene trazabilidad de auditoria?

Si. Cada mutacion del sistema queda registrada en un log de auditoria append-only: quien cambio que, cuando y desde que direccion IP. El log es inmutable: no se puede editar ni borrar ninguna entrada, ni siquiera por parte de administradores.

QuoteNode soporta autenticacion de dos factores?

Si. La autenticacion de dos factores basada en TOTP esta disponible para todos los usuarios y puede imponerse a los administradores.

Datos y copias de seguridad

Como se gestionan las copias de seguridad?

QuoteNode incluye un sistema de backup integrado. Un worker dedicado ejecuta una tarea programada (por defecto: todos los dias a las 2:00) que crea un volcado completo de la base de datos y archiva todos los archivos subidos y los PDF generados. Las copias se guardan localmente y, de forma opcional, se suben a almacenamiento remoto mediante rclone.

Puedo descargar una copia de seguridad a mi ordenador?

Si. Los administradores pueden descargar los archivos de backup directamente desde el panel de administracion (Settings > Backup). Basta con hacer clic en descargar sobre cualquier backup correcto.

Puedo cifrar mis copias de seguridad?

Si. Define la variable de entorno BACKUP_GPG_RECIPIENT con un ID de clave GPG. Tanto el volcado de base de datos como el archivo de ficheros se cifraran antes de almacenarse. Es recomendable si guardas copias en almacenamiento cloud de terceros.

Como restauro desde una copia de seguridad?

Usa el script restore.sh incluido en el repositorio. Para una instalacion existente, ejecuta ./restore.sh backup-file.tar.gz. Para un servidor nuevo (recuperacion ante desastre), ejecuta ./restore.sh --fresh-install backup-file.tar.gz. El script gestiona automaticamente la restauracion de la base de datos, los archivos y el arranque de la aplicacion. Consulta la wiki de Backup y recuperacion para la guia completa.

Que pasa si olvido hacer copias?

Si las copias automaticas estan activadas (recomendado), el sistema realiza el backup cada dia sin ninguna accion manual. El panel de administracion muestra una advertencia si no se ha registrado ninguna copia correcta en las ultimas 48 horas. Tambien puedes lanzar un backup manual en cualquier momento desde la administracion.

Cuanto tiempo se conservan las copias?

Por defecto, se conservan localmente las 7 copias correctas mas recientes. Los archivos antiguos se eliminan automaticamente tras cada backup exitoso. Las copias remotas (subidas via rclone) siguen las politicas de ciclo de vida de tu proveedor de almacenamiento.

Tecnico

Que stack tecnologico usa QuoteNode?

Backend: Java 25 con Spring Boot 4. Frontend: Vue 3 con Vite, PrimeVue 4 y Tailwind CSS 4. Base de datos: PostgreSQL 16. Generacion de PDF: Gotenberg (basado en Chromium). Reverse proxy: Caddy 2 con HTTPS automatico.

Como se gestionan las migraciones de base de datos?

QuoteNode usa Flyway para la gestion del esquema. Las migraciones se ejecutan automaticamente al arrancar el backend. Las migraciones existentes nunca se modifican; los cambios de esquema siempre son aditivos.

Puedo personalizar la plantilla PDF de ofertas?

Si. El sistema de plantillas admite columnas configurables (SKU, imagenes, descripciones, descuentos), varios modos de visualizacion de precios (NET/GROSS/desglose completo), imagenes de producto, condiciones comerciales personalizadas y la marca de tu empresa.

Como funciona la generacion de PDF?

El backend renderiza un documento HTML a partir del snapshot de la oferta usando plantillas Thymeleaf y luego lo envia a Gotenberg (un contenedor basado en Chromium) para convertirlo en un PDF listo para imprimir. Las ofertas pequenas se generan de forma sincronica (menos de 3 segundos); las grandes usan procesamiento asincrono en segundo plano con notificacion cuando estan listas.