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

Overall score for an evaluation on a numeric scale.

Properties

max string Required

Maximum value of the scale as a numeric string (e.g. '5', '10').

maxLength: 50 bytes
min string Required

Minimum value of the scale as a numeric string (e.g. '0', '1').

maxLength: 50 bytes
value string Required

Score within the inclusive range [min, max] as a numeric string (e.g. '3.7').

maxLength: 50 bytes
View raw schema 
{
  "description": "Overall score for an evaluation on a numeric scale.",
  "properties": {
    "max": {
      "description": "Maximum value of the scale as a numeric string (e.g. '5', '10').",
      "maxLength": 50,
      "type": "string"
    },
    "min": {
      "description": "Minimum value of the scale as a numeric string (e.g. '0', '1').",
      "maxLength": 50,
      "type": "string"
    },
    "value": {
      "description": "Score within the inclusive range [min, max] as a numeric string (e.g. '3.7').",
      "maxLength": 50,
      "type": "string"
    }
  },
  "required": [
    "min",
    "max",
    "value"
  ],
  "type": "object"
}

Lexicon Garden

@