# Prototipo de ejecución — BUG-007 OTP por WhatsApp falla en desarrollo por verificación TLS de cURL

- **Rama:** p-bugfix/otp-whatsapp-ssl-desarrollo
- **Rama base:** feature/desacoplar-contructor-pagos
- **Plan:** docs/bugfix/007-otp-whatsapp-ssl-desarrollo/plan.md
- **Fecha:** 2026-10-28
- **Estado:** consolidado

## Resumen

Se ajustó `Paso0::enviarWhatsappOtp()` para desactivar la verificación TLS de cURL únicamente cuando `ENVIRONMENT` es `development` o `testing`, replicando el criterio ya usado por `GoHighLevelClient`. En `production` la verificación TLS permanece activa. El payload, template, credenciales, mensajes de usuario, rutas y reglas de negocio no se modificaron. Falta la verificación manual de los flujos reales con credenciales y número de prueba de Meta, que no puede ejecutar el agente.

## Tareas realizadas

- [x] Localizar y leer el plan `docs/bugfix/007-otp-whatsapp-ssl-desarrollo/plan.md` y validar que es un bugfix con causa raíz confirmada.
- [x] Crear la rama local `p-bugfix/otp-whatsapp-ssl-desarrollo` desde `feature/desacoplar-contructor-pagos`.
- [x] Agregar en `Paso0::enviarWhatsappOtp()` la guarda de entorno que desactiva `CURLOPT_SSL_VERIFYPEER` y `CURLOPT_SSL_VERIFYHOST` solo para `development`/`testing`, antes de `curl_exec()`.
- [x] Confirmar por inspección que los tres puntos de entrada (`consultarCedula`, `solicitarOtpNuevo`, `reenviarOtp`) pasan por el mismo método, sin duplicar lógica.
- [x] Ejecutar `php -l` sobre el archivo modificado.
- [x] Ejecutar `graphify update .` para refrescar el grafo tras el cambio de código.
- [ ] Prueba manual de OTP por WhatsApp en postulación nueva, retorno y reenvío — Motivo: requiere `.env` con credenciales reales de Meta y un número de prueba; no disponible para el agente.
- [ ] Prueba manual del canal correo — Motivo: requiere envío real de correo desde el entorno local.
- [ ] Confirmación de ausencia de `SSL certificate problem`/`HTTP 0` en `writable/logs/` — Motivo: depende de las pruebas manuales anteriores.

## Archivos creados

| Archivo | Motivo |
| --- | --- |
| `docs/bugfix/007-otp-whatsapp-ssl-desarrollo/prototipo.md` | Registro de ejecución del plan, según lo solicitado. |

## Archivos modificados

| Archivo | Cambio realizado |
| --- | --- |
| `app/Controllers/Inscripciones/NuevoIngreso/Paso0.php` | En `enviarWhatsappOtp()` se agregó, antes de `curl_exec()`, un bloque que desactiva `CURLOPT_SSL_VERIFYPEER` y `CURLOPT_SSL_VERIFYHOST` cuando `ENVIRONMENT` es `development` o `testing`; en `production` no se altera la verificación TLS. |
| `docs/bugfix/007-otp-whatsapp-ssl-desarrollo/plan.md` | Estado cambiado de `pendiente` a `en curso` porque la verificación manual sigue pendiente. |
| `graphify-out/*` | Grafo regenerado con `graphify update .` (artefacto local, ignorado por git). |

## Comandos ejecutados

| Comando | Resultado |
| --- | --- |
| `git switch -c p-bugfix/otp-whatsapp-ssl-desarrollo` | Éxito: rama local creada y activa; sin push ni upstream. |
| `php -l app/Controllers/Inscripciones/NuevoIngreso/Paso0.php` | Éxito: `No syntax errors detected`. |
| `graphify update .` | Éxito: grafo reconstruido (14040 nodos, 29041 aristas). Avisos preexistentes de archivos de vistas y de `tree_sitter_sql`. |

## Verificación

- **Prueba manual:** pendiente. No se ejecutó el smoke test de los flujos reales porque requiere credenciales de Meta y un número de WhatsApp de prueba. Pasos a seguir: los puntos 1-8 del "Plan de verificación" del `plan.md`.
- **Pruebas automatizadas:** no aplica. El plan excluye explícitamente agregar pruebas automatizadas; solo se ejecutó validación de sintaxis PHP.
- **Criterios del plan:**
  - Cumplido por inspección: la verificación TLS permanece activa con `ENVIRONMENT = production`.
  - Cumplido por inspección: no se modificaron payload, template, credenciales, mensajes de usuario, rutas ni reglas de negocio.
  - Cumplido: no se agregaron secretos ni datos personales al repositorio.
  - Pendientes: envío real por WhatsApp en postulación nueva, retorno y reenvío; canal correo sin regresiones; ausencia de `SSL certificate problem`/`HTTP 0` en logs.

## Desviaciones del plan

- El plan indicaba que no se ejecutaría `graphify update` porque "no modifica código de la aplicación"; sin embargo, el cambio sí toca `app/Controllers/Inscripciones/NuevoIngreso/Paso0.php`, por lo que se ejecutó `graphify update .` conforme a `AGENTS.md`.
- Sin otras desviaciones.

## Riesgos y pendientes

- **Verificación pendiente:** el fix no está validado contra la API de Meta. Si al restaurar TLS Meta responde `400`, el plan indica no corregir el payload en este bugfix y abrir uno separado.
- **Token local vencido:** si el token de Meta está vencido, el error cambiará de SSL a `401`/`190`; no forma parte de este defecto, pero debe distinguirse al verificar.
- **Riesgo de seguridad por configuración:** desactivar TLS solo es aceptable en `development`/`testing`. Verificar el `.env` de cualquier servidor antes de desplegar.
- **Logs con datos personales:** las entradas de log incluyen teléfono y código OTP; no deben copiarse a tickets, documentación ni commits.
- **Siguiente paso:** completar el smoke test manual en local, revisar `writable/logs/` y, si todo pasa, actualizar el estado del plan a `completado`. No se hizo `commit` ni `push`.

## Consolidación

- **Fecha:** 2026-10-28
- **Rama destino:** feature/desacoplar-contructor-pagos
- **Estrategia:** merge --no-ff
- **Commits integrados:** 2 (`83e6289` fix, `6ce7c8d` docs) + merge `b2d9791`.
- **Rama prototipo eliminada:** `p-bugfix/otp-whatsapp-ssl-desarrollo`, borrada con `git branch -d` tras verificar que era ancestro de la rama destino y que no quedaban diferencias de archivos.
- **Verificación:** ancestro confirmado, sin commits pendientes y sin diferencias de archivos entre ambas ramas.
- **Pendiente:** el smoke test manual de OTP por WhatsApp y del canal correo sigue pendiente según la sección de verificación; la consolidación no valida el envío real contra Meta.