甘特图产品化补齐:依赖校验、行级只读完整性、预警描边、树筛选、写后回读、刷新按钮(7 项)

[baozhoutao]

背景

排产项目基于甘特图落地客户需求(项目→产品→排班计划→派工单四层树,拖拽排产实时回写)。逐条核对代码后,组件已覆盖大部分需求,但存在 7 个具体缺口。数据架构问题(快照表+定时重建覆盖用户数据)不在本 issue 范围——正确做法是项目侧提供只读组合接口 + 直接写业务对象,组件侧经 #2423 已支持 api 数据源读写。

缺口清单(均已核实代码位置)

1. 连线落点不拒绝锁定行/分组行:GanttView 连线拖拽的落点登记(captureLinkTarget)只排除"自己连自己";锁定行(如派工单)不能作为连线起点,却能作为落点。依赖应仅在可编辑任务行之间创建。
2. 创建依赖无环检测:松手提交(linkDrag onUp)直接创建,A→B→C→A 能连出来;scheduling.ts 的 toposort 仅在调度时跳过环,不阻止创建。
3. 无逐任务预警描边:borderColor 仅在关键路径高亮时使用,无法按行数据(预警等级)给任务条描黄/红边。
4. 快速筛选打散树:筛选为平面过滤(ObjectGantt displayTasks),激活筛选后无筛选字段的祖先行(项目/产品分组行)被滤掉,树结构断裂。应保留命中行的祖先链。
5. 抽屉绕过行级锁定:锁定行点击打开 RecordDetailDrawer 时仍无条件传入 onFieldSave/onDelete,拖不动的行在抽屉里却能改能删。锁定行应以纯查看方式打开抽屉。
6. 写后不回读:拖拽回写成功后仅本地乐观补丁,不重新拉取,服务端重算的字段(汇总实际时间、预警等级、自动顺延连锁结果)带不回来。
7. 无刷新按钮:工具栏无手动刷新入口,数据变化(新建计划、派工单报工)只能整页刷新。

方案要点

• 1+2 收口到同一个否决点:创建依赖提交前内置策略校验(锁定/分组落点拒绝、DFS 环检测),悬停登记同步过滤(不给可落高亮);并新增 onBeforeDependencyCreate 否决钩子,供宿主叠加业务规则(对齐 DHTMLX onBeforeLinkAdd / Bryntum 校验回调的业界惯例)。
• 3:新增 borderColorField 类映射,行数据驱动描边色。
• 4:树感知筛选,命中行自动保留祖先链。
• 5:记录 locked 时不传 onFieldSave/onDelete。
• 6:update 成功后 refetch。
• 7:工具栏刷新按钮。

明确不做

• 断网自动恢复监听(有刷新按钮即可)
• 并发编辑保护(需求未要求,且服务端无对应能力)
• framework 侧改动:无需要

分 PR 提交,首刀为 1+2(依赖创建校验)。

[baozhoutao]

7 项已全部提交 PR,等待评审合并:

#	项	PR
1+2	连线落点守卫(锁定行/分组行)+ 依赖成环检测	#2437
3	逐任务预警描边 `borderColorField`	#2440
4	快速筛选保留祖先链(树形语义)	#2438
5	抽屉尊重行级锁定(能力 = handler 是否传入)	#2441
6+7	写后回读服务端重算字段 + 工具栏手动刷新按钮	#2442

各 PR 相互独立(均自 main 分支拉出);#2441 与 #2442 都动了抽屉 onFieldSave 附近的行,后合入的一方需小幅 rebase。断网监听、OCC/并发保护、framework 改动按既定范围不做。