org.hypercerts.claim.evaluation

hypercerts.org

Documentation

An evaluation of a hypercert record (e.g. an activity and its impact).

main record

An evaluation of a hypercert record (e.g. an activity and its impact).

Record Key tid Timestamp-based ID

Properties

createdAt string datetime Required

Client-declared timestamp when this record was originally created

location ref com.atproto.repo.strongRef Optional

An optional reference for georeferenced evaluations. The record referenced must conform with the lexicon app.certified.location.

measurements array of ref com.atproto.repo.strongRef Optional

Optional references to the measurements that contributed to this evaluation. The record(s) referenced must conform with the lexicon org.hypercerts.claim.measurement

maxLength: 100 items
score ref #score Optional

Optional overall score for this evaluation on a numeric scale.

subject ref com.atproto.repo.strongRef Optional

A strong reference to what is being evaluated. (e.g activity, measurement, contribution, etc.)

summary string Required

Brief evaluation summary

maxLength: 5000 bytesmaxGraphemes: 1000 graphemes
View raw schema
{
  "key": "tid",
  "type": "record",
  "record": {
    "type": "object",
    "required": [
      "evaluators",
      "summary",
      "createdAt"
    ],
    "properties": {
      "score": {
        "ref": "#score",
        "type": "ref",
        "description": "Optional overall score for this evaluation on a numeric scale."
      },
      "content": {
        "type": "array",
        "items": {
          "refs": [
            "org.hypercerts.defs#uri",
            "org.hypercerts.defs#smallBlob"
          ],
          "type": "union"
        },
        "maxLength": 100,
        "description": "Evaluation data (URIs or blobs) containing detailed reports or methodology"
      },
      "subject": {
        "ref": "com.atproto.repo.strongRef",
        "type": "ref",
        "description": "A strong reference to what is being evaluated. (e.g activity, measurement, contribution, etc.)"
      },
      "summary": {
        "type": "string",
        "maxLength": 5000,
        "description": "Brief evaluation summary",
        "maxGraphemes": 1000
      },
      "location": {
        "ref": "com.atproto.repo.strongRef",
        "type": "ref",
        "description": "An optional reference for georeferenced evaluations. The record referenced must conform with the lexicon app.certified.location."
      },
      "createdAt": {
        "type": "string",
        "format": "datetime",
        "description": "Client-declared timestamp when this record was originally created"
      },
      "evaluators": {
        "type": "array",
        "items": {
          "ref": "app.certified.defs#did",
          "type": "ref"
        },
        "maxLength": 1000,
        "description": "DIDs of the evaluators"
      },
      "measurements": {
        "type": "array",
        "items": {
          "ref": "com.atproto.repo.strongRef",
          "type": "ref"
        },
        "maxLength": 100,
        "description": "Optional references to the measurements that contributed to this evaluation. The record(s) referenced must conform with the lexicon org.hypercerts.claim.measurement"
      }
    }
  },
  "description": "An evaluation of a hypercert record (e.g. an activity and its impact)."
}
score object

Overall score for an evaluation on a numeric scale.

Properties

max integer Required

Maximum value of the scale, e.g. 5 or 10.

min integer Required

Minimum value of the scale, e.g. 0 or 1.

value integer Required

Score within the inclusive range [min, max].

View raw schema
{
  "type": "object",
  "required": [
    "min",
    "max",
    "value"
  ],
  "properties": {
    "max": {
      "type": "integer",
      "description": "Maximum value of the scale, e.g. 5 or 10."
    },
    "min": {
      "type": "integer",
      "description": "Minimum value of the scale, e.g. 0 or 1."
    },
    "value": {
      "type": "integer",
      "description": "Score within the inclusive range [min, max]."
    }
  },
  "description": "Overall score for an evaluation on a numeric scale."
}

Lexicon Garden

@