{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://l0g.fr/api/v1/signals/schema.json",
  "title": "l0g signal history v2",
  "description": "Contrat des séries nommées, observations point-in-time et événements de seuil des signaux l0g.",
  "oneOf": [
    {
      "$ref": "#/$defs/meta"
    },
    {
      "$ref": "#/$defs/observation"
    },
    {
      "$ref": "#/$defs/levelChange"
    }
  ],
  "$defs": {
    "meta": {
      "type": "object",
      "required": [
        "recordType",
        "version",
        "generated",
        "coverage",
        "policy"
      ],
      "properties": {
        "recordType": {
          "const": "meta"
        },
        "generated": {
          "type": "string",
          "format": "date-time"
        }
      },
      "additionalProperties": true
    },
    "observation": {
      "type": "object",
      "required": [
        "recordType",
        "recordId",
        "instrument",
        "seriesId",
        "seriesSlug",
        "name",
        "seriesDate",
        "value",
        "snapshotHash",
        "methodologyVersionStatus",
        "appendOnlyVerified",
        "evidenceTier",
        "sourceStatus",
        "qualityStatus",
        "fallbackUsed",
        "backtestUsable"
      ],
      "properties": {
        "recordType": {
          "const": "observation"
        },
        "instrument": {
          "enum": [
            "us",
            "eu",
            "yen",
            "energie",
            "debt"
          ]
        },
        "seriesDate": {
          "type": "string",
          "format": "date-time"
        },
        "observedAt": {
          "type": [
            "string",
            "null"
          ],
          "format": "date-time"
        },
        "value": {
          "type": [
            "number",
            "null"
          ]
        },
        "rawValue": {
          "type": [
            "number",
            "null"
          ]
        },
        "methodologyVersion": {
          "type": [
            "string",
            "null"
          ]
        },
        "methodologyVersionStatus": {
          "enum": [
            "versioned",
            "unversioned-legacy"
          ]
        },
        "appendOnlyVerified": {
          "type": "boolean"
        },
        "evidenceTier": {
          "enum": [
            "attested-archive",
            "operational-archive",
            "current-snapshot"
          ]
        },
        "sourceStatus": {
          "enum": [
            "ok",
            "fallback",
            "unknown"
          ]
        },
        "qualityStatus": {
          "enum": [
            "nominal",
            "degraded",
            "official-delayed",
            "unknown"
          ]
        },
        "fallbackUsed": {
          "type": "boolean"
        },
        "fallbackReason": {
          "type": [
            "string",
            "null"
          ]
        },
        "backtestUsable": {
          "type": "boolean"
        }
      },
      "additionalProperties": true
    },
    "levelChange": {
      "type": "object",
      "required": [
        "recordType",
        "eventId",
        "instrument",
        "seriesId",
        "observedAt",
        "previousLevel",
        "currentLevel",
        "backtestUsable"
      ],
      "properties": {
        "recordType": {
          "const": "level-change"
        },
        "instrument": {
          "enum": [
            "us",
            "eu",
            "yen",
            "energie",
            "debt"
          ]
        },
        "observedAt": {
          "type": [
            "string",
            "null"
          ],
          "format": "date-time"
        },
        "backtestUsable": {
          "const": false
        }
      },
      "additionalProperties": true
    }
  }
}