{
  "code": "S47",
  "name": "Data dashboard",
  "shape": "chart",
  "family": "Evidence and pictures",
  "fits": "One headline figure in a donut, a short bar breakdown, and three supporting figures, all from one data set.",
  "use_when": "Survey or results where several figures tell one story. The donut leads; the bars and figures support it. Charts are read at a glance.",
  "slots": [
    {
      "name": "eyebrow",
      "holds": "what the data is",
      "budget": "2-3 words"
    },
    {
      "name": "head",
      "holds": "the finding, one italic word",
      "budget": "under 8 words"
    },
    {
      "name": "donut",
      "holds": "one headline percentage + mono label + one-sentence reading, in a card",
      "budget": "sentence under 12 words"
    },
    {
      "name": "bars",
      "holds": "chart title + 3-5 bars (label, bar, value)",
      "budget": "label 3 words or fewer"
    },
    {
      "name": "figures",
      "holds": "3 x (number + mono label)",
      "budget": "label 4 words or fewer"
    },
    {
      "name": "source",
      "holds": "where the data comes from",
      "budget": "mono meta"
    }
  ],
  "columns": 2,
  "density": "dense",
  "surface": "paper",
  "works_on": [
    "deck",
    "page"
  ],
  "library": "Hoffman",
  "dir": "S47-data-dashboard",
  "semantic": {
    "audience_question": "How do the headline share, breakdown and supporting measures fit one data set?",
    "intent": "Understand a coherent quantitative overview rather than independent dashboard fragments.",
    "reasoning_relation": "part-to-whole measure and breakdown",
    "message_pattern": "[Finding] is visible in [comparison or distribution]; it means [bounded implication].",
    "required_content": [
      "One coherent dataset.",
      "A meaningful headline percentage.",
      "Three to five breakdown categories and three contextual measures."
    ],
    "narrative_positions": [
      "context",
      "explanation",
      "evidence: choose only when the page supports the surrounding argument"
    ],
    "requires_before": [
      "Define assessment, referral and final status."
    ],
    "enables_after": [
      "Explain the unresolved group or resource need."
    ],
    "slot_roles": {
      "eyebrow": "Identify the dataset or reporting period.",
      "head": "State the main finding, not a causal leap.",
      "donut": "Headline percentage, its denominator and a one-sentence interpretation.",
      "bars": "Three to five labeled categories with values, units and a shared scale.",
      "figures": "Three supporting metrics that add context rather than duplicate the donut.",
      "source": "Source, date, sample size and definitions needed to reproduce the reading."
    },
    "avoid_when": [
      "Charts from unrelated populations.",
      "A donut whose percentage lacks a denominator."
    ],
    "layout_specific_contract": "One headline figure in a donut, a short bar breakdown, and three supporting figures, all from one data set.",
    "provenance": {
      "basis": "interpretation of the existing layout and slot contracts",
      "review": "Tessel model-authored guidance; implementation approved by Nic, 2026-10-10",
      "corpus_evidence_status": "not yet established",
      "guide": "../SEMANTICS.md"
    },
    "reader_outcome": "Understand a coherent quantitative overview rather than independent dashboard fragments.",
    "matching": {
      "audience_question": "How do the headline share, breakdown and supporting measures fit one data set?",
      "reader_outcome": "Understand a coherent quantitative overview rather than independent dashboard fragments.",
      "reasoning_relation": "part-to-whole measure and breakdown",
      "content_shape": {
        "composition": "One headline figure in a donut, a short bar breakdown, and three supporting figures, all from one data set.",
        "selected_state": "One headline figure in a donut, a short bar breakdown, and three supporting figures, all from one data set.",
        "density": "dense",
        "columns": 2,
        "column_note": "Base metadata only; selected option can replace the base geometry."
      },
      "required_slots": [
        {
          "name": "eyebrow",
          "reader_question": "What kind of content or argument section am I reading?",
          "semantic_role": "Identify the dataset or reporting period.",
          "content_unit_count": {
            "min": 1,
            "max": 1,
            "basis": "authored composition members where a repeated group is specified; otherwise one named slot; not a required amount of evidence"
          },
          "placeholder": "[REAL CONTENT · eyebrow · what the data is]",
          "layout_budget": {
            "authored": "2-3 words",
            "policy": "Working composition guidance: preserve scope and qualification; change layout rather than truncate the argument."
          },
          "markup": {
            "slot": "eyebrow",
            "occurrences": 1,
            "annotation_status": "present",
            "visibility_status": "not asserted from static parsing",
            "sample_word_counts": [
              3
            ]
          }
        },
        {
          "name": "head",
          "reader_question": "How do the headline share, breakdown and supporting measures fit one data set?",
          "semantic_role": "State the main finding, not a causal leap.",
          "content_unit_count": {
            "min": 1,
            "max": 1,
            "basis": "authored composition members where a repeated group is specified; otherwise one named slot; not a required amount of evidence"
          },
          "placeholder": "[REAL CONTENT · head · the finding, one italic word]",
          "layout_budget": {
            "authored": "under 8 words",
            "policy": "Working composition guidance: preserve scope and qualification; change layout rather than truncate the argument."
          },
          "markup": {
            "slot": "head",
            "occurrences": 1,
            "annotation_status": "present",
            "visibility_status": "not asserted from static parsing",
            "sample_word_counts": [
              3
            ]
          }
        },
        {
          "name": "donut",
          "reader_question": "What specific quantity or comparable member supports the governing point?",
          "semantic_role": "Headline percentage, its denominator and a one-sentence interpretation.",
          "content_unit_count": {
            "min": 1,
            "max": 1,
            "basis": "authored composition members where a repeated group is specified; otherwise one named slot; not a required amount of evidence"
          },
          "placeholder": "[REAL DATA · donut · one headline percentage + mono label + one-sentence reading, in a card]",
          "layout_budget": {
            "authored": "sentence under 12 words",
            "policy": "Working composition guidance: preserve scope and qualification; change layout rather than truncate the argument."
          },
          "markup": {
            "slot": "donut",
            "occurrences": 1,
            "annotation_status": "present",
            "visibility_status": "not asserted from static parsing",
            "sample_word_counts": [
              13
            ]
          },
          "integrity": "Supply real values, units, denominator, period and traceable source; derive any chart geometry from those values."
        },
        {
          "name": "bars",
          "reader_question": "What specific quantity or comparable member supports the governing point?",
          "semantic_role": "Three to five labeled categories with values, units and a shared scale.",
          "content_unit_count": {
            "min": 3,
            "max": 5,
            "basis": "authored composition members where a repeated group is specified; otherwise one named slot; not a required amount of evidence"
          },
          "placeholder": "[REAL DATA · bars · chart title + 3-5 bars (label, bar, value)]",
          "layout_budget": {
            "authored": "label 3 words or fewer",
            "policy": "Working composition guidance: preserve scope and qualification; change layout rather than truncate the argument."
          },
          "markup": {
            "slot": "bars",
            "occurrences": 1,
            "annotation_status": "present",
            "visibility_status": "not asserted from static parsing",
            "sample_word_counts": [
              17
            ]
          },
          "integrity": "Supply real values, units, denominator, period and traceable source; derive any chart geometry from those values."
        },
        {
          "name": "figures",
          "reader_question": "What specific quantity or comparable member supports the governing point?",
          "semantic_role": "Three supporting metrics that add context rather than duplicate the donut.",
          "content_unit_count": {
            "min": 3,
            "max": 3,
            "basis": "authored composition members where a repeated group is specified; otherwise one named slot; not a required amount of evidence"
          },
          "placeholder": "[REAL DATA · figures · 3 x (number + mono label)]",
          "layout_budget": {
            "authored": "label 4 words or fewer",
            "policy": "Working composition guidance: preserve scope and qualification; change layout rather than truncate the argument."
          },
          "markup": {
            "slot": "figures",
            "occurrences": 1,
            "annotation_status": "present",
            "visibility_status": "not asserted from static parsing",
            "sample_word_counts": [
              15
            ]
          },
          "integrity": "Supply real values, units, denominator, period and traceable source; derive any chart geometry from those values."
        },
        {
          "name": "source",
          "reader_question": "Who is accountable for this material, and where can I verify it?",
          "semantic_role": "Source, date, sample size and definitions needed to reproduce the reading.",
          "content_unit_count": {
            "min": 1,
            "max": 1,
            "basis": "authored composition members where a repeated group is specified; otherwise one named slot; not a required amount of evidence"
          },
          "placeholder": "[REAL CONTENT · source · where the data comes from]",
          "layout_budget": {
            "authored": "mono meta",
            "policy": "Working composition guidance: preserve scope and qualification; change layout rather than truncate the argument."
          },
          "markup": {
            "slot": "source",
            "occurrences": 1,
            "annotation_status": "present",
            "visibility_status": "not asserted from static parsing",
            "sample_word_counts": [
              6
            ]
          }
        }
      ],
      "rejection_constraints": [
        "Figures from different populations, decorative donut values or unsupported aggregation.",
        "Illustrative shapes presented as real data; causal claims from a correlation alone."
      ],
      "option_guidance": {
        "option": "default",
        "composition_delta": "One headline figure in a donut, a short bar breakdown, and three supporting figures, all from one data set.",
        "semantic_change": "retains base content relationship; changes presentation or disclosure",
        "matching_instruction": "Select S47 default when the supplied material answers “How do the headline share, breakdown and supporting measures fit one data set?” through part-to-whole measure and breakdown. Respect this state: One headline figure in a donut, a short bar breakdown, and three supporting figures, all from one data set."
      },
      "provenance": {
        "status": "inferred composition evidence",
        "author_intent": "not independently confirmed",
        "basis": [
          "retained source composition where available",
          "authored layout and slot contracts",
          "static implementation inspection"
        ],
        "source_visual_count": 1,
        "source_visual_sha256": [
          "b3766806cf6bed19f9f37164f6f2f08e2346d42bcfb6576d3083e37310aaf988"
        ],
        "source_export": "private source images remain outside this draft site",
        "markup_sha256": "22eeac6e45d083fee83b894a34be08fdbce4cdd742e3bc1a7454a0a234904d8d",
        "limits": [
          "Static parsing inventories authored nodes; it does not certify rendered visibility, responsive fit or interactive state.",
          "Budgets are authored layout guidance, not a content-writing limit or proof of fit.",
          "Matching guidance is a draft inference; it does not establish facts, endorsement, causation or source author intent."
        ]
      },
      "adaptation_rules": [
        "Choose by audience question, reasoning relation and required content before aesthetic preference.",
        "Supply every required semantic role; retain visible unknowns as labelled real-content placeholders.",
        "A number needs source, scope and units; a quotation needs faithful wording and attribution.",
        "Do not infer importance from area, colour, depth or movement unless the content explicitly defines that encoding.",
        "Keep colour token roles, structural objects, licences and source records; changing content does not authorize changing them."
      ]
    },
    "rejection_constraints": [
      "Figures from different populations, decorative donut values or unsupported aggregation.",
      "Illustrative shapes presented as real data; causal claims from a correlation alone."
    ],
    "markup_inventory": {
      "file": "spread.html",
      "sha256": "22eeac6e45d083fee83b894a34be08fdbce4cdd742e3bc1a7454a0a234904d8d",
      "method": "static lxml markup plus authored option description; no rendered-visibility claim",
      "all_markup_slot_counts": {
        "eyebrow": 1,
        "head": 1,
        "donut": 1,
        "bars": 1,
        "figures": 1,
        "source": 1
      },
      "slot_evidence": {
        "eyebrow": [
          {
            "tag": "span",
            "classes": "eyebrow",
            "sample_word_count": 3,
            "repeated_children": 0
          }
        ],
        "head": [
          {
            "tag": "h2",
            "classes": "head",
            "sample_word_count": 3,
            "repeated_children": 1
          }
        ],
        "donut": [
          {
            "tag": "div",
            "classes": "card",
            "sample_word_count": 13,
            "repeated_children": 2
          }
        ],
        "bars": [
          {
            "tag": "div",
            "classes": "",
            "sample_word_count": 17,
            "repeated_children": 2
          }
        ],
        "figures": [
          {
            "tag": "div",
            "classes": "figs",
            "sample_word_count": 15,
            "repeated_children": 3
          }
        ],
        "source": [
          {
            "tag": "p",
            "classes": "meta",
            "sample_word_count": 6,
            "repeated_children": 0
          }
        ]
      },
      "option_selectors": [],
      "linked_implementation": [
        {
          "file": "../spreads.css",
          "sha256": "32da94472b0c9131e4d5dae7d5bf0498b09202a9e66294b4e4f23e6ddfbf37ba"
        },
        {
          "file": "../spread.js",
          "sha256": "3d99948b83f750bd4ae95dac08e3e50a395de7c149c90a6f1a1c0ea36a2634a4"
        }
      ]
    },
    "variations": {},
    "narrative_profile": {
      "central_point": "One headline proportion is explained by a related breakdown and three contextual measures.",
      "communication_job": "Answer what the main share means within the same dataset.",
      "audience_value": "Evidence and explanation: lets the reader test a summary proportion against its composition and denominator.",
      "reading_path": [
        "Read the headline percentage and what population it covers.",
        "Inspect the bar breakdown for the categories behind the story.",
        "Use the three smaller figures for context, then check the common source and period."
      ],
      "adaptation": {
        "required_inputs": [
          "One coherent dataset.",
          "A meaningful headline percentage.",
          "Three to five breakdown categories and three contextual measures."
        ],
        "slot_guidance": {
          "eyebrow": "Identify the dataset or reporting period.",
          "head": "State the main finding, not a causal leap.",
          "donut": "Headline percentage, its denominator and a one-sentence interpretation.",
          "bars": "Three to five labeled categories with values, units and a shared scale.",
          "figures": "Three supporting metrics that add context rather than duplicate the donut.",
          "source": "Source, date, sample size and definitions needed to reproduce the reading."
        },
        "can_change": [
          "Subject, names and wording within the active slot roles.",
          "Illustrations or supporting values where present, with their provenance and limits."
        ],
        "must_survive": [
          "Shared scope and consistent units.",
          "Part-to-whole categories reconcile where claimed.",
          "The source travels with the charts."
        ]
      },
      "worked_example": {
        "fictional": true,
        "scenario": "A fictional repair pilot distinguishes completed repairs from useful referrals.",
        "slot_fills": {
          "eyebrow": "May pilot",
          "head": "Most assessed devices had a next step.",
          "donut": "90% · 36 of 40 assessed devices repaired or referred.",
          "bars": "Disposition of 40 devices: repaired24; referred12; awaiting parts3; unresolved1.",
          "figures": [
            "40 · devices assessed",
            "3 · workshop sessions",
            "8 · volunteer shifts"
          ],
          "source": "Fictional May intake ledger; one final status per assessed device."
        },
        "reasoning": "The donut combines repaired and referred cases; the breakdown prevents the reader mistaking all 90% for completed repairs.",
        "qualification": "Every organization, value and assertion in this example is fictional. Replace it with approved, sourced content before use."
      },
      "narrative_fit": {
        "before": "Define assessment, referral and final status.",
        "after": "Explain the unresolved group or resource need.",
        "good_uses": [
          "A bounded survey or operational dataset."
        ],
        "poor_fits": [
          "Charts from unrelated populations.",
          "A donut whose percentage lacks a denominator."
        ]
      },
      "evidence": {
        "observations": [
          "Retained arrangement has a donut left, horizontal bars and three supporting figures right.",
          "Current HTML carries an explicit source slot."
        ],
        "interpretations": [
          "The communication job and reuse advice are inferred from the current arrangement and slot contract, not independently confirmed source intent."
        ],
        "not_verified": [
          "Original author intent, factual accuracy of sample copy and persuasion effects are not verified.",
          "No confidential archive or proposal corpus was used."
        ],
        "references": [
          "dist/S47-data-dashboard/spread.json",
          "dist/S47-data-dashboard/spread.html",
          "02_product/spreads/S47-data-dashboard/source.webp (viewed for arrangement)"
        ]
      },
      "review": {
        "status": "reviewed",
        "basis": "Motif inspected current metadata, active markup and the retained source arrangement, then checked the fictional example against the content roles. This is a layout-contract adaptation review."
      },
      "variation_relationship": "base"
    }
  },
  "options": [],
  "also_seen_in": [],
  "source": {
    "ref": "Hoffman L41 Data dashboard",
    "url": "https://github.com/neekchan/hoffman-agency-design-system/blob/main/templates/deck/Deck.dc.html"
  }
}