id: waterfall
name:
  ja: "ウォーターフォールチャート（増減ブリッジ）"
  en: "Waterfall Chart (Change Bridge)"
purpose:
  ja: "起点から終点までの増減要因を累計配置の棒（ブリッジ）で示す。PowerPointのネイティブ滝グラフが自動化する「累計配置」だけでは差別化にならないため、同じデータを寄与度順（|増減|降順）の横棒ランキングに切り替えられる点が核。数値は常時表示し、補足は図の下で展開する"
  en: "The factors between a start and an end as stacked bars. The same data also switches to a ranking by contribution, which is what distinguishes it from a chart tool's built-in bridge"
status: published
# 索引カードの図版。pnpm layout:render が原本から描く。
still: ./still.png
category: breakdown
catalogOrder: 70
jobs:
  - measure-change
  - prioritize-diagnose
useCases:
  - kpi
layoutKinds:
  - waterfall
tags: [waterfall, bridge, breakdown, contribution, data-driven, interactive]
whenToUse:
  - ja: "四半期・年度の利益/売上ブリッジ（期首→期末の増減要因分解）"
    en: "A profit or revenue bridge across a quarter or a year"
  - ja: "コスト増減・原価変動の要因分析"
    en: "Analysing what moved a cost or a unit price"
  - ja: "施策・要因ごとの寄与度をランキングで示したい場合"
    en: "Ranking how much each factor contributed"
  - ja: "単なる推移ではなく「何が」「どれだけ」効いたかを説明したい場合"
    en: "When the point is what moved it and by how much, not the trend"
avoidWhen:
  - ja: "同一母集団が段階ごとに減少する転換を説明したい場合"
    en: "A single population narrowing stage by stage"
  - ja: "複数指標の現在値と目標達成を一覧したい場合"
    en: "Listing several indicators against their targets"
requiredInputs:
  - ja: "起点と終点の値"
    en: "The start and end values"
  - ja: "増減要因ごとの差分値"
    en: "The difference each factor makes"
  - ja: "各要因の補足"
    en: "A note on each factor"
relatedLayouts: [kpi-cards, conversion-funnel, logic-tree]
dataSchema:
  title: "string — スライドタイトル。結論を書くメッセージラインを推奨"
  subtitle: "string（任意）— 補足・出典など"
  steps: "{ label, value, isTotal?, note?, highlight? } の配列。4〜7件が読みやすい（起点・終点を含む）"
  steps[].value: "number — isTotal: true なら累計の絶対値（起点・終点・中間集計のアンカー）。false/省略なら直前の累計に加算される差分（正=増加、負=減少）"
  steps[].isTotal: "boolean（任意）— true なら累計のリセット地点（primary色の構造バー）。省略時は差分（増加=tertiary/減少=secondary）"
  steps[].note: "string（任意）— 図の下の補足欄で明示的に展開される詳細（要因・前提・出典）"
  steps[].highlight: "boolean（任意）— 最重要の1件のみ true。isTotal のステップに付けると寄与度順ビューでは除外され消えるため、差分ステップに付けること（スキーマが拒否する）"
sources: []