#Diseño detallado del sistema CRM 2.0

#1. Descripción general del sistema y filosofía de diseño

#1.1 Posicionamiento del sistema

Este sistema es una Plataforma de gestión de ventas CRM 2.0 construida sobre la plataforma sin código NocoBase. El objetivo central es:

Permitir que el equipo de ventas se concentre en construir relaciones con los clientes, en lugar de en la entrada de datos y el análisis repetitivo.

El sistema automatiza las tareas rutinarias a través de flujos de trabajo y utiliza la IA para asistir en la calificación de clientes potenciales, el análisis de oportunidades y otras tareas, ayudando a los equipos de ventas a mejorar su eficiencia.

#1.2 Filosofía de diseño

#Filosofía 1: Embudo de ventas completo

Proceso de ventas de extremo a extremo:

¿Por qué diseñarlo de esta manera?

#Filosofía 2: Pipeline de ventas configurable

Diferentes industrias pueden personalizar las etapas del pipeline de ventas sin modificar el código.

#Filosofía 3: Diseño modular

• Los módulos principales (Clientes + Oportunidades) son obligatorios; otros módulos pueden activarse según sea necesario.
• La desactivación de módulos no requiere cambios de código; se realiza a través de la configuración de la interfaz de NocoBase.
• Cada módulo se diseña de forma independiente para reducir el acoplamiento.

#2. Arquitectura de módulos y personalización

#2.1 Descripción general de los módulos

El sistema CRM adopta un diseño de arquitectura modular: cada módulo puede activarse o desactivarse de forma independiente según los requisitos del negocio.

#2.2 Dependencias de los módulos

#2.3 Versiones preconfiguradas

#2.4 Mapeo de módulo a colección

#Colecciones de módulos principales (Siempre obligatorias)

#2.5 Cómo desactivar módulos

Simplemente oculte la entrada del menú para el módulo en la interfaz de administración de NocoBase; no es necesario modificar el código ni eliminar colecciones.

#3. Entidades principales y modelo de datos

#3.1 Descripción general de las relaciones entre entidades

#3.2 Detalles de las colecciones principales

#3.2.1 Clientes potenciales (nb_crm_leads)

Gestión de prospectos utilizando un flujo de trabajo simplificado de 4 etapas.

Proceso de etapas:

Nuevo → En proceso → Calificado → Convertido en Cliente/Oportunidad
          ↓            ↓
    No calificado  No calificado

Campos clave:

#3.2.2 Clientes (nb_crm_customers)

Gestión de clientes/empresas con soporte para negocios internacionales.

Campos clave:

#3.2.3 Oportunidades (nb_crm_opportunities)

Gestión de oportunidades de venta con etapas de pipeline configurables.

Campos clave:

#3.2.4 Cotizaciones (nb_crm_quotations)

Gestión de cotizaciones con soporte multimoneda y flujos de aprobación.

Flujo de estados:

Borrador → Pendiente de aprobación → Aprobada → Enviada → Aceptada/Rechazada/Expirada
                    ↓
                Rechazada → Editar → Borrador

Campos clave:

#3.2.5 Pedidos (nb_crm_orders)

Gestión de pedidos incluyendo el seguimiento de pagos.

Campos clave:

#3.3 Resumen de colecciones

#Colecciones de negocio CRM

#Colecciones de datos base (Módulos comunes)

#3.4 Colecciones auxiliares

#3.4.1 Comentarios (nb_crm_comments)

Colección genérica de comentarios/notas que puede asociarse con varios objetos de negocio.

#3.4.2 Uso compartido de clientes (nb_crm_customer_shares)

Permite la colaboración de varias personas y el uso compartido de permisos para los clientes.

#3.4.3 Colaboradores de oportunidad (nb_crm_opportunity_users)

Soporta la colaboración del equipo de ventas en las oportunidades.

#3.4.4 Regiones (nb_cbo_regions)

Diccionario de datos base de países/regiones.

#4. Ciclo de vida del cliente potencial

La gestión de prospectos utiliza un flujo de trabajo simplificado de 4 etapas. Cuando se crea un nuevo prospecto, un flujo de trabajo puede activar automáticamente la puntuación por IA para ayudar a las ventas a identificar rápidamente prospectos de alta calidad.

#4.1 Definiciones de estado

#4.2 Diagrama de flujo de estados

#4.3 Proceso de conversión de prospectos

La interfaz de conversión ofrece tres opciones simultáneamente; el usuario puede elegir crear o asociar:

• Cliente: Crear un nuevo cliente O asociar con uno existente.
• Contacto: Crear un nuevo contacto (asociado al cliente).
• Oportunidad: Se debe crear una oportunidad.

Registros post-conversión:

• converted_customer_id: ID del cliente asociado.
• converted_contact_id: ID del contacto asociado.
• converted_opportunity_id: ID de la oportunidad creada.

#5. Ciclo de vida de la oportunidad

La gestión de oportunidades utiliza etapas de pipeline de ventas configurables. Cuando cambia la etapa de una oportunidad, se puede activar automáticamente la predicción de probabilidad de éxito por IA para ayudar a identificar riesgos y oportunidades.

#5.1 Etapas configurables

Las etapas se almacenan en la colección nb_crm_opportunity_stages y pueden personalizarse:

#5.2 Flujo del pipeline

#5.3 Detección de estancamiento

Las oportunidades sin actividad serán marcadas:

-- Calcular días de estancamiento
UPDATE nb_crm_opportunities
SET stagnant_days = EXTRACT(DAY FROM NOW() - last_activity_at)
WHERE stage NOT IN ('won', 'lost');

#5.4 Manejo de Ganadas/Perdidas

Cuando se gana:

1. Actualizar etapa a 'won'.
2. Registrar la fecha de cierre real.
3. Actualizar el estado del cliente a 'active'.
4. Activar la creación del pedido (si se aceptó una cotización).

Cuando se pierde:

1. Actualizar etapa a 'lost'.
2. Registrar el motivo de la pérdida.
3. Registrar el ID del competidor (si se perdió ante uno).
4. Notificar al gerente.

#6. Ciclo de vida de la cotización

#6.1 Definiciones de estado

#6.2 Reglas de aprobación (Por finalizar)

Los flujos de trabajo de aprobación se activan según las siguientes condiciones:

#6.3 Soporte multimoneda

#Filosofía de diseño

Utilice el USD como moneda base unificada para todos los informes y análisis. Cada registro de monto almacena:

• Moneda y monto originales (lo que ve el cliente).
• Tipo de cambio en el momento de la transacción.
• Monto equivalente en USD (para comparación interna).

#Diccionario de monedas (nb_cbo_currencies)

La configuración de monedas utiliza una colección de datos base común, permitiendo una gestión dinámica. El campo current_rate almacena el tipo de cambio actual, actualizado por una tarea programada desde el registro más reciente en nb_crm_exchange_rates.

#Historial de tipos de cambio (nb_crm_exchange_rates)

Registra datos históricos de tipos de cambio. Una tarea programada sincroniza las tasas más recientes con nb_cbo_currencies.current_rate.

Nota: Las cotizaciones se asocian con la colección nb_cbo_currencies a través de la clave foránea currency_id, y el tipo de cambio se obtiene directamente del campo current_rate. Las oportunidades y pedidos utilizan un campo VARCHAR currency para almacenar el código de la moneda.

#Patrón de campos de monto

Las colecciones que contienen montos siguen este patrón:

Aplicado a:

• nb_crm_opportunities.amount → amount_usd
• nb_crm_quotations.total_amount → total_amount_usd

#Integración de flujo de trabajo

Lógica de obtención del tipo de cambio:

1. Obtener el tipo de cambio directamente de nb_cbo_currencies.current_rate durante las operaciones de negocio.
2. Transacciones en USD: Tasa = 1.0, no se requiere búsqueda.
3. current_rate es sincronizado por una tarea programada desde el último registro de nb_crm_exchange_rates.

#6.4 Gestión de versiones

Cuando una cotización es rechazada o expira, puede duplicarse como una nueva versión:

QT-20260119-001 v1 → Rechazada
QT-20260119-001 v2 → Enviada
QT-20260119-001 v3 → Aceptada

#7. Ciclo de vida del pedido

#7.1 Descripción general del pedido

Los pedidos se crean cuando se acepta una cotización, representando un compromiso de negocio confirmado.

#7.2 Definiciones de estado del pedido

#7.3 Modelo de datos del pedido

#nb_crm_orders

#nb_crm_order_items

#7.4 Seguimiento de pagos

#nb_crm_payments

#8. Ciclo de vida del cliente

#8.1 Descripción general del cliente

Los clientes se crean durante la conversión de prospectos o cuando se gana una oportunidad. El sistema rastrea el ciclo de vida completo, desde la adquisición hasta la promoción.

#8.2 Definiciones de estado del cliente

#8.3 Puntuación de salud del cliente

La salud del cliente se calcula en función de múltiples factores:

Umbrales de salud:

if (health_score >= 90) status = 'advocate';
else if (health_score >= 70) status = 'active';
else if (health_score >= 50) status = 'growing';
else status = 'at_risk';

#8.4 Segmentación de clientes

#Segmentación automatizada

#9. Integración de correo electrónico

#9.1 Descripción general

NocoBase proporciona un plugin de integración de correo electrónico integrado que soporta Gmail y Outlook. Una vez sincronizados los correos, los flujos de trabajo pueden activar automáticamente el análisis de IA sobre el sentimiento y la intención del correo, ayudando a las ventas a comprender rápidamente la actitud del cliente.

#9.2 Sincronización de correo

Proveedores soportados:

• Gmail (vía OAuth 2.0)
• Outlook/Microsoft 365 (vía OAuth 2.0)

Comportamiento de sincronización:

• Sincronización bidireccional de correos enviados y recibidos.
• Asociación automática de correos con registros de CRM (Prospectos, Contactos, Oportunidades).
• Archivos adjuntos almacenados en el sistema de archivos de NocoBase.

#9.3 Asociación Correo-CRM (Por finalizar)

#9.4 Plantillas de correo

El equipo de ventas puede utilizar plantillas preestablecidas:

#10. Capacidades asistidas por IA

#10.1 Equipo de empleados de IA

El sistema CRM integra el plugin de IA de NocoBase, utilizando los siguientes empleados de IA integrados configurados con tareas específicas de CRM:

#10.2 Lista de tareas de IA

Las capacidades de IA se dividen en dos categorías independientes:

#I. Empleados de IA (Activados por bloques en el frontend)

Los usuarios interactúan directamente con la IA a través de bloques de Empleados de IA en el frontend para obtener análisis y sugerencias.

#II. Nodos LLM de flujo de trabajo (Ejecución automatizada en el backend)

Nodos LLM anidados dentro de flujos de trabajo, activados automáticamente por eventos de colección, eventos de acción o tareas programadas, independientemente de los Empleados de IA.

Nota: Los nodos LLM de flujo de trabajo utilizan prompts y salida de Schema para JSON estructurado, que se analiza y escribe en los campos de datos de negocio sin intervención del usuario.

#10.3 Campos de IA en la base de datos

#11. Motor de flujo de trabajo

#11.1 Flujos de trabajo implementados

#11.2 Flujos de trabajo por implementar

#12. Diseño de menús e interfaz

#12.1 Estructura de administración

#12.2 Vistas de los paneles de control

#Vista del gerente de ventas

#Vista del representante de ventas

#Vista ejecutiva

Versión del documento: v2.0 | Actualizado: 06-02-2026