Zum Inhalt springen

Schreiben Sie Ihr Produkt. Konten, Berechtigungen und Abrechnung liegen schon darunter.

Bauen Sie Ihr Produkt als UniCore-Plugin: eine .NET-Assembly und kein Frontend für die Admin-Konsole, aufbauend auf mandantenfähigen Konten, Anmeldung, Berechtigungen, Plänen, Verbrauchsmessung und Rechnungsstellung.

Auf einen Blick

Für wen das gedacht ist

Teams, die Branchensoftware für ein bestimmtes Gewerbe bauen

Agenturen, die viele Kleinbetriebe aus einer Plattform heraus bedienen

Produktteams, deren Wert in der Fachlichkeit liegt, nicht im Unterbau

Was Sie sonst selbst bauen müssten

Jedes Produkt braucht dasselbe Fundament: Konten, Anmeldung, Berechtigungen, Mandantenfähigkeit, Pläne, Verbrauchsmessung, Rechnungen, Datenexport, Löschung und eine Admin-Konsole. Sie haben es schon gebaut und würden es für das nächste Produkt wieder bauen. UniCore trägt es, und Sie schreiben das Produkt.


Was Sie bekommen

Eine Assembly, eine harte Grenze

Ein Plugin ist eine einzelne .NET-Assembly, die ausschließlich das SDK referenziert. Ein Compiler-Analyzer lässt den Build scheitern, sobald es in die Plattform-Interna greift. Damit bleibt Ihr Plugin konstruktionsbedingt trennbar und aktualisierbar.

Eine Admin-Konsole, die Sie nicht selbst schreiben müssen

Deklarieren Sie Einstellungs-, Sammlungs-, Kennzahlen- und Aktionspanels in Ihrem Manifest, und das Dashboard stellt sie dar, mit Formularen, Tabellen und Auswahllisten für Fremdschlüssel. Nichts davon braucht Frontend-Code im Plugin.

Ihr Datenmodell, von der Plattform verwaltet

Deklarieren Sie eine Domäne, und die Plattform legt sie unter Ihrem Plugin-Kürzel an. So bleiben die Namen zweier Produkte getrennt, und ein Konflikt wird abgelehnt. Schemaänderungen laufen über einen vorwärtsgerichteten Migrator, den Sie kontrollieren.

Eine veröffentlichte API mit aktueller Dokumentation

Schalten Sie die Domänen-API ein, und die Plattform liefert OpenAPI, eine im Browser bedienbare Swagger UI und typisiertes CRUD direkt aus Ihrem geladenen Plugin, optional mit anonymem Lesezugriff für öffentliche Seiten.

Abrechnung, Verbrauchsmessung und Löschung im SDK

Deklarieren Sie Produkte und legen Sie Abonnements an. Reservieren Sie Verbrauch an einem Credit- oder Token-Zähler und buchen Sie ihn anschließend oder geben Sie ihn frei. Kontingent und Preis legt der Betreiber fest. Für Löschungen fragen Sie Löschvermerke ab und löschen Ihre eigenen nutzerbezogenen Daten.

Deployment ohne Neustart

Laden Sie eine signierte Assembly hoch und installieren Sie sie. Jeder Host, der sie braucht, lädt sie im laufenden Betrieb. Während des Wechsels antworten ihre Routen mit 503 und Retry-After: 1. Scheitert die neue Version, bleibt die vorherige aktiv.

So funktioniert es

  1. Mit dem SDK beginnen

    Referenzieren Sie das SDK-Paket und deklarieren Sie ein Manifest: Identität, Version, benötigte Hosts, Berechtigungen, Routen und Release-Notes.

  2. Domäne deklarieren

    Beschreiben Sie Definitionen, Felder und Relationen in einem vorwärtsgerichteten Migrator. Die Plattform führt ihn bei der Installation aus, jeden neueren beim Upgrade, und versieht das Schema mit dieser Version.

  3. Endpunkte schreiben

    Deklarieren Sie jede Route mit ihrem Zugang: Berechtigung, angemeldet oder anonym. Beim Hochladen sieht der Betreiber die Liste. Eine anonyme Route kann ein eigenes Anfragebudget je IP und eine Obergrenze für die Anfragegröße festlegen.

  4. Admin-Oberfläche deklarieren

    Beschreiben Sie Formulare, Tabellen, Kennzahlenpanels und Aktionsschaltflächen als Manifest-Daten. Weitere Seiten können Sie als einzelnes JavaScript-Bundle mitliefern.

  5. In der CI verifizieren

    Analyzer lassen den Build außerdem scheitern, wenn Sie SDK-Mitglieder nutzen, die neuer als Ihre festgelegte Version sind. In der CI prüft 'dotnet unicore-plugin verify' die gebaute DLL: Assembly-Grenze, Manifest, SDK-Aufrufe und Routen.

  6. Installieren und übernehmen

    Installieren Sie das Plugin systemweit, oder lassen Sie es, wo Ihre Richtlinie es erlaubt, vom Administrator eines Mandanten übernehmen. Die Übernahme legt Schema und Vorlagen dieses Mandanten an, und Ihr Lifecycle-Hook kann Anfangsdaten ergänzen.

Was UniCore mitbringt und was Sie schreiben

Alles links gehört zu UniCore und wird von uns gepflegt. Alles rechts schreiben Sie selbst.

Das liefert UniCore

Mandantenfähige Konten und Mandantentrennung, mit Sitzungen, Sitzungserneuerung und Anmeldung per E-Mail und Passwort

Google, Microsoft oder Ihr eigener OIDC-Anbieter, dazu Apple auf Mobilgeräten (Paket Platform)

Rollen, benannte Berechtigungen und Zugriffsrechte je Plattformdatensatz, dazu Organisationseinheiten und Zugriffsanfragen für diese Datensätze

Ein schemaverwalteter Datenspeicher mit Migrationen und Hintergrund-Jobs mit Cron-Zeitplänen je Mandant

Nachrichtenaustausch zwischen Hosts und ein „Daten geändert“-Signal je Benutzer über den SSE-Stream

Benachrichtigungen per E-Mail in jedem Paket. Im Paket Platform kommen Telegram, Discord und WhatsApp hinzu, mit Vorlagen und Routing, die der Betreiber bearbeitet, sowie Schaltflächen zum Genehmigen und Ablehnen in Telegram- und Discord-Nachrichten

Produkte, Abonnements und Prüfung der Freischaltung

Verbrauchsmessung mit Reservieren, Buchen und Freigeben

DSGVO-Löschung für Konten, mit Löschvermerken für Ihre eigenen Daten, und Datenexport

Audit-Protokollierung (Paket Platform)

Eine aus Ihrem Manifest gerenderte Admin-Konsole

OpenAPI und Swagger für Ihre eigene API sowie Release-Notes für Ihre eigenen Versionen

Das schreiben Sie

Ihr Fachmodell

Ihre Geschäftsregeln

Ihre Kundenoberflächen, ausgehend von React-Shop-Bausteinen

Häufige Fragen

Ihre Frage ist nicht dabei? Schreiben Sie uns kurz, worum es geht.

Das SDK bietet heute PDF-Dokumente aus Vorlagen im Manifest, Cron-Zeitpläne je Mandant und typisierte Filter, auch für boolesche Felder. Anhänge werden aktuell als Metadaten geführt. Credits vergibt der Betreiber, und Einmalbuchungen werden erfasst. Eine Datei- oder Blob-Fassade, eigene Pipeline-Blöcke aus dem Plugin und die Rechnungsstellung für Einmalbuchungen setzen wir bei Bedarf oder auf Anfrage um.

Ja. Sie bauen allein gegen das SDK-Paket, der Plattform-Quellcode bleibt außen vor. Das Plugin läuft dann mit vollen Rechten im Host. Deshalb ist das Hochladen Administratoren des Hauptmandanten vorbehalten, und außerhalb der Entwicklungsumgebung braucht das Plugin eine vertrauenswürdige Signatur. Eine Sandbox für Plugins ist auf Anfrage umsetzbar.

Jeder Mandant übernimmt das Plugin getrennt, und jeder Aufruf über die SDK-Fassaden wird vom Host auf den Mandanten begrenzt. Die Mandantenfilter übernimmt damit die Plattform für Sie. Diese Begrenzung gilt für alle Zugriffe über die Fassaden. Führen Sie Datenzugriffe deshalb durchgängig über das SDK.

Upgrades sind eine bewusste Entscheidung. Eine neuere Binärdatei wird als ausstehendes Update markiert, und ein Administrator startet den Upgrade-Job, für einen Mandanten oder alle. Bei der Deinstallation bleiben Daten und Vorlagen erhalten. Das vollständige Löschen ist endgültig. Es bietet vorher einen Export an und verlangt zur Bestätigung die Eingabe des Plugin-Kürzels.

Lassen Sie sich UniCore an Ihrem eigenen Anwendungsfall zeigen

Dreißig Minuten per Bildschirmfreigabe: ein Relay, ein Plan, ein gemessener Aufruf und eine Rechnung, danach Ihre API oder Ihre Produktidee. Keine Folien.

Drei Pakete vergleichen