Operaton Examples

A curated catalog of minimal, production-quality example projects for Operaton — the open-source BPMN process engine. Every example is self-contained, builds with both Maven Wrapper and Gradle Wrapper, ships a Docker Compose setup for local exploration, and is verified end-to-end by Testcontainers integration tests: building an example means testing its processes against real integrations.

Pinned stack (all examples): Spring Boot 4.1.0, Operaton 2.1.1, Maven Wrapper 3.9.12, Gradle Wrapper 9.2.0, PostgreSQL 16.

cd examples/getting-started
docker compose up -d --wait # start PostgreSQL (and example-specific services)
./mvnw spring-boot:run      # or: ./gradlew bootRun
# Cockpit/Tasklist: http://localhost:8080  (demo/demo)
./mvnw verify               # or: ./gradlew build — runs Testcontainers ITs

flowchart LR
    subgraph example [examples/name]
        BPMN["BPMN/DMN models<br/>(operaton namespace, full DI)"]
        APP["Spring Boot app<br/>(delegates, config)"]
        IT["Integration tests<br/>(Testcontainers)"]
        DC["docker-compose.yml<br/>(local exploration)"]
        RM["README<br/>(Mermaid diagrams, walkthrough)"]
    end
    BPMN --> APP
    APP --> IT
    IT -->|"PostgreSQL + real<br/>external systems"| TC[(containers)]
    DC -->|same services| TC

Every example satisfies docs/EXAMPLE_STANDARDS.md — the definition of done covering modeling, testing, documentation and dual builds. CI builds every example with both build systems on every push.

AI agents: start with AGENTS.md. Humans: same rules — see the review checklist in docs/EXAMPLE_STANDARDS.md.

Apache-2.0