> For the complete documentation index, see [llms.txt](https://academy.trowelapp.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://academy.trowelapp.com/planificacion/panel-de-detalle/progreso-de-ejecucion.md).
# Progreso de ejecución
### Descripción
El **progreso de ejecución** indica el porcentaje completado de cada tarea (0–100 %). Se muestra en la barra del Gantt y en el panel **Progreso de ejecución** del detalle.
No existe un selector de modo: el comportamiento del panel depende automáticamente de dos factores:
1. **Vinculación a partidas**: si la tarea tiene partidas de presupuesto vinculadas.
2. **Suscripción a Cashflow**: si el tenant tiene activa la suscripción al módulo Cashflow y vinculación presupuesto-planificación.
Además, la columna de **cantidades** en descompuestos depende de un ajuste de tenant (ver [Funcionalidades y datos por defecto](/administracion/configuracion/funcionalidades-y-datos-por-defecto.md#configuracion-de-presupuestos)).
### Comportamiento según vinculación y suscripción
#### Sin partidas vinculadas o sin suscripción Cashflow
* Solo se muestra el **campo de porcentaje** (0–100). El usuario introduce el valor directamente.
* El progreso se guarda automáticamente tras un breve retardo al editar.
* La tabla de partidas no se muestra (no hay partidas vinculadas o la suscripción Cashflow no está activa).
#### Con partidas vinculadas y suscripción Cashflow
* Se muestra la **tabla de partidas** vinculadas con:
* Código, descripción, unidad, cantidad presupuestada.
* **Progreso físico** (%), editable.
* **Cantidad teórica**: la que correspondería según el % de avance.
* **Cantidad ejecutada** o **Cantidad verificada** (según configuración del tenant; ver más abajo).
* El progreso consolidado de la tarea se calcula con un **promedio ponderado por TEE** (Tiempo de Ejecución Estimado en días). Si no hay TEE, se usa peso uniforme.
* Si las partidas tienen descompuestos estimados, saldrá una lista de todos los descompuestos agrupados en una fila correspondiente a la partida; en ese caso se edita el progreso y la cantidad por fila de descompuesto.
* Al rellenar la cantidad, obtenemos una comparativa con la cantidad teórica que debería llevarse. En caso de estar por encima de lo estimado, saldrá el indicativo con el exceso en la fila correspondiente.
#### Bloques (capítulos)
* Los bloques muestran únicamente las **métricas KPI** (progreso real, teórico, estado, fecha de finalización).
* No se muestran el campo manual ni la tabla de partidas. El progreso del bloque es el agregado calculado por el servidor a partir de sus tareas hijas.
### Cantidades en descompuestos: ejecutada vs verificada
Cuando una partida vinculada tiene **descompuestos** (partidas desglosadas en el presupuesto de coste), la cantidad que se introduce en el panel de progreso puede persistirse en uno de estos destinos, según la configuración del tenant:
| Configuración | Columna en el panel | Dónde se guarda en presupuesto |
| ----------------------------------- | ------------------- | ----------------------------------------------------------------------------------- |
| **Desactivada** (valor por defecto) | Cant. ejecutada | Medición de **cantidad incurrida / ejecutada** del descompuesto (*Coste incurrido*) |
| **Activada** | Cant. verificada | Medición de **cantidad verificada** del descompuesto (*Coste verificado*) |
**Comportamiento por defecto:** cantidad **ejecutada** (medición de ejecución).
**Alcance del ajuste:**
* Aplica **solo a filas de descompuesto** dentro del panel de progreso.
* Las partidas vinculadas **sin descompuesto** siguen usando la cantidad ejecutada del vínculo tarea–partida (`PlanningTaskBudgetItem`), independientemente de este ajuste.
* El **progreso físico (%)** y la **cantidad teórica** no cambian: siguen representando avance temporal/planificado y consumo esperado según ese avance.
* La cantidad introducida sigue siendo **independiente del % de progreso** (tiempo vs material).
**Persistencia:**
* Al guardar, el sistema calcula la diferencia respecto a la cantidad ya registrada y crea una **medición incremental** en la fase de certificación editable del proyecto.
* En modo ejecutada: actualiza `ExecutedQuantity` y las mediciones de ejecución del descompuesto.
* En modo verificada: actualiza `CheckedQuantity` y las mediciones de cantidad verificada del descompuesto.
**Etiqueta de la columna:** el panel muestra automáticamente *Cant. ejecutada* o *Cant. verificada* según el ajuste activo en el tenant.
> **Nota:** Tras cambiar el ajuste en configuración, conviene recargar la planificación para que el panel refleje la etiqueta y el origen de datos correctos.
### Métricas de rendimiento
El panel muestra siempre:
* **Progreso real**: el porcentaje actual (manual o calculado por partidas, según el caso).
* **Progreso teórico**: el que correspondería según el tiempo transcurrido entre fecha inicio y fin (días laborables).
* **Estado**: "A tiempo" o "Retraso" (con días de retraso si aplica).
* **Retraso en días**: diferencia entre lo que debería haberse avanzado y lo avanzado, expresada en días laborables.
* **Índice de eficiencia** (solo con partidas y Cashflow): desviación de consumo (cantidad teórica vs cantidad de la columna de cantidades). Positivo = infraconsumo; negativo = sobreconsumo.
* **Fecha de finalización**: cuando la tarea alcanza 100 %, se registra la fecha. Si es posterior a la fecha fin planificada, se indica "Finalizado con retraso".
### Fecha de finalización
Cuando una tarea alcanza **100 %** de progreso, se registra la fecha de finalización. Esta fecha puede usarse para reportes y para el cálculo de predecesoras de otras tareas.