bo4e_core/bo/
person.rs

1//! Person (Person) business object.
2
3use chrono::NaiveDate;
4use serde::{Deserialize, Serialize};
5
6use crate::com::{Address, ContactMethod};
7use crate::enums::{Salutation, Title};
8use crate::traits::{Bo4eMeta, Bo4eObject};
9
10/// A natural person.
11///
12/// German: Person
13///
14/// # Example
15///
16/// ```rust
17/// use bo4e_core::bo::Person;
18/// use bo4e_core::enums::Salutation;
19///
20/// let person = Person {
21///     salutation: Some(Salutation::Mr),
22///     first_name: Some("Max".to_string()),
23///     last_name: Some("Mustermann".to_string()),
24///     ..Default::default()
25/// };
26/// ```
27#[derive(Debug, Clone, Default, PartialEq, Serialize, Deserialize)]
28#[serde(rename_all = "camelCase")]
29pub struct Person {
30    /// BO4E metadata
31    #[serde(flatten)]
32    pub meta: Bo4eMeta,
33
34    /// Salutation (Anrede)
35    #[serde(skip_serializing_if = "Option::is_none")]
36    pub salutation: Option<Salutation>,
37
38    /// Title (Titel)
39    #[serde(skip_serializing_if = "Option::is_none")]
40    pub title: Option<Title>,
41
42    /// First name (Vorname)
43    #[serde(skip_serializing_if = "Option::is_none")]
44    pub first_name: Option<String>,
45
46    /// Last name (Nachname)
47    #[serde(skip_serializing_if = "Option::is_none")]
48    pub last_name: Option<String>,
49
50    /// Name suffix (Namenszusatz)
51    #[serde(skip_serializing_if = "Option::is_none")]
52    pub name_suffix: Option<String>,
53
54    /// Name prefix (Namenspraefix)
55    #[serde(skip_serializing_if = "Option::is_none")]
56    pub name_prefix: Option<String>,
57
58    /// Company name if representing a company (Firma)
59    #[serde(skip_serializing_if = "Option::is_none")]
60    pub company_name: Option<String>,
61
62    /// Birth date (Geburtsdatum)
63    #[serde(skip_serializing_if = "Option::is_none")]
64    pub birth_date: Option<NaiveDate>,
65
66    /// Primary address (Adresse)
67    #[serde(skip_serializing_if = "Option::is_none")]
68    pub address: Option<Address>,
69
70    /// Contact methods (Kontaktwege)
71    #[serde(default, skip_serializing_if = "Vec::is_empty")]
72    pub contact_methods: Vec<ContactMethod>,
73}
74
75impl Bo4eObject for Person {
76    fn type_name_german() -> &'static str {
77        "Person"
78    }
79
80    fn type_name_english() -> &'static str {
81        "Person"
82    }
83
84    fn meta(&self) -> &Bo4eMeta {
85        &self.meta
86    }
87
88    fn meta_mut(&mut self) -> &mut Bo4eMeta {
89        &mut self.meta
90    }
91}
92
93#[cfg(test)]
94mod tests {
95    use super::*;
96
97    #[test]
98    fn test_person_creation() {
99        let person = Person {
100            salutation: Some(Salutation::Mr),
101            first_name: Some("Max".to_string()),
102            last_name: Some("Mustermann".to_string()),
103            ..Default::default()
104        };
105
106        assert_eq!(person.first_name, Some("Max".to_string()));
107        assert_eq!(person.last_name, Some("Mustermann".to_string()));
108    }
109
110    #[test]
111    fn test_person_with_title() {
112        let person = Person {
113            salutation: Some(Salutation::Mr),
114            title: Some(Title::Dr),
115            first_name: Some("Hans".to_string()),
116            last_name: Some("Mueller".to_string()),
117            ..Default::default()
118        };
119
120        assert_eq!(person.title, Some(Title::Dr));
121    }
122
123    #[test]
124    fn test_serialize() {
125        let person = Person {
126            meta: Bo4eMeta::with_type("Person"),
127            salutation: Some(Salutation::Ms),
128            first_name: Some("Erika".to_string()),
129            last_name: Some("Musterfrau".to_string()),
130            ..Default::default()
131        };
132
133        let json = serde_json::to_string(&person).unwrap();
134        assert!(json.contains(r#""firstName":"Erika""#));
135        assert!(json.contains(r#""lastName":"Musterfrau""#));
136    }
137
138    #[test]
139    fn test_roundtrip() {
140        let person = Person {
141            meta: Bo4eMeta::with_type("Person"),
142            salutation: Some(Salutation::Mr),
143            title: Some(Title::ProfDr),
144            first_name: Some("Klaus".to_string()),
145            last_name: Some("Schmidt".to_string()),
146            name_suffix: Some("Jr.".to_string()),
147            company_name: Some("Schmidt GmbH".to_string()),
148            birth_date: Some(NaiveDate::from_ymd_opt(1970, 5, 15).unwrap()),
149            ..Default::default()
150        };
151
152        let json = serde_json::to_string(&person).unwrap();
153        let parsed: Person = serde_json::from_str(&json).unwrap();
154        assert_eq!(person, parsed);
155    }
156
157    #[test]
158    fn test_bo4e_object_impl() {
159        assert_eq!(Person::type_name_german(), "Person");
160        assert_eq!(Person::type_name_english(), "Person");
161    }
162}
bo4e_core/bo/person.rs

bo4e_core/bo/
person.rs
