# Instalación CRM Etapa 1 - ZIP liviano de cambios

## Importante

Este paquete NO contiene todo el portal. Solo contiene archivos nuevos o modificados de la Etapa 1.

Debes copiar el contenido del ZIP encima del portal actual, respetando las carpetas.

## Antes de instalar

1. Hacer backup completo del portal actual.
2. Hacer backup de la base `ventasin_portalvi_prod`.
3. Confirmar que el usuario MySQL del portal pueda crear o usar la base `ventasin_crm_prod`.

## Instalación

1. Descomprimir el ZIP de cambios.
2. Copiar las carpetas sobre la raíz del portal:

```text
app/
core/
public/
database/
docs/
storage/
```

3. Ejecutar SQL:

```text
database/migrations/2026_crm_etapa_1_base.sql
```

4. Cerrar sesión y volver a iniciar sesión.

5. Validar menú:

```text
Comercial > CRM
```

6. Probar:

```text
crmdashboard/index
crmclientes/index
crmcontactos/index
crmoportunidades/index
crmagenda/index
crmapi/health
```

## Si la base CRM usa otro usuario

`core/DatabaseCrm.php` usa por defecto la misma conexión del portal, pero con base `ventasin_crm_prod`.

Si necesitas credenciales diferentes, agrega en `config.php` estas constantes antes del autocargador:

```php
define('DB_CRM_HOST', DB_HOST);
define('DB_CRM_PORT', DB_PORT);
define('DB_CRM_NAME', 'ventasin_crm_prod');
define('DB_CRM_USER', DB_USER);
define('DB_CRM_PASS', DB_PASS);
define('DB_CRM_CHARSET', 'utf8mb4');
```

No es obligatorio si usas el mismo usuario del portal.

## Rollback

El rollback de menú está en:

```text
database/migrations/2026_crm_etapa_1_rollback.sql
```

No elimina la base CRM automáticamente para proteger datos.