# Aviso discreto de sede sujeta a cambios en el Paso 0

- **Código:** EDT-002
- **Tipo:** edit
- **Estado:** en curso
- **Fecha:** 2026-11-03
- **Autor:** Agente (opencode)

## Objetivo
Mostrar un aviso discreto en el Paso 0 (Datos Básicos e Interés Académico) cuando el aspirante ya eligió carrera y sede, indicando que la carrera podría no estar ofertada en esa sede y que, de ser necesario, se le asignará otra sede. Aplica tanto a postulación nueva como a la edición de datos existentes.

## Motivación
Hoy el desplegable de Sede solo lista las sedes donde la carrera está ofertada, por lo que el aspirante no recibe ninguna advertencia sobre la posibilidad de reasignación de sede. El aviso adelanta esa condición desde el primer paso y evita sorpresas posteriores, sin cambiar el flujo ni la validación actual.

## Estado actual
- El formulario del Paso 0 está en `app/Views/inscripciones/nuevo_ingreso/paso0/formulario.php`.
- El bloque "INTERÉS ACADÉMICO" contiene dos selectores (`carreraSelect` y `sedeSelect`) dentro de un grid (líneas 44-60).
- `handleCarreraChange()` (líneas 622-650) filtra las sedes por carrera; si hay una sola sede la autoselecciona y guarda su `sucursal_carrera_id`; si hay varias, deja la sede vacía.
- El hidden `#sucursal_carrera_id` (línea 42) solo tiene valor cuando hay una sede seleccionada.
- El `onChange` de `sedeSelect` (líneas 617-619) actualiza ese hidden.
- En el Paso 2/3 ya existe el mensaje equivalente `OfertaAcademicaPresenter::MENSAJE_CARRERA_NO_OFERTADA`, pero en el Paso 0 no hay ningún aviso.
- No existe ningún elemento `#avisoSedeSujetaCambios` ni función `actualizarAvisoSede()` (sin colisiones).

## Cambios propuestos

| # | Archivo / ubicación | Antes | Después | Motivo |
| --- | --- | --- | --- | --- |
| 1 | `app/Views/inscripciones/nuevo_ingreso/paso0/formulario.php`, cierre del grid de interés académico (entre líneas 60 y 61) | El grid de carrera/sede cierra y pasa directo a la sección "Información Personal". | Insertar un bloque de aviso oculto por defecto con `id="avisoSedeSujetaCambios"`. | Tener el contenedor del mensaje, oculto hasta que haya sede seleccionada. |
| 2 | `app/Views/inscripciones/nuevo_ingreso/paso0/formulario.php`, `onChange` de `sedeSelect` (líneas 617-619) | `document.getElementById('sucursal_carrera_id').value = sucursalCarreraId \|\| '';` | Agregar `actualizarAvisoSede();` después de guardar el hidden. | Mostrar/ocultar el aviso cuando el aspirante elige o cambia la sede. |
| 3 | `app/Views/inscripciones/nuevo_ingreso/paso0/formulario.php`, `handleCarreraChange()` (líneas 622-650) | En la rama sin carrera hace `return` tras limpiar; en el resto termina sin tocar el aviso. | Llamar `actualizarAvisoSede();` antes del `return` de la rama vacía y al final de la función. | Cubrir autoselección de sede única, cambio de carrera y limpieza. |
| 4 | `app/Views/inscripciones/nuevo_ingreso/paso0/formulario.php`, junto a `handleCarreraChange()` | No existe la función. | Agregar `actualizarAvisoSede()`, que lee `#sucursal_carrera_id` y alterna la clase `hidden` del aviso. | Centralizar la lógica de visibilidad. |
| 5 | `app/Views/inscripciones/nuevo_ingreso/paso0/formulario.php`, precarga GHL/edición (líneas 1071-1078) | Se setea carrera y sede precargadas sin actualizar el aviso explícitamente. | Agregar `actualizarAvisoSede();` después de asignar el hidden de precarga. | Garantizar que el aviso aparezca al abrir el formulario con datos precargados o en modo edición. |

### Código propuesto

**1) Markup del aviso** (insertar al cerrar el grid de carrera/sede):

```html
                </div>

                <!-- Aviso discreto: la carrera podría no estar ofertada en la sede elegida -->
                <div id="avisoSedeSujetaCambios" class="hidden mt-3">
                    <p class="flex items-start gap-1.5 text-xs text-slate-500 dark:text-slate-400 leading-relaxed">
                        <span class="material-icons text-sm leading-none mt-0.5">info</span>
                        <span>La carrera podría no estar ofertada en la sede elegida. De ser necesario, se te asignará otra sede.</span>
                    </p>
                </div>
            </div>
```

**2) `onChange` de `sedeSelect`:**

```js
    onChange: (sucursalCarreraId) => {
        document.getElementById('sucursal_carrera_id').value = sucursalCarreraId || '';
        actualizarAvisoSede();
    }
```

**3) `handleCarreraChange()`:**

```js
    if (!carreraId) {
        hiddenSucursalCarrera.value = '';
        sedeSelect.setDisabled(true);
        sedeSelect.setPlaceholder('Primero selecciona una carrera...');
        sedeSelect.setOptions([]);
        actualizarAvisoSede();
        return;
    }
    // ...
    if (sedeOptions.length === 1) {
        sedeSelect.setOptions(sedeOptions, sedeOptions[0].value);
        hiddenSucursalCarrera.value = sedeOptions[0].value;
    } else {
        sedeSelect.setOptions(sedeOptions, null);
        hiddenSucursalCarrera.value = '';
    }

    actualizarAvisoSede();
```

**4) Nueva función (junto a `handleCarreraChange`):**

```js
function actualizarAvisoSede() {
    const aviso = document.getElementById('avisoSedeSujetaCambios');
    if (!aviso) return;

    const sucursalCarreraId = document.getElementById('sucursal_carrera_id')?.value || '';
    aviso.classList.toggle('hidden', sucursalCarreraId === '');
}
```

**5) Precarga (después de asignar el hidden):**

```js
        document.getElementById('sucursal_carrera_id').value = precargaSucursalCarreraId;
        actualizarAvisoSede();
```

> Nota: `actualizarAvisoSede` se declara como función, por lo que el hoisting permite invocarla desde el `onChange` de `sedeSelect` definido antes en el archivo.

## Alcance
- Incluye:
  - Agregar el aviso visual discreto en el Paso 0.
  - Mostrarlo solo cuando haya una sede seleccionada (incluye autoselección cuando la carrera tiene una sola sede).
  - Ocultarlo al limpiar la carrera o al quedar la sede sin valor.
  - Cubrir postulación nueva, precarga desde GHL y modo edición.
- No incluye:
  - Cambiar el desplegable de Sede ni listar sedes donde la carrera no está ofertada.
  - Implementar la reasignación real de sede (proceso administrativo/académico).
  - Modificar validaciones del backend, reglas de negocio, rutas, permisos, base de datos o contrato de API.
  - Tocar el Paso 2/3 ni el `OfertaAcademicaPresenter`.

## Archivos afectados

| Acción | Archivo | Motivo |
| --- | --- | --- |
| Modificar | `app/Views/inscripciones/nuevo_ingreso/paso0/formulario.php` | Agregar el bloque de aviso, la función de visibilidad y sus llamadas en los eventos de carrera/sede/precarga. |
| Agregar | `docs/edit/002-aviso-carrera-sede-paso0/plan.md` | Documento de esta edición. |

No se crean archivos de código nuevos. No se tocan controladores, modelos, migraciones ni dependencias.

## Verificación

### Prueba manual (flujo normal)
1. Levantar el servidor: `php spark serve --port 8080`.
2. Ir a `http://localhost:8080/inscripciones/nuevo-ingreso`, ingresar una cédula sin postulación y completar el OTP hasta llegar al formulario del Paso 0.
3. Seleccionar una carrera con **una sola sede**: la sede se autoselecciona y el aviso discreto debe aparecer.
4. Seleccionar una carrera con **varias sedes**: el aviso debe permanecer oculto hasta elegir una sede; al elegirla, debe aparecer.
5. Cambiar la carrera: el aviso debe ocultarse hasta que se elija (o autoseleccione) la nueva sede.
6. Verificar en modo claro y oscuro que el texto es legible y no rompe el layout.
7. Entrar con una postulación existente en modo edición (o precarga GHL con carrera y sede): el aviso debe mostrarse al cargar el formulario.
8. Confirmar que el texto visible es: "La carrera podría no estar ofertada en la sede elegida. De ser necesario, se te asignará otra sede."

### Lint / build / prueba automatizada
- `php -l app/Views/inscripciones/nuevo_ingreso/paso0/formulario.php` para validar la sintaxis PHP de la vista.
- `npm run build` solo si se decide agregar clases Tailwind que no existan ya en el CSS compilado; las clases propuestas ya se usan en el resto del archivo, por lo que no es imprescindible.
- No aplica prueba unitaria: es un cambio de contenido/visibilidad en una vista y no hay suite que cubra este texto. La suite completa además no inicia por el fallo preexistente documentado en `AGENTS.md` (`BotChatSystemTest`).

## Riesgos y efectos secundarios
- El aviso puede resultar redundante porque el desplegable ya filtra sedes válidas; se mitiga con el tono condicional ("podría") y el estilo discreto.
- Si en el futuro se cambia el filtrado para mostrar todas las sedes, el texto sigue siendo válido y no requiere ajustes.
- No hay impacto en servidor, validaciones, pagos ni datos.
- Sin cambios en accesibilidad más allá de texto plano; si se desea, puede agregarse `role="note"` o `aria-live="polite"` al contenedor (opcional, no incluido para mantenerlo discreto).

## Criterios de finalización
- [ ] El bloque de aviso existe en la vista con el texto acordado.
- [ ] El aviso aparece al haber carrera y sede seleccionadas, incluida la autoselección.
- [ ] El aviso se oculta al limpiar la carrera o quedar la sede sin valor.
- [ ] El aviso se muestra en modo edición y con precarga.
- [ ] `php -l` sobre la vista pasa sin errores.
- [ ] No se modificó nada fuera del alcance.
- [ ] Verificación manual completada en claro y oscuro.

## Notas del programador
- Texto confirmado por el usuario en la entrevista: versión corta y discreta.
- El disparador es `#sucursal_carrera_id` no vacío; equivale a "carrera y sede seleccionadas" porque el hidden solo se llena al elegir/autoseleccionar sede.
- `SearchableSelect.setOptions(options, value)` no dispara `onChange`; por eso la actualización explícita dentro de `handleCarreraChange` es necesaria.
- La reasignación real de sede queda fuera del alcance; este cambio solo informa.
- Si más adelante se prefiere reutilizar `OfertaAcademicaPresenter::MENSAJE_CARRERA_NO_OFERTADA`, es un cambio de una línea en el texto del aviso.
