venkatv-hub/powerbi-dashboard-builder

Power BI Dashboard Builder

Verwandelt eine Dashboard-Spezifikation (siehe bi-dashboard-design/references/dashboard-spec.md) in ein funktionierendes Power BI-Artefakt. Das Domänenwissen stammt von der Domänenfähigkeit; Layout- und Stylingregeln stammen von bi-dashboard-design. Diese Fähigkeit behandelt die Power BI-spezifischen Details.

Wählen Sie zuerst den Erstellungsmodus

Überprüfen Sie, was verfügbar ist, und teilen Sie dem Benutzer mit, welchen Modus Sie verwenden:

Modus	Wann	Was Sie erstellen
A. Live-Modell via MCP/CLI	Der Power BI Modeling MCP-Server (@microsoft/powerbi-modeling-mcp) oder pbi-cli ist verbunden und Power BI Desktop hat das Modell geöffnet	Tabellen, Beziehungen, Maßzahlen werden direkt im geöffneten Modell erstellt; Bericht als PBIR-Dateien erstellt
B. PBIP-Projektdateien	Sie können Dateien schreiben, haben aber keine Live-Verbindung	Ein .pbip Projektordner: <Name>.SemanticModel/definition/*.tmdl und <Name>.Report/definition/ (PBIR), den der Benutzer in Power BI Desktop öffnet
C. Baukasten	Weder Dateien noch Tools sind praktikabel (z. B. chat-only)	DAX-Maßzahlen-Skript, TMDL-Ausschnitte, Theme JSON und ein Seiten-für-Seiten-Bauplan, den ein Entwickler befolgt

Bevorzugen Sie A, dann B. Erinnern Sie den Benutzer im Modus B daran, die PBIP-Speicheroption und „Semantisches Modell im TMDL-Format speichern" in den Vorschaufunktionen von Power BI Desktop zu aktivieren, falls diese Version sie noch als Vorschau hat.

Arbeitsablauf

1. Lesen Sie die Spezifikation und die Domänen-Metriken-Datei. Jede von Ihnen erstellte Maßzahl muss mit einer Definition in der Datei <domänenskills>/references/metrics.md übereinstimmen.
2. Modellieren Sie das Sternschema (references/tmdl-patterns.md):
   • Eine Fakttabelle pro Körnung in der Spezifikation; Dimensionen konform über Fakten hinweg.
   • Eine dedizierte Date-Tabelle, die als Datumstabelle markiert ist, kontinuierlich, die alle Fakten-Daten abdeckt, mit Geschäftsjahresspalten, wenn die Domäne einen Geschäftskalender verwendet.
   • Einseitige 1:n-Beziehungen von Dimension zu Fakt. Verwenden Sie bidirektionale nur mit einem schriftlichen Grund. Rollenspiele für Daten (Rechnungsdatum vs. Fälligkeitsdatum vs. Zahlungsdatum): eine aktive Beziehung, die anderen inaktiv und mittels USERELATIONSHIP in Maßzahlen aktiviert.
   • Ausblenden von Fremdschlüsseln und rohen numerischen Spalten, die durch Maßzahlen ersetzt werden; setzen Sie summarizeBy: none auf Schlüssel, IDs und Jahres-/Monatsnummern.
   • Sortieren-nach-Spalten für Monatsnamen und für Bucket-Beschriftungen (Alterung, Bänder).
3. Schreiben Sie Maßzahlen (references/dax-patterns.md): eine _Measures-Tabelle, Anzeigeordner pro Thema (z. B. 01 Umsatz, 02 Marge), eine Formatzeichenfolge und eine Beschreibung für jede Maßzahl. Erstellen Sie zuerst Basismaßzahlen, dann Verhältnisse, dann Zeitintelligenz, dann Anzeigehilfen (Delta %, Pfeil, Statusfarbe).
4. Erstellen Sie Berichtsseiten (references/report-pbir.md): Ordnen Sie jede Spezifikationskomponente einem Visual zu, platzieren Sie es auf dem 1280×720-C anvas unter Verwendung des Raster-Mappings, wenden Sie das Theme aus bi-dashboard-design/references/theme-tokens.md an, fügen Sie Drill-Through-Seiten und ein Lesezeichen zum Zurücksetzen hinzu.
5. Sicherheit: Wenn die Spezifikation row_level enthält, erstellen Sie die RLS-Rolle mit einem DAX-Filter auf der relevanten Dimension und dokumentieren Sie, wie Mitglieder im Service zugewiesen werden.
6. Verifizieren: Führen Sie die DAX-Prüfungen in references/dax-patterns.md#verification durch (Summen stimmen mit der Quelle überein, Zeitintelligenz gibt Werte für den letzten Zeitraum zurück, keine leeren KPIs). Führen Sie dann die Akzeptanz-Checkliste von bi-dashboard-design aus. Berichten Sie, was Sie nicht verifizieren konnten.

Raster-Mapping (1280 × 720 Canvas)

• Ränder 16 px; nutzbare Breite 1248 px; 12 Spalten à 88 px mit 16 px Zwischenräumen.
• Spaltenspanne c → Breite c*88 + (c-1)*16 px; x = 16 + col_index*104.
• Eine Höheneinheit = 56 px mit 16 px Zwischenräumen (Kopfzeile ≈ 64 px).
• Lange Seiten: bevorzugen Sie für L1/L2 eine zweite Seite gegenüber vertikalem Scrollen; L3-Detailseiten dürfen ein höheres Canvas (1280 × 1440) für Tabellen verwenden.

Visuelles Mapping

Spezifikationskomponente	Power BI Visual	Hinweise
kpi_card	Card (neu) / KPI	Referenzetikett für Vergleich; bedingte Farbe via Maßzahl
trend_line	Liniendiagramm	Ziel als zweite Maßzahl oder konstante Linie; 13 Monate via relativem Datumsfilter oder Maßzahlfenster
ranked_bar	Gruppiertes Balkendiagramm	Top N-Filter + „Sonstige" via dynamischer Segmentierungsmaßzahl falls nötig
variance_bar	Gruppiertes Balkendiagramm auf Abweichungsmaßzahl	Farbe nach Regel basierend auf Var-Vorzeichen × Richtung
waterfall	Wasserfall	Aufschlüsselungsfeld = Treiberdimension
stacked_bar	100 % gestapeltes Balkendiagramm
matrix	Matrix	Zeilenhierarchie, Werte Ist/Budget/Var/Var%, Zellelemente auf Var%
exception_table	Tabelle	Top N- oder Schweregradfilter, bedingte Symbole, Drill-Through aktiviert
aging_buckets	Gruppierte Säulen	Bucket-Spalte sortiert nach Bucket-Reihenfolge-Spalte
funnel	Trichter oder Balken	Balken sortiert nach Stufenreihenfolge ist lesbarer
map	Azure Map / gefüllte Karte	Nur wenn der Mandant Karten erlaubt
slicer	Slicer (Dropdown oder Kachel)	Synchronisieren Sie Slicer seitenübergreifend für Zeitraum und Organisation

Schutzmaßnahmen

• Niemals Daten wie "2026-10-31" in Maßzahlen hartcodieren; leiten Sie den „letzten abgeschlossenen Zeitraum" aus den Daten oder einem Parameter ab.
• Verwenden Sie DIVIDE() für jedes Verhältnis. Mitteln Sie niemals ein Verhältnis über Zeilen.
• Bevorzugen Sie Maßzahlen gegenüber berechneten Spalten; bevorzugen Sie Power Query / Warehouse-Transformationen gegenüber DAX-berechneten Tabellen.
• Importieren Sie keine vertraulichen Spalten (SVN, Patientenname, Gehaltsdetails), es sei denn, die Spezifikation verlangt dies und RLS/OLS ist vorhanden.
• Schalten Sie Auto-Datum/Uhrzeit aus; es bläht das Modell auf und konfligiert mit der Datumstabelle.

Referenzdateien

• references/tmdl-patterns.md – TMDL-Syntax für Tabellen, Spalten, Beziehungen, Datumstabelle, Rollen. Lesen im Modus A/B.
• references/dax-patterns.md – wiederverwendbare DAX: Verhältnisse, Zeitintelligenz, semiadditive Momentaufnahmen, Alterungs-Buckets, Top N + Sonstige, Anzeigehilfen, Verifizierungsabfragen.
• references/report-pbir.md – PBIR-Ordnerstruktur, visuelle JSON-Elemente, Drill-Through, Lesezeichen und das Bauplan-Format für Modus C.