fhir 1.2.0

Fast Healthcare Interoperability Resources (FHIR) data model for Rust: the complete FHIR R5, R4, and R3 resources, datatypes, and code systems as serde-serializable types, plus a spec-driven code generator.
//! ImmunizationEvaluation
//!
//! URL: http://hl7.org/fhir/StructureDefinition/ImmunizationEvaluation
//!
//! Version: 5.0.0
//!
//! ImmunizationEvaluation Resource: Describes a comparison of an immunization event against published recommendations to determine if the administration is "valid" in relation to those recommendations.
//!
//! FHIR: <https://build.fhir.org/>
//!
//! UML: <https://build.fhir.org/uml.html>

// Allow unused crate::r5::types as types;
#![allow(unused_imports)]

use crate::r5::types;
use ::serde::{Deserialize, Serialize};
use fhir_derive_macros::Validate;

/// ImmunizationEvaluation describes a comparison of an immunization event
/// against published recommendations to determine if the administration is
/// "valid" in relation to those recommendations. It captures whether a given
/// dose counts toward a vaccine series and, if not, the reason why. This
/// resource is typically produced by clinical decision support systems that
/// assess a patient's immunization history against a schedule.
///
/// Clinically, an evaluation is generated by comparing a single recorded
/// immunization event against an authoritative vaccination schedule (such as
/// one published by a national or regional immunization advisory body) to
/// determine the dose's status, its position within a series, and whether it
/// counts toward completing that series. This supports use cases such as
/// forecasting future doses, reconciling immunization histories, and
/// generating official immunization records or certificates. Unlike a
/// recommendation for future care, an ImmunizationEvaluation is a
/// retrospective assessment of a dose that has already been administered.
///
/// Related resources: the evaluated dose is referenced from an
/// `Immunization` resource, the subject is typically a
/// [`Patient`](crate::r5::resources::patient::Patient), and coded values such
/// as the target disease and dose status use
/// [`CodeableConcept`](crate::r5::types::CodeableConcept). See also the
/// related `ImmunizationRecommendation` resource, which is forward-looking
/// rather than retrospective.
///
/// # Examples
///
/// ```
/// use fhir::r5::resources::immunization_evaluation::ImmunizationEvaluation;
///
/// let value = ImmunizationEvaluation::default();
/// let json = ::serde_json::to_value(&value).unwrap();
/// let back: ImmunizationEvaluation = ::serde_json::from_value(json).unwrap();
/// assert_eq!(value, back);
/// ```
#[serde_with::skip_serializing_none]
#[derive(Debug, Default, Clone, Serialize, Deserialize, PartialEq, Eq, Validate)]
#[serde(rename_all = "camelCase")]
pub struct ImmunizationEvaluation {
    /// Logical id of this artifact
    pub id: Option<types::String>,

    /// Metadata about the resource
    pub meta: Option<types::Meta>,

    /// A set of rules under which this content was created
    pub implicit_rules: Option<types::Uri>,
    /// Primitive extension sibling for [`implicit_rules`](Self::implicit_rules) (FHIR `_implicitRules`).
    #[serde(rename = "_implicitRules")]
    pub implicit_rules_ext: Option<types::Element>,

    /// Language of the resource content
    pub language: Option<types::Code>,
    /// Primitive extension sibling for [`language`](Self::language) (FHIR `_language`).
    #[serde(rename = "_language")]
    pub language_ext: Option<types::Element>,

    /// Text summary of the resource, for human interpretation
    pub text: Option<types::Narrative>,

    /// Contained, inline Resources
    #[serde(default, skip_serializing_if = "Vec::is_empty")]
    pub contained: Vec<::serde_json::Value>,

    /// Additional content defined by implementations
    #[serde(default, skip_serializing_if = "Vec::is_empty")]
    pub extension: Vec<types::Extension>,

    /// Extensions that cannot be ignored
    #[serde(default, skip_serializing_if = "Vec::is_empty")]
    pub modifier_extension: Vec<types::Extension>,

    /// Business identifier
    #[serde(default, skip_serializing_if = "Vec::is_empty")]
    pub identifier: Vec<types::Identifier>,

    /// The workflow status of this evaluation, either completed or entered-in-error.
    pub status: types::Code,
    /// Primitive extension sibling for [`status`](Self::status) (FHIR `_status`).
    #[serde(rename = "_status")]
    pub status_ext: Option<types::Element>,

    /// Reference to the [`Patient`](crate::r5::resources::patient::Patient) whose immunization history is being evaluated.
    pub patient: types::Reference,

    /// Date evaluation was performed
    pub date: Option<types::DateTime>,
    /// Primitive extension sibling for [`date`](Self::date) (FHIR `_date`).
    #[serde(rename = "_date")]
    pub date_ext: Option<types::Element>,

    /// Reference to the organization or body responsible for publishing the recommendations used in this evaluation.
    pub authority: Option<types::Reference>,

    /// The vaccine-preventable disease whose recommendation schedule this evaluation was assessed against.
    pub target_disease: types::CodeableConcept,

    /// Reference to the specific `Immunization` event being evaluated.
    pub immunization_event: types::Reference,

    /// Whether the dose counts as valid, invalid, or another status relative to the published recommendations.
    pub dose_status: types::CodeableConcept,

    /// Reason why the doese is considered valid, invalid or some other status
    #[serde(default, skip_serializing_if = "Vec::is_empty")]
    pub dose_status_reason: Vec<types::CodeableConcept>,

    /// Evaluation notes
    pub description: Option<types::Markdown>,
    /// Primitive extension sibling for [`description`](Self::description) (FHIR `_description`).
    #[serde(rename = "_description")]
    pub description_ext: Option<types::Element>,

    /// Name of vaccine series
    pub series: Option<types::String>,
    /// Primitive extension sibling for [`series`](Self::series) (FHIR `_series`).
    #[serde(rename = "_series")]
    pub series_ext: Option<types::Element>,

    /// Dose number within series
    pub dose_number: Option<types::String>,
    /// Primitive extension sibling for [`dose_number`](Self::dose_number) (FHIR `_doseNumber`).
    #[serde(rename = "_doseNumber")]
    pub dose_number_ext: Option<types::Element>,

    /// Recommended number of doses for immunity
    pub series_doses: Option<types::String>,
    /// Primitive extension sibling for [`series_doses`](Self::series_doses) (FHIR `_seriesDoses`).
    #[serde(rename = "_seriesDoses")]
    pub series_doses_ext: Option<types::Element>,
}

#[cfg(test)]
mod tests {
    use super::*;
    type T = ImmunizationEvaluation;

    #[test]
    fn test_default() {
        let _ = T::default();
    }

    #[test]
    fn test_serde_round_trip() {
        let value = T::default();
        let json = ::serde_json::to_value(&value).expect("to_value");
        let back: T = ::serde_json::from_value(json).expect("from_value");
        assert_eq!(value, back);
    }
}