Skip to content

Flow 架构与责任边界 ​

Flow 将设备动作、模板处理和结果输出组织成可重复的节点图,但“编辑画布、保存模板、运行节点、完成业务”由不同对象负责。本页只定义跨模块所有权与调用关系,各层具体行为在所属主题维护。

按职责定位 ​

边界主要所有者权威主题
底层画布与序列化STNodeEditor、STNodeOption、CVNodeContainer:WPF 输入、节点/端口、STN 兼容ST.Library.UI
节点执行内核FlowEngineControl、IFlowGraphHost、FlowRuntimeHost / FlowEngineRunner:图加载、服务绑定与引擎状态FlowEngineLib
模板存储TemplateFlow / FlowPackageHelper:MySQL、Base64 STN、流程包、版本/搜索侧车Flow 模板与包
编辑工作区ViewFlow、FlowEditorCanvas、FlowTemplateWorkspaceController:命令、active/requested 模板、文档基线和刷新代际工作区契约
共享业务会话FlowExecutionSession / FlowRunExecutor / FlowRunFinalizer / FlowRunLifecycleGate:批次、前后处理、门禁、最终 outcome 与诊断执行会话
隔离无界面执行FlowExecutionCoordinator / FlowHeadlessExecutionService:请求副本、独立 RuntimeHost、裸图终止结果无界面执行

IFlowGraphHost 将可视 STNodeEditor 与非可视 CVNodeContainer 适配为执行所需的图,但不拥有选择、缩放或文档命令。FlowRuntimeHost 不访问 WPF Application/Dispatcher/Window;隔离图与编辑器不能共享可变节点实例。

FlowProcessing/Editor/ 持有画布组合、布局、菜单、属性面板和校验;FlowProcessing/Runtime/ 持有工作区与运行编排。Templates/Flow/ 不应重新吸收这些 UI/运行职责。PreProcess、PostProcess、Diagnostics、Scheduling、Compilation 分别提供阶段扩展、诊断、调度和语义投影。

两条执行链 ​

text
UI/FlowJob → ViewFlow → FlowExecutionSession → 批次/前处理/门禁
           → FlowRunExecutor → FlowControl → FlowEngineLib
           → FlowRunFinalizer → RunFinalized

裸请求/HeadlessFlowJob → FlowExecutionCoordinator → 不可变STN/服务请求
                      → FlowHeadlessExecutionService
                      → 新FlowRuntimeHost / FlowEngineRunner → 裸图终止结果

第二条链不会自动获得第一条链的批次、前后处理或 RunFinalized。按 FlowKey 读取模板的协调器仍可能使用 WPF Dispatcher 访问模板集合;“隔离图执行不触碰编辑器”不等于所有入口都完全不依赖宿主。

事件层次是“单节点结束 → 整图引擎结束 → 宿主业务最终化”,不能因某层事件名称含 Completed 就跨层判断成功。完整完成判据只在执行会话和无界面结果契约中维护。

扩展与不可跨越的边界 ​

  • 公共节点执行语义归 FlowEngineLib;Engine 本地节点归 FlowProcessing/Nodes/。客户判定、协议字段和导出映射仍在 Projects/*。
  • 普通节点字段接入统一属性元数据;多模板族等专用补充面板归 Editor/NodeConfiguration/,具体规则见工作区,不要在模板存储类里创建属性 UI。
  • FlowEngineToolWindow 只承载 standalone ViewFlow;主窗口与独立窗口共用视图,但文档目标和工作区状态不相同。
  • 诊断与版本/搜索投影是辅助链,分别由执行主题和模板主题定义失败边界;它们不能替代生产流程结果或源 STN。
  • 部分现有 Projects/* 窗口仍直接持有 FlowControl,在 FlowCompleted 后完成项目自己的最终化;未迁移前不能描述为已接入共享 RunFinalized。
  • 运行、停止、模板保存/导入、Incident 处置和设备动作有不同副作用。架构入口不授予这些动作的执行权限。

症状到责任 ​

症状对应边界
画布加载后节点或连线缺失ST 类型目录、序列化兼容与节点程序集
快速切模板显示错对象,保存到了错误模板工作区 active/requested 身份、generation 与文档目标
保存成功但版本或搜索缺项模板层 catalog 侧车,不先重写源 STN
启动被拒绝、卡住或引擎结束后仍未完成共享会话的服务/门禁/后处理,或裸执行器自己的终止结果
Quartz 行为与手动运行不同先识别 FlowJob 或 HeadlessFlowJob,再查输入来源与完成边界
本地完成但客户输出不正确对应项目的最终化与结果映射,而非 ST 库或裸运行器

验证边界 ​

沿变更涉及的执行层验证,并分别记录真实数据库、MQTT、设备、项目兼容入口和项目输出的验证范围。

基于 MIT License 发布。