Lagotto BI — Architektur und technische Übersicht

7/9/2026 / 11 minutes to read / Tags: lagotto-bi, BI, self-hosted, Architektur, MSSQL

Lagotto BI liest aus einem MSSQL-ERP, synchronisiert Daten alle 5–15 Minuten in eine interne MariaDB-Datenbank und stellt sie über drag&drop-konfigurierbare Dashboards ohne Code-Schreiben bereit. Die Zeit zwischen “Ich habe das ERP noch nicht verbunden” und “Ich habe ein Dashboard mit echten Daten” wird in Wizard-Schritten gemessen, nicht in Wochen individueller Entwicklung.

Technischer Stack

Reale Konfigurationszeiten

Jeder Schritt hat einen integrierten Test oder eine Vorschau. Es wird nie blind gespeichert.

Von nicht verbundenem ERP bis zum Dashboard mit echten Daten: die Größenordnung ist eine halbe Stunde, nicht der typische Analyse-Angebot-Entwicklung-Test-Zyklus eines individuellen BI-Projekts.

Aggregations-Engine

Der Unterschied, der am wenigsten sichtbar ist, aber am meisten wiegt: die Aggregation findet in der Datenbank statt, nicht im Browser. Ein Diagramm mit Top 10 + “Sonstige” auf einer Ansicht mit Hunderttausenden von Zeilen lädt diese Zeilen nicht in den Browser, um sie dann in JavaScript zu schneiden — das Backend führt GROUP BY + SUM mit bereits angewendeter Sortierung aus und gibt nur die Zeilen zurück, die gerendert werden.

GET /api/data/v_monatsumsatz
    ?_top_n_x=monat&_top_n_y=gesamt&_top_n=10&_gruppierung=kundenregion

-- vom Backend generiert, parametrisiert — nie String-Interpolation
SELECT monat, kundenregion, SUM(gesamt) AS gesamt
FROM v_monatsumsatz
WHERE jahr = :jahr
GROUP BY monat, kundenregion
ORDER BY SUM(gesamt) DESC

Das Pivot-Widget (PRO) folgt bei Bedarf der entgegengesetzten Logik: Rohdaten ohne LIMIT, client-seitig von pivottable.js aggregiert. Verifiziert auf 100.576 echten Zeilen mit € 21.142.336 in Echtzeit summiert, während der Benutzer Felder zieht.

Ein In-Memory-Cache (TTL 60 Sekunden, pro Benutzer) verhindert, dass ein Tab-Wechsel oder ein Doppelklick auf einen Filter dieselbe Abfrage zweimal neu generiert.

Widget-Katalog

Sieben Widget-Typen, alle vom Panel konfigurierbar — keiner erfordert handgeschriebenes JSON.

Beispiel: Kombinations-Diagramm-Konfiguration

{
  "typ": "combo",
  "titel": "Umsatz vs Marge",
  "ansicht": "v_monatliche_marge",
  "x_achse": "monat",
  "serien": [
    { "feld": "umsatz",    "bezeichnung": "Umsatz",  "typ": "bar",  "y_achse": "links",  "farbe": "#4a90d9" },
    { "feld": "marge_pct", "bezeichnung": "Marge %", "typ": "line", "y_achse": "rechts", "farbe": "#e85d4a" }
  ]
}

Dieser JSON-Block — vom Widget Builder generiert, nie handgeschrieben — ist alles, was für ein Diagramm benötigt wird, das in vielen BI-Tools eine dedizierte SQL-Ansicht plus manuelle Konfiguration der zweiten Achse erfordert.

Aktionen und Drill-Through

Jedes Widget kann auf einen Klick reagieren. Der Drill-Through-Stack ist rekursiv — ein Klick in einem Modal, das durch einen vorherigen Klick geöffnet wurde, öffnet eine dritte Ebene mit Breadcrumbs zur Rückkehr. Vom Panel konfigurierbar, nicht aus Code.

Mapper Builder und Query Manager

Jedes ERP hat eine JSON-Datei, die seine Tabellen auf das Standardschema von Lagotto abbildet:

{
  "erp": "custom_erp",
  "tabellen": {
    "RECH_KOPF": {
      "ziel_ansicht": "v_monatsumsatz",
      "spalten": {
        "DOK_DATUM":  { "ziel": "rechnungsdatum", "typ": "date" },
        "KD_CODE":    { "ziel": "kundennummer",    "typ": "string" },
        "DOK_GESAMT": { "ziel": "umsatz",          "typ": "decimal",
          "anzeige": { "typ": "währung", "symbol": "€", "dezimalstellen": 0 } }
      }
    }
  }
}

Sechs vordefinierte Transformationen decken die Fälle ab, die normalerweise in einem handgeschriebenen Skript enden:

• simple — direkte Kopie
• map — Wörterbuch-Lookup
• lookup — externe Tabelle (z.B. Landkreis→Region)
• coalesce — erster Nicht-Null-Wert unter mehreren Feldern
• concat — Verkettung
• arithmetisch — Summe/Subtraktion zwischen Feldern

Das display-Feld propagiert die Formatierung automatisch bis zum endgültigen Widget, ohne sie ein zweites Mal konfigurieren zu müssen.

Query Manager (View Builder, PRO): SQL-Editor mit dem Panel der für diesen Datasource verfügbaren Staging-Tabellen. Eine hier erstellte Ansicht ist im Widget Builder sofort verfügbar — kein Backend-Neustart, kein Deploy.

-- Marge nach Kategorie, in einer benutzerdefinierten Ansicht berechnet
CREATE OR REPLACE VIEW v_kategorie_marge AS
SELECT kategorie,
       SUM(umsatz) AS gesamtumsatz,
       SUM(kosten) AS gesamtkosten,
       ROUND((SUM(umsatz) - SUM(kosten)) / NULLIF(SUM(umsatz),0) * 100, 1) AS aufschlag_pct
FROM roh_umsatz
GROUP BY kategorie

Sicherheit und Multi-Tenant-Isolierung

• Obligatorische Ansichts-Whitelist: der Daten-Endpoint akzeptiert nur Ansichten in der expliziten Whitelist — keine beliebigen Abfragen vom Frontend
• Immer parametrisierte Abfragen: nie String-Interpolation, auch nicht für Spaltennamen mit Leerzeichen oder Akzentzeichen
• Server-seitig erzwungener Agenten-Filter: ein Benutzer mit der Rolle agent sieht nur seine eigenen Daten — der Filter wird im Backend angewendet, nicht vom Frontend umgehbar
• Schema pro Tenant: jeder Kunde hat sein eigenes MariaDB-Schema (lagotto_{slug}) — null gemeinsame Daten, null Cross-Tenant-Abfragen möglich per Konstruktion
• Granulare Benutzerprofilierung: ein Admin kann einschränken, welche Dashboards, Tabs, Widgets und permanente Filter ein einzelner Benutzer sieht — server-seitig gefiltert

Pläne und Lizenzierung

Das Benutzerlimit wird server-seitig bei jeder neuen Benutzererstellung überprüft. Der Plan wird alle 30 Minuten live gegen den License Server re-verifiziert — Widerrufe und Upgrades werden ohne Neustart propagiert. Die dem Benutzer angezeigten Preise werden in Echtzeit vom License Server gelesen, keine feste Zahl im Code.

Leistung — Zahlen, keine Adjektive

Deklarierte Roadmap

Noch nicht in Produktion:

• Erweiterter Query Manager: Abfrageergebnis in einer Staging-Tabelle materialisieren, nicht nur in einer bei jeder Lesung berechneten Ansicht — für schwere Joins auf Millionen von Zeilen
• Zertifizierte Mapper-Bibliothek: ein erprobtes Mapping-Schema zwischen verschiedenen Installationen desselben ERPs exportieren/importieren
• Vollständiger Dashboard-Import/Export: Layout, Widgets und Filter als exportierbare Datei, wiederverwendbar als Ausgangspunkt für einen neuen Kunden

Technisches Dokument — Lagotto BI. Roadmap-Funktionen sind noch nicht in Produktion verfügbar.

Quellen

Autor: Giantommaso Fogli
Veröffentlichungsdatum: 2026-07-09

Rechte und Attributionen

Bilder, Logos und Fotografien sind Eigentum ihrer jeweiligen Inhaber. Verwendet für Kommentarzwecke.