id: cumulative-progress
name:
  ja: 計画と実績の累積推移
  en: Cumulative Progress
purpose:
  ja: 累積計画と実績を重ね、最新観測時点での差を読む。
  en: Cumulative Progress with explicit source values and reading conditions.
status: published
still: ./still.png
category: analysis
catalogOrder: 390
jobs:
  - measure-change
useCases:
  - kpi
layoutKinds:
  - timeline
tags:
  - cumulative-progress
  - analysis
  - offline
  - responsive
whenToUse:
  - ja: 累積計画と実績を重ね、最新観測時点での差を読む。
    en: Use to communicate cumulative progress.
avoidWhen:
  - ja: 同じ条件・単位で比較できないデータには使わない
    en: Do not compare values with incompatible units, populations, or assumptions.
requiredInputs:
  - ja: 当期の増分ではなく累積値を入力。未観測期間との比較は行わない。
    en: Provide the source values, labels and decision conditions described by the schema.
relatedLayouts:
  - line-trend
  - critical-path-gantt
dataSchema:
  title: string — 結論を伝える見出し
  subtitle: string? — 出典・時点・母集団や仮定
  unit: string — 累積量の単位
  periods: array (0, 1) — 等間隔の期間
  planned: array () — 単調増加する累積計画
  actual: array () — 累積実績。未来は末尾のnull
sources: []