

App-SDK
Das @5minds/processcube_app_sdk ist ein TypeScript-SDK zur Entwicklung von ProcessCube-Anwendungen mit Next.js . Es stellt React-Komponenten, Server-Funktionen und Utilities für Prozessvisualisierung (BPMN), dynamische Formulare und die Integration mit der ProcessCube-Engine bereit.
Features
- Next.js 15+ App Router mit React 19 Server Components
- Vollständig typisiert durch TypeScript-Support
- OAuth 2.0 Authentifizierung via Authority-Integration (NextAuth + Client Credentials)
- Ready-to-use React-Komponenten für BPMN-Viewer, Prozess-Inspektion und dynamische Formulare
- Sichere Engine-Kommunikation über Server-Side Functions und Server Actions
- Automatische Worker-Registrierung für External Tasks
- Authority Client für Server-to-Server User-Administration
Quick Start
npm install @5minds/processcube_app_sdk@latestimport { getWaitingUserTasks } from '@5minds/processcube_app_sdk/server';
export default async function Page() {
const { userTasks } = await getWaitingUserTasks();
return (
<ul>
{userTasks.map((task) => (
<li key={task.flowNodeInstanceId}>{task.flowNodeName}</li>
))}
</ul>
);
}Das AppTemplate bietet ein vollständiges Starter-Projekt mit Engine, Authority und BPMN-Prozessen — ideal zum Einstieg.
Dokumentation
| Sektion | Beschreibung |
|---|---|
| Installation | Paket installieren, Next.js konfigurieren, CSS einbinden |
| Erste Schritte | Quick Start mit erstem Code-Beispiel |
| SDK-Architektur | Drei-Schichten-Modulstruktur, Export-Map |
| Authentifizierung | User-Identity, Server-Identity, Authority Client |
| Server-Funktionen | Engine-Funktionen, User Tasks, Server Actions |
| Konfiguration | Environment Variables, Plugin System |
| Komponenten | BPMNViewer, DynamicUi, ProcessInstanceInspector, … |
| External Tasks | Geschäftslogik als automatische Worker |
| Beispiele | Vollständige Code-Beispiele und Use Cases |
Support & Links
- npm Package: @5minds/processcube_app_sdk
- AppTemplate: Starter-Projekt mit AppSDK
- Beispiele: Code-Beispiele