# Estado Etapa 2 - CRM Portal Visas

## Alcance implementado
Esta etapa completa la operación comercial sobre la base creada en Etapa 1, sin rehacer estructura ni crear una base paralela. El CRM continúa usando la base independiente `ventasin_crm_prod` y consulta usuarios/roles del portal cuando se requiere.

## Módulos fortalecidos
- Agenda comercial: edición, reprogramación, cancelación, completado, calendario mensual, vencidos e historial.
- Visitas, rutas y ubicación: inicio/final de ruta, registro de visita, puntos de ubicación, vista de rutas del día y visitas realizadas.
- Cotizaciones: creación, detalle de ítems, estados, aceptación/rechazo, historial y cierre de oportunidad al aceptar.
- Campañas / Reactivación: creación de campañas, consulta de clientes, gestión de Contact Center, creación de seguimientos y oportunidades desde campaña.
- Importaciones ERP: carga CSV por plantillas, validación básica, historial y errores por fila.
- API ERP: token, endpoints de clientes, contactos, productos, pedidos, facturas, devoluciones, cartera, histórico de compras, asignaciones, health y sync-status.
- Dashboard operativo: KPIs de operación, rutas activas, visitas, clientes sin gestión y campañas.
- Reportes operativos: pipeline por etapa/ejecutivo, cotizaciones, clientes sin gestión, visitas y campañas.
- Configuración CRM: consulta y creación básica de registros de catálogos.

## Archivos principales creados/modificados
Ver `docs/lista_archivos_etapa_2.txt`.

## SQL
- `database/migrations/2026_crm_etapa_2_operacion.sql`
- `database/migrations/2026_crm_etapa_2_rollback.sql`

## API ERP lista
Se agregó `ApiController.php` para soportar rutas tipo:
- `/v1/public/api/crm/auth/token`
- `/v1/public/api/crm/erp/clientes`
- `/v1/public/api/crm/erp/sync-status`
- `/v1/public/api/crm/erp/health`

También se mantienen rutas internas del portal por `crmapi/*` para administración visual.

## Pruebas sugeridas
1. Ejecutar SQL Etapa 2.
2. Abrir Dashboard CRM.
3. Crear actividad en Agenda.
4. Iniciar ruta, registrar visita y finalizar ruta.
5. Crear cotización con ítems y marcarla como aceptada.
6. Crear campaña y gestionar cliente.
7. Cargar CSV de clientes desde Importaciones.
8. Generar token API y probar endpoint health/sync.

## Pendiente para Etapa 3
- Implementar Loomi - Copiloto Comercial Inteligente.
- Score comercial.
- Motor de reglas.
- Recomendaciones transversales y reporte de impacto.