Add the term, equation, value, and misconception registries (src/model/course/glossary.rs) and the new optional fields on objectives, targets, lectures, readings, bank options, and policy. Load registry entries from objective files, glossary.yaml, and course.yaml, with one definition site per id as for every other registry. Port every edit in docs/design/2.1/build_schemas.py into the hand-written schema builders, add glossary.schema.json, and test the generated schemas against the targets; the only differences are two 2.0 spellings the code already had. The 2.0 example fragments load and validate unchanged. The 2.1 example bank gains `status: draft`, which every coursebank item requires. tests/docs.rs skips docs/design/, which holds design records rather than guide pages. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
214 lines
5.8 KiB
JSON
214 lines
5.8 KiB
JSON
{
|
|
"$id": "https://coursebank.dev/schema/measurements.schema.json",
|
|
"$schema": "https://json-schema.org/draft/2020-12/schema",
|
|
"additionalProperties": false,
|
|
"description": "What one administration measured. Written once and not rewritten, like a seal: it records a thing that happened on a day. Cohort aggregates only — no per-section or per-student breakdown, because a small cell crossed with anything else stops being an aggregate.",
|
|
"properties": {
|
|
"administration": {
|
|
"additionalProperties": false,
|
|
"properties": {
|
|
"assessment": {
|
|
"type": "string"
|
|
},
|
|
"coursebank": {
|
|
"type": "string"
|
|
},
|
|
"date": {
|
|
"description": "When it was given.",
|
|
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
|
|
"type": "string"
|
|
},
|
|
"forms": {
|
|
"description": "The forms in play.",
|
|
"items": {
|
|
"type": "string"
|
|
},
|
|
"type": "array"
|
|
},
|
|
"generated": {
|
|
"description": "When the analysis was run.",
|
|
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
|
|
"type": "string"
|
|
},
|
|
"id": {
|
|
"type": "string"
|
|
},
|
|
"model": {
|
|
"type": "string"
|
|
},
|
|
"n_examinees": {
|
|
"description": "The number to read before any of the others: a point-biserial on twenty-seven students is a different kind of claim than one on three hundred.",
|
|
"minimum": 0,
|
|
"type": "integer"
|
|
},
|
|
"term": {
|
|
"type": "string"
|
|
}
|
|
},
|
|
"required": [
|
|
"id",
|
|
"assessment",
|
|
"n_examinees"
|
|
],
|
|
"type": "object"
|
|
},
|
|
"items": {
|
|
"items": {
|
|
"additionalProperties": false,
|
|
"properties": {
|
|
"discrimination_index": {
|
|
"maximum": 1.0,
|
|
"minimum": -1.0,
|
|
"type": "number"
|
|
},
|
|
"flags": {
|
|
"items": {
|
|
"enum": [
|
|
"negative_discrimination",
|
|
"low_discrimination",
|
|
"distractor_outperforms_key",
|
|
"key_underperforms",
|
|
"too_easy",
|
|
"too_hard",
|
|
"high_rapid_guess",
|
|
"nonfunctioning_distractor",
|
|
"dif_flagged",
|
|
"ambiguous",
|
|
"design_mismatch"
|
|
],
|
|
"type": "string"
|
|
},
|
|
"type": "array"
|
|
},
|
|
"irt": {
|
|
"additionalProperties": false,
|
|
"properties": {
|
|
"a": {
|
|
"description": "Discrimination.",
|
|
"type": "number"
|
|
},
|
|
"b": {
|
|
"description": "Difficulty.",
|
|
"type": "number"
|
|
},
|
|
"bayesian": {
|
|
"description": "Whether priors were used. On a class-sized sample they should be.",
|
|
"type": "boolean"
|
|
},
|
|
"c": {
|
|
"description": "Lower asymptote, 3PL only.",
|
|
"maximum": 1.0,
|
|
"minimum": 0.0,
|
|
"type": "number"
|
|
},
|
|
"model": {
|
|
"enum": [
|
|
"rasch",
|
|
"2pl",
|
|
"3pl"
|
|
],
|
|
"type": "string"
|
|
},
|
|
"n": {
|
|
"minimum": 0,
|
|
"type": "integer"
|
|
},
|
|
"se_a": {
|
|
"minimum": 0.0,
|
|
"type": "number"
|
|
},
|
|
"se_b": {
|
|
"minimum": 0.0,
|
|
"type": "number"
|
|
}
|
|
},
|
|
"required": [
|
|
"a",
|
|
"b"
|
|
],
|
|
"type": "object"
|
|
},
|
|
"item": {
|
|
"type": "string"
|
|
},
|
|
"n": {
|
|
"minimum": 0,
|
|
"type": "integer"
|
|
},
|
|
"number": {
|
|
"minimum": 1,
|
|
"type": "integer"
|
|
},
|
|
"option_stats": {
|
|
"additionalProperties": {
|
|
"additionalProperties": false,
|
|
"properties": {
|
|
"lower_group_rate": {
|
|
"description": "Rate in the bottom 27%.",
|
|
"maximum": 1.0,
|
|
"minimum": 0.0,
|
|
"type": "number"
|
|
},
|
|
"point_biserial": {
|
|
"maximum": 1.0,
|
|
"minimum": -1.0,
|
|
"type": "number"
|
|
},
|
|
"selection_rate": {
|
|
"description": "How often chosen.",
|
|
"maximum": 1.0,
|
|
"minimum": 0.0,
|
|
"type": "number"
|
|
},
|
|
"upper_group_rate": {
|
|
"description": "Rate in the top 27%.",
|
|
"maximum": 1.0,
|
|
"minimum": 0.0,
|
|
"type": "number"
|
|
}
|
|
},
|
|
"type": "object"
|
|
},
|
|
"type": "object"
|
|
},
|
|
"p_value": {
|
|
"description": "Proportion correct on this administration.",
|
|
"maximum": 1.0,
|
|
"minimum": 0.0,
|
|
"type": "number"
|
|
},
|
|
"point_biserial": {
|
|
"maximum": 1.0,
|
|
"minimum": -1.0,
|
|
"type": "number"
|
|
},
|
|
"stem_digest": {
|
|
"type": "string"
|
|
},
|
|
"variant": {
|
|
"type": "string"
|
|
}
|
|
},
|
|
"required": [
|
|
"item",
|
|
"number",
|
|
"n"
|
|
],
|
|
"type": "object"
|
|
},
|
|
"type": "array"
|
|
},
|
|
"schema_version": {
|
|
"type": [
|
|
"string",
|
|
"number"
|
|
]
|
|
}
|
|
},
|
|
"required": [
|
|
"administration"
|
|
],
|
|
"title": "coursebank administration record",
|
|
"type": "object"
|
|
}
|