# Prototipo de ejecución — EDT-002 Aviso discreto de sede sujeta a cambios en el Paso 0

- **Rama:** p-edit/aviso-carrera-sede-paso0
- **Rama base:** feature/desacoplar-contructor-pagos
- **Plan:** docs/edit/002-aviso-carrera-sede-paso0/plan.md
- **Fecha:** 2026-11-03
- **Estado:** consolidado

## Resumen
Se agregó el aviso discreto `#avisoSedeSujetaCambios` en el bloque "INTERÉS ACADÉMICO" del Paso 0 y la función `actualizarAvisoSede()` que lo muestra u oculta según el valor de `#sucursal_carrera_id`. La actualización se invoca al cambiar la sede, al cambiar/limpiar la carrera y al aplicar la precarga GHL/edición. La sintaxis PHP de la vista pasa; queda pendiente la verificación manual en navegador (incluye modo claro/oscuro) porque requiere sesión y OTP.

## Cambios aplicados
| # | Archivo / ubicación | Antes | Después | Estado |
| --- | --- | --- | --- | --- |
| 1 | `app/Views/inscripciones/nuevo_ingreso/paso0/formulario.php`, tras el cierre del grid carrera/sede | El grid cerraba y pasaba directo a "Información Personal" | Bloque `#avisoSedeSujetaCambios` oculto (`hidden mt-3`) con ícono `info` y el texto acordado | aplicado |
| 2 | Ídem, `onChange` de `sedeSelect` | Solo asignaba el hidden | Se agregó `actualizarAvisoSede();` | aplicado |
| 3 | Ídem, `handleCarreraChange()` | Retornaba sin tocar el aviso y terminaba sin actualizarlo | `actualizarAvisoSede();` antes del `return` de la rama vacía y al final de la función | aplicado |
| 4 | Ídem, junto a `handleCarreraChange()` | No existía | Nueva función `actualizarAvisoSede()` que alterna la clase `hidden` | aplicado |
| 5 | Ídem, precarga GHL/edición | Seteaba el hidden de precarga sin actualizar el aviso | `actualizarAvisoSede();` después de asignar el hidden | aplicado |

## Tareas realizadas
- [x] Insertar el bloque de aviso oculto por defecto entre el grid de interés académico y la sección "Información Personal".
- [x] Mostrar/ocultar el aviso al cambiar la sede (`onChange`).
- [x] Actualizar el aviso en las tres ramas de `handleCarreraChange()` (sin carrera, una sede, varias sedes).
- [x] Agregar la función `actualizarAvisoSede()` basada en el valor de `#sucursal_carrera_id`.
- [x] Actualizar el aviso tras la precarga GHL/edición.
- [ ] Verificación manual en navegador (claro/oscuro, una sede, varias sedes, edición) — Motivo: requiere levantar el servidor y completar OTP con una cédula de prueba; no ejecutable en este entorno.

## Archivos creados
| Archivo | Motivo |
| --- | --- |
| `docs/edit/002-aviso-carrera-sede-paso0/prototipo.md` | Documentar esta ejecución. |

## Archivos modificados
| Archivo | Cambio realizado |
| --- | --- |
| `app/Views/inscripciones/nuevo_ingreso/paso0/formulario.php` | +21 líneas: markup del aviso, llamadas en `sedeSelect.onChange` y `handleCarreraChange`, nueva función `actualizarAvisoSede()` y llamada tras la precarga. |
| `docs/edit/002-aviso-carrera-sede-paso0/plan.md` | Estado ajustado de `pendiente` a `en curso` (queda verificación manual). |

## Comandos ejecutados
| Comando | Resultado |
| --- | --- |
| `php -l app/Views/inscripciones/nuevo_ingreso/paso0/formulario.php` (línea base) | Éxito: sin errores de sintaxis. |
| `php -l app/Views/inscripciones/nuevo_ingreso/paso0/formulario.php` (después) | Éxito: sin errores de sintaxis. |
| `git diff -- app/Views/inscripciones/nuevo_ingreso/paso0/formulario.php` | Solo los 5 bloques previstos; 1 archivo, +21 líneas. |

## Verificación
- **Línea base (antes):** `php -l` sobre la vista pasó sin errores; la carpeta del plan era el único cambio sin confirmar en el árbol.
- **Prueba manual (flujo normal):** pendiente. Pasos: seleccionar carrera con una sola sede (aviso aparece), carrera con varias sedes (aviso oculto hasta elegir), cambiar carrera (se oculta), modo edición/precarga (aviso visible).
- **Pruebas automatizadas / lint:** solo `php -l`; no hay suite que cubra el texto/visibilidad y la suite completa no inicia por el fallo preexistente `BotChatSystemTest` (ver `AGENTS.md`). `npm run build` no se ejecutó: las clases Tailwind usadas ya existen en el CSS compilado.
- **Criterios del plan:**
  - [x] Bloque de aviso con el texto acordado.
  - [x] Aviso visible al haber carrera y sede (incluye autoselección, vía `handleCarreraChange`).
  - [x] Aviso oculto al limpiar carrera o quedar el hidden vacío.
  - [x] Llamada en precarga/edición.
  - [x] `php -l` pasa.
  - [x] Sin cambios fuera del alcance.
  - [ ] Verificación manual en claro y oscuro (pendiente).

## Desviaciones del plan
- Ninguna en el código. Se conservó el monospace: el `write`/`edit` no alteró el resto de la vista.

## Riesgos y pendientes
- Ejecutar la verificación manual del plan en navegador (claro/oscuro y modo edición) antes de cerrar la edición.
- El aviso es redundante con el filtrado actual de sedes; se mantiene el tono condicional según el plan.
- No hacer `commit` ni `push`: la rama es local y no publicada, según lo solicitado.

## Consolidación
- **Estado:** consolidado
- **Fecha:** 2026-11-03
- **Rama prototipo:** p-edit/aviso-carrera-sede-paso0
- **Rama destino:** feature/desacoplar-contructor-pagos
- **Estrategia:** merge --no-ff (commit 1d19f46)
- **Rama prototipo eliminada:** sí (borrado seguro `git branch -d`)
- **Pendiente:** verificación manual en navegador (claro/oscuro, una/varias sedes, modo edición).
