pub fn flow_velocity(items_completed: f64, period: f64) -> Option<f64>Expand description
Flow velocity: count of flow items completed per unit time.
Flow velocity is the Flow Framework’s throughput measure (chapter 2.3). It should always be reported alongside flow distribution — a rising item count can hide a shift toward rework or item-splitting gaming, so velocity alone is an incomplete picture.
§Arguments
items_completed— count of flow items completed in the period.period— length of the observation period (any consistent time unit).
§Returns
Some(items per unit period), or None when period is zero.
§Examples
use software_engineering::flow_framework::flow_velocity;
// 40 items completed in a 4-week period = 10 items/week.
assert_eq!(flow_velocity(40.0, 4.0), Some(10.0));
assert_eq!(flow_velocity(40.0, 0.0), None);