bo4e_core/com/
price_tier.rs

1//! Price tier (Preisstaffel) component.
2
3use serde::{Deserialize, Serialize};
4
5use crate::traits::{Bo4eMeta, Bo4eObject};
6
7/// A price tier based on consumption brackets.
8///
9/// German: Preisstaffel
10///
11/// # Example
12///
13/// ```rust
14/// use bo4e_core::com::PriceTier;
15///
16/// let tier = PriceTier {
17///     lower_limit: Some(0.0),
18///     upper_limit: Some(1000.0),
19///     unit_price: Some(0.30),
20///     tier_number: Some(1),
21///     ..Default::default()
22/// };
23/// ```
24#[derive(Debug, Clone, Default, PartialEq, Serialize, Deserialize)]
25#[serde(rename_all = "camelCase")]
26pub struct PriceTier {
27    /// BO4E metadata
28    #[serde(flatten)]
29    pub meta: Bo4eMeta,
30
31    /// Lower consumption limit inclusive (Staffelgrenze von)
32    #[serde(skip_serializing_if = "Option::is_none")]
33    pub lower_limit: Option<f64>,
34
35    /// Upper consumption limit exclusive (Staffelgrenze bis)
36    #[serde(skip_serializing_if = "Option::is_none")]
37    pub upper_limit: Option<f64>,
38
39    /// Unit price for this tier (Einheitspreis)
40    #[serde(skip_serializing_if = "Option::is_none")]
41    pub unit_price: Option<f64>,
42
43    /// Tier number/sequence (Staffelnummer)
44    #[serde(skip_serializing_if = "Option::is_none")]
45    pub tier_number: Option<i32>,
46
47    /// Article ID reference (Artikel-ID)
48    #[serde(skip_serializing_if = "Option::is_none")]
49    pub article_id: Option<String>,
50}
51
52impl Bo4eObject for PriceTier {
53    fn type_name_german() -> &'static str {
54        "Preisstaffel"
55    }
56
57    fn type_name_english() -> &'static str {
58        "PriceTier"
59    }
60
61    fn meta(&self) -> &Bo4eMeta {
62        &self.meta
63    }
64
65    fn meta_mut(&mut self) -> &mut Bo4eMeta {
66        &mut self.meta
67    }
68}
69
70#[cfg(test)]
71mod tests {
72    use super::*;
73
74    #[test]
75    fn test_consumption_tiers() {
76        let tier1 = PriceTier {
77            lower_limit: Some(0.0),
78            upper_limit: Some(1000.0),
79            unit_price: Some(0.30),
80            tier_number: Some(1),
81            ..Default::default()
82        };
83
84        let tier2 = PriceTier {
85            lower_limit: Some(1000.0),
86            upper_limit: Some(5000.0),
87            unit_price: Some(0.25),
88            tier_number: Some(2),
89            ..Default::default()
90        };
91
92        assert!(tier1.unit_price.unwrap() > tier2.unit_price.unwrap());
93    }
94
95    #[test]
96    fn test_default() {
97        let tier = PriceTier::default();
98        assert!(tier.lower_limit.is_none());
99        assert!(tier.upper_limit.is_none());
100        assert!(tier.unit_price.is_none());
101    }
102
103    #[test]
104    fn test_serialize() {
105        let tier = PriceTier {
106            lower_limit: Some(0.0),
107            upper_limit: Some(1000.0),
108            unit_price: Some(0.30),
109            tier_number: Some(1),
110            ..Default::default()
111        };
112
113        let json = serde_json::to_string(&tier).unwrap();
114        assert!(json.contains(r#""lowerLimit":0"#));
115        assert!(json.contains(r#""upperLimit":1000"#));
116        assert!(json.contains(r#""unitPrice":0.3"#));
117        assert!(json.contains(r#""tierNumber":1"#));
118    }
119
120    #[test]
121    fn test_roundtrip() {
122        let tier = PriceTier {
123            lower_limit: Some(100.0),
124            upper_limit: Some(500.0),
125            unit_price: Some(0.28),
126            tier_number: Some(2),
127            article_id: Some("BDEW-123".to_string()),
128            ..Default::default()
129        };
130
131        let json = serde_json::to_string(&tier).unwrap();
132        let parsed: PriceTier = serde_json::from_str(&json).unwrap();
133        assert_eq!(tier, parsed);
134    }
135
136    #[test]
137    fn test_bo4e_object_impl() {
138        assert_eq!(PriceTier::type_name_german(), "Preisstaffel");
139        assert_eq!(PriceTier::type_name_english(), "PriceTier");
140    }
141}
bo4e_core/com/price_tier.rs

bo4e_core/com/
price_tier.rs
