openehr-its 0.0.2

// @generated by openehr-codegen (emit-rest) — DO NOT EDIT.
//! ITS-REST contract for the `definition` API group: DTOs, per-operation
//! param structs, the `DefinitionApi` server trait, and the route table.

#![allow(
    clippy::all,
    clippy::pedantic,
    clippy::nursery,
    dead_code,
    unused_variables,
    reason = "mechanically generated contract text: the OAS is emitted in full (every DTO, param struct and route, whether or not this workspace consumes it yet), so style and dead-code lints do not apply — the hand-written runtime and the implementing adapter carry the lint bar"
)]
#![expect(
    clippy::disallowed_types,
    reason = "adjudicated free-form JSON slots: serde_json::Value is workspace-banned (#1694); a generated carrier exists only where the spec leaves the slot open, and each adjudicated field's NOTE names its citation"
)]
use serde::{Deserialize, Serialize};

/// The `TemplateMetadata` transport DTO of this API group (an ITS-REST OAS
/// component schema).
#[derive(Debug, Clone, Serialize, Deserialize)]
pub struct TemplateMetadata {
    /// The `template_id` property of `TemplateMetadata`.
    pub template_id: String,
    /// The `version` property of `TemplateMetadata`.
    #[serde(skip_serializing_if = "Option::is_none")]
    pub version: Option<String>,
    /// The `concept` property of `TemplateMetadata`.
    pub concept: String,
    /// The `archetype_id` property of `TemplateMetadata`.
    pub archetype_id: String,
    /// The `created_timestamp` property of `TemplateMetadata`.
    pub created_timestamp: String,
}

/// The `TemplateList` ITS-REST OAS component schema (a non-object shape, so
/// it is an alias rather than a struct).
pub type TemplateList = Vec<TemplateMetadata>;

/// The `OperationalTemplate` ITS-REST OAS component schema (a non-object shape, so
/// it is an alias rather than a struct).
pub type OperationalTemplate = std::collections::BTreeMap<String, serde_json::Value>;

/// The `LocalizedNames` transport DTO of this API group (an ITS-REST OAS
/// component schema).
#[derive(Debug, Clone, Serialize, Deserialize)]
pub struct LocalizedNames {
    /// The `en` property of `LocalizedNames`.
    pub en: String,
}

/// The `LocalizedDescriptions` transport DTO of this API group (an ITS-REST OAS
/// component schema).
#[derive(Debug, Clone, Serialize, Deserialize)]
pub struct LocalizedDescriptions {
    /// The `sl` property of `LocalizedDescriptions`.
    pub sl: String,
}

/// The `LocalizedNames1` transport DTO of this API group (an ITS-REST OAS
/// component schema).
#[derive(Debug, Clone, Serialize, Deserialize)]
pub struct LocalizedNames1 {
    /// The `sl` property of `LocalizedNames1`.
    pub sl: String,
}

/// The `LocalizedNames2` transport DTO of this API group (an ITS-REST OAS
/// component schema).
#[derive(Debug, Clone, Serialize, Deserialize)]
pub struct LocalizedNames2 {
    /// The `sl` property of `LocalizedNames2`.
    pub sl: String,
    /// The `en` property of `LocalizedNames2`.
    #[serde(skip_serializing_if = "Option::is_none")]
    pub en: Option<String>,
}

/// The `Annotations` transport DTO of this API group (an ITS-REST OAS
/// component schema).
#[derive(Debug, Clone, Serialize, Deserialize)]
pub struct Annotations {
    /// The `comment` property of `Annotations`.
    #[serde(skip_serializing_if = "Option::is_none")]
    pub comment: Option<String>,
    /// The `default` property of `Annotations`.
    #[serde(skip_serializing_if = "Option::is_none")]
    pub default: Option<String>,
}

/// The `Precision` transport DTO of this API group (an ITS-REST OAS
/// component schema).
#[derive(Debug, Clone, Serialize, Deserialize)]
pub struct Precision {
    /// The `minOp` property of `Precision`.
    #[serde(rename = "minOp")]
    pub min_op: String,
    /// The `min` property of `Precision`.
    pub min: i64,
    /// The `maxOp` property of `Precision`.
    #[serde(rename = "maxOp")]
    pub max_op: String,
    /// The `max` property of `Precision`.
    pub max: i64,
}

/// The `Range` transport DTO of this API group (an ITS-REST OAS
/// component schema).
#[derive(Debug, Clone, Serialize, Deserialize)]
pub struct Range {
    /// The `minOp` property of `Range`.
    #[serde(rename = "minOp")]
    pub min_op: String,
    /// The `min` property of `Range`.
    pub min: i64,
    /// The `maxOp` property of `Range`.
    #[serde(rename = "maxOp")]
    #[serde(skip_serializing_if = "Option::is_none")]
    pub max_op: Option<String>,
    /// The `max` property of `Range`.
    #[serde(skip_serializing_if = "Option::is_none")]
    pub max: Option<i64>,
}

/// The `Validation` transport DTO of this API group (an ITS-REST OAS
/// component schema).
#[derive(Debug, Clone, Serialize, Deserialize)]
pub struct Validation {
    /// The `precision` property of `Validation`.
    #[serde(skip_serializing_if = "Option::is_none")]
    pub precision: Option<Precision>,
    /// The `range` property of `Validation`.
    #[serde(skip_serializing_if = "Option::is_none")]
    pub range: Option<Range>,
}

/// The `LocalizedLabels` transport DTO of this API group (an ITS-REST OAS
/// component schema).
#[derive(Debug, Clone, Serialize, Deserialize)]
pub struct LocalizedLabels {
    /// The `sl` property of `LocalizedLabels`.
    pub sl: String,
}

/// The `List` transport DTO of this API group (an ITS-REST OAS
/// component schema).
#[derive(Debug, Clone, Serialize, Deserialize)]
pub struct List {
    /// The `value` property of `List`.
    pub value: String,
    /// The `label` property of `List`.
    pub label: String,
    /// The `validation` property of `List`.
    #[serde(skip_serializing_if = "Option::is_none")]
    pub validation: Option<Validation>,
    /// The `localizedLabels` property of `List`.
    #[serde(rename = "localizedLabels")]
    #[serde(skip_serializing_if = "Option::is_none")]
    pub localized_labels: Option<LocalizedLabels>,
    /// The `localizedDescriptions` property of `List`.
    #[serde(rename = "localizedDescriptions")]
    #[serde(skip_serializing_if = "Option::is_none")]
    pub localized_descriptions: Option<LocalizedDescriptions>,
}

/// The `Validation1` transport DTO of this API group (an ITS-REST OAS
/// component schema).
#[derive(Debug, Clone, Serialize, Deserialize)]
pub struct Validation1 {
    /// The `range` property of `Validation1`.
    pub range: Range,
    /// The `precision` property of `Validation1`.
    #[serde(skip_serializing_if = "Option::is_none")]
    pub precision: Option<Precision>,
}

/// The `Input` transport DTO of this API group (an ITS-REST OAS
/// component schema).
#[derive(Debug, Clone, Serialize, Deserialize)]
pub struct Input {
    /// The `type` property of `Input`.
    pub r#type: String,
    /// The `suffix` property of `Input`.
    #[serde(skip_serializing_if = "Option::is_none")]
    pub suffix: Option<String>,
    /// The `list` property of `Input`.
    #[serde(skip_serializing_if = "Option::is_none")]
    pub list: Option<Vec<List>>,
    /// The `defaultValue` property of `Input`.
    #[serde(rename = "defaultValue")]
    #[serde(skip_serializing_if = "Option::is_none")]
    pub default_value: Option<String>,
    /// The `validation` property of `Input`.
    #[serde(skip_serializing_if = "Option::is_none")]
    pub validation: Option<Validation1>,
}

/// The `SNOMEDCT` transport DTO of this API group (an ITS-REST OAS
/// component schema).
#[derive(Debug, Clone, Serialize, Deserialize)]
pub struct Snomedct {
    /// The `value` property of `SNOMEDCT`.
    pub value: String,
    /// The `terminologyId` property of `SNOMEDCT`.
    #[serde(rename = "terminologyId")]
    pub terminology_id: String,
}

/// The `TermBindings` transport DTO of this API group (an ITS-REST OAS
/// component schema).
#[derive(Debug, Clone, Serialize, Deserialize)]
pub struct TermBindings {
    /// The `SNOMED-CT` property of `TermBindings`.
    #[serde(rename = "SNOMED-CT")]
    pub snomed_ct: Snomedct,
}

/// The `Input1` transport DTO of this API group (an ITS-REST OAS
/// component schema).
#[derive(Debug, Clone, Serialize, Deserialize)]
pub struct Input1 {
    /// The `type` property of `Input1`.
    pub r#type: String,
    /// The `suffix` property of `Input1`.
    #[serde(skip_serializing_if = "Option::is_none")]
    pub suffix: Option<String>,
}

/// The `Child3` transport DTO of this API group (an ITS-REST OAS
/// component schema).
#[derive(Debug, Clone, Serialize, Deserialize)]
pub struct Child3 {
    /// The `id` property of `Child3`.
    pub id: String,
    /// The `localizedName` property of `Child3`.
    #[serde(rename = "localizedName")]
    pub localized_name: String,
    /// The `rmType` property of `Child3`.
    #[serde(rename = "rmType")]
    pub rm_type: String,
    /// The `nodeId` property of `Child3`.
    #[serde(rename = "nodeId")]
    pub node_id: String,
    /// The `min` property of `Child3`.
    pub min: i64,
    /// The `max` property of `Child3`.
    pub max: i64,
    /// The `localizedNames` property of `Child3`.
    #[serde(rename = "localizedNames")]
    pub localized_names: LocalizedNames1,
    /// The `localizedDescriptions` property of `Child3`.
    #[serde(rename = "localizedDescriptions")]
    pub localized_descriptions: LocalizedDescriptions,
    /// The `aqlPath` property of `Child3`.
    #[serde(rename = "aqlPath")]
    pub aql_path: String,
    /// The `inputs` property of `Child3`.
    pub inputs: Vec<Input1>,
    /// The `name` property of `Child3`.
    #[serde(skip_serializing_if = "Option::is_none")]
    pub name: Option<String>,
}

/// The `Child2` transport DTO of this API group (an ITS-REST OAS
/// component schema).
#[derive(Debug, Clone, Serialize, Deserialize)]
pub struct Child2 {
    /// The `id` property of `Child2`.
    pub id: String,
    /// The `name` property of `Child2`.
    pub name: String,
    /// The `localizedName` property of `Child2`.
    #[serde(rename = "localizedName")]
    pub localized_name: String,
    /// The `rmType` property of `Child2`.
    #[serde(rename = "rmType")]
    pub rm_type: String,
    /// The `nodeId` property of `Child2`.
    #[serde(rename = "nodeId")]
    pub node_id: String,
    /// The `min` property of `Child2`.
    pub min: i64,
    /// The `max` property of `Child2`.
    pub max: i64,
    /// The `localizedNames` property of `Child2`.
    #[serde(rename = "localizedNames")]
    pub localized_names: LocalizedNames2,
    /// The `localizedDescriptions` property of `Child2`.
    #[serde(rename = "localizedDescriptions")]
    pub localized_descriptions: LocalizedDescriptions,
    /// The `annotations` property of `Child2`.
    #[serde(skip_serializing_if = "Option::is_none")]
    pub annotations: Option<Annotations>,
    /// The `aqlPath` property of `Child2`.
    #[serde(rename = "aqlPath")]
    pub aql_path: String,
    /// The `inputs` property of `Child2`.
    pub inputs: Vec<Input>,
    /// The `dependsOn` property of `Child2`.
    #[serde(rename = "dependsOn")]
    #[serde(skip_serializing_if = "Option::is_none")]
    pub depends_on: Option<Vec<String>>,
    /// The `inContext` property of `Child2`.
    #[serde(rename = "inContext")]
    #[serde(skip_serializing_if = "Option::is_none")]
    pub in_context: Option<bool>,
    /// The `termBindings` property of `Child2`.
    #[serde(rename = "termBindings")]
    #[serde(skip_serializing_if = "Option::is_none")]
    pub term_bindings: Option<TermBindings>,
    /// The `children` property of `Child2`.
    #[serde(skip_serializing_if = "Option::is_none")]
    pub children: Option<Vec<Child3>>,
}

/// The `List1` transport DTO of this API group (an ITS-REST OAS
/// component schema).
#[derive(Debug, Clone, Serialize, Deserialize)]
pub struct List1 {
    /// The `value` property of `List1`.
    pub value: String,
    /// The `label` property of `List1`.
    pub label: String,
    /// The `localizedLabels` property of `List1`.
    #[serde(rename = "localizedLabels")]
    pub localized_labels: LocalizedLabels,
    /// The `localizedDescriptions` property of `List1`.
    #[serde(rename = "localizedDescriptions")]
    pub localized_descriptions: LocalizedDescriptions,
}

/// The `Input2` transport DTO of this API group (an ITS-REST OAS
/// component schema).
#[derive(Debug, Clone, Serialize, Deserialize)]
pub struct Input2 {
    /// The `type` property of `Input2`.
    pub r#type: String,
    /// The `suffix` property of `Input2`.
    #[serde(skip_serializing_if = "Option::is_none")]
    pub suffix: Option<String>,
    /// The `list` property of `Input2`.
    #[serde(skip_serializing_if = "Option::is_none")]
    pub list: Option<Vec<List1>>,
}

/// The `Annotations1` transport DTO of this API group (an ITS-REST OAS
/// component schema).
#[derive(Debug, Clone, Serialize, Deserialize)]
pub struct Annotations1 {
    /// The `comment` property of `Annotations1`.
    #[serde(skip_serializing_if = "Option::is_none")]
    pub comment: Option<String>,
    /// The `view:pass_through` property of `Annotations1`.
    #[serde(rename = "view:pass_through")]
    #[serde(skip_serializing_if = "Option::is_none")]
    pub view_pass_through: Option<String>,
}

/// The `Child1` transport DTO of this API group (an ITS-REST OAS
/// component schema).
#[derive(Debug, Clone, Serialize, Deserialize)]
pub struct Child1 {
    /// The `id` property of `Child1`.
    pub id: String,
    /// The `name` property of `Child1`.
    pub name: String,
    /// The `localizedName` property of `Child1`.
    #[serde(rename = "localizedName")]
    #[serde(skip_serializing_if = "Option::is_none")]
    pub localized_name: Option<String>,
    /// The `rmType` property of `Child1`.
    #[serde(rename = "rmType")]
    pub rm_type: String,
    /// The `nodeId` property of `Child1`.
    #[serde(rename = "nodeId")]
    #[serde(skip_serializing_if = "Option::is_none")]
    pub node_id: Option<String>,
    /// The `min` property of `Child1`.
    pub min: i64,
    /// The `max` property of `Child1`.
    pub max: i64,
    /// The `localizedNames` property of `Child1`.
    #[serde(rename = "localizedNames")]
    #[serde(skip_serializing_if = "Option::is_none")]
    pub localized_names: Option<LocalizedNames1>,
    /// The `localizedDescriptions` property of `Child1`.
    #[serde(rename = "localizedDescriptions")]
    #[serde(skip_serializing_if = "Option::is_none")]
    pub localized_descriptions: Option<LocalizedDescriptions>,
    /// The `aqlPath` property of `Child1`.
    #[serde(rename = "aqlPath")]
    pub aql_path: String,
    /// The `children` property of `Child1`.
    #[serde(skip_serializing_if = "Option::is_none")]
    pub children: Option<Vec<Child2>>,
    /// The `inputs` property of `Child1`.
    #[serde(skip_serializing_if = "Option::is_none")]
    pub inputs: Option<Vec<Input2>>,
    /// The `inContext` property of `Child1`.
    #[serde(rename = "inContext")]
    #[serde(skip_serializing_if = "Option::is_none")]
    pub in_context: Option<bool>,
    /// The `dependsOn` property of `Child1`.
    #[serde(rename = "dependsOn")]
    #[serde(skip_serializing_if = "Option::is_none")]
    pub depends_on: Option<Vec<String>>,
    /// The `annotations` property of `Child1`.
    #[serde(skip_serializing_if = "Option::is_none")]
    pub annotations: Option<Annotations1>,
    /// The `termBindings` property of `Child1`.
    #[serde(rename = "termBindings")]
    #[serde(skip_serializing_if = "Option::is_none")]
    pub term_bindings: Option<TermBindings>,
    /// The `proportionTypes` property of `Child1`.
    #[serde(rename = "proportionTypes")]
    #[serde(skip_serializing_if = "Option::is_none")]
    pub proportion_types: Option<Vec<String>>,
}

/// The `List2` transport DTO of this API group (an ITS-REST OAS
/// component schema).
#[derive(Debug, Clone, Serialize, Deserialize)]
pub struct List2 {
    /// The `value` property of `List2`.
    pub value: String,
    /// The `label` property of `List2`.
    pub label: String,
    /// The `localizedLabels` property of `List2`.
    #[serde(rename = "localizedLabels")]
    pub localized_labels: LocalizedLabels,
}

/// The `Input3` transport DTO of this API group (an ITS-REST OAS
/// component schema).
#[derive(Debug, Clone, Serialize, Deserialize)]
pub struct Input3 {
    /// The `suffix` property of `Input3`.
    pub suffix: String,
    /// The `type` property of `Input3`.
    pub r#type: String,
    /// The `list` property of `Input3`.
    #[serde(skip_serializing_if = "Option::is_none")]
    pub list: Option<Vec<List2>>,
    /// The `terminology` property of `Input3`.
    #[serde(skip_serializing_if = "Option::is_none")]
    pub terminology: Option<String>,
}

/// The `Child` transport DTO of this API group (an ITS-REST OAS
/// component schema).
#[derive(Debug, Clone, Serialize, Deserialize)]
pub struct Child {
    /// The `id` property of `Child`.
    pub id: String,
    /// The `rmType` property of `Child`.
    #[serde(rename = "rmType")]
    pub rm_type: String,
    /// The `nodeId` property of `Child`.
    #[serde(rename = "nodeId")]
    #[serde(skip_serializing_if = "Option::is_none")]
    pub node_id: Option<String>,
    /// The `min` property of `Child`.
    pub min: i64,
    /// The `max` property of `Child`.
    pub max: i64,
    /// The `aqlPath` property of `Child`.
    #[serde(rename = "aqlPath")]
    pub aql_path: String,
    /// The `children` property of `Child`.
    #[serde(skip_serializing_if = "Option::is_none")]
    pub children: Option<Vec<Child1>>,
    /// The `name` property of `Child`.
    #[serde(skip_serializing_if = "Option::is_none")]
    pub name: Option<String>,
    /// The `localizedName` property of `Child`.
    #[serde(rename = "localizedName")]
    #[serde(skip_serializing_if = "Option::is_none")]
    pub localized_name: Option<String>,
    /// The `localizedNames` property of `Child`.
    #[serde(rename = "localizedNames")]
    #[serde(skip_serializing_if = "Option::is_none")]
    pub localized_names: Option<LocalizedNames1>,
    /// The `localizedDescriptions` property of `Child`.
    #[serde(rename = "localizedDescriptions")]
    #[serde(skip_serializing_if = "Option::is_none")]
    pub localized_descriptions: Option<LocalizedDescriptions>,
    /// The `termBindings` property of `Child`.
    #[serde(rename = "termBindings")]
    #[serde(skip_serializing_if = "Option::is_none")]
    pub term_bindings: Option<TermBindings>,
    /// The `inputs` property of `Child`.
    #[serde(skip_serializing_if = "Option::is_none")]
    pub inputs: Option<Vec<Input3>>,
    /// The `inContext` property of `Child`.
    #[serde(rename = "inContext")]
    #[serde(skip_serializing_if = "Option::is_none")]
    pub in_context: Option<bool>,
}

/// The `Tree` transport DTO of this API group (an ITS-REST OAS
/// component schema).
#[derive(Debug, Clone, Serialize, Deserialize)]
pub struct Tree {
    /// The `id` property of `Tree`.
    pub id: String,
    /// The `name` property of `Tree`.
    pub name: String,
    /// The `localizedName` property of `Tree`.
    #[serde(rename = "localizedName")]
    pub localized_name: String,
    /// The `rmType` property of `Tree`.
    #[serde(rename = "rmType")]
    pub rm_type: String,
    /// The `nodeId` property of `Tree`.
    #[serde(rename = "nodeId")]
    pub node_id: String,
    /// The `min` property of `Tree`.
    pub min: i64,
    /// The `max` property of `Tree`.
    pub max: i64,
    /// The `localizedNames` property of `Tree`.
    #[serde(rename = "localizedNames")]
    pub localized_names: LocalizedNames,
    /// The `localizedDescriptions` property of `Tree`.
    #[serde(rename = "localizedDescriptions")]
    pub localized_descriptions: LocalizedDescriptions,
    /// The `aqlPath` property of `Tree`.
    #[serde(rename = "aqlPath")]
    pub aql_path: String,
    /// The `children` property of `Tree`.
    pub children: Vec<Child>,
}

/// The `WebTemplate` transport DTO of this API group (an ITS-REST OAS
/// component schema).
#[derive(Debug, Clone, Serialize, Deserialize)]
pub struct WebTemplate {
    /// The `templateId` property of `WebTemplate`.
    #[serde(rename = "templateId")]
    pub template_id: String,
    /// The `version` property of `WebTemplate`.
    pub version: String,
    /// The `defaultLanguage` property of `WebTemplate`.
    #[serde(rename = "defaultLanguage")]
    pub default_language: String,
    /// The `languages` property of `WebTemplate`.
    pub languages: Vec<String>,
    /// The `tree` property of `WebTemplate`.
    pub tree: Tree,
}

/// The `TemplateIdentifier` transport DTO of this API group (an ITS-REST OAS
/// component schema).
#[derive(Debug, Clone, Serialize, Deserialize)]
pub struct TemplateIdentifier {
    /// The `template_id` property of `TemplateIdentifier`.
    pub template_id: String,
}

/// The `Versionable` ITS-REST OAS component schema: `_type`-discriminated
/// polymorphism over its OAS `discriminator.mapping` targets.
#[derive(Debug, Clone)]
pub enum Versionable {
    /// `_type: "ACTOR"`
    Actor(openehr_rm::prelude::Actor),
    /// `_type: "AGENT"`
    Agent(openehr_rm::prelude::Agent),
    /// `_type: "COMPOSITION"`
    Composition(openehr_rm::prelude::Composition),
    /// `_type: "EHR_STATUS"`
    EhrStatus(openehr_rm::prelude::EhrStatus),
    /// `_type: "FOLDER"`
    Folder(openehr_rm::prelude::Folder),
    /// `_type: "GROUP"`
    Group(openehr_rm::prelude::Group),
    /// `_type: "ORGANISATION"`
    Organisation(openehr_rm::prelude::Organisation),
    /// `_type: "PARTY"`
    Party(openehr_rm::prelude::Party),
    /// `_type: "PERSON"`
    Person(openehr_rm::prelude::Person),
    /// `_type: "ROLE"`
    Role(openehr_rm::prelude::Role),
}

impl ::serde::Serialize for Versionable {
    fn serialize<__S: ::serde::Serializer>(
        &self,
        __serializer: __S,
    ) -> ::core::result::Result<__S::Ok, __S::Error> {
        match self {
            Self::Actor(__x) => ::serde::Serialize::serialize(__x, __serializer),
            Self::Agent(__x) => ::serde::Serialize::serialize(__x, __serializer),
            Self::Composition(__x) => ::serde::Serialize::serialize(__x, __serializer),
            Self::EhrStatus(__x) => ::serde::Serialize::serialize(__x, __serializer),
            Self::Folder(__x) => ::serde::Serialize::serialize(__x, __serializer),
            Self::Group(__x) => ::serde::Serialize::serialize(__x, __serializer),
            Self::Organisation(__x) => ::serde::Serialize::serialize(__x, __serializer),
            Self::Party(__x) => ::serde::Serialize::serialize(__x, __serializer),
            Self::Person(__x) => ::serde::Serialize::serialize(__x, __serializer),
            Self::Role(__x) => ::serde::Serialize::serialize(__x, __serializer),
        }
    }
}

impl<'de> ::serde::Deserialize<'de> for Versionable {
    fn deserialize<__D: ::serde::Deserializer<'de>>(
        __deserializer: __D,
    ) -> ::core::result::Result<Self, __D::Error> {
        const __TAGS: &[&str] = &[
            "ACTOR",
            "AGENT",
            "COMPOSITION",
            "EHR_STATUS",
            "FOLDER",
            "GROUP",
            "ORGANISATION",
            "PARTY",
            "PERSON",
            "ROLE",
        ];
        struct __Visitor;
        impl<'de> ::serde::de::Visitor<'de> for __Visitor {
            type Value = Versionable;
            fn expecting(&self, __f: &mut ::core::fmt::Formatter<'_>) -> ::core::fmt::Result {
                __f.write_str("an ITS-REST `Versionable` object")
            }
            fn visit_map<__A: ::serde::de::MapAccess<'de>>(
                self,
                mut __map: __A,
            ) -> ::core::result::Result<Self::Value, __A::Error> {
                let (__tag, __buffered) =
                    ::openehr_base::serde_support::read_slot_tag(&mut __map, __TAGS)?;
                match __tag {
                    Some(::openehr_base::serde_support::TagMatch::Known(__t)) => {
                        let __rest = ::openehr_base::serde_support::TaggedRest::new(
                            Some(__t),
                            __buffered,
                            __map,
                        );
                        match __t {
                            "ACTOR" => ::core::result::Result::Ok(Versionable::Actor(
                                ::serde::Deserialize::deserialize(__rest)?,
                            )),
                            "AGENT" => ::core::result::Result::Ok(Versionable::Agent(
                                ::serde::Deserialize::deserialize(__rest)?,
                            )),
                            "COMPOSITION" => ::core::result::Result::Ok(Versionable::Composition(
                                ::serde::Deserialize::deserialize(__rest)?,
                            )),
                            "EHR_STATUS" => ::core::result::Result::Ok(Versionable::EhrStatus(
                                ::serde::Deserialize::deserialize(__rest)?,
                            )),
                            "FOLDER" => ::core::result::Result::Ok(Versionable::Folder(
                                ::serde::Deserialize::deserialize(__rest)?,
                            )),
                            "GROUP" => ::core::result::Result::Ok(Versionable::Group(
                                ::serde::Deserialize::deserialize(__rest)?,
                            )),
                            "ORGANISATION" => {
                                ::core::result::Result::Ok(Versionable::Organisation(
                                    ::serde::Deserialize::deserialize(__rest)?,
                                ))
                            }
                            "PARTY" => ::core::result::Result::Ok(Versionable::Party(
                                ::serde::Deserialize::deserialize(__rest)?,
                            )),
                            "PERSON" => ::core::result::Result::Ok(Versionable::Person(
                                ::serde::Deserialize::deserialize(__rest)?,
                            )),
                            "ROLE" => ::core::result::Result::Ok(Versionable::Role(
                                ::serde::Deserialize::deserialize(__rest)?,
                            )),
                            __other => ::core::result::Result::Err(
                                ::openehr_base::serde_support::unexpected_type(
                                    "Versionable",
                                    __other,
                                    "ACTOR, AGENT, COMPOSITION, EHR_STATUS, FOLDER, GROUP, ORGANISATION, PARTY, PERSON, ROLE",
                                ),
                            ),
                        }
                    }
                    Some(::openehr_base::serde_support::TagMatch::Unknown(__other)) => {
                        ::core::result::Result::Err(::openehr_base::serde_support::unexpected_type(
                            "Versionable",
                            &__other,
                            "ACTOR, AGENT, COMPOSITION, EHR_STATUS, FOLDER, GROUP, ORGANISATION, PARTY, PERSON, ROLE",
                        ))
                    }
                    None => {
                        ::core::result::Result::Err(::openehr_base::serde_support::missing_type(
                            "Versionable",
                            "ACTOR, AGENT, COMPOSITION, EHR_STATUS, FOLDER, GROUP, ORGANISATION, PARTY, PERSON, ROLE",
                        ))
                    }
                }
            }
        }
        ::serde::Deserializer::deserialize_map(__deserializer, __Visitor)
    }
}

/// The `OperationalTemplateV2` ITS-REST OAS component schema (a non-object shape, so
/// it is an alias rather than a struct).
pub type OperationalTemplateV2 = std::collections::BTreeMap<String, serde_json::Value>;

/// The `QueryType` ITS-REST OAS component schema (a non-object shape, so
/// it is an alias rather than a struct).
pub type QueryType = String;

/// The `QueryVersion` ITS-REST OAS component schema (a non-object shape, so
/// it is an alias rather than a struct).
pub type QueryVersion = String;

/// The `StoredQuery` transport DTO of this API group (an ITS-REST OAS
/// component schema).
#[derive(Debug, Clone, Serialize, Deserialize)]
pub struct StoredQuery {
    /// The `name` property of `StoredQuery`.
    pub name: super::common::QueryName,
    /// The `type` property of `StoredQuery`.
    pub r#type: QueryType,
    /// The `version` property of `StoredQuery`.
    pub version: QueryVersion,
    /// The `saved` property of `StoredQuery`.
    pub saved: String,
    /// The `q` property of `StoredQuery`.
    pub q: super::common::Aql,
}

/// The `QueryList` ITS-REST OAS component schema (a non-object shape, so
/// it is an alias rather than a struct).
pub type QueryList = Vec<StoredQuery>;

/// Parameters for `definition_template_adl1.4_list` (path/query/header).
#[derive(Debug, Clone, Serialize, Deserialize)]
pub struct DefinitionTemplateAdl14ListParams {
    #[serde(rename = "Accept")]
    #[serde(skip_serializing_if = "Option::is_none")]
    /// `Accept` (header)
    pub accept: Option<String>,
    #[serde(skip_serializing_if = "Option::is_none")]
    /// `template_id` (query)
    pub template_id: Option<String>,
    #[serde(skip_serializing_if = "Option::is_none")]
    /// `concept` (query)
    pub concept: Option<String>,
    #[serde(skip_serializing_if = "Option::is_none")]
    /// `version` (query)
    pub version: Option<String>,
    #[serde(skip_serializing_if = "Option::is_none")]
    /// `offset` (query)
    pub offset: Option<i64>,
    #[serde(skip_serializing_if = "Option::is_none")]
    /// `fetch` (query)
    pub fetch: Option<i64>,
}

/// Parameters for `definition_template_adl1.4_upload` (path/query/header).
#[derive(Debug, Clone, Serialize, Deserialize)]
pub struct DefinitionTemplateAdl14UploadParams {
    #[serde(rename = "Prefer")]
    #[serde(skip_serializing_if = "Option::is_none")]
    /// `Prefer` (header)
    pub prefer: Option<String>,
    #[serde(rename = "Accept")]
    #[serde(skip_serializing_if = "Option::is_none")]
    /// `Accept` (header)
    pub accept: Option<String>,
    #[serde(rename = "Content-Type")]
    #[serde(skip_serializing_if = "Option::is_none")]
    /// `Content-Type` (header)
    pub content_type: Option<String>,
}

/// Parameters for `definition_template_adl1.4_get` (path/query/header).
#[derive(Debug, Clone, Serialize, Deserialize)]
pub struct DefinitionTemplateAdl14GetParams {
    /// `template_id` (path)
    pub template_id: String,
    #[serde(rename = "Accept")]
    #[serde(skip_serializing_if = "Option::is_none")]
    /// `Accept` (header)
    pub accept: Option<String>,
}

/// Parameters for `definition_template_adl1.4_example_get` (path/query/header).
#[derive(Debug, Clone, Serialize, Deserialize)]
pub struct DefinitionTemplateAdl14ExampleGetParams {
    /// `template_id` (path)
    pub template_id: String,
    #[serde(skip_serializing_if = "Option::is_none")]
    /// `type` (query)
    pub r#type: Option<String>,
    #[serde(skip_serializing_if = "Option::is_none")]
    /// `detail_level` (query)
    pub detail_level: Option<String>,
    #[serde(rename = "Accept")]
    #[serde(skip_serializing_if = "Option::is_none")]
    /// `Accept` (header)
    pub accept: Option<String>,
}

/// Parameters for `definition_template_adl2_list` (path/query/header).
#[derive(Debug, Clone, Serialize, Deserialize)]
pub struct DefinitionTemplateAdl2ListParams {
    #[serde(rename = "Accept")]
    #[serde(skip_serializing_if = "Option::is_none")]
    /// `Accept` (header)
    pub accept: Option<String>,
    #[serde(skip_serializing_if = "Option::is_none")]
    /// `template_id` (query)
    pub template_id: Option<String>,
    #[serde(skip_serializing_if = "Option::is_none")]
    /// `concept` (query)
    pub concept: Option<String>,
    #[serde(skip_serializing_if = "Option::is_none")]
    /// `version` (query)
    pub version: Option<String>,
    #[serde(skip_serializing_if = "Option::is_none")]
    /// `offset` (query)
    pub offset: Option<i64>,
    #[serde(skip_serializing_if = "Option::is_none")]
    /// `fetch` (query)
    pub fetch: Option<i64>,
}

/// Parameters for `definition_template_adl2_upload` (path/query/header).
#[derive(Debug, Clone, Serialize, Deserialize)]
pub struct DefinitionTemplateAdl2UploadParams {
    #[serde(skip_serializing_if = "Option::is_none")]
    /// `version` (query)
    pub version: Option<String>,
    #[serde(rename = "Prefer")]
    #[serde(skip_serializing_if = "Option::is_none")]
    /// `Prefer` (header)
    pub prefer: Option<String>,
    #[serde(rename = "Accept")]
    #[serde(skip_serializing_if = "Option::is_none")]
    /// `Accept` (header)
    pub accept: Option<String>,
    #[serde(rename = "Content-Type")]
    #[serde(skip_serializing_if = "Option::is_none")]
    /// `Content-Type` (header)
    pub content_type: Option<String>,
}

/// Parameters for `definition_template_adl2_get` (path/query/header).
#[derive(Debug, Clone, Serialize, Deserialize)]
pub struct DefinitionTemplateAdl2GetParams {
    /// `template_id` (path)
    pub template_id: String,
    #[serde(rename = "Accept")]
    #[serde(skip_serializing_if = "Option::is_none")]
    /// `Accept` (header)
    pub accept: Option<String>,
}

/// Parameters for `definition_template_adl2_example_get` (path/query/header).
#[derive(Debug, Clone, Serialize, Deserialize)]
pub struct DefinitionTemplateAdl2ExampleGetParams {
    /// `template_id` (path)
    pub template_id: String,
    #[serde(skip_serializing_if = "Option::is_none")]
    /// `type` (query)
    pub r#type: Option<String>,
    #[serde(skip_serializing_if = "Option::is_none")]
    /// `detail_level` (query)
    pub detail_level: Option<String>,
    #[serde(rename = "Accept")]
    #[serde(skip_serializing_if = "Option::is_none")]
    /// `Accept` (header)
    pub accept: Option<String>,
}

/// Parameters for `definition_template_adl2_version_get` (path/query/header).
#[derive(Debug, Clone, Serialize, Deserialize)]
pub struct DefinitionTemplateAdl2VersionGetParams {
    /// `template_id` (path)
    pub template_id: String,
    /// `version` (path)
    pub version: String,
    #[serde(rename = "Accept")]
    #[serde(skip_serializing_if = "Option::is_none")]
    /// `Accept` (header)
    pub accept: Option<String>,
}

/// Parameters for `definition_query_list` (path/query/header).
#[derive(Debug, Clone, Serialize, Deserialize)]
pub struct DefinitionQueryListParams {
    /// `qualified_query_name` (path)
    pub qualified_query_name: super::common::QueryName,
    #[serde(rename = "Accept")]
    #[serde(skip_serializing_if = "Option::is_none")]
    /// `Accept` (header)
    pub accept: Option<String>,
}

/// Parameters for `definition_query_store.yaml` (path/query/header).
#[derive(Debug, Clone, Serialize, Deserialize)]
pub struct DefinitionQueryStoreYamlParams {
    /// `qualified_query_name` (path)
    pub qualified_query_name: super::common::QueryName,
    #[serde(skip_serializing_if = "Option::is_none")]
    /// `query_type` (query)
    pub query_type: Option<String>,
    #[serde(rename = "Accept")]
    #[serde(skip_serializing_if = "Option::is_none")]
    /// `Accept` (header)
    pub accept: Option<String>,
    #[serde(rename = "Content-Type")]
    #[serde(skip_serializing_if = "Option::is_none")]
    /// `Content-Type` (header)
    pub content_type: Option<String>,
}

/// Parameters for `definition_query_version_get` (path/query/header).
#[derive(Debug, Clone, Serialize, Deserialize)]
pub struct DefinitionQueryVersionGetParams {
    /// `qualified_query_name` (path)
    pub qualified_query_name: super::common::QueryName,
    /// `version` (path)
    pub version: String,
    #[serde(rename = "Accept")]
    #[serde(skip_serializing_if = "Option::is_none")]
    /// `Accept` (header)
    pub accept: Option<String>,
}

/// Parameters for `definition_query_version_store.yaml` (path/query/header).
#[derive(Debug, Clone, Serialize, Deserialize)]
pub struct DefinitionQueryVersionStoreYamlParams {
    /// `qualified_query_name` (path)
    pub qualified_query_name: super::common::QueryName,
    /// `version` (path)
    pub version: String,
    #[serde(skip_serializing_if = "Option::is_none")]
    /// `query_type` (query)
    pub query_type: Option<String>,
    #[serde(rename = "Accept")]
    #[serde(skip_serializing_if = "Option::is_none")]
    /// `Accept` (header)
    pub accept: Option<String>,
}

/// Server contract for the `definition` API group (ITS-REST). Every method
/// defaults to returning `ApiError::NotImplemented`, so an implementor
/// (the application service, or a test stub) overrides only the
/// operations it supports.
#[async_trait::async_trait]
pub trait DefinitionApi {
    /// `GET /definition/template/adl1.4`
    async fn definition_template_adl1_4_list(
        &self,
        params: DefinitionTemplateAdl14ListParams,
    ) -> Result<TemplateList, crate::rest::runtime::ApiError> {
        Err(crate::rest::runtime::ApiError::NotImplemented)
    }
    /// `POST /definition/template/adl1.4`
    async fn definition_template_adl1_4_upload(
        &self,
        params: DefinitionTemplateAdl14UploadParams,
        body: serde_json::Value,
    ) -> Result<TemplateIdentifier, crate::rest::runtime::ApiError> {
        Err(crate::rest::runtime::ApiError::NotImplemented)
    }
    /// `GET /definition/template/adl1.4/{template_id}`
    async fn definition_template_adl1_4_get(
        &self,
        params: DefinitionTemplateAdl14GetParams,
    ) -> Result<serde_json::Value, crate::rest::runtime::ApiError> {
        Err(crate::rest::runtime::ApiError::NotImplemented)
    }
    /// `GET /definition/template/adl1.4/{template_id}/example`
    async fn definition_template_adl1_4_example_get(
        &self,
        params: DefinitionTemplateAdl14ExampleGetParams,
    ) -> Result<serde_json::Value, crate::rest::runtime::ApiError> {
        Err(crate::rest::runtime::ApiError::NotImplemented)
    }
    /// `GET /definition/template/adl2`
    async fn definition_template_adl2_list(
        &self,
        params: DefinitionTemplateAdl2ListParams,
    ) -> Result<TemplateList, crate::rest::runtime::ApiError> {
        Err(crate::rest::runtime::ApiError::NotImplemented)
    }
    /// `POST /definition/template/adl2`
    async fn definition_template_adl2_upload(
        &self,
        params: DefinitionTemplateAdl2UploadParams,
        body: serde_json::Value,
    ) -> Result<TemplateIdentifier, crate::rest::runtime::ApiError> {
        Err(crate::rest::runtime::ApiError::NotImplemented)
    }
    /// `GET /definition/template/adl2/{template_id}`
    async fn definition_template_adl2_get(
        &self,
        params: DefinitionTemplateAdl2GetParams,
    ) -> Result<OperationalTemplateV2, crate::rest::runtime::ApiError> {
        Err(crate::rest::runtime::ApiError::NotImplemented)
    }
    /// `GET /definition/template/adl2/{template_id}/example`
    async fn definition_template_adl2_example_get(
        &self,
        params: DefinitionTemplateAdl2ExampleGetParams,
    ) -> Result<serde_json::Value, crate::rest::runtime::ApiError> {
        Err(crate::rest::runtime::ApiError::NotImplemented)
    }
    /// `GET /definition/template/adl2/{template_id}/{version}`
    async fn definition_template_adl2_version_get(
        &self,
        params: DefinitionTemplateAdl2VersionGetParams,
    ) -> Result<OperationalTemplateV2, crate::rest::runtime::ApiError> {
        Err(crate::rest::runtime::ApiError::NotImplemented)
    }
    /// `GET /definition/query/{qualified_query_name}`
    async fn definition_query_list(
        &self,
        params: DefinitionQueryListParams,
    ) -> Result<QueryList, crate::rest::runtime::ApiError> {
        Err(crate::rest::runtime::ApiError::NotImplemented)
    }
    /// `PUT /definition/query/{qualified_query_name}`
    async fn definition_query_store_yaml(
        &self,
        params: DefinitionQueryStoreYamlParams,
        body: super::common::Aql,
    ) -> Result<(), crate::rest::runtime::ApiError> {
        Err(crate::rest::runtime::ApiError::NotImplemented)
    }
    /// `GET /definition/query/{qualified_query_name}/{version}`
    async fn definition_query_version_get(
        &self,
        params: DefinitionQueryVersionGetParams,
    ) -> Result<StoredQuery, crate::rest::runtime::ApiError> {
        Err(crate::rest::runtime::ApiError::NotImplemented)
    }
    /// `PUT /definition/query/{qualified_query_name}/{version}`
    async fn definition_query_version_store_yaml(
        &self,
        params: DefinitionQueryVersionStoreYamlParams,
        body: super::common::Aql,
    ) -> Result<(), crate::rest::runtime::ApiError> {
        Err(crate::rest::runtime::ApiError::NotImplemented)
    }
}

/// The operations of this group as `(method, path, operation_id)`, for
/// wiring an axum router in `ferroehr-rest`.
pub const ROUTES: &[(&str, &str, &str)] = &[
    (
        "GET",
        "/definition/template/adl1.4",
        "definition_template_adl1.4_list",
    ),
    (
        "POST",
        "/definition/template/adl1.4",
        "definition_template_adl1.4_upload",
    ),
    (
        "GET",
        "/definition/template/adl1.4/{template_id}",
        "definition_template_adl1.4_get",
    ),
    (
        "GET",
        "/definition/template/adl1.4/{template_id}/example",
        "definition_template_adl1.4_example_get",
    ),
    (
        "GET",
        "/definition/template/adl2",
        "definition_template_adl2_list",
    ),
    (
        "POST",
        "/definition/template/adl2",
        "definition_template_adl2_upload",
    ),
    (
        "GET",
        "/definition/template/adl2/{template_id}",
        "definition_template_adl2_get",
    ),
    (
        "GET",
        "/definition/template/adl2/{template_id}/example",
        "definition_template_adl2_example_get",
    ),
    (
        "GET",
        "/definition/template/adl2/{template_id}/{version}",
        "definition_template_adl2_version_get",
    ),
    (
        "GET",
        "/definition/query/{qualified_query_name}",
        "definition_query_list",
    ),
    (
        "PUT",
        "/definition/query/{qualified_query_name}",
        "definition_query_store.yaml",
    ),
    (
        "GET",
        "/definition/query/{qualified_query_name}/{version}",
        "definition_query_version_get",
    ),
    (
        "PUT",
        "/definition/query/{qualified_query_name}/{version}",
        "definition_query_version_store.yaml",
    ),
];