WJb Docs - Basic

💡 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.