Msm.Workflow.Lib.Application 1.9.2

Msm.Workflow.Lib.Application

Application layer cho MSM Workflow Engine - chứa business logic, services, DTOs, và interfaces.

📦 Installation

<PackageReference Include="Msm.Workflow.Lib.Application" Version="1.0.0" />

dotnet add package Msm.Workflow.Lib.Application

📋 Overview

Package này chứa business logic layer của workflow engine. Bao gồm services, DTOs, và các interfaces để customize workflow behavior.

Contents

• Services:
  • WorkflowProcessService - Quản lý workflow processes
  • WorkflowInstanceService - Quản lý workflow instances và execution
  • TenantService - Quản lý multi-tenancy
• DTOs: Data Transfer Objects cho API
• Interfaces:
  • IUserProvider - Customize user resolution
  • IApproverResolver - Customize approver resolution
  • ICriteriaEvaluator - Customize criteria evaluation
  • IWorkflowActionHandler - Customize action handlers

🎯 Usage

Register Services

using Msm.Workflow.Lib.Application;

// In Program.cs or Startup.cs
services.AddApplication();

Configure Custom Providers

services.AddApplication()
    .ConfigureWorkflow(options =>
    {
        // Customize UserProvider
        options.UseUserProvider<MyUserProvider>();
        
        // Customize ApproverResolver
        options.UseApproverResolver<MyApproverResolver>();
        
        // Customize CriteriaEvaluator
        options.UseCriteriaEvaluator<MyCriteriaEvaluator>();
    });

Use Services

public class MyController : ControllerBase
{
    private readonly IWorkflowProcessService _processService;
    private readonly IWorkflowInstanceService _instanceService;

    public MyController(
        IWorkflowProcessService processService,
        IWorkflowInstanceService instanceService)
    {
        _processService = processService;
        _instanceService = instanceService;
    }

    [HttpPost("create-process")]
    public async Task<IActionResult> CreateProcess(CreateWorkflowProcessDto dto)
    {
        var process = await _processService.CreateWorkflowProcessFromDtoAsync(dto);
        return Ok(process);
    }

    [HttpPost("trigger")]
    public async Task<IActionResult> TriggerWorkflow(Guid workflowProcessId, string objectId)
    {
        var instance = await _instanceService.SubmitWorkflowInstanceAsync(
            workflowProcessId: workflowProcessId,
            targetRecordId: objectId,
            targetObjectType: "PURCHASE_ORDER",
            submittedBy: "user123",
            contextData: null
        );
        return Ok(instance);
    }
}

Implement Custom Interfaces

// Custom UserProvider
public class MyUserProvider : IUserProvider
{
    public Task<UserInfo?> GetUserAsync(string userId, CancellationToken cancellationToken = default)
    {
        // Your implementation
    }
    
    // ... other methods
}

// Custom Action Handler
using Msm.Workflow.Lib.Domain.Entities.Workflow;

public class MySmsHandler : IWorkflowActionHandler
{
    public string ActionType => "SMS_ALERT";
    
    public Task ExecuteAsync(
        WorkflowInstance request,
        WorkflowStepAction action,
        CancellationToken cancellationToken = default)
    {
        // Your implementation
        return Task.CompletedTask;
    }
}

🔗 Dependencies

• Msm.Workflow.Lib.Domain (required)
• Msm.Workflow.Lib.Infrastructure (required)
• Microsoft.Extensions.Hosting.Abstractions (10.0.1)

📚 Related Packages

• Msm.Workflow.Lib.Domain - Required dependency
• Msm.Workflow.Lib.Infrastructure - Required dependency
• Msm.Workflow.Lib.Api.Controllers - Uses this package

📖 Documentation

For more information, see the main README.md and GETTING_STARTED.md.