Ordo

The open-source decision platform — author, test, and govern business rules at scale

---

Ordo has entered its platform phase. Teams can now manage organizations, projects, templates, rulesets, tests, release workflows, and connected servers from one workspace instead of scattering decision logic across codebases, spreadsheets, and tribal knowledge.

Platform — org workspace, project hub, server fleet, templates, release center, testing and governance.
Studio — visual flow editor, decision table editor, trace-driven testing, version history, template instantiation.
Engine — sub-microsecond rule execution, JIT-compiled, runs everywhere (HTTP · gRPC · WASM · CLI).

---

Why Ordo?

	Ordo	OPA	Drools	json-rules-engine
JIT compilation	✅ Cranelift	❌	❌	❌
Authoring model	Visual flow + decision table	Rego policy code	DRL / DMN + Business Central	JSON rule DSL
Built-in web workbench	✅ Studio	Playground / APIs	✅ Business Central	❌
Browser / Wasm target	✅ Native	✅ Policy-to-Wasm	❌	✅ Browser JS
Deployment	Single binary or hosted platform	Binary, sidecar, or service	JVM app, KIE Server, Business Central	JS library for Node/browser

Comparison focuses on first-party documented authoring and deployment capabilities rather than cross-project benchmark claims.

---

Quick Start

Try Studio (5 minutes)

docker compose up          # platform + engine + studio
# open http://localhost:5173

Or use the hosted Live Playground — no install needed.

Engine only

docker run -d -p 8080:8080 ghcr.io/pama-lee/ordo:latest

# Create a rule
curl -X POST http://localhost:8080/api/v1/rulesets \
  -H "Content-Type: application/json" \
  -d @examples/discount.json

# Execute
curl -X POST http://localhost:8080/api/v1/rulesets/discount/execute \
  -d '{"input": {"user": {"vip": true}}}'
# → {"code": "VIP", "message": "20% discount"}

Embed the editor

npm install @ordo-engine/editor-vue    # Vue 3
npm install @ordo-engine/editor-react  # React

---

Platform Features

Rule Authoring

• Flow editor — drag-and-drop decision trees with live WASM execution
• Decision table — spreadsheet-style multi-condition rules
• Templates — ship pre-built rule sets (e.g. ecommerce-coupon) that teams clone in one click

Platform Workspace

• Organization and project hub — manage orgs, projects, members, roles, and project workspaces from one dashboard
• Server fleet — register connected Ordo servers, group them by environment, and target release rollouts by instance
• Release center — create release requests, track staged rollouts, approvals, retries, and rollback history

Governance

• Fact catalog — register every input field with type, source, latency, and null policy
• Decision contracts — typed input/output schemas per ruleset; generate test skeletons automatically
• Version history — full snapshot log per ruleset; roll back with one click
• Test and diagnostics — run platform-local draft tests, inspect expected/actual diffs, replay execution paths, and review decision-table hits

Engine

• 1.63 µs interpreter · 50–80 ns JIT (Cranelift) · 54k QPS HTTP single-thread
• Multi-tenancy, WAL crash recovery, hot reload, NATS JetStream sync
• Data Filter API — push rule logic into SQL / MongoDB $match / JSON predicates
• Compiled .ordo binary format with ED25519 signature for rule protection

---

Project Structure

ordo/
├── crates/
│   ├── ordo-core/       # Rule engine + JIT compiler
│   ├── ordo-server/     # HTTP/gRPC API server
│   ├── ordo-platform/   # Org/project/template/testing management layer
│   ├── ordo-cli/        # CLI — eval, exec, test
│   ├── ordo-wasm/       # WebAssembly bindings
│   ├── ordo-proto/      # gRPC definitions
│   └── ordo-derive/     # TypedContext derive macro
├── ordo-editor/
│   ├── packages/        # @ordo-engine/editor-{core,vue,react,wasm}
│   └── apps/
│       ├── studio/      # Platform Studio (Vue 3 + TDesign)
│       ├── playground/  # Live demo
│       └── docs/        # VitePress documentation
└── scripts/             # sync-version.sh, benchmarks

---

Roadmap

Milestone	Target	Goal
M1 — Platform Foundation	v0.4 ✅	Org workspace, Studio app, template flow, test management
First Decision	v0.5	5-min onboarding, guided setup wizard
Deploy & Connect	v0.6	Release center, server registration, rollout execution, SDK codegen
Observe	v0.7	Execution dashboard, trace explorer, alerting
Govern	v0.8	Change requests, impact analysis, approval flows
Ordo Cloud	v1.0	Managed platform with hosted engine

Full roadmap → docs/roadmap

---

License

MIT — see LICENSE.

_{Built with Rust · Discord · Docs}