Datos para gráfico de progreso e hitos de objetivos

Indique el valor inicial, el valor más reciente, el objetivo y los porcentajes de los hitos que desea mostrar. El resultado presenta el progreso real, una posición limitada apta para el gráfico, los hitos alcanzados, el siguiente hito cuando exista y una serie ordenada de puntos. Funciona tanto con objetivos ascendentes como con metas que deben disminuir, por ejemplo defectos, gastos o tiempos de respuesta.

Defina el objetivo con un punto de partida explícito

Para obtener un porcentaje de progreso útil se necesitan tres valores, no solo el valor actual y el objetivo. El valor inicial establece el cero por ciento, el objetivo establece el cien por ciento y el valor actual indica la situación presente. Esta diferencia resulta esencial cuando el trabajo parte de una referencia distinta de cero. Por ejemplo, si una puntuación debe subir de 20 a 100, el punto medio es 60, no un progreso del sesenta por ciento calculado directamente sobre la puntuación. Envíe estos datos como números e incluya al menos un porcentaje de hito entre cero y cien. Puede indicar los hitos en cualquier orden; los porcentajes repetidos se consolidan para entregar al gráfico una serie ascendente limpia. El objetivo debe ser diferente del inicio, porque un intervalo de longitud cero no permite calcular una proporción significativa. Si ambos coinciden, la capacidad devuelve un error de entrada tipado, en lugar de infinito, un porcentaje arbitrario o datos que solo parecen correctos. Cada solicitud admite hasta cien elementos de hito, suficientes para planes detallados sin dejar de limitar el procesamiento y la salida.

Interprete de forma uniforme objetivos ascendentes y descendentes

Una misma fórmula sirve para ambos sentidos: el progreso es la distancia recorrida desde el inicio dividida por la distancia total entre inicio y objetivo. Cuando el objetivo supera al inicio, el resultado identifica una meta ascendente. Cuando es menor, identifica una meta descendente; así, pasar de 100 incidencias a un objetivo de 20 se considera avance y no un resultado negativo. El porcentaje de progreso devuelto no se limita de manera intencionada. Un valor inferior a cero revela un retroceso más allá del punto inicial, mientras que uno superior a cien refleja que se ha superado el objetivo. Para la presentación, chart_progress_percentage y chart_percentage del punto actual sí se restringen al intervalo de cero a cien. La decisión sobre qué hitos se han alcanzado utiliza el progreso real sin limitar. Cada hito normalizado incluye su porcentaje, el valor correspondiente dentro del trayecto y un indicador de cumplimiento. La salida incluye además la cantidad y los porcentajes de los hitos alcanzados, junto con el siguiente hito si todavía queda alguno pendiente. Si todos se han cumplido, ese campo opcional se omite en lugar de devolver null.

Utilice los puntos en gráficos y vistas de estado

El array chart_points aporta un punto inicial ordenado, un punto por cada hito normalizado y un punto final para el objetivo. Cada registro contiene su tipo, porcentaje, valor y estado de cumplimiento, por lo que puede alimentar gráficos de líneas, barras de avance, marcadores cronológicos y resúmenes textuales accesibles. El objeto current_point conserva el valor actual y el progreso real, y también ofrece la coordenada limitada para el gráfico. Esta separación permite colocar el marcador en un extremo cuando la meta se encuentra retrasada o superada, sin ocultar la cifra verdadera en la etiqueta o descripción emergente. Use reached_milestone_percentages para insignias, celebraciones o eventos de auditoría, y next_milestone para explicar el próximo paso sin volver a recorrer la lista. El cálculo es determinista y no usa red, hora, estado almacenado ni valores aleatorios; la misma entrada siempre produce la misma salida. Puede ejecutarlo gratis en el navegador para planificar o usar la API por $0.002 por solicitud al generar informes, actualizar paneles o procesar objetivos automáticamente.