WJb Docs - Intermediate

💡 What Is WJb?

WJb is an explicit background job framework for .NET.

Instead of hiding workflow transitions behind pipelines, middleware and framework magic, WJb keeps everything visible in code.

The Core Idea

Most systems eventually become:

Job
 ↓
Pipeline
 ↓
Middleware
 ↓
Retry
 ↓
Magic

WJb intentionally stays simple:

Action
 ↓
Result
 ↓
Next Action

If you can read the code, you can understand the workflow.

Building Blocks

Action

An Action is a unit of work.

Examples:

• Send an email
• Generate a report
• Import a file
• Call an external API

Result

Every Action returns a Result.

The Result tells WJb what should happen next.

Examples:

• Complete the workflow
• Continue to another Action
• Create multiple jobs

Job

A Job represents a scheduled execution of an Action.

Jobs are stored until a Worker executes them.

Worker

A Worker executes jobs.

Workers:

• Load jobs from the store
• Execute actions
• Save results
• Schedule next jobs

Example Workflow

GenerateReportAction
 ↓
SendEmailAction

The first Action generates a report. The second Action sends the report by email.

The workflow is completely visible in code.

Why WJb?

• ✅ Explicit workflows
• ✅ No hidden pipelines
• ✅ Easy debugging
• ✅ Easy testing
• ✅ Provider-neutral design
• ✅ Works from simple console apps to WASM

Philosophy

WJb follows a simple principle:

Every workflow should be understandable by reading the code.

No hidden transitions. No magic execution flow. No surprises.