Plattform-Architektur

Das AppTemplate startet eine vollständige ProcessCube® Plattform als Docker-Compose-Umgebung. Beide App-Typen (LowCode und AppSDK) nutzen dieselbe Infrastruktur.

Übersicht

Dienste

Dienst	Image	Port	Funktion
postgres	`processcube.postgres:0.2.1`	5432	PostgreSQL 18, erstellt automatisch Datenbanken `engine`, `authority`, `appdb`
engine	`processcube_engine:20.1.1`	8000	BPMN-Workflow-Engine, verwaltet Prozesse und Tasks
authority	`processcube_authority:3.5.2`	11560	OAuth2/OIDC Identity Provider mit User-Management
whodb	`clidey/whodb:latest`	8080	Web-basierte Datenbankverwaltung
lowcode	Eigenes Image (Dockerfile)	1880	Node-RED mit Custom Nodes und Widgets
appsdk_sample	Eigenes Image (Dockerfile)	3000	Next.js App mit UserTasks und External Tasks

Abhängigkeiten

Die Services starten in einer definierten Reihenfolge über Docker-Compose Healthchecks:

PostgreSQL startet zuerst und erstellt die Datenbanken
Engine und Authority warten auf PostgreSQL (Healthcheck)
LowCode und AppSDK warten auf Engine + Authority (Healthcheck)

Verzeichnisstruktur


ProcessCube.AppTemplate/
├── apps/
│   ├── lowcode/                 # LowCode-App (Node-RED)
│   │   ├── src/                 # Custom Nodes, Widgets, Plugins
│   │   ├── data/                # Persistente Node-RED-Daten
│   │   └── Dockerfile
│   └── appsdk_sample/           # AppSDK-App (Next.js)
│       ├── app/                 # Next.js App Router
│       ├── .env.local           # Umgebungsvariablen
│       └── Dockerfile
├── processes/                   # BPMN-Prozessdefinitionen (Auto-Seed)
├── .processcube/
│   ├── engine/config/           # Engine-Konfiguration
│   └── authority/config/        # Authority + User-Seeding
├── .vscode/                     # Debugging-Konfiguration
└── docker-compose.yml           # Service-Orchestrierung

Konfigurationsverzeichnisse

Engine (`.processcube/engine/config/`)

Enthält die config.json mit Datenbank-Einstellungen und dem Seed-Verzeichnis für BPMN-Prozesse.

Authority (`.processcube/authority/config/`)

Enthält OIDC-Einstellungen und User-Seeding-Daten. Die Authority stellt bereits eine externalTaskWorkers-Konfiguration für AppSDK-Apps bereit.

Prozesse (`processes/`)

BPMN-Prozessdefinitionen werden beim Start der Engine automatisch geladen (Seeding).

Nächste Schritte

LowCode vs AppSDK — Welcher Entwicklungsweg passt?
Konfiguration — Umgebungsvariablen und Einstellungen
Image-Versionen — Aktuelle Versionen aller Images