# Elsa Workflows 集成说明

## 问题背景

YZWater3 项目需要集成工作流引擎来实现工艺流程编排。经过评估，选择了 Elsa Workflows 作为候选方案。

## 遇到的问题

### 1. API 不兼容

安装 `Elsa.Workflows.Core 3.7.1` 后，发现以下命名空间不存在：
- `Elsa.Workflows.Contracts`
- `Elsa.Workflows.Runtime`
- `Elsa.Workflows.Runtime.Messages`

### 2. 需要完整的 DI 容器

Elsa 3.x 需要完整的依赖注入容器配置，不适合直接在桌面应用中使用。

### 3. 需要额外的 NuGet 包

完整功能需要安装：
- `Elsa.Workflows.Core`
- `Elsa.Workflows.Runtime`
- `Elsa.Activities.Console`
- `Elsa.Activities.Http`
- 等...

## 当前解决方案

### 简化版工作流服务

创建了自定义的 `WorkflowService`，提供基本的工作流功能：

```csharp
// 初始化
await WorkflowService.Instance.InitializeAsync();

// 执行工作流
var result = await WorkflowService.Instance.ExecuteWorkflowAsync("WastewaterTreatment", context);

// 注册自定义工作流
WorkflowService.Instance.RegisterWorkflow("MyWorkflow", definition);
```

### 工作流定义

```csharp
var workflow = new WorkflowDefinition
{
    Name = "污水处理流程",
    Description = "自动检测液位、流量，控制泵启停",
    Steps = new List<WorkflowStep>
    {
        new() { Name = "CheckTankLevel", Action = CheckTankLevel },
        new() { Name = "CheckFlowRate", Action = CheckFlowRate },
        new() { Name = "ControlPump", Action = ControlPump }
    }
};
```

## 完整 Elsa 集成方案（未来参考）

### 所需 NuGet 包

```xml
<PackageReference Include="Elsa.Workflows.Core" Version="3.7.1" />
<PackageReference Include="Elsa.Workflows.Runtime" Version="3.7.1" />
<PackageReference Include="Elsa.Activities.Console" Version="3.7.1" />
<PackageReference Include="Microsoft.Extensions.DependencyInjection" Version="8.0.0" />
```

### 配置代码

```csharp
using Elsa.Extensions;
using Microsoft.Extensions.DependencyInjection;

var services = new ServiceCollection();

services.AddElsa(elsa =>
{
    elsa.AddActivitiesFrom<Program>();
    elsa.UsePersistence(new MemoryWorkflowStateProvider());
});

var serviceProvider = services.BuildServiceProvider();
```

### 执行工作流

```csharp
using var scope = serviceProvider.CreateScope();
var workflowRunner = scope.ServiceProvider.GetRequiredService<IWorkflowRunner>();
var workflow = new Workflow(new Sequence { ... });
var result = await workflowRunner.RunAsync(workflow);
```

## 替代方案

如果未来需要更强大的工作流引擎，可以考虑：

1. **WorkflowCore** - 更轻量，API 更简单
2. **CoreWF** - .NET Workflow Foundation 的移植版
3. **自建简单状态机** - 对于简单场景足够

## 总结

当前使用简化版工作流服务满足基本需求。如果未来需要：
- 工作流持久化
- 可视化设计器
- 复杂分支/并行执行
- 与外部系统集成

建议重新评估 Elsa Workflows 的完整集成方案，或考虑替代方案。

---

*创建时间: 2026-09-01*  
*状态: 待后续完善*