feat(carbon): Carbon-Konformität nachprüfbar machen statt behaupten

Recherche an der Quelle statt an der Dokumentation. Zwei Ergebnisse:

1. Carbon regelt Datenvisualisierung nur teilweise. Farben, Gitter, Achsen,
   Tooltip und Tickanzahl sind verbindlich festgelegt — Paddings, Margins und
   Dashboard-Raster dagegen NICHT. Die Carbon-Seiten zu Chart-Anatomie und
   Dashboards tragen ausdrücklich den Hinweis "this guidance is a work in
   progress" und enthalten keine Zahlenwerte. Unsere Abstandswerte stammen
   deshalb aus der Carbon-Spacing-Skala und der Planung mit dem Branchenpartner,
   nicht aus der Data-Viz-Norm. Das steht jetzt so in DESIGN-SYSTEM.md §0.

2. Eine echte Abweichung gefunden: Der Tooltip ist seit Carbon v11 hell
   (--cds-layer-02 #ffffff auf --cds-text-primary #161616, abgesetzt allein
   durch den Schatten). Unser Theme führte den dunklen v10-Stand (#393939) und
   berief sich dabei auf das ausgelieferte Stylesheet — die Angabe war veraltet.
   Korrigiert.

Neu:
- docs/carbon-referenz.json — kanonische Werte mit Quelle, Version und
  Prüfdatum, gezogen aus @carbon/charts 1.23.0 styles.min.css und
  configuration.ts. Bewusste Abweichungen (Balkenbreite 48 statt 16, feste
  Kategoriefarben statt n-Serien-Paletten) sind dort begründet.
- scripts/verify-carbon.mjs + npm run verify:carbon — gleicht chartTheme.ts
  gegen die Referenz ab und bricht bei Drift ab.
- docs/PRUEFFRAGEN.md — Prüffragen für die Gestaltungsabnahme mit
  nachprüfbarem Ja/Nein, plus Leseliste (FT Visual Vocabulary, IBCS,
  Cleveland & McGill, Few, Datawrapper Academy).

Die 14er-Palette wurde gegen die CSS-Variablen --cds-charts-14-1-* geprüft und
stimmt exakt; ebenso Gitter #e0e0e0, Achse #8d8d8d und Achsentext #525252.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01QPeZNwSeU7qG3RRCwaxEZX
This commit is contained in:
dejanandClaude Opus 5 committed 2026-08-29 17:53:51 +02:00
1 parent 99be627dad
commit 0875ae2688
8 files changed
+412 -20

No files matched your search

+108
View File
@@ -0,0 +1,108 @@
# Prüffragen für die Gestaltungsabnahme
Für Reviews ohne Designerauge. Die Fragen sind so gestellt, dass man sie am
Bildschirm beantworten kann — jede hat ein nachprüfbares Ja oder Nein, keine
Geschmacksfrage.
Reihenfolge nach Wirkung: Wer nur zehn Minuten hat, nimmt Abschnitt 1.
---
## 1. Die vier Fragen, die die meisten Fehler finden
**1. Nenne die Aussage der Seite in einem Satz.**
Geht das nicht, fehlt die Hierarchie. Auf jeder Seite muss genau ein Block
dominieren. Sehen alle Karten gleich aus, ist keiner wichtig.
**2. Gibt es ein Diagramm, dessen Balken oder Segmente alle etwa gleich groß sind?**
Dann trägt es keine Information. Typische Ursachen: Werte in einem engen Band
(74–96 %) auf einer Skala ab null, oder eine Rangfolge aus 5/4/3/3/3.
Entweder die Kodierung wechseln oder die Karte streichen.
**3. Steht dieselbe Zahl zweimal auf der Seite?**
Kennzahl oben und Fußzeile unter dem Diagramm sind der übliche Fall. Eine
Wiederholung ist kein Beleg, sondern verbrauchter Platz.
**4. Was soll der Betrachter danach tun?**
Findet sich darauf keine Antwort, ist es ein Bericht, kein Dashboard. Eine
Handlungsliste braucht je Zeile einen Betrag und ein Verb.
---
## 2. Diagramme
| Frage | Wenn nein |
|---|---|
| Beginnt jede Balkenachse bei null? | Balken kodieren über Länge — abgeschnitten lügen sie. Bei engen Wertebändern Punktdiagramm statt Balken |
| Hat jede Achse runde Werte (0/50/100, nicht 0/55/110)? | Der Leser rechnet bei jedem Blick mit |
| Trägt eine Achse genau eine Einheit? | „0 €" neben „10 T€" ist ein Einheitenwechsel mitten in der Skala |
| Belegt in einem Ring kein Segment mehr als etwa 80 %? | Dann ist die Bezugsgröße falsch gewählt, nicht der Diagrammtyp |
| Hat der Ring höchstens fünf Segmente? | Alles darüber gehört zu „Sonstige" zusammengefasst |
| Zeigt jede Legende eine Reihe, die es im Bild wirklich gibt? | Tote Legendeneinträge sind ein häufiger und peinlicher Fehler |
| Sind Kategorie- und Ampelfarben getrennt? | Eine grüne Kategorie neben einem grünen Positiv-Status ist nicht mehr lesbar |
| Behält eine Kategorie ihre Farbe über alle Seiten? | Sonst muss jede Legende neu gelesen werden |
| Ist bei jeder Karte erkennbar, ob sie den Zeitfilter beachtet? | Stichtagswerte neben gefilterten Werten ohne Kennzeichnung erzeugen falsche Schlüsse |
---
## 3. Zahlen und Text
- Tausendertrennung überall gleich? (`1.900`, nie `1900`)
- Dieselbe Zahl im selben Format? (`177 T€` und `177.010 €` auf einer Seite ist ein Bruch)
- Singular und Plural korrekt? („1 Tag", nicht „1 Tage")
- Spaltenköpfe einheitlich geschrieben?
- Bricht irgendwo Text ab, der nicht abbrechen dürfte? (Beträge, Kartenuntertitel)
---
## 4. Raster und Zustände
- Erzeugt eine Karte tote Fläche, weil die Nachbarkarte höher ist?
Gleiche Höhe ist nur bei gleicher Struktur richtig (Kennzahlenreihe), nicht bei
Diagramm neben Tabelle.
- Was passiert, wenn die Filter alles wegschneiden? Jede Ansicht braucht einen
Leerzustand.
- Ist der Tastaturfokus sichtbar? Mit Tab durch die Seite gehen.
- Schließt jedes Menü mit Escape?
- Verspricht ein Hover-Effekt eine Interaktion, die es nicht gibt?
---
## 5. Womit man das Auge trainiert
Kurz und ergiebig, in dieser Reihenfolge:
1. **FT Visual Vocabulary** — ein Poster, das Diagrammtypen nach Aussageabsicht
ordnet (Vergleich, Verteilung, Anteil, Veränderung …).
Das beste Verhältnis von Aufwand zu Ertrag überhaupt.
`github.com/Financial-Times/chart-doctor` → `visual-vocabulary`
2. **IBCS — International Business Communication Standards**, die SUCCESS-Regeln.
Das ist der ausgearbeitete Standard für *Geschäfts*grafik, den Carbon nicht
ersetzt: einheitliche Notation, Ist/Plan/Vorjahr, Informationsdichte.
Frei unter CC BY-SA auf `ibcs.com`.
3. **Cleveland & McGill (1984)**, „Graphical Perception". Die Studie, aus der die
Rangfolge der Kodierungen stammt: Position wird genauer gelesen als Länge,
Länge genauer als Winkel, Winkel genauer als Fläche. Erklärt in einer Seite,
warum Ringe schwach und Punktdiagramme stark sind.
4. **Stephen Few, „Information Dashboard Design"**. Das Standardwerk zur
Dashboard-Kritik; die ersten beiden Kapitel reichen für ein geschultes Auge.
5. **Datawrapper Academy** (`academy.datawrapper.de`) — kurze, gut belegte
Artikel zu einzelnen Fragen („Wann Balken, wann Linien", „Warum keine zwei
Y-Achsen").
Zum Zielsystem passend:
6. **Carbon Data Visualization** (`carbondesignsystem.com/data-visualization/`)
für Farben, Achsen und Diagrammtypen — mit der Einschränkung aus
[DESIGN-SYSTEM.md](DESIGN-SYSTEM.md) Abschnitt 0: Abstände regelt Carbon nicht.
7. **Carbon Spacing und 2x-Grid** (`carbondesignsystem.com/elements/spacing/`)
für genau diese Abstände.
---
## 6. Was hier bewusst nicht geprüft wird
Layout und Anordnung sind im Zielsystem **Entscheidung des Designers**
(siehe [LEITPLANKEN.md](LEITPLANKEN.md)). Verbindlich zu übergeben sind
Kennzahl-Definitionen, Diagrammregeln und Verhalten. Wer diese Liste im Review
benutzt, prüft die Substanz — nicht, ob eine Karte 40 px weiter links sitzt.