Appearance
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.
| Capacidad | SUPERADMIN | ADMIN | SUPERVISOR |
|---|---|---|---|
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 (
requireRolepor ruta).SUPERADMINhace bypass enrequireRole. Tras este cambio, todas las rutas operativas admitenADMINySUPERVISOR; solo Usuarios y Plantillas quedan paraADMIN. - La UI (
frontend/src/auth/role-permissions.ts) refleja la misma matriz: elSUPERVISORrecibe todos los permisos operativos (VIGILANTES_*,SEDES_*,EDIFICIOS_*,AULAS_*,TRIBUNAL_MIEMBROS_*,CONVOCATORIAS_*,EJERCICIOS_*,ASIGNACIONES_READ,CONFIGURACION_READ) y no recibeTEMPLATES_*niUSERS_*. - Configuración reservada a ADMIN (
CLAVES_CONFIGURACION_SOLO_ADMINenbackend/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_automaticayurl_pagina_ayuda.configuracion.controllerresponde403si unSUPERVISORintenta modificarlas, yConfiguracionPagedeshabilita su edición.
Al cambiar permisos hay que alinear tres sitios: roles de las rutas backend,
role-permissions.tsy las comprobaciones de la UI.
2. Correcciones del flujo de ejercicios
2.1 Asignación rápida (simulation.service.ts)
applySimulationahora valida el destino (pertenece al ejercicio), la capacidad (ratio/fijo en aulas;vigilantes_manualen 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.updateyremoverechazan la operación si la convocatoria estáCERRADA(antes solo lo hacíacreatey la reapertura). La UI ya mostraba el aviso de "solo lectura"; ahora el backend lo impone.
2.3 Notificación activa y asignaciones anuladas
getAsignacionesConNotificacionActivaya 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 conbloqueado=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
citacionenNotificacionTipo.notificacionService.createguarda las citaciones comocitacion(antes usaban el valor heredadollamamiento); la numeración considera ambos. La columnanotificaciones.tipose crea directamente condefault 'citacion'(CreateTablesynotificacion.entity), por lo que no se necesita migración de reclasificación:llamamientosigue siendo un valor válido para los registros históricos.
2.6 Otros
created_byde las notificaciones ya se rellena con el usuario autenticado (req.currentUser).- Corregido el parámetro de
DELETE /ejercicios/:ejercicioId/sedes/:idy.../aulas/:id(leían unreq.paramsinexistente). - El componente
ConfirmarExportacionLlamamientoDialogdeclara la propmodalId(elimina elVue 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.createya la comprobaba congetAsignacionActiva.asignacion.service.autoAsignarahora excluye del reparto a los vigilantes que ya tienen una asignación activa en el ejercicio (rellena solo huecos; conreasignar=truese borran antes).asignacion.service.restaurarAsistenciaahora 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.applySimulationya validaba duplicados del payload y la reactivación de anuladas.- La semilla
InsertTestExpedienteya 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 compartidofrontend/src/utils/asignacion.tspara 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 deQuickAssignResultsPanel. 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
localStorageobsoletas (siva-quickselect-presets,siva-quickselect-ultima).
3. Pruebas
- Backend:
src/__tests__/fixes-regresion.test.tsysrc/__tests__/simulation-capacidad.test.tscubren el bloqueo de vigilantes, la lista de claves reservadas y la validación de capacidad. - Backend:
src/__tests__/asignacion.service.test.tscubre la invariante encreate,restaurarAsistenciayautoAsignar;src/__tests__/seed-asignaciones-integridad.test.tsvalida que la semilla no duplica asignaciones activas por ejercicio. - Frontend:
src/utils/__tests__/asignacion.test.tsysrc/stores/__tests__/ejercicioStore.test.tscubren la disponibilidad de vigilantes y el rechazo al restaurar. - E2E (Playwright, carpeta
e2e/):tests/asignaciones-invariante.spec.tscomprueba 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.tsabre el modal de asignaciones del ejercicio semilla. - Frontend:
src/auth/__tests__/role-permissions.test.tsrefleja la nueva matriz delSUPERVISOR.
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:
updateUserSchemaaceptapasswordopcional;UserService.updatela hashea con argon2 e invalidarefresh_token;EditUserModalpide repetirla y aplica la política. (Antes se descartaba en silencio.)Importar confirmaciones:
aplicarExcelConfirmacionesaceptasobrescribir_idsy sobrescribe los ya confirmados marcados; el modal envía la sede sugerida del archivo.Notificación:
reenviarCorreoIndividualyreenviarNotificacionCompletaeligen la plantillaNOTIFICACION_REASIGNACIONcuando el vigilante ya había sido notificado.Contraseñas:
ResetPasswordPagevalida convalidatePassword(10 + complejidad).Verificación de correo: la plantilla por defecto incluye
?token=; se siembra ya corregida enInsertDefaultEmailTemplates.Ubicaciones del ejercicio (híbrido):
validarUbicacionessepara bloqueos (asignaciones con notificación activa) de desasignables;saveUbicacioneselimina 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» (
loadSummarycomprueba 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.resetPasswordyVerifyEmailPage; cada pantalla muestra un único aviso en línea (recuadro). Para conservar el mensaje del servidor,resetPasswordpasa a devolver{ success, message }.Limpieza de código muerto (2026-09-21): se eliminaron ramas y avisos inalcanzables (
showSimpleAlertde "Sin datos"/"Sin selección" enGestionarVigilantesModal, "Sin datos para exportar" enExportVigilantesFieldsModal, estado vacío deRealizarNotificacionDialog, toast deGestionarAsignacionesModal,openToggleStatusErrorModaldetemplateStore,toast.warningdeConfiguracionPage) y los listenersonClosede los modales de detalle, redundantes con el cierre deBaseModal. 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.tsyfrontend/src/components/users/modals/__tests__/EditUserModal.test.ts.Manual: nueva página
documentation/user/cobertura.md(146 ventanas y 129 mensajes) y seccionesVentanas y avisos+Mensajes del sistemapor 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 enCreateTables(no requiere migración incremental). El parámetropromocion_lista_espera_automatica(booleano, reservado a ADMIN) se siembra enInsertDefaultConfiguracion.
Actualización posterior (2026-09-26): la columna se renombró a
fecha_confirmaciony se añadióorden_confirmacion(int, nullable). La confirmación manual y la importación sin fecha escriben ahorafecha_confirmacion(la manual, el instante del clic; la importación sin fecha, una única base temporal para todo el lote) yorden_confirmacioncon la secuencia de fila. El orden del motor pasa afecha_confirmacion ?? fecha_respuestacon desempate pororden_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 tipoMARCATEMPORAL,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.xlsxy.csv, conhas_headersystart_rowconfigurables (una sola hoja). - Fechas: parser propio (
backend/src/utils/excel-date.util.ts) que aceptaDatede Excel, serial, textodd/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(concambio_sede,asignado,notificado),fueraDePlazo(posteriores afecha_limite_respuesta),rechazadosIgnoradosynoEncontrados. - Aplicar (
aplicarExcelConfirmaciones): fijafecha_respuesta(ahora),fecha_respuesta_formularioyorigen_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) yconfirmaciones-mapping.test.ts,ejercicioStore.actions.test.ts(frontend). - Manual: nueva página
documentation/user/ejercicios/importar-confirmaciones.md(formato, columnas, reglas y restricciones) enlazada desdeejercicios/vigilantes.mdyfaq.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 desdeparticipacion.service.ts) es el único comparador del criterio (fecha_confirmacion ?? fecha_respuestay, a igualdad,orden_confirmacion). El motor de simulación (simulation.service.ts) ygetOrdenConfirmacionlo 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úncompararOrdenConfirmacion. Dos confirmaciones empatan cuando coinciden en fecha (fecha_confirmacion ?? fecha_respuesta) y enorden_confirmacion; entonces comparten posición y la siguiente es consecutiva (1, 2, 2, 3). No se aplica un desempate extra:1, 2, 3inventaría un orden que el motor no distingue y1, 2, 2, 4dejaría huecos. - API:
GET /ejercicios/:ejercicioId/confirmaciones/pendientesañadeordena cada fila (solo en la confirmación efectiva de cada vigilante;nullen 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 helperfrontend/src/utils/ordenConfirmacion.ts. - Tests:
participacion.service.test.ts(comparador y rango denso),frontend/src/utils/__tests__/ordenConfirmacion.test.tsye2e/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 (ordenyorden_confirmacion). Es prioridad, no filtro (fallback al siguiente candidato).recomendadoParaDestinodevuelve el mejor. - UI (
GestionarAsignacionesModal.vue): bloque Asignación guiada con desplegable de destino y botón Asignar recomendado; la lista de candidatos se ordena porordende 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 defectoresp → pref → orden → equidad. La reglarespya intenta la sede preferida del responsable antes del fallback.QuickAssignRulesList.vueavisa (sin bloquear) siordenva antes queprefo siprefestá desactivada. - Tests:
frontend/src/utils/__tests__/asignacionPrioridad.test.tsye2e/tests/asignacion-guiada.spec.ts(recomienda y asigna); manual de usuario actualizado con la captura06-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) yVigilanteLlamamientoService.getListaEspera(ejercicioId, excluir): confirmados efectivos sin ninguna asignación (ni activa ni anulada, D7), no bloqueados ni penalizados, ordenados por confirmación (orden1..N). EndpointGET /api/ejercicios/:ejercicioId/lista-espera?excluir=. Tests envigilante-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 (usaasignacionPrioridad) y manual, primario segúnpromocion_lista_espera_automatica.ejercicioStore.fetchListaEspera. Tests:ejercicioStore.actions.test.tsye2e/tests/lista-espera.spec.ts. - Fase 5 — Restauración coherente.
AsignacionService.restaurarAsistenciarevalida las 10 reglas (con helpersgetDestinoInfo,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.tsyutils/__tests__/asignacion.test.ts. - Fase 7 — «Reasignar todo» ya no borra anuladas.
simulation.service.tsomitea.anuladoen el bucle de borrado yAsignacionService.autoAsignarborra solo las no anuladas. Test de regresión ensimulation-capacidad.test.tsyasignacion.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 arecomendadoParaDestinoen 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únpromocion_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.createno 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 elloNotificacionService.createacepta un parámetro opcionalasignacionIds; el controlador lo lee deasignacion_ids(en multipart, JSON o lista por comas) yejercicioStore.createNotificacionlo 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.tsye2e/tests/lista-espera.spec.ts(incluye un test de integración del acotado porasignacion_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,asignarRecomendadoy la ordenación de la lista por destino. utils/asignacionPrioridad.ts: se eliminancompararPrioridadCandidato,ordenarPorPrioridadyrecomendadoParaDestino; se conservanDestinoPrioridadyprimerCandidatoParaSede.- E2E:
asignacion-guiada.spec.tsse sustituye porasignacion-manual.spec.ts.
- Se retiran
- Rol de responsable en la promoción:
primerCandidatoParaSedepasa a ser una cascada (responsable+sede → sede → orden). La lista de espera se enriquece conesResponsabledesdeconfirmados(loadListaEspera) yofrecerPromocionpasa{ sedeId, requiereResponsable }del destino liberado. Tests enutils/__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_LLAMAMIENTOelimina la filaHorariode 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) exigehora_vigilantes_aula_tribunalyhora_comienzo_ejercicio. Se aplica en:notificacion.service.ts:create,reenviarNotificacionCompletayreenviarCorreoIndividual.asignacion.service.ts:restaurarAsistencia(solo el correoNOTIFICACION_RESTAURACIONmuestra el horario;ANULACION_ASISTENCIAno). Si falta alguna hora, el backend responde400con «No se puede notificar: el ejercicio no tiene configuradas las horas …».
- Aviso en la UI.
frontend/src/utils/modal-dialogs.tsañadeopenFaltanHorasNotificacionDialog(faltantes)yGestionarAsignacionesModal.vuelo 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.tsyfrontend/src/utils/__tests__/modal-dialogs.test.ts. - Manual:
documentation/user/ejercicios/notificacion-asistencia.md(ventana «Faltan horas del ejercicio» con captura06-notificacion-faltan-horas.png) ydocumentation/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_PRINCIPALenGestionarAsignacionesModal.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 existenteNOTIFICACION_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 agetAsignacionesPendientesAsistencia(bloqueo de cierre) como acountAsignacionesPorEstado(avisos de impacto engetImpactoCierre), 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 porNOTIFICACION_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.
ImpactoCierreygetImpactoCierre(backend/src/services/ejercicio.service.ts) dejan de calcular y devolverllamamientosActivosynotificacionesActivas;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) ybackend/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:observacionesno estaba enupdateEjercicioSchema(se descartaba siempre) yfechano podía vaciarse (""se convertía enundefined= 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 acreateyupdate. - Backend. Nuevos helpers de Zod y refactor de todos los esquemas implicados (
sede,edificio,aula,convocatoria,ejercicio—que ganaobservaciones—,template,document-template,tribunal-miembro,vigilante,user). EnrestaurarAsistenciael409de «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.updateSearchNormalizedincluíahora_comienzo_ejerciciodos veces y omitíahora_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.tsye2e/tests/edicion-campos-vacios.spec.ts(contrato API por módulo + flujo UI). - Docs.
docs/API.md(semántica de la actualización parcial) ydocs/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ámetrocontacto_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 allamamiento.service.ts(enviarCorreosyreenviarCorreoIndividual) y auser.service.ts(alta de usuario → verificación). - Seed. Esas dos plantillas se siembran ya con
enInsertDefaultEmailTemplates, y el parámetrocontacto_proceso_selectivose siembra enInsertDefaultConfiguracion. La antigua migraciónInsertContactoProcesoSelectivo(que reemplazaba el literal a posteriori) se eliminó, ya que la base de datos se recrea. - Backend. Los tres puntos añaden
email_contactoal objeto de variables, tomado deconfiguracionService.getContactoProceso()(igual que ya hacíannotificacion.service,asignacion.servicey la previsualización de plantillas deemail-template.service). - Frontend. La vista previa del correo de llamamiento (
ConfirmarExportacionLlamamientoDialog.abrirPreview) no incluíaemail_contacto, así queaplicarValoresdejaba el literalen pantalla; ahora usauseConfiguracionStore().contactoProceso. - Tests.
backend/src/__tests__/llamamiento-email-contacto.test.ts(envío individual y alta de llamamiento) y un caso nuevo enfrontend/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.createy el controlador ya aceptanasignacion_idspara 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.vuemantiene la selección en unSetdeasignacion_idy emiteonConfirmconasignacionIds;GestionarAsignacionesModalañadeasignacion_idal mapeo de destinatarios, escuchacanConfirmChangedpara el botón y pasadata.asignacionIdsacreateNotificacion. - Tests.
frontend/src/components/ejercicios/modals/__tests__/RealizarNotificacionDialog.test.ts(casillas por defecto, cabecera por tabla, clic en fila, payload sin selección) ye2e/tests/notificacion-seleccion-asignaciones.spec.ts(flujo real con confirmaciones y asignaciones). - Docs.
documentation/user/ejercicios/notificacion-asistencia.mdy captura06-notificacion-realizar.pngactualizada.
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 (
EdificioUbicacionCardconhide-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.mdy nueva captura06-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
LIKEsobre columnas con acentos en lugar de la columna normalizada:sede.serviceytribunal-miembro.service(teníansearchNormalizedsin usar),email-template.service(columna presente, entidad sin el campo) ydocument-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. Varios servicios filtraban con
- Backend. Nuevo helper
normalizeSearch(string.util.ts) y uso desearchNormalized LIKE :termen todos los servicios buscables (aula, convocatoria, configuración, document-template, edificio, ejercicio, email-template, sede, tribunal-miembro, user, vigilante).EmailTemplate,DocumentTemplateyParametroSistemaganansearchNormalized+ hooks; se añaden sus columnassearch_normalizedenCreateTables(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 consqljs),frontend/src/utils/__tests__/search.test.tsye2e/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.anularAsistenciamanda la plantillaANULACION_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».
- «Anular asistencia» (
- 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.mdy capturas06-asistencia-anular.pngy06-promocion-lista-espera.pngactualizadas.
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", enGestionarAsignacionesModal.vue). Los documentos son de nivel de ejercicio y el endpointPOST /ejercicios/:id/documentossolo 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 conplaywright-clisobre 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.setEmailVerifiedmarcais_email_verified = truey limpiaemail_verification_token; si ya estaba verificado responde400. EndpointPATCH /api/users/:id/verify(ADMIN, con jerarquía: SUPERADMIN → ADMIN/SUPERVISOR, ADMIN → SUPERVISOR; nunca el SUPERADMIN ni uno mismo). Nuevo permiso frontendusers:verify.UsersPageyDetailsUserModalmuestran el botón deshabilitado si ya está verificado; no existe la operación inversa (desverificar). - Alta y edición.
createUserSchema/updateUserSchemaaceptanis_email_verified.UserService.createrespeta el parámetroverificacion_email_obligatoria(si esfalse, crea la cuenta ya verificada y omite el correo);UserService.updatesolo permitefalse → true, nunca desverifica. - Política de contraseñas configurable. Parámetros
password_min_length(por defecto6) ypassword_require_uppercase,password_require_lowercase,password_require_numberypassword_require_special(booleanos, por defectofalse: solo se exige longitud).utils/password-policy.tsmantiene una caché en memoria consultada porpasswordSchemaen cada validación;ConfiguracionService.updatela refresca al guardar (write-through) yserver.tsla carga al arrancar. Endpoint públicoGET /api/configuracion/politica-passwordconsumido porconfiguracionStore(fetchPasswordPolicy) yvalidatePassword(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 capturas08-usuario-verificar.pngy08-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).