{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "http://smart.who.int/base/StructureDefinition-KGRecommendation.schema.json",
  "title": "Knowledge graph L1: Recommendation",
  "description": "The atomic normative statement. This is the node nothing in the WHO estate currently makes addressable. statement is a VERBATIM quote, never a paraphrase — a paraphrased recommendation is a new recommendation. strength is GRADE (strong | conditional); certainty is GRADE (high | moderate | low | very-low); conditionality records the 'in settings where…' qualifier that decides whether a DAK can adopt it unchanged. Class IRI: http://smart.who.int/kg/recommendation.",
  "type": "object",
  "properties": {
    "resourceType": {
      "type": "string",
      "const": "KGRecommendation",
      "description": "Resource type identifier for KGRecommendation logical model"
    },
    "@context": {
      "description": "JSON-LD context for this logical model with ValueSet vocabularies",
      "anyOf": [
        {
          "type": "string",
          "format": "uri",
          "description": "URI reference to external JSON-LD context"
        },
        {
          "type": "object",
          "description": "Inline JSON-LD context",
          "properties": {
            "@version": {
              "type": "number",
              "const": 1.1
            },
            "fhir": {
              "type": "string",
              "const": "http://hl7.org/fhir/"
            }
          },
          "additionalProperties": {
            "type": "string",
            "format": "uri"
          }
        },
        {
          "type": "array",
          "description": "Array of JSON-LD context objects/URIs",
          "items": {
            "anyOf": [
              {
                "type": "string",
                "format": "uri"
              },
              {
                "type": "object"
              }
            ]
          }
        }
      ]
    },
    "@type": {
      "type": "string",
      "description": "JSON-LD type identifier for KGRecommendation logical model",
      "examples": [
        "LogicalModel-KGRecommendation"
      ]
    },
    "identifier": {
      "type": "string",
      "description": "The recommendation's label or number as printed."
    },
    "statement": {
      "type": "string",
      "description": "The recommendation text, VERBATIM. A paraphrased recommendation is a new recommendation."
    },
    "strength": {
      "oneOf": [
        {
          "type": "string",
          "description": "Code from ValueSet KGGradeStrengthVS (plain string)"
        },
        {
          "type": "object",
          "description": "Code from ValueSet KGGradeStrengthVS (JSON-LD structure)",
          "properties": {
            "@type": {
              "type": "string",
              "const": "http://smart.who.int/base/ValueSet-KGGradeStrengthVS.jsonld",
              "description": "JSON-LD type reference to ValueSet KGGradeStrengthVS"
            },
            "@id": {
              "type": "string",
              "format": "uri",
              "description": "Full IRI of the code from ValueSet KGGradeStrengthVS"
            }
          },
          "required": [
            "@type",
            "@id"
          ],
          "additionalProperties": false
        }
      ],
      "description": "GRADE strength, as stated in the source."
    },
    "certainty": {
      "oneOf": [
        {
          "type": "string",
          "description": "Code from ValueSet KGGradeCertaintyVS (plain string)"
        },
        {
          "type": "object",
          "description": "Code from ValueSet KGGradeCertaintyVS (JSON-LD structure)",
          "properties": {
            "@type": {
              "type": "string",
              "const": "http://smart.who.int/base/ValueSet-KGGradeCertaintyVS.jsonld",
              "description": "JSON-LD type reference to ValueSet KGGradeCertaintyVS"
            },
            "@id": {
              "type": "string",
              "format": "uri",
              "description": "Full IRI of the code from ValueSet KGGradeCertaintyVS"
            }
          },
          "required": [
            "@type",
            "@id"
          ],
          "additionalProperties": false
        }
      ],
      "description": "GRADE certainty of evidence, as stated in the source."
    },
    "conditionality": {
      "type": "string",
      "description": "The 'in settings where…' qualifier, verbatim, that decides whether a DAK can adopt the recommendation unchanged."
    },
    "status": {
      "type": "string",
      "description": "The recommendation's standing in its publication (for example current or superseded), as stated."
    }
  },
  "required": [
    "resourceType"
  ],
  "resourceDefinition": "http://smart.who.int/base/StructureDefinition/KGRecommendation",
  "fhir:parent": "http://hl7.org/fhir/StructureDefinition/Base",
  "jsonld:valuesets": [
    "KGGradeStrengthVS",
    "KGGradeCertaintyVS"
  ],
  "jsonld:contextTemplate": {
    "@version": 1.1,
    "fhir": "http://hl7.org/fhir/",
    "KGGradeStrengthVS": "http://smart.who.int/base/ValueSet-KGGradeStrengthVS.jsonld",
    "KGGradeCertaintyVS": "http://smart.who.int/base/ValueSet-KGGradeCertaintyVS.jsonld"
  }
}