ROAR Backend Technical Specification

Draft Notice

These technical specifications reflect Adam's current thinking and design direction. They have not yet been thoroughly vetted by the rest of the development team and are not endorsed as an official ROAR standard. Please review with discretion and open issues for any questions or concerns.

This index organizes all of ROAR's backend technical specifications by functional domain.

Identity and Access

Users & Organizations

Covers:

  • User account model
  • Org hierarchy (district → school → class, families, groups)
  • Historical org membership
  • Rostering provenance and audit logs
  • FERPA/PII compliance and data minimization

Rostering Integration

Covers:

  • Rostering workflows via API and CSV ingestion
  • Deferred Auth UID binding
  • Detection of stale users and unenrollment

Permissions & Access Control

Covers:

  • RBAC (Role-Based Access Control) design
  • Granting permissions to orgs, users, and entities
  • Role expiration and provenance
  • Access and mutation logging

Parent Accounts and Access Modes

Covers:

  • School-linked vs ROAR@Home access modes
  • Parent-child relationship management
  • Identity linking and cohort enrollment

Task Infrastructure

Task Configuration

Covers:

  • Task definitions
  • Parameter management
  • Variant ID system
  • Task versioning

Assessment Execution

Covers:

  • Run lifecycle and metadata
  • Trial-level events
  • Runtime modes (practice/test)
  • Linking variants to executions

Measurement Services Integration

Covers:

  • Integration of task runtimes with measurement services
  • Score schema (raw, computed, normed)
  • Trial-level score accumulation
  • Reliability evaluation and event tracking
  • Stopping condition and item selection services
  • Browser interaction logging
  • Score and reliability compute/validate endpoints

Delivery and Research Operations

Administrations & Assignments

Covers:

  • Assignment creation and management
  • Administration series and scheduling logic
  • Linking students and educators to tasks
  • Tracking completion across assigned groups

Agreements

Covers:

  • User agreements such as assent, consent, and TOS
  • Agreement versioning and translations
  • Associating agreement versions with administrations