Superadmin · Content · Canonical exam governance

Standardized Exams

Govern canonical exam definitions, questions, answer keys, rubrics, response sheets, OCR readiness, and publishing.

← Back to Content Command Center + New Exam Draft Open Tetrahedron OCR & Exams Publishing Queue

🎓 Canonical exam governance layer Governed runtime connected

Standardized Exams are the canonical layer that defines official exam packages — questions, answer keys, rubrics, response-sheet templates, and OCR readiness — before any teacher in Tetrahedron can assign them. This is where SuperAdmin owns the exam itself; Tetrahedron only instantiates published packages.

Use the governed catalog below to move from jurisdiction to subject, administration instance, package questions, answer key, and downstream publication. Reads come from the canonical exam collections; instance changes use the governed Standardized Exam callables.

🗽Regents (NY State)

Catalog defined

NY State end-of-course exams (Algebra I, Living Environment, Global History, etc.). The canonical subject roster is defined below; questions, scoring keys, and OCR response sheets are governed here.

Manage exam instances →

Show discontinued / legacy exams Shared catalog

Loading governed instances…

Canonical package readiness and advanced filters ▾

Total exam definitions—administrations across all families

Families—e.g. Regents, SAT, ICFES

Programs—e.g. Algebra I, SAT Math

Published—status = published

OCR-ready—layout + key present

Missing answer key—readiness gap

Missing rubric—readiness gap

Missing response sheet—readiness gap

Loading canonical package readiness… Reading from Firestore in read-only mode.

🏛️SAT & college readiness

Planned

SAT, PSAT, AP, ACT, and college-readiness practice packages. Section-timed delivery, rubric-graded essays, multi-form versions.

🇨🇴ICFES & national exams

Planned

ICFES Saber 11 (Colombia) and equivalent national-level standardized exams. Multilingual questions and country-scoped jurisdiction.

🏫State exams

Planned

State-level standardized assessments (other than NY Regents). Per-jurisdiction grade and subject alignment, OCR-friendly response sheets.

📊Benchmarks

Planned

School- or district-scoped benchmark assessments — fall, winter, spring cycles. Reusable templates with versioned answer keys.

🩺Diagnostics

Planned

Skill-tagged diagnostics that feed into mastery and remediation pathways. Short-form, adaptive-friendly question sets.

📦 Canonical package model Architecture · Reference

The collections that an exam package spans. SuperAdmin owns the canonical entities; Tetrahedron consumes published packages and writes only the runtime layer.

Canonical · SuperAdmin

StandardizedExams

The canonical exam definition — identity, exam_family, jurisdiction, language, grade/subject/course refs, question manifest, version metadata.

Canonical · SuperAdmin

AnswerKeys

Per-question correct answers, accepted variants, point allocations, partial-credit rules. Versioned alongside the exam.

Canonical · SuperAdmin

ExamRubrics

Rubric definitions for short-response and open-response items — criteria, levels, descriptors, score bands.

Canonical · SuperAdmin

ResponseSheetTemplates

OCR-ready response-sheet layouts — bubble grid, fiducials, page geometry, multi-form mapping. Required for paper delivery + scan.

Runtime · Tetrahedron

ExamAssignments

Course-bound instance of a published exam package. Carries delivery_mode, timing window, scramble/form selection, and the canonical exam_ref.

Runtime · Tetrahedron

AssignedAssignments

Per-student submission record. Lifecycle is governed by deriveEvaluationState() — SUBMITTED, SCAN_PENDING, GRADED, etc.

Runtime · Tetrahedron

StudentExamQuestionResults

Per-question outcome records — selected answer, correct/partial/incorrect, points, rubric scores. Used by Observatory and Octahedron.

✅ Package readiness checklist Validation gates

A canonical exam package can only move to the Publishing Queue when every gate clears. This is the contract Tetrahedron consumes.

Identity completeexam_id, title, exam_family, jurisdiction, language_code, country_code set

Taxonomy alignedgrade_refs, subject_refs, course_refs resolve to canonical taxonomy entries

Questions present and numberedQuestion manifest has at least one item; question_number is contiguous

Answer key completeEvery scored question has a correct_answer or accepted_answers; total points reconcile

Rubrics attached where requiredOpen-response and short-response items have a linked ExamRubric

Response-sheet template readyOCR layout, fiducials, and form mapping validated for paper delivery

Forms / scramble configuration validMulti-form versions (A/B/C/D) consistent with answer-key mapping

Translations reviewedEach available_language has a human-reviewed translation pass

Source & license clearedSource provenance, license_type, and human_review_required flags resolved

🔁 Downstream runtime flow

How a published exam package moves from canonical governance to per-student results.

1SuperAdminAuthors and validates the exam package — questions, answer key, rubrics, response sheet, forms.

2Publishing QueueReadiness gates clear; the package is published as a canonical, immutable version.

3TetrahedronA teacher creates an ExamAssignment from the published package — course-bound, timed, with delivery_mode chosen.

4CubeStudents take the exam (online or paper). Online responses or scanned response sheets are captured.

5OCR / ScanFor paper delivery, scanned response sheets are processed; bubble selections are extracted into AssignedAssignments.

6GradingAuto-graded items resolve via the canonical answer key; rubric items wait for teacher review. StudentExamQuestionResults are written.

7Observatory · OctahedronPer-student, per-question outcomes feed mastery, readiness, and intervention surfaces for tutors and stakeholders.

Technical context

auth uid

—

collection branch used

—

docs loaded

—

families count

—

programs count

—

visible administrations

—

fallback branches tried

—

errors by branch

none

filters applied

none

Firestore mode

read-only

writes on this page

none

last load

—

last error

—

normalized docs count

—

render errors

—

Canonical collection (primary)

StandardizedExams

Fallback collections

ExamDefinitions · StandardizedExamDefinitions · ExamTemplates

Canonical companions

AnswerKeys · ExamRubrics · ResponseSheetTemplates

Runtime collections

ExamAssignments · AssignedAssignments · StudentExamQuestionResults

Lifecycle helper

deriveEvaluationState() · /shared/js/assignment-lifecycle.js

Authority boundary

SuperAdmin authors · Tetrahedron consumes

Authoring builder

planned

OCR / Storage APIs

planned (no backend wired)

Fanout / assignment

planned (handled by Tetrahedron later)