WorkflowCoreHangfire.AspNetCore 1.0.0

WorkflowCoreHangfire.AspNetCore

🚀 The complete ASP.NET Core integration for combining Hangfire job scheduling with WorkflowCore workflow orchestration.

Features

✨ One-line setup - Automatic configuration with dashboard integration
🌐 HttpContext support - Access HTTP request context in background workflows
📊 Rich dashboard - Beautiful workflow visualization and monitoring
🛡️ Production ready - Built on proven technologies

Installation

dotnet add package WorkflowCoreHangfire.AspNetCore

Quick Start

1. Configure Services

using Hangfire.WorkflowCore.Extensions;

var builder = WebApplication.CreateBuilder(args);

// One-line setup with automatic dashboard integration
builder.Services.AddHangfireWorkflowCoreAspNetCore(
    hangfire => hangfire.UseMemoryStorage());
    
// Includes:
// ✅ WorkflowCore integration
// ✅ Dashboard visualization  
// ✅ HttpContext support
// ✅ Background job processing

var app = builder.Build();

2. Add Dashboard

// Workflow information included automatically
app.UseHangfireDashboard("/hangfire");

app.Run();

3. Create a Workflow

public class MyWorkflow : IWorkflow<MyData>
{
    public string Id => "my-workflow";
    public int Version => 1;

    public void Build(IWorkflowBuilder<MyData> builder)
    {
        builder
            .StartWith<ProcessDataStep>()
                .Input(step => step.Data, data => data)
            .Then<SendNotificationStep>();
    }
}

4. Execute Workflows

// Execute immediately
var jobId = BackgroundJobWorkflow.Instance
    .Enqueue<MyWorkflow, MyData>(new MyData { Value = "Hello" });

// Schedule for later
var scheduledJobId = BackgroundJobWorkflow.Instance
    .ScheduleWorkflow<MyWorkflow, MyData>(
        new MyData { Value = "Scheduled" }, 
        TimeSpan.FromMinutes(30));

HttpContext Access

Access HTTP request context in your workflow steps:

public class HttpAwareStep : StepBody
{
    private readonly IHttpContextSnapshotProvider _httpContext;
    
    public HttpAwareStep(IHttpContextSnapshotProvider httpContext)
    {
        _httpContext = httpContext;
    }
    
    public override ExecutionResult Run(IStepExecutionContext context)
    {
        var userAgent = _httpContext.UserAgent;
        var userId = _httpContext.UserId;
        
        // Use HTTP context data in background workflow
        return ExecutionResult.Next();
    }
}

Dashboard Features

Navigate to /hangfire to see:

• 🔍 Workflow Details: Complete execution information
• 📈 Step Progress: Real-time step monitoring
• 🎯 Data Visualization: Input/output data for each step
• 🚨 Error Tracking: Detailed error information

Advanced Configuration

services.AddHangfireWorkflowCoreAspNetCore(
    hangfire =>
    {
        hangfire.UseSqlServerStorage(connectionString);
        hangfire.UseColouredConsoleLogProvider();
    },
    workflow =>
    {
        workflow.UseSqlServer(connectionString, true, true);
        workflow.UseLockProvider(new SqlServerLockProvider(connectionString));
    });

Package Relationships

• WorkflowCoreHangfire - Core integration library
• WorkflowCoreHangfire.Dashboard - Dashboard visualization
• WorkflowCoreHangfire.Abstractions - Interfaces and contracts

This package includes all dependencies for a complete solution.

Documentation

📖 Getting Started Guide
📖 ASP.NET Core Integration
📖 Complete Documentation

Support

💖 Support this project: Buy me a coffee

License

Licensed under LGPL v3 - see LICENSE for details.