PlantUML甘特图中资源不可用时间的声明顺序问题解析

在PlantUML甘特图设计中，资源不可用时间（Resource off）的声明顺序会对任务排期产生直接影响。本文将通过技术解析帮助用户理解这一机制。

问题现象

当用户定义任务和里程碑后声明资源不可用时间时，系统不会自动将这些非工作日计算到任务持续时间中。例如：

[Task1] as [T1] on {UserA} lasts 14 days
[Milestone1] as [M1] happens after [T1]'s end
{UserA} is off on sunday
{UserA} is off on saturday

这种情况下，里程碑日期不会自动延后考虑周末的非工作日。

技术原理

PlantUML的甘特图引擎采用线性解析算法，按照从上到下的顺序处理定义语句。资源不可用时间的声明只有在任务定义之前才会被正确应用到后续的任务排期计算中。

正确实践

应将资源不可用时间声明置于任务定义之前：

{UserA} is off on sunday
{UserA} is off on saturday
[Task1] as [T1] on {UserA} lasts 14 days
[Milestone1] as [M1] happens after [T1]'s end

这种顺序能确保：

1. 系统先建立资源日历模型
2. 后续任务排期自动考虑已定义的非工作日
3. 里程碑日期计算包含所有非工作日

设计建议

1. 在项目开始前集中定义所有资源日历
2. 将资源约束声明放在文件顶部
3. 复杂项目可分区块组织：先资源定义，再任务排期
4. 使用注释标明不同区段的功能

理解这一机制后，用户可以更精确地控制PlantUML甘特图中的时间计算逻辑，确保项目计划符合实际工作日历。