Wolkenwald
PurePower Engine · Betreiben

Plugin-System und Shop

Das Plugin-System der PurePower Engine trennt den Kern von allem, was ein Betrieb braucht: Tickets, Wiki, Zeiterfassung, Reservierung, Themes — alles kommt als Plugin. Plugins laufen in eigenen Prozessen, sind signiert, melden ihre Rechte an und werden über den Plugin-Shop bezogen, installiert und aktualisiert.

Plugin-Übersicht mit den Klassen F0, F1, F2, F3 und XUI

Die Plugin-Übersicht: installierte Plugins nach Klasse, mit Zustand und Fassung.

Feature-Klassen

  • F0 — ohne eigenen Code: nur Beschreibungen. Tabellen, Listen und Formulare, Workflows, Pipelines, Rechte, Themes; das Rahmenwerk führt alles aus.
  • F1 — Unterprozess je Auslöser: ein Programm oder Skript, das auf ein Ereignis oder einen Timer reagiert und endet.
  • F2 — Bibliothek im eigenen Adapter: eine schmale Schnittstelle für kernnahe Aufgaben wie zweiten Faktor oder LDAP; die Bibliothek läuft in einem eigenen Prozess.
  • F3 — eigener Dienst: langlebig, mit HTTP-Routen, WebSocket, Streaming, Pipeline-Knoten, Workflow-Haken und mehreren Instanzen. Die grossen Fachplugins sind F3.
  • XUI — Oberflächenpakete: eigene Widgets für Listen und Formulare (Diagramme, Kanban, Editor …), ohne eigenen Prozess.

Eigene Prozesse

F1-, F2- und F3-Plugins laufen ausserhalb des Rahmenwerks und sprechen mit ihm über PPMSG, ein binäres Nachrichtenformat über Unix-Sockets. Stürzt ein Plugin ab, läuft die Engine weiter, und das Plugin wird neu gestartet. Ein F3-Dienst übersteht auch einen Neustart des Rahmenwerks. Je Plugin sieht der Administrator Instanzen, Protokoll, Routen mit Nutzung und Fehlern, Betrieb und Scopes.

Manifest

Jedes Plugin beschreibt sich in einem Manifest: Klasse, Fassung, benötigte Fassung des Rahmenwerks, Tabellen (Migrationen), Rechte, Seiten, Workflows, Pipelines, Sprachen. Das Rahmenwerk prüft es beim Einspielen, pp_manifest_lint schon vorher. Ein kleines F0-Plugin:

<plugin_manifest api_version='2' xmlns='urn:purepower:schema:1.0'>
  <info>
    <name>urlaub</name>
    <version>0.1.0</version>
    <scope>tenant</scope>
  </info>
  <feature_class>F0</feature_class>
  <requires><framework min_version='0.10.175'/></requires>
  <migrations>…</migrations>
  <admin_pages>…</admin_pages>
  <workflows>…</workflows>
</plugin_manifest>

Ein Plugin arbeitet immer in seinem eigenen Namensraum: Seine Abfragen und Pipelines laufen mit seinen Rechten, nie mit denen des Rahmenwerks.

Kritische Scopes und Freigabe

Manche Fähigkeiten sind so mächtig, dass ein Plugin sie nicht einfach verlangen kann: eigene Anmelde- und OAuth-Pfade, zweiter Faktor, Sitzungen für externe Identitäten, E-Mail an Benutzer, Zugriff auf ein Sprachmodell, Konten anlegen oder einladen, eigener Netzwerk-Listener, Ablage in den Medien. Ein solcher Scope wirkt erst, wenn ein Administrator ihn für dieses Plugin freigibt — und lässt sich jederzeit wieder entziehen.

Kritische Scopes eines Plugins mit Freigabe
Ein kritischer Scope in den Plugin-Details: freigegeben, mit Knopf zum Entziehen.

Signierte Pakete

Plugins und das Rahmenwerk selbst kommen als signierte Pakete (Ed25519). Eingespielt wird nur, was eine gültige Signatur eines vertrauenswürdigen Schlüssels trägt; die Liste der Schlüssel führt der Administrator unter Trusted Keys. Das Rahmenwerk aktualisiert sich nur auf Knopfdruck: Ein eigener Helfer prüft Prüfsumme und Signatur noch einmal, sichert den alten Stand, installiert, prüft den Start und spielt bei Misserfolg den alten Stand zurück.

Plugin-Shop und Lizenzen

Unter Verwaltung → Plugins → Shop sieht jede Installation die Plugins ihrer Bezugsquellen: frei, mit Lizenz oder mit kostenloser OSS-Lizenz für Open-Source-Projekte. Mit einem verbundenen Kundenkonto lassen sich Angebote testen und kaufen; Lizenzschlüssel werden der Bezugsquelle zugeordnet und, wenn ein Tresor-Plugin geladen ist, dort verwahrt. Installieren und Aktualisieren gehen über denselben geprüften Weg wie ein manueller Upload; je Fassung zeigt der Shop Signatur, Grösse und Änderungen.

Bezugsquellen im Plugin-Shop
Bezugsquellen im Shop: Kundenkonto verbinden oder Lizenzschlüssel eintragen.

PP-SDK und Sprachen

Das PP-SDK enthält alles für eigene Plugins: SDKs je Klasse und Sprache, Werkzeuge zum Signieren, Prüfen und Packen (pp_keygen, pp_sign, pp_manifest_lint, pp_pipeline_lint, pp_new_plugin …), die Spezifikation von PPMSG mit Testvektoren und Beispiel-Plugins.

  • F3: PureBasic, C, C++, Go, Rust, Java und Python.
  • F2: PureBasic, C, Go und Rust.
  • F1: jede ausführbare Datei, etwa Bash, Python oder Go.
  • F0 und XUI: ohne Programmiersprache — XML, PPQL und für XUI-Widgets JavaScript.

Welche Plugins es gibt, steht in der Übersicht der Plugins.

Zurück zur PurePower Engine.

Kontakt

Fragen zu Plugin-System und Shop?

Wir zeigen es Ihnen gern oder beraten Sie zu Lizenz, Hosting und Betrieb.