Novedades¶

¿Qué es?¶

El módulo de Novedades registra situaciones especiales del personal que afectan la operación normal de los turnos: reemplazos, ausencias planificadas, cambios de puesto, permisos y cualquier evento fuera de la programación habitual. Cada novedad tiene un empleado afectado, un tipo de novedad, un período (inicio–fin con horas), un puesto de trabajo, y opcionalmente un empleado de reemplazo y una fotografía de evidencia.

Vista principal¶

La tabla muestra todas las novedades con las siguientes columnas:

Empleado — Nombre del empleado afectado. Ancho variable, truncado.
Tipo — Nombre del tipo de novedad. Ancho 160 px, truncado.
Proyecto — Nombre del proyecto relacionado. Ancho 180 px, truncado.
Puesto — Puesto de trabajo donde ocurre la novedad. Ancho 150 px.
Inicio — Fecha y hora de inicio en formato AAAA-MM-DD HH:MM. Ancho 155 px. La hora se almacena como decimal (0–24) y se convierte a HH:MM para mostrar.
Fin — Fecha y hora de fin en el mismo formato. Ancho 155 px.
Reemplazo — Nombre del empleado que cubre la novedad. Ancho 180 px. Muestra (—) si no hay reemplazo asignado.
Estado — Badge de color según el estado. Ancho 110 px.
Adjuntos — Botón que muestra el número de fotos de evidencia. Al hacer clic abre el lightbox directamente desde la lista sin necesidad de abrir el modal de edición. Ancho 90 px.

Filtros¶

Buscar empleado, puesto, tipo... — Campo de texto libre.
Estado — Selector con opciones: Todos, Borrador, Confirmada, Hecha, Cancelada.

Ordenación por defecto¶

Ordenada por fecha de inicio descendente.

Estados de una novedad¶

Estado	Badge	Descripción
Borrador	Gris	Recién creada, pendiente de confirmación
Confirmada	Azul	Aprobada y activa
Hecha	Verde	Ya ejecutada, el período ha pasado
Cancelada	Rojo	Anulada

Acciones en la lista¶

Botón "Nueva novedad"¶

Visible con permiso news: create. Abre el modal de creación.

Exportar¶

Botón de exportación. Descarga un archivo reemplazos con los registros filtrados. Requiere permiso news: export.

Acciones masivas¶

Al seleccionar una o más novedades:

Cambiar estado — Selector de estado + botón Aplicar. Envía PATCH a /news/bulk/state.
Eliminar — Requiere confirmación doble. Envía DELETE a /news/bulk.

Al hacer clic en cualquier fila de la tabla, o al hacer clic en el botón Nueva novedad, se abre el modal.

Campos del formulario¶

Campos de vinculación (jerarquía en cascada): - Cliente (partner) — Autocompletado. Al seleccionar uno, se reinician Proyecto y Puesto. - Proyecto (project) — Autocompletado filtrado por el cliente seleccionado. Al seleccionar uno, se reinicia Puesto. - Puesto (puesto) — Autocompletado filtrado por el proyecto seleccionado. Al seleccionar un puesto en modo Crear, se cargan automáticamente los valores de auxilio de alimentación y transporte desde la configuración del puesto (con cascada hacia la empresa si el puesto no tiene configurados). - Empleado — Autocompletado del empleado afectado (obligatorio). No puede ser el mismo que el de Reemplazo. - Tipo de novedad — Autocompletado del catálogo de tipos (obligatorio). - Reemplazo — Autocompletado del empleado que cubre (opcional). No puede ser el mismo que el Empleado principal.

Período: - Fecha inicio — Selector de fecha (obligatorio). Hay una restricción de días pasados configurada en preferencias de la empresa (max_past_days_for_absence). Las fechas anteriores al límite quedan deshabilitadas. - Hora inicio — Selector de hora en formato HH:MM (por defecto 08:00). - Fecha fin — Selector de fecha (obligatorio). No puede ser anterior a la fecha de inicio. - Hora fin — Selector de hora (por defecto 17:00). La fecha/hora de fin debe ser posterior a la de inicio. - Duración calculada — Se muestra automáticamente al definir las fechas y horas (ej. "8 horas", "2 días 4 horas"). Advertencias si la duración supera el umbral alto (170 h por defecto) o es menor al umbral bajo (1 h).

Otros campos: - Estado — Selector con los estados disponibles (por defecto: Borrador). - Auxilio de alimentación — Toggle + valor en COP. Se carga automáticamente al seleccionar puesto si hay configuración. - Auxilio de transporte — Toggle + valor en COP. Igual. - Nota — Campo de texto libre para observaciones adicionales.

Evidencia (foto): - Botón para subir una imagen de evidencia. - En modo Crear: la foto se guarda localmente y se sube después de que el registro se crea en el servidor. - En modo Editar: la foto se sube inmediatamente al servidor al seleccionarla. - Si ya hay evidencia, se muestra una miniatura. Al hacer clic en la miniatura abre el lightbox.

Validaciones al guardar¶

Empleado es obligatorio.
Proyecto es obligatorio.
Puesto es obligatorio.
Tipo de novedad es obligatorio.
Fechas de inicio y fin son obligatorias.
La fecha/hora de fin debe ser posterior a la de inicio.
El empleado y el reemplazo no pueden ser la misma persona.

Disponible tanto desde la columna Adjuntos en la lista como desde el modal de edición. Funciona igual que en Asistencia y Minutas: pantalla completa oscura, navegación con flechas, descarga y pantalla completa.

Permisos¶

Acción	Permiso requerido
Ver novedades	`news: view`
Crear novedad	`news: create`
Editar / cambiar estado	`news: edit`
Eliminar	`news: delete`
Exportar	`news: export`

Páginas relacionadas¶

Empleados — El personal involucrado en las novedades.
Turnos y horarios — Las programaciones que las novedades alteran.
Puestos — Lugares físicos donde ocurren las novedades.
Proyectos — Cada novedad está asociada a un proyecto.
Contratos — La configuración de auxilios puede provenir del contrato del empleado.

Preguntas frecuentes¶

¿Cuál es la diferencia entre una novedad y una ausencia? Una novedad es cualquier evento no planificado (reemplazo, cambio de puesto, permiso, etc.). Una ausencia (módulo separado) es una solicitud formal de tiempo libre (vacaciones, incapacidad, etc.) con flujo de aprobación.

¿Por qué no puedo seleccionar fechas muy antiguas? La empresa tiene configurado un límite de días pasados (max_past_days_for_absence) para evitar registrar novedades con fechas muy lejanas. Si necesitas registrar algo más antiguo, contacta al administrador del sistema.

¿Qué pasa con los auxilios al seleccionar un puesto? Al seleccionar el puesto en modo Creación, el sistema consulta automáticamente los valores de auxilio configurados para ese puesto. Si el puesto no tiene valores, usa los de la empresa (configuración general). Los toggles se activan automáticamente si hay valores mayores a 0.

¿Puedo asignar el mismo empleado como afectado y como reemplazo? No. El sistema valida que el empleado principal y el reemplazo sean personas diferentes. Si seleccionas el mismo, uno de los campos se limpia automáticamente.

¿Cómo veo solo las novedades confirmadas? Usa el filtro Estado → Confirmada en la barra de filtros de la lista.