Dashboard

Dashboard ist die projektbezogene Statusfläche der Suite: wie viele Arbeitselemente es gibt, was blockiert ist, wie es um die angebundenen Dienste steht, dazu ein Risikoregister. Es führt keinen eigenen Zustand — alles, was es zeigt, gehört einem anderen Paket. Gedacht ist es für Projektverantwortliche, die einen Überblick brauchen, ohne jede Liste einzeln zu öffnen.

Erste Schritte

Schnelleinstieg: Das Dashboard öffnen und das erste Risiko eintragen — der kürzeste Weg zum ersten Ergebnis, in zwei Schritten.

Voraussetzungen prüfen → Rechte klären → Dashboard öffnen

Häufige Aufgaben

Was Sie wollen	Für wen	Wo Sie das tun	Anleitung
das Dashboard eines Projekts öffnen	Projektbeteiligte	`do=wkdodashboard` auf einer Projektseite	Zweck
verstehen, warum eine Kennzahl leer bleibt	Projektbeteiligte	–	Kein eigener Zustand
herausfinden, warum jemand weniger sieht als Sie	Verwaltung	–	Drei Rechte, nicht eines
das Risikoregister pflegen	Projektverantwortliche	Dashboard	Zweck
eine Einstellung ändern	Verwaltung	Konfigurationsmanager	Konfiguration
wissen, was das Paket nicht leistet	alle	–	Grenzen

Zweck

Eine projektbezogene Statusfläche — Anzahl der Arbeitselemente, was blockiert ist, Zustand der Repositorys — dazu ein Risikoregister, das beim Projekt geführt wird und nicht anderswo.

Vier Tafeln: Arbeitselemente nach Zustand, die Zahl der blockierten, Repository-Gesundheit und das Risikoregister.

Kein eigener Zustand, und was daraus folgt

Das Dashboard führt keine eigenen Zähler. Jede Zahl wird zum Darstellungszeitpunkt aus den Daten des Projekts abgeleitet.

Auf dieser Seite ist nichts zu beheben. Eine falsche Zahl bedeutet falsche Daten, falsche Rechte oder eine zwischengespeicherte Seite — es gibt keine Dashboard-Einstellung, die sie berichtigen könnte.

Der Preis dafür ist die Rechenzeit: die Kosten sind die Summe der dargestellten Tafeln. Auf einem großen Projekt ist die Zusammenfassung der Arbeitselemente die teure; das Mittel dagegen sind weniger Tafeln und nicht eine zwischengespeicherte Zahl — die wäre genau die zweite Wahrheit, die diese Bauform vermeidet.

Drei Rechte, nicht eines

Recht	Frage
`canView`	darf diese Person das Dashboard sehen?
`canEditRisk`	darf sie einen Risikoeintrag ändern?
`canRemoveRisk`	darf sie einen Risikoeintrag entfernen?

Entfernen beendet eine Historie; Ändern berichtigt einen Datensatz. Beides zusammenzufassen machte einen unumkehrbaren Vorgang für jeden verfügbar, der einen Tippfehler korrigieren darf.

Zahlen achten die Rechte: das Dashboard zählt, was der Lesende sehen darf. Zwei Personen sehen deshalb berechtigterweise verschiedene Summen — das ist richtiges Verhalten und kein Fehlalarm.

Konfiguration

Keine. Die Zahlen leiten sich aus den Projektdaten ab, die Rechte aus der Projektrolle. Da das Dashboard keine Zähler führt, gibt es nichts, was eine Einstellung entscheiden könnte — und nichts, was mit den Daten außer Tritt geraten kann.

Voraussetzungen

PHP 8.2 oder neuer.
Core Plugin, DevOps Core, DevOps Storage Plugin.
Work Items und die Repository-Pakete liefern die Daten, die die Tafeln füllen. Ohne sie stellt sich das Dashboard dar und meldet, dass nichts zu zeigen ist — das ist zutreffend und nicht defekt.

Das optionale Darstellungspaket wvdsdwui ist auf dieser Installation nicht vorhanden; die Darstellung ist deshalb schlichter.

Grenzen

Blockierte Elemente und die Zustandszusammenfassung ergeben zusammen nicht die Gesamtzahl. Sie teilen die Menge nach verschiedenen Gesichtspunkten auf, ausdrücklich so.
Das Dashboard meldet, dass ein Repository nicht gesund ist, nicht warum. Der Grund gehört der Gesundheitsprüfung des jeweiligen Repository-Pakets.
Ein leeres Risikoregister auf einem aktiven Projekt ist ein Befund, kein Fehler.

Paketangaben

Plugin: wkdodashboard
Namespace: lib/plugins/wkdodashboard/
Autor: Wolfgang van der Stille Wolfgang.van.der.Stille@gmail.com (The White Knight Labs)
Lizenz: GPL 2