MAD

Ein offenes Format und eine einbettbare Engine für relationales Reporting — hier ist jeder Bericht ein portabler Abfragegraph, eine materialisierte SQLite-Tabelle und ein parametrisches Layout.

MAD ist eine eingebettete Plattform für relationales Reporting für Ad-hoc-Abfragen, Berichte und Design: die Apps MAD Designer und MAD Viewer für iOS und natives macOS (AppKit), die headless Engine, die sie unter Linux und macOS ausführt, und das offene .mad-Dokumentformat. Eine .mad-Datei enthält die gesamte Definition eines Berichts — den Schema-Snapshot der Datenbank, den Abfragegraphen (Tabellen, Joins, Prädikate, Gruppierungen) und das bandbasierte Layout seiner Elemente — in weniger als 100 KB, sauber getrennt von der materialisierten SQLite-Tabelle (.maddb + .mdcache), die sie beim Aktualisieren erzeugt.

Der Code liegt auf github.com/mthomason/MAD, unter MIT-Lizenz; die Namen und das App-Artwork sind von dieser Lizenz nicht abgedeckt (siehe NOTICE).

MAD Designer auf macOS ausprobieren (macOS 12.0+, Apple Silicon):

• Homebrew: brew install --cask mthomason/tap/mad-designer

• Direkter Download: MAD-Designer-macOS.dmg

  MAD-Designer-macOS.zip (bei direkten Downloads nach dem Kopieren nach /Applications einmal xattr -cr "/Applications/MAD Designer.app" ausführen)

In Aktion

MAD Designer für macOS — native AppKit-Desktopanwendung (NSDocument, visuelle Abfrageleinwand für Tabellen und Joins, interaktive Minimap der Bereiche und bandbasierter Berichtsdesigner sowie seitenweise Anzeige von PDF/HTML/CSV/JSON-Berichten):

MAD Designer für iOS, von der Auswahl einer Datenquelle bis zum fertigen Bericht in MAD Viewer:

Dieselbe Engine headless unter Linux: inspect, schema, query, refresh und export über die mad-CLI, ohne Datenbankserver und ohne Zugangsdaten:

Der exportierte Bericht der Aufzeichnung ist reines HTML und lässt sich in jedem Browser öffnen.

Warum MAD

• Interoperabel durch Kontrakt. Statt einmalige SQL-Skripte und maßgeschneiderten Dashboard-Klebstoff über eine Organisation zu verteilen, bündelt eine .mad-Datei den Schema-Kontrakt, den Abfrage-AST und das Präsentationslayout in einem einzigen einsehbaren, diffbaren Artefakt, das byte-identisches SQL und byte-identische Exporte auf Apple- und Linux-Plattformen erzeugt.
• Geschrieben, nicht zusammengesetzt. Die SQL-Erzeugung, der SQL-Parser, die Datenbanktabellen-Engine, der Speicher, das Layoutmodell und der Renderer sind eigenentwickeltes Objective-C über vierzehn Frameworks. Drittanbieter-Code beschränkt sich auf die Verbindungsebene — MariaDB Connector/C, FreeTDS, libpq, SQLite — plus libarchive/bzip2 und zint für Barcodes. Kein proprietäres Reporting-SDK wird weiterverkauft.
• Mobile-first, speicherbudgetiert. Ein Refresh liest die Ergebnismenge einmal in einen SQLite-Zeilen-Cache (MADDataTableFast) und berechnet von dort zweistufige Gruppierungen und Aggregate, sodass das seitenweise Rendern im Speicher eines Telefons schnell bleibt.
• Einbettbar und portabel. Elf der vierzehn Frameworks sind frei von UIKit und lassen sich headless bauen; sie bestehen 1.303 Tests unter Linux in Docker. Der .mad-Container ist ein bzip2-tar-Archiv mit einem portablen SQLite-Speicher; zum Öffnen ist kein Apple-Framework erforderlich.

Das .mad-Format

Die offene Spezifikation, ein Kapitel pro Datei:

Was ein Dokument ist · Der Container · Der Speicher · Lesen und Schreiben · Begleitdateien · Fallstricke · Normativ v1 · Offene Fragen · Verifikation

Die Engine verwenden

• MAD Designer für macOS — die native AppKit-Desktop-App: visuelle Abfrageleinwand, bandbasierter Berichtsdesigner mit Minimap und Inspector, seitenweise Anzeige und wie man sie aus dem Quellcode baut oder paketiert.
• Bauen und testen — die genauen Befehle für die iOS-Suites, die nativen macOS-Suites und den Linux-Build.
• Die mad-CLI — eine .mad-Datei mit einer Zeile aus Docker inspizieren, aktualisieren und exportieren.
• mad-action — eine eingecheckte .mad-Datei in GitHub Actions ausführen und ihren Export hochladen; mthomason/mad-action@v1.
• Tutorial zum Schreiben eines Treibers — der vorgesehene erste Beitrag: MADDatabase ableiten, den Treiber registrieren, Zeilen zurückgeben.

Die Richtung

Vision — Berichte als kombinierbare Datenbanktabellen, Abfragen mit mehreren Quellen in einem einzigen Bericht, native UIKit-Datenansichten jenseits des Papierparadigmas und die Konvertierung von Legacy-Crystal-Reports-Dateien (.rpt) in offene .mad-Dateien.

---

Die App MAD Designer — der Berichtsdesigner, der auf dieser Engine aufbaut — hat ihre eigene Website unter mad.everydayapps.com.

Diese Seite ist eine deutsche Übersetzung des englischen Originals; bei Abweichungen ist der englische Originaltext maßgeblich.

Diese Website ist Open Source. Diese Seite verbessern.