Struct Sprint 

pub struct Sprint {
    pub id: SprintId,
    pub title: String,
    pub goal: String,
    pub start: Option<DateTime<Utc>>,
    pub end: Option<DateTime<Utc>>,
    pub daily_work_hours: Option<f64>,
    pub holiday_days: Option<u32>,
    pub deduction_factor: Option<f64>,
    pub state: SprintState,
    pub created: DateTime<Utc>,
    pub updated: DateTime<Utc>,
}

A sprint that groups PBIs into a time-boxed work period.

start and end are planned dates independent of state transitions; editing sets the schedule while Sprint::start and Sprint::close advance the state.

Fields

id: SprintId

Stable identifier.

title: String

Display title.

goal: String

Sprint goal (free description, multiple lines allowed).

start: Option<DateTime<Utc>>

Planned start date and time, or None when unset.

end: Option<DateTime<Utc>>

Planned end date and time, or None when unset.

daily_work_hours: Option<f64>

Working hours per day; capacity is unavailable when unset.

holiday_days: Option<u32>

Holidays within the period, deducted from the inclusive calendar-day count.

deduction_factor: Option<f64>

Fraction of daily capacity retained after meetings and interruptions (0.0..=1.0).

state: SprintState

Current state (planned, active, or closed).

created: DateTime<Utc>

updated: DateTime<Utc>

Implementations

impl Sprint

pub fn new( id: SprintId, title: impl Into<String>, now: DateTime<Utc>, ) -> Result<Self>

Create a minimal sprint in SprintState::Planned with an empty goal and no schedule.

Return Error::EmptySprintTitle when title is empty or only whitespace.

pub fn update_details( &mut self, title: Option<String>, goal: Option<String>, period: Option<(DateTime<Utc>, DateTime<Utc>)>, now: DateTime<Utc>, ) -> Result<()>

Update the editable sprint details and refresh updated.

Fields set to None remain unchanged. A blank title or inverted period is rejected before any field changes are applied. Return Error::NothingToUpdate when no field is supplied.

pub fn start(&mut self, now: DateTime<Utc>) -> Result<()>

Start a sprint (planned → active) and update updated.

A sprint without a non-blank goal is rejected with Error::EmptySprintGoal. Return Error::InvalidSprintTransition for any other starting state without changing it.

pub fn close(&mut self, now: DateTime<Utc>) -> Result<()>

Close a sprint (active → closed) and update updated.

Return Error::InvalidSprintTransition for any other state without changing it.

pub fn set_capacity( &mut self, daily_work_hours: f64, holiday_days: u32, deduction_factor: f64, ) -> Result<()>

Update settings for capacity calculations.

Count calendar days inclusively, subtract holiday_days, and multiply the result by daily_work_hours × deduction_factor. Reject an unset period or invalid value without changing existing settings.

pub fn capacity(&self) -> Option<SprintCapacity>

Return working days and available hours when the schedule and capacity settings are complete.

Trait Implementations

impl Clone for Sprint

fn clone(&self) -> Sprint

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for Sprint

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl PartialEq for Sprint

fn eq(&self, other: &Sprint) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl StructuralPartialEq for Sprint