# Instalación — ajustes finales CRM por módulos y mockups

## Alcance

Este paquete contiene únicamente archivos nuevos o modificados del CRM. No contiene el portal completo ni reemplaza módulos ajenos al CRM.

## Respaldos obligatorios

Antes de instalar:

1. Respaldar los archivos actuales del portal.
2. Respaldar la base `ventasin_crm_prod`.
3. Respaldar la base `ventasin_portalvi_prod`, porque la migración retira del menú las opciones independientes **Contactos** y **Cotizaciones**, conservando sus tablas y controladores para uso interno del CRM.

## Orden de instalación

1. Descomprimir el ZIP.
2. Copiar su contenido sobre la raíz del portal respetando exactamente la estructura de carpetas.
3. En phpMyAdmin, seleccionar la base `ventasin_crm_prod`.
4. Ejecutar:

   `database/migrations/2026_crm_ajustes_finales_mockups.sql`

5. Ejecutar para comprobar la instalación:

   `database/migrations/2026_crm_ajustes_finales_mockups_verificacion.sql`

6. Cerrar sesión en el portal y volver a ingresar para regenerar el menú y permisos en sesión.
7. Recargar el navegador con `Ctrl + F5` para evitar archivos JavaScript o CSS almacenados en caché.

## Validaciones funcionales recomendadas

### Dashboard CRM

- Entrar, cambiar a otro módulo y volver.
- Confirmar que las listas de Ejecutivo y Segmento vuelvan a cargar.
- Confirmar que Ejecutivo solo muestre usuarios activos de los roles Ejecutivo, Contact Center y Comercial.
- Confirmar que Desempeño del equipo solo muestre Ejecutivos y Contact Center activos.

### Clientes y Vista 360

- Buscar un cliente por su nombre exacto.
- Filtrar por ciudad, estado, segmento y responsable.
- Confirmar que las alertas comerciales aparezcan en Clientes.
- Crear un prospecto sin NIT usando teléfono o correo.
- Agregar una o varias sucursales.
- Probar Ver y Editar en Vista 360.
- Confirmar que Editar solo aparezca a roles Sistemas o Comercial.

### Oportunidades

- Revisar indicadores superiores y tablero Kanban.
- Crear una oportunidad buscando cliente y productos dentro de los selectores.
- Seleccionar varios productos adicionales.
- Seleccionar una próxima acción.
- Mover etapas y validar reglas del pipeline.
- En Cotización, cargar el PDF y continuar a Negociación.

### Agenda comercial

- Confirmar que el calendario muestre el mes actual sin deformarse.
- Probar el ciclo diario: Iniciar ruta → Nueva actividad/Finalizar ruta → Ruta finalizada.
- Confirmar que el estado permanezca correcto al recargar o cambiar de módulo.
- Probar el control deslizante para finalizar ruta.
- Confirmar que Gestionar sustituya a Completar.
- Con rol Sistemas o Comercial, revisar Actividades programadas del equipo.

### Visitas y rutas

- Registrar inicio de ruta con ubicación.
- Registrar visita programada y no programada.
- Adjuntar fotografía de fachada.
- Registrar puntos y finalizar ruta.
- Revisar indicadores, mapa, trayecto y detalle de resultados.

### Campañas

- Revisar la distribución a ancho completo.
- Crear campaña y asignar clientes.
- Registrar gestión, seguimiento y oportunidad enlazada.

### Reportes

- Aplicar filtros.
- Confirmar tabla y gráfico.
- Probar exportación.

### Configuración CRM

- Crear, editar e inactivar/eliminar lógicamente una configuración.
- Confirmar que valores ya usados no destruyan historial.

## Nota sobre permisos SQL

La última sección de la migración modifica opciones de menú en `ventasin_portalvi_prod`. Si el usuario de phpMyAdmin no tiene permisos sobre esa base, ejecutar esa sección con un usuario autorizado. La información de Contactos y Cotizaciones no se elimina: únicamente dejan de mostrarse como módulos independientes.

## Reversión

El archivo `2026_crm_ajustes_finales_mockups_rollback.sql` realiza una reversión conservadora de las estructuras nuevas del cierre. No vuelve a crear automáticamente las opciones de menú retiradas, porque sus identificadores y permisos deben conservar la configuración particular de cada ambiente. Restaurarlas desde el respaldo de `ventasin_portalvi_prod` si fuera necesario.