avro schema audit derived

{
  "input": {
    "body": {
      "schema": {
        "name": "Invoice",
        "type": "record",
        "fields": [
          {
            "name": "invoice_id",
            "type": "string"
          },
          {
            "name": "amount",
            "type": "double"
          },
          {
            "name": "issued_at",
            "type": {
              "type": "string",
              "logicalType": "timestamp-millis"
            }
          },
          {
            "name": "memo",
            "type": [
              "string",
              "null"
            ],
            "default": null
          },
          {
            "name": "state",
            "type": {
              "name": "State",
              "type": "enum",
              "symbols": [
                "DRAFT",
                "SENT"
              ]
            }
          }
        ]
      },
      "require_documentation": true
    },
    "type": "http",
    "method": "POST",
    "bodyType": "json"
  },
  "output": {
    "type": "json",
    "example": {
      "root": "record Invoice",
      "valid": false,
      "limits": {
        "maxFindings": 500,
        "maxSdlBytes": 262144,
        "maxVersions": 25,
        "maxAvroBytes": 262144,
        "maxConsumers": 50,
        "maxProtoBytes": 262144,
        "maxPathsPerConsumer": 200
      },
      "passed": false,
      "complete": true,
      "findings": [
        {
          "code": "NAMESPACE_ABSENT",
          "detail": "The top-level record Invoice declares no namespace, so its full name is just Invoice and it collides with any other schema of that name in a shared registry.",
          "location": "(root)"
        },
        {
          "code": "RECORD_NOT_DOCUMENTED",
          "detail": "The record Invoice carries no doc, so a consumer reading the schema alone cannot tell what it represents.",
          "location": "(root)"
        },
        {
          "code": "FIELD_WITHOUT_DEFAULT",
          "detail": "(root).invoice_id declares no default, so it cannot be removed later without breaking a reader on this schema, and a reader adding it must supply one.",
          "location": "(root).invoice_id"
        }
      ],
      "node_count": 8,
      "request_id": "example-request",
      "service_id": "avro_schema_audit",
      "assumptions": [
        "The findings are about what this schema makes possible later, not only about what is wrong now. A field with no default and an enum with no default are both legal and both make a later change breaking...",
        "An Avro default must match the first branch of a union, so a null default with null second is reported as invalid rather than as a style preference.",
        "A logicalType on a base the specification does not allow it on is reported, because readers ignore it silently and the field quietly means something else."
      ],
      "limitations": [
        "One schema as written. Whether its field names and semantics suit the domain is not assessed, and this is not a certification.",
        "valid is true only when nothing above applied. Documentation findings are only produced when require_documentation is set."
      ],
      "observed_at": "2026-10-02T00:00:00.000Z",
      "not_examined": [],
      "finding_count": 15,
      "service_version": "1.0.0",
      "findings_by_code": {
        "NAMESPACE_ABSENT": 1,
        "ENUM_WITHOUT_DEFAULT": 1,
        "FIELD_NOT_DOCUMENTED": 5,
        "FIELD_WITHOUT_DEFAULT": 4,
        "RECORD_NOT_DOCUMENTED": 1,
        "LOGICAL_TYPE_BASE_MISMATCH": 1,
        "BINARY_FLOAT_FOR_MONETARY_FIELD": 1,
        "NULL_DEFAULT_WITH_NULL_NOT_FIRST": 1
      },
      "named_type_count": 2,
      "documentation_checked": true
    }
  }
}