Cómo se calcula el avance

1. Avance de una acción

Cada acción tiene una ponderación (ponderacion_accion, entre 0 y 1) que representa cuánto pesa dentro de su meta. La suma de las ponderaciones de las acciones de una meta debe dar 1.

El avance se reporta por año del plan y por fecha de corte, en el nodo avance_accion_anual:

"A-003": {
  "ponderacion_accion": 0.5,
  "avance_accion_anual": {
    "2025-09-11": { "año1": 0 },
    "2025-12-16": { "año2": 0.25 },
    "2026-03-10": { "año1": 0, "año2": 0.25 }   ← último corte: es el que manda
  }
}

Consecuencias prácticas de que solo cuente el último corte:

• Reportar un corte nuevo reemplaza la lectura anterior; no se acumula con ella. Si en el corte nuevo omites un año que antes tenía valor, ese año pasa a contar como 0.
• Los cortes anteriores se conservan íntegros como historial y son los que dibujan la curva de evolución.
• Las claves de corte son fechas AAAA-MM-DD: el orden alfabético coincide con el cronológico.

2. Avance de una meta

Ejemplo real — meta E1M1

"Consolidar el sistema de autoevaluación y autorregulación institucional permanente", con cuatro acciones:

Nótese A-003: pesa 0,50 y solo ha reportado 0,25, es decir va por la mitad de su propio compromiso. Y A-004, que pesa 0,20, aún no aporta nada.

Ese 55 % es exactamente el avance_meta que S-PLAN publica hoy para E1M1. Compruébalo en el explorador del PDI.

3. Avance del PDI

Cada meta tiene una ponderación dentro del plan completo (ponderacion_meta). La suma de las 120 ponderaciones es 1.

Ambos valores se materializan al guardar cada meta:

• S-PLAN/metas_con_ponderacion/{meta} — avance efectivo, avance real, avance ponderado y los ids del eje/programa/proyecto. Es el índice que consumen dashboards e informes: evita recorrer el árbol completo.
• S-PLAN/avance_general — el número único del PDI.

4. Lo programado: cronograma y proyección

Además de lo ejecutado, S-PLAN necesita saber cuánto debía llevarse a cada año. Hay dos fuentes, y conviene no confundirlas.

a) Cronograma de la acción

cronograma_anual.añoK es un mapa de meses marcados ({ "12": true }). La regla es binaria y por año:

Una acción programada en varios años reparte su peso: en el gráfico de avance por acción, el objetivo de cada año es ponderación ÷ (número de años programados).

b) Proyección de la meta

proyeccion_anual guarda el reparto planeado por año (por ejemplo { año1: 0.1, año2: 0.5, año3: 0.3, año4: 0.1 }) y se interpreta según dos banderas de la meta:

5. Cumplimiento del Plan Anual de Acciones

Es un indicador distinto del avance del PDI y no debe mezclarse con él. Mide, dentro de la vigencia en curso, qué proporción de lo programado para ese año efectivamente se cumplió:

El índice S-PLAN/cumplimiento_meta_paa/{meta} guarda el resultado por meta y año, y es lo que consume la tarjeta Cumplimiento Plan Anual de Acciones y el informe técnico.

6. Overrides: cuando el número mostrado no es el calculado

En casos puntuales Planeación necesita mostrar un avance distinto del calculado —por ejemplo, mientras se revisa una inconsistencia de reporte—. S-PLAN lo soporta, pero con un mecanismo que conviene conocer porque no basta con escribir en la base de datos.

La ficha de meta marca los overrides vigentes en su tooltip (“valor real calculado: X %”), y el explorador del PDI los señala con el chip Avance con override. Actualmente hay … meta(s) con override activo.

7. Metas fantasma

Una meta real siempre tiene id_meta y titulo_meta. Un nodo que solo contenga ejecucion_financiera, inversion_realizada y fecha_actualizacion_financiera es un fantasma: una escritura financiera que aterrizó en la rama equivocada del árbol.

Distorsionan los conteos y las sumas de inversión. La defensa está en dos partes:

• Toda escritura financiera valida la ruta contra S-PLAN/indices_metas antes de guardar.
• Las vistas de proyecto filtran los nodos sin id_meta/titulo_meta.

Este explorador aplica el mismo filtro, así que los conteos que ves aquí ya excluyen fantasmas.

Checklist de diagnóstico