kpi-auswertung-nachrichten
Verarbeitet die quartalsweise "Auswertung KPI X Monate"-PDF (BWA-Kennzahlen pro Filiale von der Buchhaltung/HQ) zu kurzen, verständlichen Filial-Nachrichten (Deutsch + Vietnamesisch) und trägt sie dir
SKILL.md.claude/skills/kpi-auswertung-nachrichten/SKILL.md
GitHubKPI-/BWA-Auswertung → Filial-Nachrichten in der App
Warum dieses Skill existiert
Jedes Quartal schickt die Buchhaltung eine PDF mit Umsatz/Wareneinsatz/
Personalkosten/Ergebnis pro Filiale (kommt nur per E-Mail, steht NICHT in
Axonity — kann also nicht automatisch abgeholt werden, das PDF muss der
Nutzer jedes Mal hochladen). Daraus entstehen kurze, verständliche
Nachrichten pro Filiale, die direkt in der App (nicht WhatsApp) an das
jeweilige Team geschickt werden — siehe die Karte "📊 KPI-Auswertung" im
Bereich Urlaub/Mitteilungen von index.html (KPI_DRAFTS-Array,
kpiDraftsRender()/kpiDraftSend(i)), die die Filial-Ziel-Mitteilung
(news-Collection, Feld filiale, siehe maStartFbNews in
mitarbeiter.html) wiederverwendet.
Der eine große Stolperstein, den dieses Skill von Anfang an vermeidet:
das PDF nennt Filialen oft anders/kürzer als die App (z.B.
"Bovenden-Industriestraße" im PDF vs. "402207: E-Bovenden- Industriestraße" in echten emps.filiale-Werten) — und mindestens einmal
war der Name im PDF sogar ECHT falsch ("Friederichs" statt "Friedrich",
Kostenstelle 402302, live festgestellt 08.09.2026). Eine Nachricht mit
falschem filiale-Wert erreicht in der App NIEMANDEN (strenger
Gleichheits-Filter in maStartFbNews), ohne dass das auffällt. Deshalb
immer über die Kostenstellen-Nummer matchen, nie über den Filialnamen aus
dem PDF — siehe Schritt 3.
Ablauf
1. PDF lesen und pro Filiale extrahieren
Die PDF hat eine Tabelle mit einer Zeile pro Filiale, erkennbar an der
Kostenstellen-Nummer (6-stellig, z.B. 402207) — die ist der
zuverlässige Schlüssel, nicht der Filialname daneben. Für jede Filiale und
jeden Monat im Berichtszeitraum (meist ein Quartal, 3 Monate) die
tatsächlichen Euro-Werte lesen (nicht nur Prozente/Abweichungen):
- Umsatz
- Wareneinsatz (Materialkosten)
- Personalkosten
- Ergebnis (Gewinn/Verlust)
Daraus ein JSON bauen, ein Objekt pro Filiale:
{
"kostenstelle": "402207",
"pdfName": "Bovenden-Industriestraße",
"months": {
"2026-06": {"umsatz": 41250, "wareneinsatz": 12100, "personal": 15800, "ergebnis": -820},
"2026-07": {"umsatz": 43900, "wareneinsatz": 12500, "personal": 15800, "ergebnis": 640},
"2026-08": {"umsatz": 42010, "wareneinsatz": 12300, "personal": 15800, "ergebnis": -110}
}
}
In eine Datei im Scratchpad schreiben, z.B. kpi_input.json (alle Filialen
als Array).
2. Filialen den echten App-Daten zuordnen (Kostenstelle → echter Filialname)
cd C:\Users\Public\GLSC\automation
node src/match-kpi-branches.js <pfad>/kpi_input.json <pfad>/kpi_matched.json
Fragt live emps (nur active:true) ab, baut Kostenstelle → echter emps.filiale-String + region und hängt das an jedes Objekt an
(filiale, region, matched:true/false). Jede Zeile mit
matched:false genau ansehen und mit dem Nutzer klären, bevor dafür eine
Nachricht gebaut wird (Tippfehler in der Kostenstelle? Filiale neu, noch
nicht in emps? Filiale inzwischen umbenannt/geschlossen?) — nie eine
unmatched Zeile einfach mit dem PDF-Namen weiterverwenden, das reproduziert
genau den Bug, den dieser Schritt verhindern soll.
3. Nachrichtentexte bauen (Deutsch + Vietnamesisch)
Pro Filiale einen kurzen Text in beiden Sprachen — Regeln, die der Nutzer in der Vergangenheit explizit so festgelegt hat:
- Kurz und ohne BWA-Fachjargon — nicht jeder im Team versteht "Wareneinsatzquote" o.ä. Einfache Alltagssprache.
- Konkrete Euro-Zahlen pro Monat nennen (Umsatz, Personalkosten, Wareneinsatz, Ergebnis) statt nur Prozent/Trend — das Team soll sehen, worum es wirklich geht.
- Kein "ruf mich an"/"lass uns zusammensetzen"/"sprechen wir darüber" — die Nachricht geht an das GANZE Team der Filiale, nicht mehr 1:1 an den Shopleiter, ein Anruf-Angebot ergibt da keinen Sinn mehr.
- Ton je nach Zahlen anpassen: bei anhaltendem/wachsendem Verlust sachlich benennen, was auffällt (z.B. Personal- oder Wareneinsatzkosten im Verhältnis zum Umsatz hoch) — bei guter Entwicklung/steigendem Gewinn ausdrücklich loben.
- Beide Sprachfassungen inhaltlich gleich, nicht wörtlich übersetzt wo es im Vietnamesischen natürlicher klingt.
Vor dem Weitermachen die fertigen Texte selbst gegen die verbotenen Formulierungen prüfen (grep-artig nach "telefonieren", "rufe an", "zusammensetzen", "sprechen wir", "Anruf") — das war beim letzten Mal der Abnahme-Check und sollte es wieder sein.
4. In index.html eintragen
Baut ein Array, ein Objekt pro Filiale, in index.html in der Variable
KPI_DRAFTS:
{nr: 1, filiale: '402207: E-Bovenden-Industriestraße', de: '...', vi: '...'},
filiale muss exakt der filiale-Wert aus Schritt 2 sein (kein
Abtippen/Kürzen) — das ist der Wert, gegen den mitarbeiter.html beim
Anzeigen filtert.
Technik zum Einfügen (bewährt aus dem letzten Durchlauf, JS-String- Escaping ist bei ~28 Objekten von Hand fehleranfällig):
- Escaped-JS-Literal-Text generieren (eigenes kleines Node-Skript im
Scratchpad, das die Werte aus
kpi_matched.json+ die gebauten Texte innr:...,\n filiale:'...',\n de:'...',\n vi:'...'Zeilen umwandelt, dabei\,'und Zeilenumbrüche escapen). - In
index.htmldie Stellecontent.indexOf('var KPI_DRAFTS = [')biscontent.indexOf('\n];', searchFrom)per Node-Skript ersetzen (nicht von Hand über den Edit-Tool-Diff, bei 28 langen Objekten zu fehleranfällig) — exakt dieselbe Technik wie letztes Mal. - Danach den Artikel/die Karte "kpi-drafts-card" kurz im Code
gegenprüfen: sie ist aktuell über
regionRenderSwitcher()aufactiveRegion==='ost'||activeRegion==='west'beschränkt — falls inzwischen eine neue Region KPI-Nachrichten bekommen soll, diese Zeile mit erweitern.
5. Testen, bevor der Nutzer es sieht
- Browser öffnen (
.claude/launch.json→glsc-static), als Manager einloggen (oder überauthGateHide()/gemockte Session testen wie bei anderen Änderungen in diesem Projekt), Karte "📊 KPI-Auswertung" öffnen. - Prüfen: alle Filialen aus Schritt 2 erscheinen als Karte, Text lesbar, keine der verbotenen Formulierungen aus Schritt 3 im gerenderten HTML.
- Senden NIEMALS live gegen echte Mitarbeiter testen. Stattdessen
window.fbDbkurz durch ein Mock ersetzen (collection().add()fängt das Payload nur ab, schreibt nichts wirklich),kpiDraftSend(i)für 1-2 Einträge aufrufen, Payload-Struktur (filialeexakt korrekt?regiongesetzt?) verifizieren, danachfbDbwieder zurücksetzen — die im Projekt etablierte Vorgehensweise für "Senden" testen ohne echte Daten zu berühren.
6. Dem Nutzer zurückmelden
Kurz zusammenfassen: wie viele Filialen verarbeitet, wie viele
matched:false (und was damit passiert ist), auffällige Fälle (starker
Verlust/starke Verbesserung) kurz benennen — der Nutzer öffnet dann selbst
die App-Karte, liest jeden Entwurf durch und klickt pro Filiale auf Senden
(bewusst kein "alle auf einmal", siehe bestehendes UI).
Optional: vollständiger Auswertungsbericht als Artifact
Zusätzlich zu den Kurznachrichten wurde beim letzten Mal auch ein
ausführlicher Bericht (Gebiet-Summen, Standorte mit anhaltendem Verlust vs.
starker Entwicklung, volle Vergleichstabelle) als Artifact veröffentlicht —
nur bauen, wenn der Nutzer das explizit will oder es aus dem Kontext klar
gewünscht ist, nicht automatisch bei jedem Durchlauf. Nutzt dieselben
Rohdaten aus Schritt 1, nur ausführlicher aufbereitet; artifact-design
Skill vorher laden.
Kurzfassung für einen kompletten Durchlauf
# 1) PDF lesen, kpi_input.json im Scratchpad bauen (siehe Schritt 1)
cd C:\Users\Public\GLSC\automation
# 2) Filialen zuordnen
node src/match-kpi-branches.js <scratchpad>/kpi_input.json <scratchpad>/kpi_matched.json
# unmatched-Zeilen mit dem Nutzer klären
# 3) Texte bauen (DE+VI, Regeln aus Schritt 3), gegen verbotene Formulierungen prüfen
# 4) In index.html KPI_DRAFTS ersetzen (Node-Skript, siehe Schritt 4)
# 5) Im Browser testen (Karte rendert, kein verbotener Text, Send-Payload gemockt geprüft)
# 6) Nutzer Bescheid geben — er sendet pro Filiale selbst