Dashboard

Das Dashboard ist der Startbildschirm. Es beantwortet eine Frage — wo steht heute jede Zahl — und hier entstehen neue KPIs. Diese Seite geht den Bildschirm von oben nach unten durch und nimmt danach eine einzelne KPI-Karte Element für Element auseinander.

Wo das Dashboard sitzt

Pulsaria hat sechs Hauptbildschirme: Dashboard, Projekte, Tägliche Erfassung, Berichte, Fetch-Log und App-Einstellungen. Ab 1024 px Fensterbreite liegen sie in einer festen 260 px breiten Seitenleiste links, unter der Überschrift „Navigation“. Das Pulsaria-Logo darüber führt zurück aufs Dashboard, die App-Version steht im Fuß der Seitenleiste. In schmaleren Fenstern erscheinen dieselben sechs Einträge als Tab-Leiste am unteren Rand.

Der aktive Eintrag ist cyan hervorgehoben und hat links einen schmalen Balken. Eine KPI-Detailseite (/kpi/<id>) gehört zu keinem Navigationseintrag — dort ist also nichts markiert.

Die Seitenleiste lässt sich nicht einklappen oder ausblenden, und sie hat keine Regel, die sie in schmalen Fenstern versteckt. Das Fenster-Minimum liegt bei 900 × 600: zwischen 900 px und 1024 px Breite überlagert die Seitenleiste den Inhalt, während gleichzeitig die untere Tab-Leiste sichtbar ist. Halte das Fenster mindestens 1024 px breit.

Auf macOS liegt in der Menüleiste Pulsaria → Settings… (Cmd+,) und springt zu den App-Einstellungen. Das ist die einzige Tastenkombination der App. Es gibt kein Cmd+N, keinen Shortcut fürs Aktualisieren und keine Befehlspalette.

Der Kopfbereich

Die Überschrift lautet „Dashboard“, darunter steht das heutige Datum — Wochentag, Tag, Monat und Jahr, formatiert in der App-Sprache. Rechts sitzt der Button Aktualisieren.

Aktualisieren

Aktualisieren führt alle automatischen KPIs sofort aus und ignoriert dabei deren Zeitplan. Es ist derselbe Code-Pfad wie beim Scheduler: Werte, Fetch-Log-Zeilen und Warnungen entstehen exakt so wie bei einem planmäßigen Lauf.

Das Ergebnis kommt als Toast, dessen Beschreibung die Ausgänge zählt, verbunden mit · — zum Beispiel 3 erfolgreich · 1 übersprungen:

Situation	Toast-Titel	Aktions-Button
Keine automatischen KPIs vorhanden	„Keine Auto-KPIs konfiguriert“	—
Mindestens ein KPI wurde übersprungen	„Auto-KPIs aktualisiert“	Freigeben — öffnet den Bearbeiten-Dialog des ersten übersprungenen KPI
Nichts übersprungen, etwas fehlgeschlagen	„Auto-KPIs mit Fehlern“	Details — öffnet das Fetch-Log
Alles hat geklappt	„Auto-KPIs aktualisiert“	—

Der Fall „übersprungen“ hat Vorrang vor dem Fall „fehlgeschlagen“: ein Lauf mit übersprungenen und fehlgeschlagenen KPIs zeigt den neutralen Toast „Auto-KPIs aktualisiert“, nicht den roten. Toasts mit Aktion bleiben 30 Sekunden stehen, reine Fehler-Toasts 8, Erfolg und Info 5.

Zwei Einschränkungen. Den Button gibt es nur auf macOS — automatisches Abrufen läuft ausschließlich dort, auf anderen Plattformen blendet er sich komplett aus. Und er ist deaktiviert, mit dem Tooltip „Lizenz oder aktive Testversion nötig“, sobald die Testphase abgelaufen ist oder eine Lizenz widerrufen wurde.

Was „übersprungen“ bedeutet und wie Zeitpläne funktionieren, steht unter Zeitpläne & Aktualisierung.

Die Übersichts-Pills

Unter dem Kopfbereich liegt eine Reihe von Pills, die über die ganze App zählen, projektübergreifend:

• Gesamtzahl der KPIs.
• Im Plan in Grün — immer sichtbar, auch bei null.
• Gefährdet in Amber — nur sichtbar, wenn der Wert über null liegt.
• Aus dem Plan in Rot — nur sichtbar, wenn der Wert über null liegt.

Ein KPI ganz ohne erfassten Wert gilt intern als „aus dem Plan“, wird aus der roten Pill aber herausgerechnet — sonst würde die Zahl der neutralen Karte daneben widersprechen.

Gruppen

Karten sind gruppiert. Die Reihenfolge liegt fest:

1. Unternehmensweit — alle KPIs ohne Projekt.
2. Ein Abschnitt pro Projekt, in der Reihenfolge, in der die Projekte angelegt wurden.
3. Sonstige — erscheint nur, wenn ein KPI auf ein Projekt zeigt, das es nicht mehr gibt.

Jedes Projekt bekommt einen Abschnitt, auch ohne KPIs. Damit ist das Dashboard der natürliche Ort, um ein frisches Projekt zu füllen. Eine leere Gruppe zeigt die Zeile „Noch keine KPIs hier — mit „+ KPI“ anlegen.“

Jeder Gruppenkopf zeigt den Namen, die Anzahl der KPIs und farbige Punktzähler für „im Plan“, „gefährdet“ und „aus dem Plan“. Wie bei den Pills wird ein Zähler ausgeblendet, wenn er null wäre, und KPIs ohne Daten zählen nicht in den roten.

Einklappen

Ein Klick auf den Gruppenkopf klappt die Gruppe ein oder aus. Der Pfeil dreht sich, der Abschnitt schließt sich über 250 ms. Eingeklappte Gruppen bleiben über Neustarts hinweg eingeklappt — der Zustand liegt in Pulsarias Konfigurationsdatei, nicht nur im Arbeitsspeicher.

Ein „Alle einklappen“ gibt es nicht, und Gruppen lassen sich von hier aus weder umsortieren noch umbenennen.

+ KPI

Jede Gruppe außer Sonstige hat einen + KPI-Button. Er öffnet den Dialog für einen neuen KPI mit dem Bereich der Gruppe vorausgewählt. Sonstige hat bewusst keinen — die Gruppe ist kein echtes Ziel zum Anlegen.

Im Nur-Lesen-Modus ist der Button deaktiviert, mit dem Tooltip „Lizenz oder aktive Testversion nötig“. Das ganze Formular beschreibt Aufbau eines KPI.

Die KPI-Karte im Detail

Jeder KPI ist eine Karte. Von oben nach unten:

Kopfzeile

• Ein farbiger Punkt und der KPI-Name. Die Farbe ist reine Position, keine Bedeutung: die Karten durchlaufen Cyan, Violett, Smaragd, Amber, Rot und Purpur, und der Zyklus läuft über Gruppengrenzen hinweg weiter. Die Sparkline bekommt dieselbe Farbe.
• Ein Quellen-Badge — CONNECTOR, BASH oder HTTP — bei KPIs, die sich selbst holen. Manuelle KPIs haben keins.
• Ein Play-Button neben dem Badge, bei automatischen KPIs. Er ist immer sichtbar, kein Hover nötig, und er fehlt bei manuellen KPIs und auf Nicht-macOS-Builds.
• Ein Status-Punkt ganz rechts: grün im Plan, amber gefährdet, rot aus dem Plan. Ein KPI ohne erfassten Wert zeigt stattdessen einen neutralen grauen Punkt.

Der Play-Button holt genau diesen einen KPI, ohne das Dashboard zu verlassen. Erfolg meldet der Toast „KPI aktualisiert“ mit <Name>: <Wert>, ein Fehlschlag „Auto-KPI fehlgeschlagen“ mit der Aktion Details ansehen, die das Fetch-Log öffnet — dort liegt die vollständige Ausgabe.

Im Nur-Lesen-Modus ist der Play-Button nicht deaktiviert. Ein Klick erzeugt den generischen Toast „Auto-KPI fehlgeschlagen“, dessen Beschreibung „Trial expired“ oder „License revoked“ lautet.

Wert und Abstands-Badge

Der aktuelle Wert ist die große Zahl in Monospace, daneben die Einheit klein. „Aktuell“ heißt: der neueste erfasste Wert, nicht zwingend der von heute — wenn du zuletzt am Montag etwas eingetragen hast, zeigt die Karte am Donnerstag weiterhin den Montagswert.

Ändert sich der Wert nach einer Aktualisierung, pulsiert die Zahl einmal für knapp eine Sekunde. Das passiert nur bei einer Änderung, nie beim ersten Rendern.

Gegenüber dem Wert sitzt das Abstands-Badge: der prozentuale Abstand zwischen deinem Wert und dem heutigen Ideal, mit Pfeil nach oben oder unten, beschriftet mit vs. Ideal — oder vs. Ziel bei einem KPI vom Typ „wiederkehrender Wert“. Die Farbe folgt dem Abstand:

Situation	Farbe
Auf oder über dem Ideal	Grün
Weniger als 10 % dahinter	Amber
10 % oder mehr dahinter	Rot

Was „voraus“ heißt, hängt von der Richtung ab: bei „höher ist besser“ auf oder über dem Ideal, bei „niedriger ist besser“ auf oder unter dem Ideal. Das Badge erscheint nur, wenn das heutige Ideal größer als null ist — ganz am Anfang eines Zeitraums oder bei einem Zielwert von 0 gibt es nichts Sinnvolles zu vergleichen.

Ein KPI ganz ohne Verlauf zeigt statt eines Werts einen Gedankenstrich, und im Badge steht Heute eintragen.

Das Ideal selbst erklärt Ideal-Linie & Status.

Badge zur Vorwoche

Unter dem Wert zeigt ein kleines Badge die Veränderung gegenüber der Vorwoche, zum Beispiel +12% vs. Vorwoche. Verglichen wird der neueste erfasste Wert mit dem nächstgelegenen Punkt sieben Tage davor oder früher — Ankerpunkt ist dein neuester Eintrag, nicht das heutige Datum.

Dafür braucht es mindestens zwei erfasste Tage und je einen Punkt auf beiden Seiten des Sieben-Tage-Fensters. Reicht der Verlauf nicht, fehlt das Badge einfach. Die Farbe folgt der Richtung des KPI: grün, wenn die Veränderung für dich gut ist, rot, wenn nicht.

Sparkline mit Ideal-Linie

Das 120 px hohe Diagramm zeichnet den kompletten Zielzeitraum, einen Punkt pro Kalendertag — 1. Januar bis 31. Dezember bei einem Jahres-KPI, den laufenden Monat bei einem Monats-KPI, das laufende Quartal bei einem Quartals-KPI, den konfigurierten Bereich bei einem eigenen Zeitraum.

• Die gefüllte Linie in der Akzentfarbe der Karte sind deine Ist-Werte. Tage ohne Eintrag sind Lücken, werden aber durchverbunden, damit die Linie durchgehend bleibt.
• Die graue gestrichelte Linie ist der Ideal-Verlauf. Sie wird bewusst linear interpoliert — das Modell dahinter ist eine Gerade, eine Kurve würde es falsch darstellen.
• Tage nach heute bleiben leer, weil es keine Zukunftsdaten gibt.

Beim Überfahren erscheint ein Tooltip mit dem Tag, dem Ist-Wert (Ist) und dem Ideal (Ideal) — bzw. Ziel bei einem wiederkehrenden Wert. Es gibt keine Achsen, keine Legende, keinen Zoom; diese Version des Diagramms liegt auf der KPI-Detailseite.

Die Ist-Linie wird über 800 ms eingeblendet. Die Animation entfällt, wenn in macOS „Bewegung reduzieren“ aktiv ist. Die Ideal-Linie wird nie animiert.

Fußzeile

Eine dünne Fußzeile trägt zwei Fakten:

• Links, neben einem Zielsymbol: der Zielwert mit Einheit und Zeitraum-Suffix — /Jahr, /Monat oder /Quartal. Bei einem eigenen Zeitraum steht dort stattdessen eine Datumsspanne wie 1. Mär – 30. Jun.
• Rechts: das heutige Ideal, beschriftet mit ideal: — bzw. Ziel: bei einem wiederkehrenden Wert.

Was ein Klick macht

Ein Klick irgendwo auf die Karte außer auf den Play-Button öffnet die Detailseite des KPI. Außerdem leuchtet die Karte unter dem Mauszeiger auf — der Schein folgt dem Cursor.

Auf der Karte selbst gibt es kein Bearbeiten und kein Verschieben nach… — das liegt auf der KPI-Detailseite.

Wenn eine Karte rot ist

Lassen sich die Daten eines KPI nicht lesen — eine defekte Datei oder eine falsch geformte, die von einem anderen Gerät synchronisiert wurde — wird die Karte durch eine rote ersetzt: KPI-Name, die Zeile „KPI konnte nicht geladen werden“, die Fehlermeldung im Rohtext in Monospace und „Klicken, um zu bearbeiten“. Ein Klick öffnet die Detailseite mit bereits geöffnetem Bearbeiten-Dialog.

Ein unlesbarer KPI reißt nie das ganze Dashboard mit: der Fehler wird pro KPI abgefangen, der Rest des Rasters rendert normal. Eine Reparaturfunktion über den Bearbeiten-Dialog hinaus gibt es nicht.

Warnungen

Wenn ein KPI in einen schlechteren Zustand rutscht, erscheint über dem KPI-Raster ein rot umrandeter Kasten mit der Überschrift „2 Warnungen“. Jede Zeile lautet <KPI-Name> ist gefährdet (oder „ist aus dem Plan“), dazu Tag, Monatskürzel und Uhrzeit.

Wie Warnungen entstehen

Eine Warnung entsteht, wenn ein gespeicherter Wert den Status des KPI verschlechtert — auf „gefährdet“ oder „aus dem Plan“. Das gilt für Werte, die du eintippst, genauso wie für Werte, die ein Abruf bringt; beide laufen durch dieselbe Prüfung.

• Verbesserungen erzeugen nie eine Warnung. Von „aus dem Plan“ zurück auf „im Plan“ ist eine gute Nachricht, keine Warnung.
• Der alte Status wird aus einem anderen Eintrag desselben Tages berechnet, falls es einen gibt, sonst aus dem jüngsten früheren Tag.
• Warnungen liegen in alerts.json neben deinen Daten. Die neuesten 100 bleiben erhalten.

Lesen und verwerfen

Ein Klick auf eine Warnungszeile springt zur Detailseite des KPI. Fährst du über eine Zeile, erscheint ein ×, das genau diese Warnung verwirft; Alle verwerfen oben rechts räumt alle ab — dieser Button erscheint erst ab zwei Warnungen.

Verworfene Warnungen werden markiert, nicht gelöscht, und aus dem Kasten herausgefiltert. Es gibt keinen Verlauf für Warnungen und keine Möglichkeit, eine verworfene zurückzuholen. Warnungen werden außerdem nie zu Systembenachrichtigungen; die einzige Benachrichtigung, die Pulsaria verschickt, ist die tägliche Erinnerung aus den Einstellungen.

Das Hinweis-Banner

Zwischen Warnungen und KPI-Raster kann ein einzelnes cyanfarbenes Banner mit Glühbirnen-Symbol auftauchen und etwas vorschlagen, das du noch nicht eingerichtet hast. Es hat einen Titel, eine Zeile Text, einen Aktions-Button und ein ×.

Fünf Hinweise gibt es, geprüft in dieser Reihenfolge:

Hinweis	Erscheint, wenn	Der Button führt zu
„Gruppiere deine KPIs in Projekte“	3 oder mehr unternehmensweite KPIs und kein Projekt existiert	Dialog für ein neues Projekt
„Automatisiere deine KPI-Erfassung“	macOS, 5 oder mehr manuelle KPIs, kein automatischer	Dialog für einen neuen KPI im Dashboard
„Vergiss keinen Check-in mehr“	Seit 3+ Tagen installiert, Einträge an 3+ Tagen, Erinnerung aus	App-Einstellungen
„Pulsaria beim Login starten“	macOS, seit 3+ Tagen installiert, Autostart aus	App-Einstellungen
„Zwischen deinen Macs synchronisieren“	Seit 7+ Tagen installiert, kein eigener Datenordner	App-Einstellungen

Sowohl der Aktions-Button als auch das × gelten als Verwerfen: der Hinweis wird dauerhaft vermerkt und kommt nie wieder. Pro App-Sitzung erscheint höchstens ein Hinweis — wurde einer gezeigt, folgt keiner mehr, bis du Pulsaria neu startest. Hat nichts gepasst, läuft die Prüfung beim nächsten Öffnen des Dashboards einfach erneut.

Eine Liste der Hinweise gibt es nicht, und einen verworfenen kannst du nicht reaktivieren.

Das Banner für Testphase und Lizenz

Über den Warnungen weist ein Banner auf den Lizenzstatus hin:

Zustand	Ton	Buttons
Testphase, 4–10 Tage übrig	Amber	Pulsaria kaufen
Testphase, 3 Tage oder weniger	Rot	Pulsaria kaufen
Testphase abgelaufen	Rot, blockierend	Pulsaria kaufen, Lizenz-Einstellungen
Lizenz widerrufen	Rot, blockierend	Lizenz-Einstellungen
Lizenz seit 30+ Tagen nicht verifiziert	Amber	Neu prüfen

Bei aktivierter Lizenz und in einer Testphase mit mehr als 10 verbleibenden Tagen erscheint nichts. Lizenz-Einstellungen und Neu prüfen sind schlichte Links in die App-Einstellungen — die eigentliche Prüfung läuft dort, nicht im Banner. Das Banner lässt sich nicht wegklicken. Details stehen unter Testphase & Lizenz.

Leere Zustände

Es gibt zwei, und sie sehen völlig unterschiedlich aus.

Gar nichts — keine KPIs und keine Projekte. Das Dashboard zeigt ein Willkommensfeld: „Willkommen bei Pulsaria“, eine kurze Erklärung und drei Buttons — Projekt anlegen, KPI anlegen und Vorlage verwenden. In diesem Zustand gibt es keinen Aktualisieren-Button, keine Übersichts-Pills und überhaupt keine Banner, auch kein Lizenz-Banner.

Vorlage verwenden legt ein fertiges Set von KPIs an. Der Button existiert nur hier und im letzten Schritt des Willkommens-Assistenten; sobald ein einziger KPI oder ein Projekt existiert, verschwindet er, und es gibt keinen anderen Weg zu den Vorlagen zurück.

Projekte, aber keine KPIs. Dann siehst du das normale Gruppenlayout mit leeren Gruppen, jede mit ihrer Hinweiszeile und ihrem eigenen + KPI-Button.

Wie du von leer zur ersten Zahl kommst, steht unter Dein erster KPI.

Laden und Live-Updates

Während die Daten laden, zeigt das Dashboard einen grauen Platzhalter in der Form des Echten: eine Titelzeile, drei Pills und sechs Karten. Das Pulsieren entfällt, wenn in macOS „Bewegung reduzieren“ aktiv ist.

Der Bildschirm liest seine Daten neu, sobald irgendwo in der App geschrieben wird — ein gespeicherter Wert, ein fertiger Abruf, eine neue Fetch-Log-Zeile. Ein planmäßiger Abruf, der läuft, während du aufs Dashboard schaust, aktualisiert die Karte an Ort und Stelle, ohne Neuladen.

Stürzt der Bildschirm selbst ab, wird er durch „Etwas ist schiefgelaufen“ ersetzt, mit einem Button Neu laden und dem Hinweis, dass deine Daten sicher gespeichert sind. Ein Wechsel auf einen anderen Bildschirm räumt den Fehler ebenfalls ab.

Was das Dashboard nicht kann

Klar gesagt:

• Keine Suche, kein Filter, keine Sortierung. Keine Befehlspalette.
• Keine Kartenreihenfolge. Karten stehen innerhalb einer Gruppe in der Reihenfolge ihrer Anlage, Gruppen in der oben beschriebenen Ordnung.
• Kein Drag-and-drop, nirgends.
• Kein Bearbeiten von der Karte aus — Werte erfasst du auf der KPI-Detailseite oder unter Werte erfassen.
• Keinen Datumsbereich für das ganze Board. Jede Karte zeigt immer ihren kompletten Zielzeitraum.