Skip to content

Roles, permisos y correcciones recientes del flujo de ejercicios ​

Documento de apoyo que consolida, en un solo sitio, el modelo de roles/permisos vigente y las correcciones aplicadas al flujo de ejercicios (ubicaciones, vigilantes/llamamiento, asignaciones, notificación y asistencia).

Última revisión: 2026-09-30.

1. Roles y permisos ​

Roles reales (backend/src/enums/user-role.enum.ts): SUPERADMIN, ADMIN, SUPERVISOR.

CapacidadSUPERADMINADMINSUPERVISOR
Acceso total ("*" en frontend)✅✅—
Catálogos: Sedes / Edificios / Aulas / Plantas / Vigilantes / Etiquetas✅✅✅ (CRUD)
Tribunal, Convocatorias, Ejercicios (CRUD y cambio de estado)✅✅✅
Ubicaciones, Selección de vigilantes, Llamamiento, Confirmación✅✅✅
Asignaciones y Asignación rápida✅✅✅
Notificación y Asistencia (incluida anulación)✅✅✅
Configuración (consulta y edición habitual)✅✅✅
Configuración: claves reservadas a ADMIN✅✅❌
Plantillas (templates:*)✅✅❌
Usuarios (users:*)✅✅❌
  • La autorización real vive en el backend (requireRole por ruta). SUPERADMIN hace bypass en requireRole. Tras este cambio, todas las rutas operativas admiten ADMIN y SUPERVISOR; solo Usuarios y Plantillas quedan para ADMIN.
  • La UI (frontend/src/auth/role-permissions.ts) refleja la misma matriz: el SUPERVISOR recibe todos los permisos operativos (VIGILANTES_*, SEDES_*, EDIFICIOS_*, AULAS_*, TRIBUNAL_MIEMBROS_*, CONVOCATORIAS_*, EJERCICIOS_*, ASIGNACIONES_READ, CONFIGURACION_READ) y no recibe TEMPLATES_* ni USERS_*.
  • Configuración reservada a ADMIN (CLAVES_CONFIGURACION_SOLO_ADMIN en backend/src/services/configuracion.service.ts): colores_miembros_tribunal, colores_roles_usuarios, contacto_proceso_selectivo, envio_correos_vigilantes, etiqueta_colores_predefinidos, export_field_labels, penalizacion_duracion_dias, penalizacion_habilitada, modo_asignacion_aulas_default, promocion_lista_espera_automatica y url_pagina_ayuda. configuracion.controller responde 403 si un SUPERVISOR intenta modificarlas, y ConfiguracionPage deshabilita su edición.

Al cambiar permisos hay que alinear tres sitios: roles de las rutas backend, role-permissions.ts y las comprobaciones de la UI.

2. Correcciones del flujo de ejercicios ​

2.1 Asignación rápida (simulation.service.ts) ​

  • applySimulation ahora valida el destino (pertenece al ejercicio), la capacidad (ratio/fijo en aulas; vigilantes_manual en edificios manuales) y que el vigilante no esté bloqueado ni penalizado. Antes podía sobreasignar un aula o crear asignaciones a ubicaciones de otro ejercicio por API.
  • Al reactivar una asignación anulada se comprueba antes que el vigilante no tenga ya otra asignación activa, evitando dos asignaciones activas simultáneas.

2.2 Convocatoria cerrada = solo lectura efectiva ​

  • ejercicio.service.update y remove rechazan la operación si la convocatoria está CERRADA (antes solo lo hacía create y la reapertura). La UI ya mostraba el aviso de "solo lectura"; ahora el backend lo impone.

2.3 Notificación activa y asignaciones anuladas ​

  • getAsignacionesConNotificacionActiva ya no ignora las asignaciones anuladas: una notificación activa protege siempre su asignación, evitando que se borre y deje la notificación huérfana (asignacion_id = NULL).
  • Las asignaciones anuladas sin notificación activa dejan de bloquear quitar su sede/edificio/aula (validarUbicaciones, removeSede, removeAula) o al vigilante del ejercicio (removeVigilante).
  • La pestaña Asistencia incluye ahora las asignaciones anuladas y ofrece un botón Eliminar (habilitado solo sin notificación activa). Flujo resultante: anular asistencia → anular notificación (si la hubiera) → eliminar asignación → quitar la ubicación.

2.4 Bloqueo de vigilantes ​

  • vigilante.service.toggleBloqueado (y la edición con bloqueado=true) impide bloquear a un vigilante con asignaciones activas o notificaciones activas. Debe resolverse primero (anular/eliminar la asignación o anular la notificación).

2.5 Tipo de notificación ​

  • Nuevo valor citacion en NotificacionTipo. notificacionService.create guarda las citaciones como citacion (antes usaban el valor heredado llamamiento); la numeración considera ambos. La columna notificaciones.tipo se crea directamente con default 'citacion' (CreateTables y notificacion.entity), por lo que no se necesita migración de reclasificación: llamamiento sigue siendo un valor válido para los registros históricos.

2.6 Otros ​

  • created_by de las notificaciones ya se rellena con el usuario autenticado (req.currentUser).
  • Corregido el parámetro de DELETE /ejercicios/:ejercicioId/sedes/:id y .../aulas/:id (leían un req.params inexistente).
  • El componente ConfirmarExportacionLlamamientoDialog declara la prop modalId (elimina el Vue warn).

2.7 Un vigilante, una sola ubicación activa por ejercicio ​

Un vigilante no puede estar asignado a dos aulas/edificios a la vez dentro del mismo ejercicio. La invariante se garantiza en la capa de servicio (no en BD) y se aplica en todos los caminos:

  • asignacion.service.create ya la comprobaba con getAsignacionActiva.
  • asignacion.service.autoAsignar ahora excluye del reparto a los vigilantes que ya tienen una asignación activa en el ejercicio (rellena solo huecos; con reasignar=true se borran antes).
  • asignacion.service.restaurarAsistencia ahora rechaza reactivar una asignación anulada si el vigilante ya tiene otra activa en el ejercicio (409). Antes podía quedar activo en dos destinos a la vez.
  • simulation.service.applySimulation ya validaba duplicados del payload y la reactivación de anuladas.
  • La semilla InsertTestExpediente ya no crea dos asignaciones activas del mismo ejercicio para el vigilante de prueba (cada ejercicio tiene una activa y una anulada).
  • El frontend (GestionarAsignacionesModal) usa el util compartido frontend/src/utils/asignacion.ts para calcular los vigilantes disponibles, excluyendo asignados, anulados y bloqueados.

2.8 Selección rápida de vigilantes y penalizados ​

  • Los vigilantes penalizados se tratan igual que los bloqueados al seleccionar vigilantes: se excluyen de la lista de disponibles (y de la "Selección rápida"), no se pueden arrastrar ni añadir a grupos y se omiten al autoguardar los grupos. La condición central vive en frontend/src/utils/vigilante.ts (esNoDisponible).
  • El modal Selección rápida (QuickSelectDialog.vue) se rediseñó como workspace XL: configuración a la izquierda (origen, método, cantidad y opciones) y vista previa a la derecha. La pestaña de información reutiliza el patrón de QuickAssignResultsPanel. La configuración vive solo en memoria (frontend/src/utils/quickSelectConfig.ts); no hay preajustes ni última configuración persistida.
  • En modo Todos los disponibles se puede filtrar por etiquetas (coincidencia AND) o por Sin etiqueta.
  • El método por defecto es Aleatorios y el botón Barajar de nuevo vive en el pie del modal, junto a Aplicar selección.
  • El modal recibe del padre el estado del listado (filtrosActuales). En Filtro actual lo muestra con el mismo formato de chips que «Todos los disponibles» pero de solo lectura: todas las etiquetas con las activas resaltadas, el término de búsqueda y, si procede, la vista «Solo seleccionados». Incorpora un buscador interno que refina el pool sobre ambos orígenes.
  • La sección Orden (campos compartidos con la lista principal mediante frontend/src/utils/vigilanteSort.ts) es editable en Todos los disponibles. Al añadir un criterio, el método pasa automáticamente a Primeros, de modo que el orden actúa a nivel del pool y determina la selección (los N primeros); con Aleatorios o Porcentaje el orden no influye en la selección. En Filtro actual el orden es el del listado y se muestra en solo lectura; el orden propio no se aplica.
  • Cada origen (Filtro actual / Todos los disponibles) mantiene su propio estado (método, cantidad, opciones, etiquetas, búsqueda y orden) en memoria; al alternar se guarda el del origen saliente y se restaura el del entrante (seleccionarOrigen). Antes, el cambio de origen reutilizaba el mismo estado y borraba las etiquetas al volver a «Filtro actual».
  • Se eliminaron los preajustes con nombre y la última configuración persistida (no aportaban valor sobre la naturaleza contextual de la ventana). Se conserva Restablecer, que devuelve ambos orígenes a los valores por defecto. Al abrir la ventana se limpian las claves localStorage obsoletas (siva-quickselect-presets, siva-quickselect-ultima).

3. Pruebas ​

  • Backend: src/__tests__/fixes-regresion.test.ts y src/__tests__/simulation-capacidad.test.ts cubren el bloqueo de vigilantes, la lista de claves reservadas y la validación de capacidad.
  • Backend: src/__tests__/asignacion.service.test.ts cubre la invariante en create, restaurarAsistencia y autoAsignar; src/__tests__/seed-asignaciones-integridad.test.ts valida que la semilla no duplica asignaciones activas por ejercicio.
  • Frontend: src/utils/__tests__/asignacion.test.ts y src/stores/__tests__/ejercicioStore.test.ts cubren la disponibilidad de vigilantes y el rechazo al restaurar.
  • E2E (Playwright, carpeta e2e/): tests/asignaciones-invariante.spec.ts comprueba contra la app real que ningún ejercicio duplica vigilantes activos y que no se puede restaurar una asistencia con otra activa; tests/asignaciones-ui.spec.ts abre el modal de asignaciones del ejercicio semilla.
  • Frontend: src/auth/__tests__/role-permissions.test.ts refleja la nueva matriz del SUPERVISOR.

3. Correcciones de coherencia entre código y manual (2026-09-21) ​

Se corrigieron comportamientos que el manual describía de forma inexacta (auditoría "ventanas y avisos"), y se reestructuró la documentación de usuario.

  • Cambio de contraseña en Editar usuario: updateUserSchema acepta password opcional; UserService.update la hashea con argon2 e invalida refresh_token; EditUserModal pide repetirla y aplica la política. (Antes se descartaba en silencio.)

  • Importar confirmaciones: aplicarExcelConfirmaciones acepta sobrescribir_ids y sobrescribe los ya confirmados marcados; el modal envía la sede sugerida del archivo.

  • Notificación: reenviarCorreoIndividual y reenviarNotificacionCompleta eligen la plantilla NOTIFICACION_REASIGNACION cuando el vigilante ya había sido notificado.

  • Contraseñas: ResetPasswordPage valida con validatePassword (10 + complejidad).

  • Verificación de correo: la plantilla por defecto incluye ?token=; se siembra ya corregida en InsertDefaultEmailTemplates.

  • Ubicaciones del ejercicio (híbrido): validarUbicaciones separa bloqueos (asignaciones con notificación activa) de desasignables; saveUbicaciones elimina las desasignables. El aviso «Se desasignarán vigilantes» vuelve a ser alcanzable.

  • Ejercicios: el candado permite pulsar con la convocatoria cerrada para mostrar «No se puede reabrir el ejercicio»; el Dashboard muestra de verdad el error con «Reintentar» (loadSummary comprueba el resultado).

  • Coherencia de formularios: los modales de edición de sede/edificio/aula ya no permiten cambiar el estado (solo el flujo «Cambiar estado», con sus avisos); la capacidad del aula es obligatoria también en edición; el export de ubicaciones no cuenta aulas no disponibles; gramática del borrado de grupos.

  • Avisos de las pantallas de acceso: se eliminaron los avisos emergentes duplicados de authStore.forgotPassword, authStore.resetPassword y VerifyEmailPage; cada pantalla muestra un único aviso en línea (recuadro). Para conservar el mensaje del servidor, resetPassword pasa a devolver { success, message }.

  • Limpieza de código muerto (2026-09-21): se eliminaron ramas y avisos inalcanzables (showSimpleAlert de "Sin datos"/"Sin selección" en GestionarVigilantesModal, "Sin datos para exportar" en ExportVigilantesFieldsModal, estado vacío de RealizarNotificacionDialog, toast de GestionarAsignacionesModal, openToggleStatusErrorModal de templateStore, toast.warning de ConfiguracionPage) y los listeners onClose de los modales de detalle, redundantes con el cierre de BaseModal. Se corrigió un toast duplicado al bloquear/desbloquear vigilantes (el refresco tras el PUT ya no propaga el error) y erratas ("Volverá"/"Volverán"). Las guardas de sistema del backend se mantienen como autoridad.

  • Tests: backend/src/__tests__/user-update-password.test.ts y frontend/src/components/users/modals/__tests__/EditUserModal.test.ts.

  • Manual: nueva página documentation/user/cobertura.md (146 ventanas y 129 mensajes) y secciones Ventanas y avisos + Mensajes del sistema por módulo.

4. Importación de confirmaciones con orden por marca temporal y mapeo de columnas (2026-09-23) ​

Rediseño del importador de confirmaciones de un ejercicio (pestaña Confirmación):

  • Modelo: nueva columna vigilante_llamamientos.fecha_respuesta_formulario (datetime, nullable). Se añade en CreateTables (no requiere migración incremental). El parámetro promocion_lista_espera_automatica (booleano, reservado a ADMIN) se siembra en InsertDefaultConfiguracion.

Actualización posterior (2026-09-26): la columna se renombró a fecha_confirmacion y se añadió orden_confirmacion (int, nullable). La confirmación manual y la importación sin fecha escriben ahora fecha_confirmacion (la manual, el instante del clic; la importación sin fecha, una única base temporal para todo el lote) y orden_confirmacion con la secuencia de fila. El orden del motor pasa a fecha_confirmacion ?? fecha_respuesta con desempate por orden_confirmacion.

  • Mapeo de columnas: el asistente (3 pasos: Subir · Asociar columnas · Revisar) autodetecta cabeceras por alias (DNI/NIF/NIF/NIE; SEDEPREFERENCIA/SEDE/PREFERENCIA; marcas temporales tipo MARCATEMPORAL, TIMESTAMP, FECHARESPUESTA…; FECHA + HORA; datos personales) y permite ajustarlo manualmente. DNI y Sede son obligatorios; no se admiten dos columnas para el mismo campo. Admite .xlsx y .csv, con has_headers y start_row configurables (una sola hoja).
  • Fechas: parser propio (backend/src/utils/excel-date.util.ts) que acepta Date de Excel, serial, texto dd/mm/yyyy[ hh:mm[:ss]] (con / - .), ISO, año de 2 cifras y valida rangos y bisiestos. Fecha y hora pueden venir en columnas separadas; se combinan. Se guarda la marca "de pared" en UTC.
  • Orden y de-duplicado: de-dup por DNI conservando los datos de la respuesta más reciente y la marca más antigua para el orden; si no hay columna de fecha, se respeta el orden de filas (ordenOrigen).
  • Clasificación: encontrados, yaConfirmados (con cambio_sede, asignado, notificado), fueraDePlazo (posteriores a fecha_limite_respuesta), rechazadosIgnorados y noEncontrados.
  • Aplicar (aplicarExcelConfirmaciones): fija fecha_respuesta (ahora), fecha_respuesta_formulario y origen_confirmacion = excel; en los ya confirmados sobrescritos actualiza la sede sin pisar la marca existente. Devuelve { aplicadas, actualizadas, omitidas, fueraDePlazo }.
  • Motor de asignación: la regla «Orden de confirmación» usa fecha_respuesta_formulario ?? fecha_respuesta (participacion.service.ts).
  • Tests: vigilante-llamamiento-fechas.test.ts, vigilante-llamamiento-import.test.ts, participacion.service.test.ts, fixes-regresion.test.ts (backend) y confirmaciones-mapping.test.ts, ejercicioStore.actions.test.ts (frontend).
  • Manual: nueva página documentation/user/ejercicios/importar-confirmaciones.md (formato, columnas, reglas y restricciones) enlazada desde ejercicios/vigilantes.md y faq.md.

5. Orden de confirmación visible en la pestaña Confirmación (2026-09-26) ​

La pestaña Confirmación muestra ahora el orden que aplicará la regla «Orden de confirmación» de la Asignación rápida:

  • Fuente única de verdad: compararOrdenConfirmacion (exportado desde participacion.service.ts) es el único comparador del criterio (fecha_confirmacion ?? fecha_respuesta y, a igualdad, orden_confirmacion). El motor de simulación (simulation.service.ts) y getOrdenConfirmacion lo consumen; antes estaba duplicado como método privado de simulación.
  • Rango denso global: ParticipacionService.getOrdenConfirmacion(ejercicioId) devuelve las confirmaciones efectivas ordenadas y con rango. El rango es global (se calcula sobre todas las confirmaciones efectivas; buscar o filtrar no renumera) y denso: solo se incrementa cuando dos confirmaciones consecutivas no son equivalentes según compararOrdenConfirmacion. Dos confirmaciones empatan cuando coinciden en fecha (fecha_confirmacion ?? fecha_respuesta) y en orden_confirmacion; entonces comparten posición y la siguiente es consecutiva (1, 2, 2, 3). No se aplica un desempate extra: 1, 2, 3 inventaría un orden que el motor no distingue y 1, 2, 2, 4 dejaría huecos.
  • API: GET /ejercicios/:ejercicioId/confirmaciones/pendientes añade orden a cada fila (solo en la confirmación efectiva de cada vigilante; null en pendientes, rechazados y filas no efectivas).
  • UI (GestionarVigilantesModal.vue): columna «Orden» ordenable (ascendente → descendente → sin orden); las filas sin orden muestran — y quedan al final. La ordenación usa el helper frontend/src/utils/ordenConfirmacion.ts.
  • Tests: participacion.service.test.ts (comparador y rango denso), frontend/src/utils/__tests__/ordenConfirmacion.test.ts y e2e/tests/confirmacion-orden.spec.ts (rango y columna en UI).

6. Asignación manual guiada y coherencia del orden de reglas (2026-09-26) ​

La asignación manual respeta el mismo criterio de prioridad que la Asignación rápida, y el orden de reglas se protege con avisos de coherencia:

  • Criterio de prioridad frontend/src/utils/asignacionPrioridad.ts: compararPrioridadCandidato(a, b, destino) con las claves rol (si el destino requiere responsable) → sede preferida (coincide con la del destino) → orden de confirmación (orden y orden_confirmacion). Es prioridad, no filtro (fallback al siguiente candidato). recomendadoParaDestino devuelve el mejor.
  • UI (GestionarAsignacionesModal.vue): bloque Asignación guiada con desplegable de destino y botón Asignar recomendado; la lista de candidatos se ordena por orden de serie y, con un destino elegido, por el criterio de prioridad, con badges Recomendado, Coincide sede y Responsable. El rol solo prioriza, nunca bloquea.
  • Asignación rápida (simulation.service.ts): se mantiene el motor de reglas; orden canónico por defecto resp → pref → orden → equidad. La regla resp ya intenta la sede preferida del responsable antes del fallback. QuickAssignRulesList.vue avisa (sin bloquear) si orden va antes que pref o si pref está desactivada.
  • Tests: frontend/src/utils/__tests__/asignacionPrioridad.test.ts y e2e/tests/asignacion-guiada.spec.ts (recomienda y asigna); manual de usuario actualizado con la captura 06-asignacion-guiada.png.

7. Lista de espera, promoción y restauración coherente (2026-09-26) ​

Cierre de las fases 3–7 de especificaciones.md:

  • Fase 3 — Lista de espera (backend). AsignacionService.getVigilantesConAsignacion(ejercicioId, anulado?) (+ envoltorios …Activa/…Anulada) y VigilanteLlamamientoService.getListaEspera(ejercicioId, excluir): confirmados efectivos sin ninguna asignación (ni activa ni anulada, D7), no bloqueados ni penalizados, ordenados por confirmación (orden 1..N). Endpoint GET /api/ejercicios/:ejercicioId/lista-espera?excluir=. Tests en vigilante-llamamiento-lista-espera.test.ts.
  • Fase 4 — Lista de espera y promoción (frontend). Panel plegable «Lista de espera (N)» en la pestaña Asistencia (visible solo si hay candidatos) y PromocionListaEsperaDialog.vue: al anular una plaza, diálogo «Cubrir la plaza liberada» con procesos guiado (usa asignacionPrioridad) y manual, primario según promocion_lista_espera_automatica. ejercicioStore.fetchListaEspera. Tests: ejercicioStore.actions.test.ts y e2e/tests/lista-espera.spec.ts.
  • Fase 5 — Restauración coherente. AsignacionService.restaurarAsistencia revalida las 10 reglas (con helpers getDestinoInfo, necesariosDeAula, contarActivasDestino, nombreCompletoVigilante, nombreDestinoDeAsignacion) y devuelve 409 específicos. Frontend: utils/asignacion.ts → calcularConflictoRestaurar (reasignado / plaza cubierta / ubicación no disponible) con badge y botón deshabilitado. Tests: asignacion.service.test.ts y utils/__tests__/asignacion.test.ts.
  • Fase 7 — «Reasignar todo» ya no borra anuladas. simulation.service.ts omite a.anulado en el bucle de borrado y AsignacionService.autoAsignar borra solo las no anuladas. Test de regresión en simulation-capacidad.test.ts y asignacion.service.test.ts.
  • Fase 6 — Documentación. Manual de usuario (ejercicios/asignaciones.md, ejercicios/notificacion-asistencia.md), capturas (06-lista-espera.png) y documentación de sistema (API/openapi, modelo de datos, componentes).

8. Promoción desde la lista de espera: regla de encaje y notificación automática (2026-09-28) ​

Mejoras sobre el flujo de «Cubrir la plaza liberada»:

  • Regla de selección del sustituto (frontend/src/utils/asignacionPrioridad.ts → primerCandidatoParaSede): se recorre la lista de espera por orden de confirmación y se toma el primer candidato que encaja con la sede liberada, entendiendo por encajar tener esa sede preferida o no tener preferencia (puede ir a cualquier sede). Si ninguno encaja, se usa el primero por orden (fallback) y el diálogo lo avisa (esFallback). Sustituye a recomendadoParaDestino en la promoción.
  • Diálogo (PromocionListaEsperaDialog.vue): muestra al vigilante reemplazado (el anulado) y al candidato que se usará para reemplazar; botones Asignación automática, Asignación manual y Ahora no (primario según promocion_lista_espera_automatica, regla D8). Ya no usa «Asignar al siguiente».
  • Asignación manual (irAAsignacionManual): además de ir a la pestaña Asignación, marcar al candidato y enfocar el destino, activa la pestaña de la sede/edificio del destino liberado (activarTabDestinoLiberado), según la vista activa (por sedes → sede:<id>; por edificios → edif:<id>). Limpia la búsqueda de ubicación.
  • Notificación automática solo al promovido: AsignacionService.create no notifica por sí mismo. Al promover en modo automático se crea y envía una notificación acotada a esa única asignación. Para ello NotificacionService.create acepta un parámetro opcional asignacionIds; el controlador lo lee de asignacion_ids (en multipart, JSON o lista por comas) y ejercicioStore.createNotificacion lo envía. En modo manual no se notifica solo: se hace después desde la pestaña Notificación.
  • Tests: utils/__tests__/asignacionPrioridad.test.ts, PromocionListaEsperaDialog.test.ts, stores/__tests__/ejercicioStore.actions.test.ts, backend/.../notificacion-create-scope.test.ts y e2e/tests/lista-espera.spec.ts (incluye un test de integración del acotado por asignacion_ids).

9. Retirada de la «Asignación guiada» y rol en la promoción (2026-09-28) ​

  • Retirada de la Asignación guiada (GestionarAsignacionesModal.vue): se elimina el bloque con desplegable de destino + botón Asignar recomendado y los badges Recomendado/Coincide sede. La pestaña Asignación queda con Asignación manual (checkbox/«Asignar a…»/drag&drop) y Asignación rápida.
    • Se retiran destinoFocoKey, destinoFoco, destinosPorSede, recomendadoActual, esRecomendado, coincideSedeDestino, asignarRecomendado y la ordenación de la lista por destino.
    • utils/asignacionPrioridad.ts: se eliminan compararPrioridadCandidato, ordenarPorPrioridad y recomendadoParaDestino; se conservan DestinoPrioridad y primerCandidatoParaSede.
    • E2E: asignacion-guiada.spec.ts se sustituye por asignacion-manual.spec.ts.
  • Rol de responsable en la promoción: primerCandidatoParaSede pasa a ser una cascada (responsable+sede → sede → orden). La lista de espera se enriquece con esResponsable desde confirmados (loadListaEspera) y ofrecerPromocion pasa { sedeId, requiereResponsable } del destino liberado. Tests en utils/__tests__/asignacionPrioridad.test.ts.

10. Horas obligatorias al notificar y sin horario en el email de llamamiento (2026-09-29) ​

  • Email de llamamiento sin horario. La plantilla de sistema CONVOCATORIA_LLAMAMIENTO elimina la fila Horario de su cuerpo (solo conserva ejercicio, convocatoria, fecha, tipo, DNI y sedes disponibles). El horario se comunica en la notificación/citación posterior. La constante semilla (InsertDefaultEmailTemplates) ya no la incluye; al poder recrearse la base de datos, no se mantiene una migración de limpieza para bases antiguas. Las copias de usuario no se tocan.
  • Horas obligatorias antes de enviar correos que muestran el horario. La utilidad compartida backend/src/utils/ejercicio-horas.util.ts (assertHorasNotificacion / horasNotificacionFaltantes) exige hora_vigilantes_aula_tribunal y hora_comienzo_ejercicio. Se aplica en:
    • notificacion.service.ts: create, reenviarNotificacionCompleta y reenviarCorreoIndividual.
    • asignacion.service.ts: restaurarAsistencia (solo el correo NOTIFICACION_RESTAURACION muestra el horario; ANULACION_ASISTENCIA no). Si falta alguna hora, el backend responde 400 con «No se puede notificar: el ejercicio no tiene configuradas las horas …».
  • Aviso en la UI. frontend/src/utils/modal-dialogs.ts añade openFaltanHorasNotificacionDialog(faltantes) y GestionarAsignacionesModal.vue lo invoca con un pre-chequeo (comprobarHorasEjercicio) antes de notificar, reenviar, restaurar o promover automáticamente, de modo que no se abre el diálogo de envío si faltan horas.
  • Tests: backend/src/__tests__/ejercicio-horas.util.test.ts, backend/src/__tests__/notificacion-create-scope.test.ts, backend/src/__tests__/asignacion.service.test.ts y frontend/src/utils/__tests__/modal-dialogs.test.ts.
  • Manual: documentation/user/ejercicios/notificacion-asistencia.md (ventana «Faltan horas del ejercicio» con captura 06-notificacion-faltan-horas.png) y documentation/user/ejercicios/vigilantes.md (el correo de llamamiento no incluye el horario). Captura del preview de llamamiento regenerada (06-vigilantes-preview-email.png).

11. Cierre de ejercicio: solo bloquean las citaciones/llamamientos vigentes (2026-09-30) ​

  • Bug. La validación de cierre (backend/src/services/ejercicio.service.ts → asignacionesConEstadoQuery) consideraba "notificada" cualquier asignación con alguna notificación no anulada, sin mirar el tipo. Una asignación con la citación anulada pero con notificaciones históricas activas (anulacion/restauracion) bloqueaba el cierre; sin embargo la pestaña Asistencia solo muestra asignaciones con notificación principal activa (citacion/llamamiento, TIPOS_NOTIFICACION_PRINCIPAL en GestionarAsignacionesModal.vue), por lo que esas asignaciones no eran visibles ni resolubles desde la UI: un callejón sin salida (el mensaje pedía marcarlas, pero no aparecían).
  • Corrección. La query añade n.tipo IN (:...tiposVigentes) reutilizando la constante ya existente NOTIFICACION_TIPOS_VIGENTES (backend/src/enums/notificacion-tipo.enum.ts), cuyo comentario ya indicaba que anulación/restauración son registros históricos y no bloquean operaciones. Afecta tanto a getAsignacionesPendientesAsistencia (bloqueo de cierre) como a countAsignacionesPorEstado (avisos de impacto en getImpactoCierre), que comparten la query. Backend y UI quedan con el mismo ámbito: lo que bloquea el cierre es exactamente lo que se ve y se resuelve en la pestaña Asistencia.
  • Tests: backend/src/__tests__/ejercicio-cierre.test.ts (verifica que la query filtra por NOTIFICACION_TIPOS_VIGENTES).

12. Avisos de cierre: se retiran llamamientos y notificaciones como «datos pendientes» (2026-09-30) ​

  • Motivo. El diálogo de cierre (y el de bloqueo) listaba «N llamamiento(s) activo(s)» y «N notificación(es) activa(s)» bajo «Se detectaron datos pendientes». No son datos pendientes: son el estado normal de un ejercicio trabajado y quedan inertes al cerrarlo (el ejercicio pasa a solo lectura). Solo generaban ruido y confusión, mezclados con avisos que sí requieren acción.
  • Cambio. ImpactoCierre y getImpactoCierre (backend/src/services/ejercicio.service.ts) dejan de calcular y devolver llamamientosActivos y notificacionesActivas; openChangeEstadoModal (frontend/src/stores/ ejercicioStore.ts) deja de mostrarlos. Se mantienen:
    • Bloqueo: asignaciones sin pasar lista.
    • Recordatorios accionables: vigilantes que no asistieron y penalizaciones activas.
  • Documentación de usuario: documentation/user/ejercicios/index.md (ventana «Cerrar ejercicio»).
  • Tests: frontend/src/stores/__tests__/ejercicioStore.actions.test.ts (el mensaje ya no incluye llamamientos/notificaciones) y backend/src/__tests__/ejercicio-cierre.test.ts.

13. Edición: convención única de campos vacíos en create/update (2026-09-30) ​

  • Bug. Al editar, los campos vaciados no se guardaban (p. ej. borrar la «Hora vigilantes aula/tribunal» o la «Hora comienzo ejercicio» de un ejercicio). Causa: los formularios eliminaban del payload las claves con ""/null (delete data[k]), y como la edición es una actualización parcial (Object.assign), el backend conservaba el valor anterior. De paso: observaciones no estaba en updateEjercicioSchema (se descartaba siempre) y fecha no podía vaciarse ("" se convertía en undefined = sin cambio).
  • Convención (única). La normalización vive en el borde de la API (backend/src/dtos/helpers.ts): omitido = no cambia; columna nullable + ""/null = limpiar (null); requerido vacío = 400; columna NOT NULL con "vacío" significativo = "". Aplica por igual a create y update.
  • Backend. Nuevos helpers de Zod y refactor de todos los esquemas implicados (sede, edificio, aula, convocatoria, ejercicio —que gana observaciones—, template, document-template, tribunal-miembro, vigilante, user). En restaurarAsistencia el 409 de «asignación activa» conserva su prioridad sobre el requisito de horas.
  • Frontend. Se elimina el borrado de campos vacíos en los modales de edición/creación (Edit/CreateEjercicio, Edit/CreateAula, Edit/CreateEdificio, Edit/CreateTemplate, CreateSede, CreateUser); se envían los valores tal cual.
  • Entidad. Ejercicio.updateSearchNormalized incluía hora_comienzo_ejercicio dos veces y omitía hora_vigilantes_aula_tribunal.
  • Tests. backend/src/__tests__/dto-empty-null.test.ts (140 casos de esquema), backend/src/__tests__/ejercicio-search-normalized.test.ts, frontend/src/components/edicion-campos-vacios*.test.ts y e2e/tests/edicion-campos-vacios.spec.ts (contrato API por módulo + flujo UI).
  • Docs. docs/API.md (semántica de la actualización parcial) y docs/GUIA_CONTRIBUCION.md (convención para nuevos esquemas).

14. Contacto del proceso en los correos de llamamiento y verificación (2026-09-30) ​

  • Bug. Las plantillas de sistema Convocatoria de Llamamiento y Verificación de correo usan la variable (valor del parámetro contacto_proceso_selectivo), pero varios emisores no la inyectaban, por lo que Handlebars la renderizaba vacía y el correo mostraba el contacto en blanco. Afectaba a llamamiento.service.ts (enviarCorreos y reenviarCorreoIndividual) y a user.service.ts (alta de usuario → verificación).
  • Seed. Esas dos plantillas se siembran ya con en InsertDefaultEmailTemplates, y el parámetro contacto_proceso_selectivo se siembra en InsertDefaultConfiguracion. La antigua migración InsertContactoProcesoSelectivo (que reemplazaba el literal a posteriori) se eliminó, ya que la base de datos se recrea.
  • Backend. Los tres puntos añaden email_contacto al objeto de variables, tomado de configuracionService.getContactoProceso() (igual que ya hacían notificacion.service, asignacion.service y la previsualización de plantillas de email-template.service).
  • Frontend. La vista previa del correo de llamamiento (ConfirmarExportacionLlamamientoDialog.abrirPreview) no incluía email_contacto, así que aplicarValores dejaba el literal en pantalla; ahora usa useConfiguracionStore().contactoProceso.
  • Tests. backend/src/__tests__/llamamiento-email-contacto.test.ts (envío individual y alta de llamamiento) y un caso nuevo en frontend/src/components/ejercicios/modals/__tests__/ConfirmarExportacionLlamamientoDialog.test.ts (la previsualización sustituye el contacto por el valor configurado).

15. Selección de destinatarios al realizar una notificación (2026-09-30) ​

  • Mejora. Las tablas Nuevas asignaciones y Reasignaciones del diálogo Realizar Notificación N incorporan una casilla por fila, marcada por defecto, con la misma interacción que la tabla de «Nuevos» del llamamiento: el clic en la fila alterna su casilla, la casilla de la cabecera marca/desmarca toda esa tabla y Enviar notificación se deshabilita si no queda ninguna asignación marcada.
  • Backend. Sin cambios: notificacion.service.create y el controlador ya aceptan asignacion_ids para acotar la notificación a asignaciones concretas (lo usaba la promoción automática); el diálogo reutiliza ese filtro enviando solo las marcadas.
  • Frontend. RealizarNotificacionDialog.vue mantiene la selección en un Set de asignacion_id y emite onConfirm con asignacionIds; GestionarAsignacionesModal añade asignacion_id al mapeo de destinatarios, escucha canConfirmChanged para el botón y pasa data.asignacionIds a createNotificacion.
  • Tests. frontend/src/components/ejercicios/modals/__tests__/RealizarNotificacionDialog.test.ts (casillas por defecto, cabecera por tabla, clic en fila, payload sin selección) y e2e/tests/notificacion-seleccion-asignaciones.spec.ts (flujo real con confirmaciones y asignaciones).
  • Docs. documentation/user/ejercicios/notificacion-asistencia.md y captura 06-notificacion-realizar.png actualizada.

16. Estado del edificio visible en la vista «Edificios» de Seleccionar ubicaciones (2026-09-30) ​

  • Mejora. El icono de estado del edificio (✅ activo / 🔧 en obras / ✖ inactivo) solo se mostraba en la cabecera de la tarjeta, que está oculta en la vista compacta Edificios (EdificioUbicacionCard con hide-header). Ahora esa vista muestra una fila de título con el nombre del edificio y el mismo icono (con su tooltip), de modo que se entiende por qué la casilla aparece deshabilitada (p. ej. un edificio en obras sin aulas disponibles).
  • Frontend. La lógica del icono y del tooltip se extrae a los computedestadoIconoClase / estadoTooltip, reutilizados por la cabecera y por la nueva fila .edificio-compact-title.
  • Tests. frontend/src/components/ejercicios/modals/__tests__/EdificioUbicacionCard.test.ts (icono por estado en la vista compacta y casilla habilitada/deshabilitada).
  • Docs. documentation/user/ejercicios/ubicaciones.md y nueva captura 06-ubicaciones-edificio-estado.png.

17. Búsquedas insensibles a acentos y mayúsculas (2026-09-30) ​

  • Bug. Buscar «unico» no encontraba «Edificio Único» ni «periferica» encontraba «Sede Periférica Alcalá». Causa doble:
    • Backend. Varios servicios filtraban con LIKE sobre columnas con acentos en lugar de la columna normalizada: sede.service y tribunal-miembro.service (tenían searchNormalized sin usar), email-template.service (columna presente, entidad sin el campo) y document-template.service / configuracion.service (sin columna).
    • Frontend. Las búsquedas locales comparaban con .toLowerCase().includes(), sin quitar diacríticos (el caso reportado era «Seleccionar ubicaciones»).
  • Backend. Nuevo helper normalizeSearch (string.util.ts) y uso de searchNormalized LIKE :term en todos los servicios buscables (aula, convocatoria, configuración, document-template, edificio, ejercicio, email-template, sede, tribunal-miembro, user, vigilante). EmailTemplate, DocumentTemplate y ParametroSistema ganan searchNormalized + hooks; se añaden sus columnas search_normalized en CreateTables (reutilizando la migración existente).
  • Frontend. Nuevo frontend/src/utils/search.ts (normalizeSearch/matchesSearch) aplicado a todas las búsquedas locales (Seleccionar ubicaciones, notificaciones, asignaciones, selección rápida, grupos, asignación rápida y expediente del vigilante).
  • Tests. backend/src/__tests__/search-normalized.test.ts (util, hooks y búsqueda accent-insensitive con sqljs), frontend/src/utils/__tests__/search.test.ts y e2e/tests/busquedas-acentos.spec.ts (una comprobación por cada página con buscador).
  • Docs. docs/GUIA_CONTRIBUCION.md (convención de búsquedas).

18. Avisos de notificación en «Anular asistencia» y «Cubrir la plaza liberada» (2026-09-30) ​

  • Mejora. Se hacen explícitas las notificaciones que dispara la anulación de una asistencia y la promoción desde la lista de espera:
    • «Anular asistencia» (GestionarAsignacionesModal.anularAsistenciaHandler): el diálogo avisa de que se enviará un correo al vigilante con la anulación (igual que ya hacía «Restaurar asistencia»). El envío es real: asignacion.service.anularAsistencia manda la plantilla ANULACION_ASISTENCIA.
    • «Cubrir la plaza liberada» (PromocionListaEsperaDialog): se añade un bloque que explica que Asignación automática envía automáticamente la notificación de la nueva asignación al promovido (además del correo de anulación ya enviado al reemplazado), mientras que Asignación manual solo deja el correo de anulación y la notificación del promovido se hace después desde «Realizar notificación».
  • Frontend. Cambios solo de texto en los dos diálogos; sin cambios de lógica ni de backend.
  • Tests. Casos nuevos en frontend/src/components/ejercicios/modals/__tests__/PromocionListaEsperaDialog.test.ts.
  • Docs. documentation/user/ejercicios/notificacion-asistencia.md, documentation/user/ejercicios/asignaciones.md y capturas 06-asistencia-anular.png y 06-promocion-lista-espera.png actualizadas.

19. Adjuntar documentos del ejercicio sin notificaciones previas (2026-09-30) ​

  • Bug. En la pestaña Notificación de «Asignaciones y asistencia», el botón Adjuntar documento de «Documentos del ejercicio» estaba deshabilitado mientras el ejercicio no tuviera ninguna notificación (:disabled="notificaciones.length === 0", en GestionarAsignacionesModal.vue). Los documentos son de nivel de ejercicio y el endpoint POST /ejercicios/:id/documentos solo exige que el ejercicio sea editable (notificacion.service.subirDocumentoEjercicio → assertEditable); además se adjuntan a los correos al enviarlos (getAdjuntosEjercicio). Es decir, se podía adjuntar antes de crear la primera notificación, pero la interfaz lo impedía.
  • Frontend. El botón pasa a deshabilitarse solo cuando el ejercicio está cerrado (:disabled="ejercicioCerrado", con tooltip «El ejercicio está cerrado»).
  • Tests. Caso nuevo en e2e/tests/notificacion-seleccion-asignaciones.spec.ts (botón habilitado y subida real de un documento). Verificado también con playwright-cli sobre base de datos limpia (0 notificaciones).
  • Docs. documentation/user/ejercicios/notificacion-asistencia.md.

20. Verificación de correo gestionable y política de contraseñas configurable (2026-10-02) ​

  • Problema. Al crear un usuario, el correo de verificación puede no entregarse y la cuenta queda inaccesible: el token solo viaja en el correo y el creador no puede verlo.
  • Verificación manual (un solo sentido). UserService.setEmailVerified marca is_email_verified = true y limpia email_verification_token; si ya estaba verificado responde 400. Endpoint PATCH /api/users/:id/verify (ADMIN, con jerarquía: SUPERADMIN → ADMIN/SUPERVISOR, ADMIN → SUPERVISOR; nunca el SUPERADMIN ni uno mismo). Nuevo permiso frontend users:verify. UsersPage y DetailsUserModal muestran el botón deshabilitado si ya está verificado; no existe la operación inversa (desverificar).
  • Alta y edición. createUserSchema/updateUserSchema aceptan is_email_verified. UserService.create respeta el parámetro verificacion_email_obligatoria (si es false, crea la cuenta ya verificada y omite el correo); UserService.update solo permite false → true, nunca desverifica.
  • Política de contraseñas configurable. Parámetros password_min_length (por defecto 6) y password_require_uppercase, password_require_lowercase, password_require_number y password_require_special (booleanos, por defecto false: solo se exige longitud). utils/password-policy.ts mantiene una caché en memoria consultada por passwordSchema en cada validación; ConfiguracionService.update la refresca al guardar (write-through) y server.ts la carga al arrancar. Endpoint público GET /api/configuracion/politica-password consumido por configuracionStore (fetchPasswordPolicy) y validatePassword (frontend) en alta/edición de usuarios, cambio y restablecimiento de contraseña.
  • Migración. Los 6 parámetros se siembran en InsertDefaultConfiguracion (1718300006100); al ser la base de datos recreable no se añade migración de backfill.
  • Nota operativa. El cambio de política se aplica al guardar por API; un cambio directo en la tabla no se refleja hasta reiniciar (caché en memoria).
  • Tests. Backend: user-email-verification.test.ts, configuracion.service.test.ts, fixes-regresion.test.ts. Frontend: password.test.ts, CreateUserModal.test.ts, EditUserModal.test.ts, authPages.test.ts.
  • Docs. Manual de usuario (administracion/usuarios.md, administracion/configuracion.md, mi-cuenta/cambiar-contrasena.md, primeros-pasos/acceso.md, cobertura.md, faq.md) con las capturas 08-usuario-verificar.png y 08-configuracion-password.png, además de las regeneradas (08-usuarios-lista, 08-usuario-nuevo*, 08-usuario-editar, 08-usuario-detalles, 08-configuracion, 08-configuracion-boolean, 02-reset-password).

SIVA — Sistema Integral de Vigilantes de Aulas