Aufbau eines KPI

Ein KPI ist in Pulsaria eine kleine Definition: ein Name, eine Zahl, auf die du zielst, und die Regeln, nach denen Pulsaria entscheidet, ob der heutige Wert gut genug ist. Diese Seite geht jedes Feld des Formulars durch, in der Reihenfolge, in der es erscheint, und sagt dir, was passiert, wenn du es später änderst.

Wo das Formular liegt

Pulsaria hat keine zentrale KPI-Liste. KPIs entstehen im Dashboard und werden auf der Detailseite des einzelnen KPI verwaltet.

Einen neuen KPI startest du an vier Stellen:

1. Dashboard → + KPI in einem Gruppenkopf. Die Gruppe bestimmt den vorausgewählten Bereich.
2. Leeres Dashboard → KPI anlegen.
3. Projekte → + KPI auf einer Projektkarte.
4. Detailseite eines Projekts → Neuer KPI.

Beim Anlegen öffnet der Dialog zuerst die Quellenauswahl mit der Zeile „Woher kommen die Daten dieser KPI? Du kannst das später ändern.“ und vier Karten: Manuell, Connector, Bash, HTTP. Nach der Auswahl erscheint das Konfigurationsformular mit zwei Abschnitten — erst Datenquelle, dann Ziel.

Beim Bearbeiten entfällt die Quellenauswahl. Der Dialog öffnet direkt das Konfigurationsformular, und die Quelle wird zu einem Vier-Wege-Schalter, den du an Ort und Stelle umlegen kannst.

Pflicht sind nur Name und Zielwert. Alle anderen Felder haben einen Standardwert.

Name

Freitext, Pflichtfeld, Platzhalter z. B. Umsatzwachstum. Bleibt er leer, erscheint „Name ist erforderlich“ und das Speichern wird blockiert.

Späteres Umbenennen ist unkritisch. Es ändert das Label überall dort, wo der KPI ab diesem Moment angezeigt wird. Bereits ausgelöste Warnungen und schon geschriebene Zeilen im Fetch-Log behalten den alten Namen — beide speichern den Namen so, wie er zum Zeitpunkt der Aufzeichnung war.

Einheit

Freitext, ganz nach deinem Geschmack. Neue KPIs starten mit vorausgefülltem %. Es gibt kein Dropdown, keine Währungsauswahl und keine Validierung — ein KPI mit leerer Einheit lässt sich problemlos speichern.

Die Einheit wird wörtlich neben die Zahl geschrieben und bestimmt außerdem, wie viele Nachkommastellen Pulsaria anzeigt:

Einheit (exakte Übereinstimmung)	Nachkommastellen
%, stars, k, GB/h	bis zu 1
ms, hours, $/day, /week, /day, count, points	0
EUR, USD, GBP, CHF, €, $	0 ab 1000, sonst genau 2
alles andere	bis zu 2

Der Abgleich ist exakt und unterscheidet Groß- und Kleinschreibung: EUR bekommt die Währungsregel, eur und Eur fallen in die letzte Zeile. Tausendertrennung und Dezimalzeichen folgen der App-Sprache — 50.000 auf Deutsch, 50,000 auf Englisch. Pulsaria zeigt nie ein eigenes Währungssymbol an und rechnet nie zwischen Währungen um.

Änderst du die Einheit später, ändern sich Label und ggf. die Nachkommastellen auf dem Bildschirm. Gespeicherte Werte bleiben unangetastet.

Zielwert

Pflichtfeld. Es ist ein reines Zahlenfeld mit step="any" und muss eine endliche Zahl größer als 0 enthalten — sonst erscheint „Zielwert ist erforderlich“ oder „Zielwert muss eine Zahl größer als 0 sein“. Solange kein Fehler vorliegt, steht unter dem Feld der kleine Hinweis Erforderlich.

Das Feld Zielwert akzeptiert nicht beide Schreibweisen 1.234,56 und 1,234.56, wie es die Wertefelder auf der Seite Tägliche Erfassung tun. Tippe den Zielwert so, wie das Zahlenfeld deines Systems ihn erwartet.

Der Zielwert ist der Anker für alles, was Pulsaria rechnet: die Ideal-Linie, den Ampelstatus, das Abweichungs-Badge, die Status-Änderungen und die Ideal-Spalte der History-Tabelle. Änderst du ihn später, wird deine gesamte erfasste Historie gegen die neue Zahl neu bewertet. Pulsaria merkt sich den alten Zielwert nicht und schreibt deine erfassten Werte nie um.

Richtung

Höher ist besser (Standard) oder Niedriger ist besser. Das legt fest, welche Seite der Ideal-Linie gut ist.

• Höher ist besser: im Plan, wenn der Wert auf oder über dem Ideal liegt.
• Niedriger ist besser: im Plan, wenn der Wert auf oder unter dem Ideal liegt.

Das gelbe Band „Gefährdet“ liegt in beiden Fällen 10 % auf der schlechten Seite. Die Richtung dreht außerdem das Vorzeichen des Abweichungs-Badges: Bei einem KPI mit „Niedriger ist besser“ bekommt ein Wert unter dem Ideal ein +, weil er vorne liegt. Die vollständigen Bewertungsregeln stehen unter Ideal-Linie & Status.

KPI-Typ: Kumulatives Ziel oder Wiederkehrender Wert

Zwei anklickbare Karten unter KPI-Typ. Dieses Feld entscheidet häufiger als jedes andere darüber, ob ein KPI sinnvoll zu lesen ist.

Kumulatives Ziel — „Wert summiert sich zum Ziel (z.B. Umsatz)“. Die Ideal-Linie wächst geradlinig von 0 am ersten Tag des Zeitraums bis zum Zielwert am Ende. Wähle das, wenn die Zahl zu Beginn jedes Zeitraums neu anfängt und sich darüber aufsummiert: Umsatz diesen Monat, Neuanmeldungen dieses Quartal, Bestellungen, abrechenbare Stunden, gelaufene Kilometer.

Wiederkehrender Wert — „Je Periode ein neuer Messwert gegen einen Zielwert (z.B. MAU)“. Die Ideal-Linie ist flach: Sie entspricht an jedem einzelnen Tag des Zeitraums dem Zielwert. Wähle das, wenn die Zahl ein Niveau ist, das du halten willst, statt einer Summe, die du erreichen willst: monatlich aktive Nutzer, Conversion-Rate, Churn-Rate, durchschnittlicher Bestellwert, Support-Antwortzeit, Fehlerquote.

Ein schneller Test: Wenn du an zwei Tagen hintereinander dieselbe Zahl erfasst — hieße das „kein Fortschritt“? Dann ist es kumulativ. Hieße es „weiterhin auf Ziel“? Dann ist es ein wiederkehrender Wert.

Pulsaria addiert deine Einträge nie. Bei einem kumulativen KPI erfasst du den laufenden Gesamtwert des Zeitraums — nicht den Betrag, der heute dazugekommen ist. Auch mehrere Werte am selben Tag summieren sich nicht: Der jüngste gewinnt.

Standard ist Kumulatives Ziel, und jeder KPI, der vor Einführung dieses Feldes angelegt wurde, wird als kumulativ gelesen.

Wechselst du den Typ später, wird die komplette Historie gegen die neue Ideal-Linie neu bewertet — gleiche Werte, andere Urteile. Auch die Beschriftungen ändern sich: Der Kartenfuß zeigt ideal: bei kumulativen und Ziel: bei wiederkehrenden KPIs, das Abweichungs-Badge wechselt zwischen vs. Ideal und vs. Ziel, die Diagramm-Legende zwischen Ideal-Trend und Ziel.

Bereich

Unternehmensweit oder genau ein Projekt. Intern speichert ein KPI eine Projektreferenz, und unternehmensweit heißt schlicht „kein Projekt“.

Das Dropdown ist danach vorausgewählt, wo du den Dialog geöffnet hast: aus einer Projektgruppe, einer Projektkarte oder einer Projekt-Detailseite ist dieses Projekt vorbelegt, überall sonst Unternehmensweit.

Der Bereich bestimmt, in welcher Dashboard-Gruppe die Karte erscheint und in welche Zähler eines Projekts (im Plan / gefährdet / aus dem Plan) sie einfließt. Unternehmensweite KPIs gehören in keine Projektzähler. Mehr dazu unter Projekte.

Ein Bereichswechsel verschiebt Karte und Zähler. Deine erfassten Werte bleiben unangetastet und werden in keiner Weise umgehängt — dieselbe Reihe erscheint einfach unter einer anderen Überschrift. Dafür brauchst du den Bearbeiten-Dialog nicht; siehe Zwischen Projekten verschieben weiter unten.

Zeitraum

Jahr (Standard), Monat, Quartal oder Benutzerdefiniert. Der Zeitraum ist das Fenster, über das die Ideal-Linie läuft.

Zeitraum	Beginnt	Endet
Jahr	1. Januar des laufenden Jahres	31. Dezember
Monat	1. des laufenden Monats	letzter Tag dieses Monats
Quartal	erster Tag des laufenden Quartals	letzter Tag dieses Quartals
Benutzerdefiniert	dein Startdatum	dein Enddatum

Jahr, Monat und Quartal folgen immer dem aktuellen Kalenderzeitraum, berechnet aus dem lokalen Datum deines Macs, und rollen von selbst weiter. Es gibt keinen Wochen- oder Tageszeitraum, kein gleitendes „letzte N Tage“-Fenster und keinen Geschäftsjahres-Versatz — Benutzerdefiniert ist der einzige Weg, einen KPI auf ein selbst gewähltes Fenster zu setzen.

Benutzerdefiniert blendet Startdatum und Enddatum ein. Beide sind Pflicht („Start- und Enddatum wählen“), und das Ende muss am oder nach dem Start liegen. Die beiden Felder begrenzen sich gegenseitig, eine unmögliche Kombination ist also nicht wählbar. Es sind native Datumsfelder, ihr Kalender-Popup kommt daher vom System und nicht von Pulsaria.

Wechselst du den Zeitraum weg von Benutzerdefiniert, werden Start- und Enddatum beim Speichern verworfen.

Der Zeitraum wird direkt hinter der Einheit auf der KPI-Karte und im Detail-Header gedruckt: /Jahr, /Monat, /Quartal. Ein benutzerdefinierter Zeitraum zeigt stattdessen seine zwei Daten, zum Beispiel 1. Mär – 30. Jun. Details und die Tagesberechnung stehen unter Zeiträume & Ziele.

Datenquelle

Vier Karten, und die Wahl ist nicht endgültig — du kannst einen KPI jederzeit auf eine andere Quelle umstellen.

Quelle	Woher die Zahl kommt	Hinweise
Manuell	Du tippst sie ein — auf der Seite Tägliche Erfassung oder über Wert eintragen auf der KPI-Detailseite	Funktioniert überall, keine Freigabe
Connector	Eine fertige Metrik eines eingebauten Dienstes: Google Search Console, Google Analytics 4, Plausible, Polar, Stripe, Awin	Braucht eine Verbindung mit deinen Zugangsdaten; keine Freigabe
Bash	Ein Shell-Befehl, der eine einzelne Zahl auf stdout ausgibt	Läuft auf deinem Mac, braucht deine ausdrückliche Freigabe
HTTP	Ein GET-Request, dessen JSON-Antwort die Zahl enthält, adressiert über einen Punkt-/Bracket-Pfad	Braucht deine ausdrückliche Freigabe

Wählst du eine Connector-Metrik, füllt Pulsaria das Formular vor: Einheit, Richtung und KPI-Typ werden immer überschrieben, der Name nur, wenn du noch keinen getippt hast, Zeitraum und Cron nur, wenn die Metrik sie definiert.

Alle drei automatischen Quellen bieten zusätzlich einen optionalen Cron-Zeitplan. Ein automatischer KPI, der mit leerem Cron gespeichert wird, wird vom Scheduler nie angefasst — er aktualisiert sich nur, wenn du Jetzt ausführen auf dem KPI oder Aktualisieren im Dashboard drückst. Geplante Abrufe laufen nur, solange die App geöffnet ist, und nur auf macOS.

Ein späterer Quellenwechsel hat Folgen, die du kennen solltest:

• Der Wechsel auf Manuell löscht Befehl, Cron-Zeitplan, URL, Header, JSONPath und die Freigabe.
• Der Wechsel zwischen Bash und HTTP löscht die Felder der jeweils anderen Quelle.
• Änderst du Befehl, URL, Header oder JSONPath eines bereits freigegebenen KPI, verfällt die Freigabe, und der Scheduler überspringt den KPI, bis du ihn erneut freigibst. Änderst du nur Name, Zielwert, Cron oder Bereich, bleibt die Freigabe bestehen.
• Ein Connector-KPI ohne Metrik oder ohne Verbindung lässt sich trotzdem speichern. Er ruft dann einfach nie etwas ab, und der Abschnitt zeigt „Noch keine Metrik ausgewählt…“.

Bereits erfasste Werte überstehen jeden Quellenwechsel. Mehr dazu unter Datenquellen im Überblick, Connectoren, Shell-Befehle, Eigene HTTP-Quellen und Zeitpläne & Aktualisierung.

Feldreferenz

Feld	Pflicht	Was es tut	Wenn du es später änderst
Name	ja	Das Label auf Karte, Detailseite und in Berichten	Rein kosmetisch. Bestehende Warnungen und Fetch-Log-Zeilen behalten den alten Namen
Einheit	nein	Steht neben jeder Zahl und bestimmt die Nachkommastellen	Label und Nachkommastellen ändern sich; gespeicherte Werte werden nicht umgerechnet
Zielwert	ja	Die Zahl, auf die die Ideal-Linie zuläuft; muss > 0 sein	Bewertet die gesamte Historie neu — Ideal, Status, Abweichung, Verlauf. Der alte Zielwert wird nicht aufbewahrt
Richtung	nein (Standard: höher)	Welche Seite des Ideals gut ist	Bewertet die gesamte Historie neu und dreht das Vorzeichen des Abweichungs-Badges
KPI-Typ	nein (Standard: kumulativ)	Anstieg von 0 auf den Zielwert oder flache Linie auf dem Zielwert	Bewertet die gesamte Historie neu und ändert die Ideal-/Ziel-Beschriftungen
Bereich	nein (Standard: unternehmensweit)	Dashboard-Gruppe und Projektzähler	Karte und Zähler wandern; Werte bleiben unangetastet
Zeitraum	nein (Standard: Jahr)	Das Fenster, über das die Ideal-Linie läuft	Jedes Ideal, jeder Status und jede Abweichung wird neu berechnet. Weg von Benutzerdefiniert löscht die beiden Daten
Start-/Enddatum	nur bei Benutzerdefiniert	Das explizite Fenster	Beide Pflicht, Ende am oder nach dem Start
Datenquelle	in Schritt 1 gewählt	Woher die Zahl kommt	Löscht die Felder der verlassenen Quelle; kann die Freigabe verfallen lassen
Cron-Zeitplan	nein	Wann der Scheduler einen automatischen KPI abruft	Leer heißt „nur auf Zuruf“. Änderungen daran berühren die Freigabe nie

Keine dieser Änderungen schreibt erfasste Werte um. Nur die Berechnungen darum herum ändern sich.

Mit einer Vorlage starten

Statt die ersten KPIs einzeln zu tippen, kannst du ein Starter-Pack anwenden. Drei sind eingebaut:

Pack	KPIs	Inhalt
SaaS-Gründer	6	MRR, Churn-Rate, Trial-zu-Zahlend-Conversion, Aktive Nutzer, Neuanmeldungen, Support-Antwortzeit
Freelancer	5	Monatsumsatz, Abrechenbare Stunden, Aktive Projekte, Durchschnittliches Rechnungsalter, Neue Leads
E-Commerce	6	Umsatz, Bestellungen, Conversion-Rate, Durchschnittlicher Bestellwert, Warenkorb-Abbruch, Retourenquote

Jeder Pack-KPI ist manuell, unternehmensweit und nutzt den Zeitraum Monat. Richtung, Einheit und KPI-Typ sind pro KPI gesetzt — die meisten sind Wiederkehrender Wert, die aufsummierenden (Umsatz, Bestellungen, Neuanmeldungen, Leads, abrechenbare Stunden) sind Kumulatives Ziel. Die Namen kommen in deiner aktuellen UI-Sprache. Die Zielwerte sind Platzhalter, und der Dialog sagt das offen: „Erstelle ein fertiges KPI-Set mit sinnvollen Standardwerten. Die Zielwerte passt du danach an — es werden keine Demo-Daten angelegt.“

Es gibt genau zwei Einstiege, beide mit dem Label Vorlage verwenden: Schritt 3 des Willkommens-Assistenten und ein vollständig leeres Dashboard. Sobald ein einziger KPI oder ein einziges Projekt existiert, ist der Button weg — die App-Einstellungen haben keine Vorlagen-Karte, und eigene Packs kannst du weder anlegen noch bearbeiten oder importieren. Die Auswahl ist mit „Mit einer Vorlage starten“ überschrieben; jedes Pack zeigt seine KPI-Anzahl und einen Button Pack verwenden.

Wendest du ein Pack aus dem Willkommens-Assistenten heraus an, schließt sich der Assistent und das Onboarding gilt als erledigt. Was du im KPI-Formular dieses Schritts getippt hast, wird verworfen, und daraus entsteht kein KPI.

Wenn der KPI erst einmal existiert

Alle vier Aktionen liegen im Kopf der KPI-Detailseite, die du über einen Klick auf die Karte im Dashboard erreichst. Jede ist ohne Lizenz oder aktive Testphase deaktiviert, mit dem Tooltip „Lizenz oder aktive Testversion nötig“ — siehe Testphase & Lizenz.

Bearbeiten

Drücke Bearbeiten. Der Dialog öffnet das Konfigurationsformular mit allen vorbelegten Feldern und umschaltbarer Quelle. Zwei weitere Wege hinein: der Deep Link /kpi/<id>?edit=1 und eine Karte, die nicht geladen werden konnte — sie erscheint rot mit „KPI konnte nicht geladen werden“ und „Klicken, um zu bearbeiten“ und springt direkt in den Dialog.

Es gibt keine Warnung vor ungespeicherten Änderungen. Abbrechen, das X, Escape oder ein Klick neben den Dialog verwerfen das Formular kommentarlos.

Duplizieren

Drücke Duplizieren. Die Kopie übernimmt Einheit, Zielwert, Richtung, Bereich, Zeitraum, KPI-Typ, Quelle und die komplette Konfiguration der Quelle. Sie heißt <Name> (Kopieren); ist der Name schon vergeben, (Kopieren 2), dann (Kopieren 3).

Nicht kopiert werden: die Historie, die Fetch-Log-Einträge und die Freigabe. Eine duplizierte Bash- oder HTTP-KPI landet deshalb ohne Freigabe und wird vom Scheduler übersprungen, bis du sie freigibst — der Toast sagt das ausdrücklich. Pulsaria bringt dich anschließend direkt zur Kopie, damit du sie anpassen kannst.

Zwischen Projekten verschieben

Drücke Verschieben nach…. Das Menü listet zuerst Unternehmensweit, dann jedes Projekt; der aktuelle Bereich trägt einen Haken und ist nicht erneut wählbar. Ein Klick, kein Dialog, und das Dashboard aktualisiert sich sofort.

Verschieben ist eine Umbeschriftung, keine Migration: Deine Werte bleiben exakt, wie sie sind, und werden nicht umgehängt. Immer nur ein KPI — es gibt keine Mehrfachauswahl, kein Massenverschieben und kein Drag-and-drop, und das Menü existiert nur auf der Detailseite.

Löschen

Drücke Löschen und bestätige. Der Dialog heißt „KPI löschen“ und liest sich als „<Name> und alle historischen Daten löschen? Kann nicht rückgängig gemacht werden.“

Das ist wörtlich gemeint. Das Löschen entfernt die Definition und jeden je erfassten Wert von der Platte und bringt dich zurück ins Dashboard. Es gibt kein Rückgängig, keinen Papierkorb und kein Archiv.

Löschst du ein Projekt, nimmt es seine KPIs mit. Die Bestätigung lautet „<Name> und alle seine KPIs löschen? Kann nicht rückgängig gemacht werden.“ — und das schließt alle erfassten Werte ein. Ein Projekt zu löschen und seine KPIs zu behalten, ist nicht vorgesehen.

Wie es weitergeht

• Dein erster KPI — der geführte Weg von der Installation zur ersten Zahl
• Werte erfassen — wie Werte erfasst, korrigiert und gelöscht werden
• KPI-Detailseite — die Seite, auf der alle obigen Aktionen liegen