Documentación del Sistema

Appearance

Sistema de Extensiones de Tipos de CRM ​

Modulo: CRM Tipo: Resource Estado: Implementado Fecha: 2026-02-02

Descripcion ​

El sistema de CRM de Sistema Bautista utiliza una arquitectura modular basada en extensiones de tipos. Esta arquitectura permite que diferentes areas de negocio (Ventas, Servicio Tecnico, etc.) tengan registros de CRM con campos especificos para sus necesidades, mientras comparten una estructura base comun.

Arquitectura de Extensiones ​

El sistema se compone de:

  1. Registro Base (CRM Record): Contiene los datos comunes a todos los tipos de CRM:

    • Fecha y hora del registro
    • Contacto asociado
    • Titulo y detalle descriptivo
    • Operador/usuario responsable
    • Estado de cancelacion
    • Relaciones con otros registros
    • Derivaciones entre usuarios

  2. Extension de Tipo (ext_data): Contiene los campos especificos segun el tipo de CRM:

    • Comercial/Ventas: Categorias, estados, prioridades, modelos de interes, derivacion a concesionarias
    • Servicio Tecnico: Accesorios, ubicacion en estanteria (fila/columna)
    • Basico: Sin extension - usa solo campos base

Beneficios del Sistema ​

  • Modularidad: Cada tipo de CRM puede tener sus propios campos sin afectar a otros
  • Reutilizacion: Los componentes base (contactos, derivaciones, relaciones) se comparten
  • Flexibilidad: Se pueden agregar nuevos tipos de CRM sin modificar el nucleo del sistema
  • Migracion: Permite migrar datos de sistemas legacy manteniendo compatibilidad

Tipos de CRM Implementados ​

1. CRM Basico ​

El tipo mas simple, utiliza unicamente los campos del registro base:

  • Sin campos adicionales en ext_data
  • Ideal para registros genericos de seguimiento
  • Permite campos dinamicos configurables por el usuario

Ver: No requiere documentacion adicional - usa solo campos base

2. Extension Comercial (Registro Comercial) ​

Extension especializada para el area comercial con campos para clasificacion de llamadas, seguimiento de intereses en productos y derivacion a concesionarias. Es el tipo de CRM que ejecuta el flujo de licitaciones, pedidos y notas de venta.

⚠️ MANDATORY: El código de tipo interno cambia de industrial → comercial. Ver nota completa en el archivo.

Ver: extension-comercial

3. Extension Servicio Tecnico ​

Extension para el area de servicio tecnico con registro de accesorios y ubicacion fisica en estanterias.

Ver: servicio-tecnico.md

4. Extension Producción (Trazabilidad) ​

Tipo liviano para trazabilidad del proceso de fabricación. Producción carga estados, Ventas/Comercial consulta. Opcional — el módulo Producción funciona sin este tipo.

Ver: extension-produccion

Integracion con Modulo Ventas ​

El CRM permite vincular contactos con clientes del modulo de Ventas, facilitando la conversion de contactos en clientes comerciales.

Ver: cliente.md

Funcionamiento del Sistema ​

Flujo de Creacion de Registro ​

  1. El usuario selecciona el tipo de CRM desde el menu
  2. El sistema carga el formulario base mas los campos especificos del tipo seleccionado
  3. Al guardar, se crea:
    • Un registro en la entidad principal de CRM
    • Un registro en la entidad de extension correspondiente (si aplica)
  4. Ambos registros quedan vinculados por identificador unico

Flujo de Consulta ​

  1. Al consultar registros, el sistema obtiene:
    • Datos del registro base
    • Datos de extension (si el tipo tiene extension)
    • Relaciones cargadas (contacto, operador, motivo cierre, etc.)
  2. Los datos de extension se entregan hidratados con sus descripciones

Migracion de Datos Legacy ​

Para tipos que existian en sistemas anteriores (como Ventas/Llamadas), se proporciona un proceso de migracion que:

  • Transfiere datos historicos al nuevo sistema
  • Mantiene trazabilidad con identificadores originales
  • Preserva relaciones y derivaciones existentes

Consideraciones ​

Consistencia de Datos ​

  • Un registro de CRM puede tener como maximo UNA extension de tipo
  • La extension siempre esta vinculada 1:1 con el registro base
  • Al eliminar un registro base, se elimina su extension asociada

Validaciones ​

  • Los campos requeridos de cada extension se validan al crear/modificar
  • Las referencias a catalogos (categorias, estados, etc.) se validan por existencia
  • La fecha de cancelacion debe ser posterior o igual a la fecha del registro

Permisos ​

Cada tipo de CRM tiene sus propios permisos:

  • Visualizar registros
  • Crear registros
  • Editar registros
  • Eliminar registros

Documentacion Relacionada ​