person-service 0.5.0

Person Service - A person administration microservice that interoperates with the person-matcher crate
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
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84

//! The [`Organization`] model — a clinic, hospital, or other body.
//!
//! Organizations appear as the `managing_organization` of a person and
//! as the `assigner` of identifiers. They reuse the shared
//! [`crate::models::Address`], [`crate::models::ContactPoint`], and
//! [`crate::models::Identifier`] value objects, and can nest via
//! `part_of` to model a parent/child hierarchy.
//!
//! # Examples
//!
//! ```
//! use person_service::models::Organization;
//!
//! let org = Organization::new("General Hospital".to_string());
//! assert!(org.active);
//! assert!(org.addresses.is_empty());
//! ```

use jiff::Timestamp;
use serde::{Deserialize, Serialize};
use uuid::Uuid;
use utoipa::ToSchema;

use super::{Address, ContactPoint};

/// Organization (clinic, hospital, etc.)
#[derive(Debug, Clone, Serialize, Deserialize, ToSchema)]
pub struct Organization {
    /// Unique organization identifier
    pub id: Uuid,

    /// Organization identifiers
    pub identifiers: Vec<super::Identifier>,

    /// Active status
    pub active: bool,

    /// Organization type (Hospital, Clinic, etc.)
    pub org_type: Vec<String>,

    /// Organization name
    pub name: String,

    /// Alias names
    pub alias: Vec<String>,

    /// Telecom contacts
    pub telecom: Vec<ContactPoint>,

    /// Addresses
    pub addresses: Vec<Address>,

    /// Part of (parent organization)
    pub part_of: Option<Uuid>,

    /// Created timestamp
    pub created_at: Timestamp,

    /// Updated timestamp
    pub updated_at: Timestamp,
}

impl Organization {
    /// Create a new active organization from a name.
    ///
    /// Generates a fresh UUID, stamps timestamps, marks it `active`, and
    /// leaves every collection empty and `part_of` unset.
    pub fn new(name: String) -> Self {
        let now = Timestamp::now();
        Self {
            id: Uuid::new_v4(),
            identifiers: Vec::new(),
            active: true,
            org_type: Vec::new(),
            name,
            alias: Vec::new(),
            telecom: Vec::new(),
            addresses: Vec::new(),
            part_of: None,
            created_at: now,
            updated_at: now,
        }
    }
}