event-service 0.5.0

Event Service - An event administration microservice that interoperates with the event-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

//! Consent management models.
//!
//! A [`Consent`] record captures permission attached to an event —
//! for example, consent to share data about a clinical encounter, or a
//! media-release consent for recording a performance. Consent has a
//! [`ConsentType`] (what it covers) and a [`ConsentStatus`]
//! (active / revoked / expired). The privacy layer consults these
//! records when honoring GDPR and data-sharing rules.

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

/// Type of consent
#[derive(Debug, Clone, Serialize, Deserialize, ToSchema, PartialEq, Eq)]
#[serde(rename_all = "lowercase")]
pub enum ConsentType {
    /// Consent for data processing
    DataProcessing,
    /// Consent for data sharing with third parties
    DataSharing,
    /// Consent for marketing communications
    Marketing,
    /// Consent for research use of data
    Research,
    /// Consent for emergency access to data
    EmergencyAccess,
}

/// Status of a consent record
#[derive(Debug, Clone, Serialize, Deserialize, ToSchema, PartialEq, Eq)]
#[serde(rename_all = "lowercase")]
pub enum ConsentStatus {
    /// Consent is active
    Active,
    /// Consent has been revoked by the event
    Revoked,
    /// Consent has expired
    Expired,
}

/// A consent record attached to an event (e.g. consent for data
/// sharing about a clinical encounter, or a media-release consent
/// for a performance recording).
#[derive(Debug, Clone, Serialize, Deserialize, ToSchema)]
pub struct Consent {
    /// Unique consent record ID
    pub id: Uuid,

    /// The event this consent applies to
    pub event_id: Uuid,

    /// Type of consent
    pub consent_type: ConsentType,

    /// Current status
    pub status: ConsentStatus,

    /// Date consent was granted
    pub granted_date: Date,

    /// Date consent expires (if applicable)
    pub expiry_date: Option<Date>,

    /// Date consent was revoked (if applicable)
    pub revoked_date: Option<Date>,

    /// Purpose description
    pub purpose: Option<String>,

    /// How consent was obtained (e.g., "written", "electronic", "verbal")
    pub method: Option<String>,

    /// When this consent record was created.
    pub created_at: Timestamp,
    /// When this consent record was last modified.
    pub updated_at: Timestamp,
}