# Ajuste CRM: roles, equipos, agenda y datos de demostración

## Contenido del paquete

El paquete contiene únicamente archivos nuevos o modificados del CRM. No reemplaza el portal completo.

### Funcionalidad incluida

- Alcances por rol y equipo en Dashboard, Clientes, Agenda y Oportunidades.
- Gestión de agenda condicionada por el estado de ruta para Ejecutivo Comercial.
- Próximo responsable limitado al equipo del usuario y usuarios activos con rol Comercial.
- Próxima acción seleccionable desde catálogo.
- Producto buscable desde el catálogo ERP o interés escrito manualmente.
- Recordatorios únicamente del usuario conectado.
- Vencidos y actividades del equipo según liderazgo, rol y usuario consultado.
- Pipeline del Dashboard y Oportunidades con tarjetas resumidas y modal “Ver más”.
- Protección de contactos según el alcance de clientes del usuario.

## Instalación de archivos

1. Haz respaldo del portal actual.
2. Descomprime el ZIP.
3. Copia las carpetas sobre la raíz del portal, conservando exactamente la estructura.
4. Cierra sesión y vuelve a entrar.
5. Recarga con `Ctrl + F5` para tomar las nuevas versiones de CSS y JavaScript.

No se requiere migración de estructura para estos ajustes.

## SQL de demostración

Archivo:

`database/demo/2026_crm_carga_demo_completa.sql`

- Agrega registros identificados con prefijos `DEMO`.
- Usa usuarios activos reales del portal para mantener las relaciones válidas.
- Carga información relacionada en las 55 tablas físicas del CRM.
- Puede volver a ejecutarse: primero retira únicamente la carga DEMO anterior.
- No elimina clientes ni información real.

Antes de ejecutarlo, confirma que las bases se llamen:

- `ventasin_crm_prod`
- `ventasin_portalvi_prod`

Si los nombres del ambiente son diferentes, ajusta las sentencias `USE` y las referencias a la base del portal.

## Limpieza para producción

Archivo:

`database/demo/2026_crm_limpiar_todas_las_tablas_para_produccion.sql`

**Advertencia:** elimina toda la información almacenada en las tablas físicas del CRM. Debe ejecutarse solamente después de un respaldo y cuando se haya autorizado el paso a producción.

El script deja vacíos clientes, oportunidades, contactos, agenda, campañas, cotizaciones, rutas, visitas, integraciones y auditoría. Después vuelve a crear únicamente los catálogos y parámetros mínimos para que el CRM continúe funcional.

## Pruebas recomendadas

1. Ingresar con Sistemas o Comercial y confirmar acceso global.
2. Ingresar con Ejecutivo Comercial sin ruta y verificar modo consulta.
3. Iniciar ruta y validar creación/gestión propia; si es líder, validar gestión del equipo.
4. Finalizar ruta y confirmar bloqueo de acciones durante el resto del día.
5. Ingresar con Contact Center y comprobar gestión propia y consulta del equipo.
6. Validar Dashboard, Clientes y Oportunidades con usuarios líderes y no líderes.
7. Abrir “Ver más” en cada etapa del pipeline y probar filtros y búsqueda.
8. Gestionar una actividad con próxima acción, responsable y producto/interés.