数据清洗 ​

基于 Vue Flow 的可视化数据清洗：用声明式 清洗流（CleanFlow） 把数据源、清洗算子、合并、聚合与输出串成有向图；流定义在设计期编排，调用时再执行（按需跑通整条管道）。设计器内可用 本地管道预览（runCleanFlowLocal + Demo / Mock 表数据）验证拓扑与算子效果。

与其它低代码工具的分工（完整链路见 低代码设计器）：

数据库建模（PostgreSQL 物理模型）
    ↓ 已发布元数据
数据准备 Dataset（怎么算：Join + 公式度量）
    ↓ 原始表 / 查询输出（亦可直接引用建模表）
数据清洗 CleanFlow（怎么洗：源 → 算子 → 输出）   ← 本模块
    ↓ 调用时执行（目标：报表 / 页面 / API，后续对接）
    ├─→ 低代码设计器（页面数据源）
    └─→ 报表设计器（图表数据集）

界面分区 ​

┌─────────────────────────────────────────────────────────────┐
│ 工具栏：清洗流名称 / 草稿|已发布 / 预览 / 保存                 │
├──────────┬──────────────────────────────────────────────────┤
│ 组件库   │ Vue Flow 画布                                     │
│ 240px    │ 节点、连线、缩放；选中后浮层配置面板                 │
│          │                                                   │
├──────────┴──────────────────────────────────────────────────┤
│ 底部：管道预览表（选中节点或全流至输出；含 warning / error）     │
└─────────────────────────────────────────────────────────────┘

核心能力 ​

1. 声明式清洗流：产物为 CleanFlow（version: 1），含 nodes + edges；设计期存定义，生产侧按「调用时执行」消费（对接中）
2. 五类算子组件库：源（表 / API）、清洗（空值、格式、去重、过滤、分支、字段拆分等）、合并（Join / Union）、聚合（分组 / 透视）、输出
3. 本地管道执行：runCleanFlowLocal 对全部节点类型做真实变换；设计器预览与 Mock POST /data-clean/preview 共用该引擎
4. 有向无环连线：必须从输出锚点拖到输入锚点；禁止自连与成环；同对同出口不重复连边
5. 条件分支双出口：condition 节点右侧「是 / 否」两路，与「条件过滤」（丢弃行）语义不同
6. 多源表引用（Demo）：建模表、Dataset 原始表、Dataset 输出三类来源（列表为前端 / Mock 写死）

当前边界（务必知晓） ​

推荐阅读 ​

1. 基础用法 — 接入演示、工具栏 / 画布操作、组件 API
2. 数据模型 — CleanFlow / 节点 config / 工厂与导出
3. 节点与算子 — 类别、端口、各类型配置字段与过滤运算符