企业官网建设流程全解析

• 后端
• 工作流自动化
• 流程编排
• 低代码

Elsa Core 是一个大型的多项目 .NET 解决方案，采用"小而独立打包的模块"而非单一体架构来组织代码。本文以仓库官方导航文档 repository-map.md 为骨架，逐层拆解其顶层目录、主要模块家族、参考宿主与构建体系，并结合源码给出快速定位代码的实战方法。读完本文，你将能够根据功能需求（如持久化、脚本、多租户、用户任务）迅速找到对应的项目、Feature 类与测试目录，直接进入源码阅读与二次开发。

顶层布局：一条路径对应一类职责

仓库根目录下的src/、test/、doc/、specs/等目录各自承担明确的职责，理解顶层布局是导航的第一步。

几点源码佐证：

• 构建体系：根目录 Directory.Build.props 定义了全仓共享的 MSBuild 属性（LangVersion latest、Nullable enable、ImplicitUsings enable、MIT 许可、Symbol 包等）；src/Directory.Build.props 将源包多目标到net8.0;net9.0;net10.0；Directory.Packages.props 启用ManagePackageVersionsCentrally集中管理包版本，并对 .NET 8/9 与 .NET 10 分别提供条件版本（例如 FastEndpoints 在 net8/9 下为 7.1.1，net10 下为 8.2.0）。NUKE 构建入口位于 build/Build.cs，build/Build.CI.GitHubActions.cs 负责 CI 装配。
• 测试分层：test/unit下有 40 余个单元测试项目（如Elsa.Workflows.Core.UnitTests、Elsa.Workflows.Runtime.UnitTests），test/integration下有Elsa.Workflows.IntegrationTests、Elsa.Http.IntegrationTests等，test/performance下是Elsa.Workflows.PerformanceTests，与顶层表格一一对应。

核心装配机制：Elsa 基座包

Elsa 是"基座宿主包"，对外暴露AddElsa、ElsaFeature以及默认工作流 Feature 装配。

其核心实现位于 Features/ElsaFeature.cs：

[DependsOn(typeof(MediatorFeature))] [DependsOn(typeof(WorkflowsFeature))] [DependsOn(typeof(FlowchartFeature))] [DependsOn(typeof(DefaultWorkflowRuntimeFeature))] [DependsOn(typeof(WorkflowManagementFeature))] public class ElsaFeature : FeatureBase

从源码结构看，ElsaFeature通过DependsOn声明依赖链（Mediator → Workflows → Flowchart → 默认运行时 → 工作流管理），并在Configure()中装配默认的执行管线（WithDefaultWorkflowExecutionPipeline/WithDefaultActivityExecutionPipeline），同时自动注册Elsa.Workflows.Core中的活动——唯独显式移除ReadLine，因为"读一行"活动在等待用户输入时容易造成容器挂起，官方选择让使用者显式开启。这就是在Program.cs中调用services.AddElsa(...)后一切默认功能即可用的底层原理。

主要模块家族：一条功能主线对应一组项目

下表是仓库官方的模块家族划分，映射了"业务能力 → 项目 → 职责"的完整链路。

从源码印证模块家族的组装方式

以运行时家族为例，Elsa.Workflows.Runtime/Features 目录下依次是WorkflowRuntimeFeature（基座运行时）、DefaultWorkflowRuntimeFeature（默认运行时实现）、CachingWorkflowRuntimeFeature（缓存增强）。参考宿主 Program.cs 展示了典型用法：

.UseWorkflowRuntime(runtime => { runtime.UseEntityFrameworkCore(ef => ef.UseSqlite()); runtime.UseCache(); runtime.UseDistributedRuntime(); // 该示例宿主允许在开发环境或显式单宿主开启时使用单机文件系统锁 runtime.DistributedLockingOptions = options => options.AllowLocalLockProviderInDistributedRuntime = allowLocalDistributedRuntimeLockProvider; })

同一文件中还串联了UseIdentity、UseWorkflowsApi、UseScheduling、UseBpmnInterchange、UseCSharp/UseJavaScript/UsePython/UseLiquid、UseHttp、UseTenants、可选UseStructuredLogs等调用——这正是"多模块家族被组装进一个宿主"的直观范例。

参考宿主：从样例快速起步

仓库提供了四个可直接运行的参考宿主，用途各有侧重：

• Elsa.Server.Web：最完整的综合 ASP.NET Core 示例。其 Program.cs 展示了典型模块组合：身份、EF Core SQLite、运行时、管理、HTTP、调度、脚本、多租户，以及可选的结构化日志。它还演示了 API 限流（AddRateLimiter+ 固定窗口策略）、健康检查（/health/live、/health/ready）、CORS 与开发环境 Swagger UI。
• Elsa.ModularServer.Web：通过 Nuplane 与 Shell Feature 演示模块化包加载（对应Elsa.Shells.Api家族）。
• Elsa.Server.LoadBalancer：负载均衡宿主，可与Elsa.Hosting.Management的心跳集群能力配合理解多节点部署。
• Elsa.SamplePackage：极简的"包式 Feature"样例，适合学习如何把一个功能封装成可分发模块。

构建与打包文件：三个关键 MSBuild 入口

• Directory.Build.props：全仓共享 MSBuild 设置（语言版本、Nullable、隐式 using、MIT 许可、文档生成、SourceLink 符号包等）。
• src/Directory.Build.props：源包多目标到net8.0;net9.0;net10.0，并引入 src/Fody.props 的 Fody 装配。
• Directory.Packages.props：集中管理包版本，ManagePackageVersionsCentrally开启；注意其"条件版本"策略——net8.0/net9.0与net10.0使用不同的依赖版本组，这是理解"同一仓库多目标兼容"的关键。

NUKE 构建目标定义在 build/Build.cs，CI 相关装配见 build/Build.CI.GitHubActions.cs。此外 docker 目录提供了ElsaServer.Dockerfile、ElsaServerAndStudio.Dockerfile、ElsaStudio.Dockerfile及 docker-compose.yml（含 Kafka、Datadog+OTel Collector 变体），可用于本地快速起服务。

快速定位代码：Feature 优先，契约随后

官方导航给出的核心搜索策略是：先找 Feature 类，再沿契约与服务注册追踪到实现。绝大多数模块都有Features/*Feature.cs，且常伴有平行的ShellFeatures/*Feature.cs；Feature 类会告诉你该模块注册了什么、依赖了哪些其他 Feature。

推荐的四个起步搜索命令：

# 1. 找出所有模块与共享基础设施中的 Feature 类 rg "class .*Feature" src/modules src/common # 2. 找出所有 Store 契约（持久化入口） rg "interface I.*Store" src/modules # 3. 查看运行时模块注册了哪些服务生命周期 rg "AddScoped|AddSingleton|TryAdd" src/modules/Elsa.Workflows.Runtime/Features # 4. 查看工作流 API 暴露了哪些 REST 端点 rg "Get\(|Post\(|Delete\(" src/modules/Elsa.Workflows.Api/Endpoints

以第一条为例，直接执行即可看到ElsaFeature、WorkflowsFeature、FlowchartFeature、WorkflowManagementFeature、WorkflowRuntimeFeature等一条完整的 Feature 链；第三条会定位到 DefaultWorkflowRuntimeFeature.cs 中的AddScoped/TryAdd服务注册，帮助你理解"触发器、书签、运行日志"等组件在容器中的生命周期。

结语

这份仓库地图的价值在于把 200+ 个 .NET 项目按"能力家族"组织成一张可导航的拓扑：先看顶层目录定大方向，再看模块家族定具体项目，进 Feature 类看装配，沿契约追实现，最后用参考宿主与测试目录验证行为。无论你要调研持久化 vNext、接入外部认证、扩展表达式语言，还是为工作流引擎增加新活动，都可以从本文的路径索引出发，直达源码深处。

• 后端
• 工作流自动化
• 流程编排
• 低代码