made-core 0.7.7

Domain core of MADE: entities, value objects, events, ports. No IO.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69

use serde::{Deserialize, Serialize};
use time::OffsetDateTime;

use crate::value_objects::{
    BudgetReservationId, CeremonyId, ContextKey, RoleId, StateIteration, StepAttempt,
    StepClaimFence, StepDeadline, StepExecutionRecord, StepId, StepIteration, StepLease,
};
use crate::DomainError;

/// A seat took a step to run.
///
/// The lease carries the idempotency key the aggregate records, and the
/// attempt is the one the aggregate assigned — a fold applies it rather
/// than recomputing it.
#[derive(Debug, Clone, PartialEq, Eq, Serialize, Deserialize)]
pub struct StepStarted {
    pub step_id: StepId,
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub state_visit: Option<crate::value_objects::StateVisit>,
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub state_iteration: Option<StateIteration>,
    pub iteration: StepIteration,
    pub attempt: StepAttempt,
    pub lease: StepLease,
    pub started_by: RoleId,
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub role_from: Option<ContextKey>,
    /// The actual role accepted for a static concurrent step when replay cannot
    /// recover it from the definition's canonical owner alone. This covers
    /// mixed dynamic/static states and explicitly selected alternate roles;
    /// canonical static-only claims retain the legacy unmarked shape.
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub sealed_role: Option<RoleId>,
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub deadline: Option<StepDeadline>,
    /// Reservation admitted before this claim was appended.
    #[serde(default, skip_serializing_if = "Option::is_none")]
    pub budget_reservation_id: Option<BudgetReservationId>,
    #[serde(with = "time::serde::rfc3339")]
    pub started_at: OffsetDateTime,
}

impl StepStarted {
    /// Rebuild the immutable fence carried by this accepted claim.
    pub fn claim_fence(&self, ceremony_id: &CeremonyId) -> Result<StepClaimFence, DomainError> {
        let record =
            StepExecutionRecord::pending_coordinates(self.state_iteration(), self.iteration)
                .with_state_visit(self.state_visit())
                .with_started(
                    self.lease.clone(),
                    self.attempt,
                    self.role_from
                        .as_ref()
                        .map(|_| self.started_by.clone())
                        .or_else(|| self.sealed_role.clone()),
                );
        StepClaimFence::for_record(ceremony_id, &self.step_id, &record)
    }

    #[must_use]
    pub fn state_iteration(&self) -> StateIteration {
        self.state_iteration.unwrap_or(StateIteration::FIRST)
    }

    #[must_use]
    pub fn state_visit(&self) -> crate::value_objects::StateVisit {
        self.state_visit.unwrap_or_default()
    }
}