Sistema de Gestión de Avisos y Urgencias en AP v1.1

Configuración del Sistema

Generación del Calendario de Guardias

Generar Guardias

Manual de Uso del Sistema v1.1

1. Introducción

Este documento es la guía de referencia para el Sistema de Gestión de Avisos y Urgencias v1.1. El objetivo de la aplicación es generar cuadrantes de guardias mensuales de forma equitativa, distribuyendo la carga de trabajo entre los profesionales.

La característica principal de esta versión es su sistema de compensación histórica, que tiene en cuenta la carga de trabajo de meses anteriores para garantizar un equilibrio justo a largo plazo.

2. Paso 1: Configuración del Sistema

Antes de generar cualquier calendario, es imprescindible configurar correctamente todos los parámetros del equipo. Esto se realiza a través de las pestañas de la sección "Configuración".

• Médicos: Permite añadir, eliminar y gestionar la lista de profesionales. Cada médico tiene un turno asignado (MAÑANA, TARDE o MIXTO) y un estado (Activo/Inactivo).

  Nota: Se puede realizar una importación masiva de profesionales pegando datos desde una hoja de cálculo en el campo "Importación rápida". El formato es: `Nombre [TAB] Turno [TAB] %Jornada`.

• Jornada y Exclusiones: Permite definir reducciones de jornada (en %) y exclusiones de días fijos de la semana (ej. no trabajar los viernes) para un médico.

  Efecto en el cálculo: Ambos parámetros reducen el número de guardias "Objetivo" que el sistema calcula para ese médico, de forma proporcional a los días que deja de estar disponible.

• Festivos: Lista de fechas que se consideran no laborables para todo el equipo.

  Efecto en el cálculo: En estas fechas no se asignará ninguna guardia. El total de guardias a cubrir en el mes se reduce.

• Ausencias (Vacaciones/Bajas): Permite registrar rangos de fechas en los que un médico no está disponible.

  Efecto en el cálculo: Funciona de forma similar a "Jornada y Exclusiones", reduciendo el objetivo de guardias del médico afectado.

• Excl. Puntuales: Permite bloquear días específicos para un médico por motivos personales.

  Diferencia clave con Ausencias: Una exclusión puntual impide que al médico se le asigne una guardia ese día, pero NO reduce su objetivo mensual. El sistema intentará asignarle esa guardia en otro día disponible.

• Plan. Turnos (Mixtos): Define el turno (Mañana o Tarde) que un médico de turno MIXTO realizará cada día de la semana.

  Efecto en el cálculo: Un médico MIXTO solo será candidato para las guardias de la franja horaria que tenga asignada ese día de la semana.

• Parámetros Avanzados: Permite ajustar el comportamiento del sistema de compensación histórica. Para un uso estándar, no es necesario modificar los valores por defecto.

3. Paso 2: Generación del Calendario Mensual

Este es el proceso principal que se realiza cada mes.

1. Accede a la pestaña "Calendario".
2. Selecciona el Mes y el Año deseados.
3. Pulsa el botón "Generar Guardias".

El sistema mostrará el calendario y la tabla de resumen con los resultados.

4. Paso 3: Análisis y Guardado de Resultados

Tras la generación, se presentan dos bloques de información:

• Calendario de Guardias: La tabla principal que muestra qué médico ha sido asignado a cada uno de los 4 puestos diarios (Avisos/Urgencias de Mañana/Tarde).
• Resumen de Asignación: Una tabla que desglosa por médico el número de guardias objetivo, las finalmente asignadas, la diferencia, y otros datos estadísticos.

Acción Obligatoria: Guardar el Resultado en el Histórico

Una vez verificado y aprobado el calendario, es IMPRESCINDIBLE realizar la siguiente acción para el correcto funcionamiento del sistema de compensación:

💾 Guardar en Histórico

Esta acción registra la columna "Dif." (Diferencia) de cada médico en una base de datos interna. Este dato es el que se utilizará en meses futuros para aplicar la compensación.

5. Funcionalidad Clave: El Sistema de Compensación Histórica

Principio de Funcionamiento

El sistema calcula un "saldo" para cada médico, que es la suma de las "Diferencias" de todos los meses guardados en el histórico.

• Un saldo positivo (ej. `+3.5`) significa que el médico ha realizado más guardias de las que le correspondían.
• Un saldo negativo (ej. `-2.0`) significa que ha realizado menos.

Al calcular el "Objetivo" de un nuevo mes, el sistema primero calcula un objetivo base (proporcional a la disponibilidad) y luego le aplica un ajuste basado en el saldo. De esta forma, el reparto tiende a un equilibrio de `0` a largo plazo.

6. Gestión de Datos: Importar y Exportar

La aplicación permite importar y exportar dos tipos de datos distintos:

Exportar/Importar Configuración (Botones Azules 📄/📥)

Guarda y carga el estado de la sección de Configuración (lista de médicos, festivos, ausencias, etc.). Es útil para tener una copia de seguridad de la estructura del equipo o para trasladarla a otro ordenador.

Exportar/Importar Histórico (Botones Amarillos 📊/📈)

Guarda y carga la base de datos del histórico de saldos. Es fundamental para mantener una copia de seguridad de los datos de compensación acumulados a lo largo del tiempo.