# Metodología del simulador

## Naturaleza de los valores

Las cargas, mezcla, tiempos, productividad y recursos que aparecen al iniciar son **hipótesis de modelización** del encargo. No son estadísticas oficiales de un Ayuntamiento concreto. El backlog de 40 expedientes a seis meses es un escenario hipotético de trabajo. Los resultados se calculan a partir de los parámetros editables; no son mediciones ni predicciones oficiales.

## Carga por expediente

La carga base de cada tipología se multiplica por su proporción y se suma:

- Técnica: `5×0,20 + 10×0,55 + 18×0,20 + 30×0,05 = 11,6 h/expediente`.
- Administrativa: `1,5×0,20 + 2×0,55 + 2,5×0,20 + 3×0,05 = 2,05 h/expediente`.
- Jurídica: `1×0,20 + 1,5×0,55 + 2,5×0,20 + 4×0,05 = 1,725 h/expediente`.

La carga técnica esperada de cada tipología es `horas de primera revisión + probabilidad de al menos una subsanación × rondas medias condicionadas a subsanación × horas por revisión`. La distribución condicional asigna los expedientes afectados a una, dos o tres rondas o más; la clase «tres o más» se aproxima a tres. Con los valores iniciales, las rondas condicionadas medias son 1,36 y la carga técnica media es 12,464 h/expediente. El valor de 11,6 h/expediente corresponde a una sola revisión por expediente afectado. El dimensionamiento y el flujo usan la carga de rondas configurada. El tiempo del promotor se contabiliza aparte en cada ciclo de subsanación.

## ETP y capacidad

ETP significa equivalente a tiempo completo dedicado a la función analizada. Puede calcularse como `personas × dedicación (%)`, o introducirse directamente. Dos empleados al 50 % equivalen a 1 ETP.

Modo simplificado: las horas planificables por ETP y mes se introducen directamente; valor inicial `60 h/mes`. Modo avanzado: `capacidad efectiva = jornada mensual × dedicación directa × disponibilidad × utilización objetivo`. Los valores iniciales son `150 × 0,50 × 1,00 × 0,80 = 60 h/mes`. Si la dedicación directa ya excluye reuniones o tareas ajenas al procedimiento, no vuelvas a descontar esas mismas horas dentro de disponibilidad. Las horas útiles del equipo son `ETP × capacidad útil por ETP`. Si la capacidad es cero y hay carga, se informa como insuficiente sin dividir por cero.

## Backlog avanzado y rondas

El backlog avanzado distribuye recuentos agregados entre estados y permite definir una mezcla A/B/C/D distinta en cada estado. El total pendiente se deriva de la suma de esos recuentos. Al simular, los grupos entran directamente en sus colas y eventos pendientes: antes del control documental consumen el ciclo completo; los expedientes completos esperan la primera revisión técnica; los que están en revisión conservan la mitad de sus horas de primera revisión; los que esperan al promotor permanecen suspendidos durante el plazo configurado y luego pasan a revisión; los situados en espera del promotor o en subsanación se reparten según la distribución configurada de rondas restantes; los técnicamente favorables o pendientes de jurídico consumen solo trabajo jurídico; y los pendientes de resolución o notificación consumen respectivamente un 25 % o un 10 % de horas administrativas y las esperas de fase que faltan. Cada regla es una hipótesis inicial, editable indirectamente mediante horas y tiempos de tipología/fase, y debe contrastarse con observaciones. El recuento agregado no aporta edad real por expediente.

Las cargas residuales calculadas para dimensionar el saneamiento siguen esas mismas reglas de horas y fases. Los grupos a la espera del promotor incluyen la revisión técnica futura en la carga residual de dimensionamiento, aunque no ocupan la cola técnica durante la espera. La simulación, en cambio, los incorpora a la cola cuando vence ese plazo.

La probabilidad de subsanación de cada tipología determina qué proporción requiere al menos una ronda. La distribución editable de rondas es condicional a que exista subsanación y reparte ese grupo entre una, dos o tres rondas o más; sus porcentajes positivos se normalizan a 100 %. El FPY es la proporción ponderada que no requiere subsanación según la mezcla de demanda. Las rondas medias por expediente son la incidencia ponderada por tipología multiplicada por la media condicional de rondas. La clase «tres o más» se aproxima a tres. Son estimaciones derivadas de hipótesis, no observaciones históricas.

## Cargas y dimensionamiento

La carga mensual base se calcula por perfil como expedientes/mes por horas medias por expediente. Se añade carga administrativa de solicitudes de informes externos cuando se configura. Para dimensionar el saneamiento, las horas de backlog del perfil se dividen por el plazo objetivo y se agregan a la carga mensual nueva. `ETP requeridos = carga mensual total / capacidad útil por ETP`. La recomendación operativa se redondea hacia arriba en pasos de 0,25 ETP; el mínimo matemático se conserva sin redondeo.

## Simulación por cohortes y colas

El motor avanza día a día en días hábiles, hasta el horizonte elegido y, para cerrar las entradas pendientes, hasta 60 meses adicionales. Distribuye las entradas mensuales por tipología; cada cohorte se divide en volúmenes esperados con y sin subsanación y con y sin informe externo. Son cohortes fraccionarias deterministas, no expedientes aleatorios observados. El volumen anual de entradas no cambia al activar la estacionalidad: los 12 coeficientes mensuales se normalizan por su media.

Cada perfil tiene su propia cola de horas. Las actuaciones pasan por administración, primera revisión técnica, el número configurado de ciclos de espera del promotor y revisión técnica, jurídico y resolución/notificación. Los objetivos temporales de fase se aplican como esperas configurables y se mantienen separados del servicio en horas. Los días hábiles no descuentan festivos ni vacaciones. El backlog inicial se inicia en la fase administrativa y recorre el flujo completo porque no se dispone de su estado procesal; esta es una hipótesis explícita que puede sobrestimar trabajo pendiente si ya tenía fases completadas.

En «Subsanaciones prioritarias», las tareas de revisión técnica listas para servicio se atienden antes que las primeras revisiones; dentro de cada grupo se conserva el orden de incorporación. En FIFO estricta, ambas clases se ordenan por incorporación a la cola. La respuesta del promotor retrasa el regreso de una cohorte y su duración se contabiliza fuera del reloj municipal.

La capacidad extraordinaria técnica se suma solo en los meses que cubre el intervalo de inicio y duración. La capacidad sostenible y las semanas de cola se calculan con recursos municipales, sin extrapolar apoyo temporal. La utilización mensual se calcula con las horas al inicio de mes más el trabajo que entra en cada perfil durante el mes, divididas por la capacidad ofrecida.

El refuerzo automático, desactivado inicialmente, observa al cierre de cada mes las semanas de cola técnica calculadas frente a capacidad municipal. Si la cola supera el umbral configurado durante los meses consecutivos exigidos, añade los ETP establecidos desde el mes siguiente. Se retira cuando la cola queda por debajo del umbral inferior durante los meses consecutivos indicados o al alcanzar la duración máxima. Tras alcanzar esa duración, no se reactiva hasta que la cola haya bajado al umbral de retirada durante el periodo configurado. El refuerzo automático es técnico y se suma al apoyo manual si ambos coinciden; no asigna recursos separados a las nuevas entradas y al backlog.

El backlog mensual es el número esperado de expedientes equivalentes aún abiertos, contando fases y esperas. Además de las colas por perfil, la proyección desglosa seis grupos operativos: documental, primera revisión técnica, subsanación técnica, jurídica, resolución y notificación. Las primeras cuatro muestran horas pendientes y la fracción de capacidad compartida consumida por las tareas de esa fase durante el último mes; no son recursos independientes. Resolución y notificación muestran expedientes en espera. En la ruta ordinaria son esperas temporales sin horas de servicio parametrizadas; para el backlog avanzado se incluyen los factores administrativos residuales aproximados del 25 % y 10 % definidos para esos estados. La edad mostrada es la transcurrida desde la entrada de cada cohorte al modelo; el estado agregado del backlog no contiene edad histórica real. Las colas no incluyen cohortes que esperan al promotor o a una fecha objetivo de fase.

## Tiempos y tres relojes

Para cada cohorte resuelta, el tiempo total transcurre desde su entrada hasta la notificación. El tiempo municipal resta los días de respuesta del promotor y la espera externa configurada; esos relojes se informan aparte. El tiempo limpio corresponde a las ramas sin subsanación ni informe externo. El objetivo interno de 45–60 días naturales se compara con el tiempo limpio; la conversión usa 7/5 y omite festivos.

La media, P50/P80/P90/P95, mínimo, máximo, desviación típica y proporción por encima de 90 días hábiles se ponderan por el volumen esperado de las cohortes completadas. Se publican solo cuando se ha resuelto al menos el 99,9 % de las nuevas entradas previstas; si hay entradas censuradas, se muestran como no disponibles, evitando sesgo por expedientes pendientes. Son percentiles del modelo determinista por cohortes, no percentiles observados ni pronósticos probabilísticos. La cobertura indica la fracción del volumen previsto que el motor logró completar.

## Colas y semáforos

Las semanas de cola se aproximan como horas pendientes ÷ capacidad mensual municipal × 4,33. Umbrales: verde hasta 2 semanas; amarillo hasta 3; naranja hasta 4; rojo por encima de 4, que recomienda activar capacidad extraordinaria. Con capacidad nula y carga pendiente el valor es infinito.

Utilización: verde <70 %, amarillo 70–80 %, naranja >80–90 %, rojo >90 %. Por encima de 100 % se informa de capacidad insuficiente. El signo de crecimiento o reducción de la cola es visible en la tabla mensual.

## Análisis de sensibilidad y costes directos

La pantalla de sensibilidad ejecuta variaciones de un factor cada vez: carga horaria por expediente, demanda mensual, productividad y probabilidad de subsanación, con cambios de ±10 %, ±20 % y ±30 %. Cada banda muestra el mínimo y máximo entre los escenarios bajo y alto. No es un intervalo de confianza ni un análisis probabilístico. Las probabilidades de subsanación se limitan a 0–100 %; la carga horaria varía escalando horas de primera revisión, revisión de subsanación y cargas administrativa y jurídica.

El coste directo acumulado en el horizonte suma: coste anual por ETP municipal × ETP municipales × meses/12; coste mensual del apoyo técnico manual por los meses activos dentro del horizonte; coste anual por ETP municipal imputado al refuerzo automático por sus ETP-mes activos; y coste por expediente afectado por informe externo × entradas del horizonte × incidencia externa. Coste por expediente resuelto divide por todos los expedientes equivalentes resueltos dentro del horizonte, incluidos backlog inicial y nuevas entradas; coste por hora ejecutada divide por las horas de servicio realmente consumidas en las fases modeladas durante ese horizonte. Si un coste necesario para un componente activo no está configurado, el coste total y sus cocientes se muestran como «No disponible»; los componentes inactivos aportan cero. El coste incremental del apoyo incluye solo la factura del apoyo manual y/o el coste salarial imputado al refuerzo automático. Los meses adelantados solo se calculan cuando el backlog inicial termina en ambos escenarios comparados. No se imputan costes indirectos ni se extrapolan costes después del horizonte. Estas convenciones permiten comparar escenarios, pero no constituyen contabilidad de costes.

## Ley de Little

`L = λ × W` relaciona expedientes en curso, tasa de salida estable y tiempo medio. El indicador se muestra únicamente cuando la capacidad configurada absorbe el flujo nuevo en los tres perfiles. Es una comprobación orientativa del régimen estacionario; durante la eliminación del atraso o con capacidad temporal variable no debe interpretarse como predicción de WIP observado.

## Limitaciones

- La simulación es diaria en días hábiles, pero determinista y basada en cohortes esperadas; no simula expedientes aleatorios ni decisiones profesionales individuales.
- La prioridad/FIFO se aplica a tareas agregadas en las colas técnicas; no reproduce la asignación real a profesionales ni la antigüedad de cada expediente histórico.
- Los percentiles calculados son del modelo ponderado, no percentiles empíricos. La falta de cohortes resueltas invalida los estadísticos agregados de tiempo.
- Los tiempos de fase son objetivos iniciales editables; no son plazos legales ni resultados observados.
- El modelo permite estacionalidad configurable, pero no representa vacaciones, absentismo, días festivos o variabilidad entre profesionales.
- Los costes directos solo se calculan cuando están configuradas las tarifas necesarias; no incluyen costes indirectos ni sustituyen una contabilidad presupuestaria.
- Los datos guardados en `localStorage` pertenecen al navegador y dispositivo actuales. JSON permite conservar y mover escenarios.

## Sustitución con datos reales

Para calibrar el simulador se necesitarán, como mínimo, entradas mensuales y mezcla por tipología; backlog y antigüedad a fecha de corte; dedicación efectiva por perfil; horas productivas observadas; fechas de cada transición de fase; subsanaciones y tiempos de respuesta; informes externos; salidas y resoluciones. Mantener separadas observaciones, supuestos y estimaciones al incorporar esos datos.
