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

//! [`StatisticsPort`] — operational counter surface.
//!
//! Every [`DeliberateUseCase`](super) invocation that completes
//! records its duration and specialty through this port; every
//! [`OrchestrateUseCase`](super) invocation records the orchestration
//! duration. Adapters decide where the numbers live — in-memory for
//! a single replica, external store for multi-replica setups — and
//! whatever Prometheus / gRPC exposer the composition root wires
//! reads [`Statistics`] through `snapshot`.

use async_trait::async_trait;

use crate::entities::Statistics;
use crate::error::DomainError;
use crate::value_objects::{AuthorizationEvidence, DurationMs, Specialty};

#[async_trait]
pub trait StatisticsPort: Send + Sync {
    /// Record that a deliberation for `specialty` completed in
    /// `duration`.
    async fn record_deliberation(
        &self,
        specialty: &Specialty,
        duration: DurationMs,
    ) -> Result<(), DomainError>;
    async fn record_deliberation_authorized(
        &self,
        specialty: &Specialty,
        duration: DurationMs,
        authorization: Option<AuthorizationEvidence>,
    ) -> Result<(), DomainError> {
        reject_unsupported(authorization.as_ref())?;
        self.record_deliberation(specialty, duration).await
    }

    /// Record that an orchestration (deliberate + execute) completed
    /// in `duration`.
    async fn record_orchestration(&self, duration: DurationMs) -> Result<(), DomainError>;
    async fn record_orchestration_authorized(
        &self,
        duration: DurationMs,
        authorization: Option<AuthorizationEvidence>,
    ) -> Result<(), DomainError> {
        reject_unsupported(authorization.as_ref())?;
        self.record_orchestration(duration).await
    }

    /// Read-only snapshot. Callers receive a clone so the returned
    /// value is safe to serialise without holding any lock.
    async fn snapshot(&self) -> Result<Statistics, DomainError>;
}

fn reject_unsupported(authorization: Option<&AuthorizationEvidence>) -> Result<(), DomainError> {
    if authorization.is_some() {
        return Err(DomainError::InvariantViolated {
            reason: "statistics adapter cannot persist authorization evidence",
        });
    }
    Ok(())
}