📚 Chapter 4: Phase 1 - Data Format Standard

This chapter defines the JSON schemas that form the foundation of the WIA EDU Standard. These data formats enable interoperability across all education platforms.


4.1 Learner Profile Schema

The Learner Profile stores all accessibility preferences and needs for a learner.

4.1.1 Complete Learner Profile Schema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://wiastandards.com/schemas/edu/learner-profile.schema.json",
  "title": "WIA EDU Learner Profile",
  "type": "object",
  "required": ["profile_id", "schema_version"],
  "properties": {
    "profile_id": {
      "type": "string",
      "pattern": "^EDU-[0-9]{4}-[A-Z0-9]{4}-[A-Z0-9]{4}$",
      "description": "Unique identifier for this profile"
    },
    "schema_version": {
      "type": "string",
      "const": "1.0.0"
    },
    "created_at": {
      "type": "string",
      "format": "date-time"
    },
    "updated_at": {
      "type": "string",
      "format": "date-time"
    },
    "learner_info": {
      "type": "object",
      "properties": {
        "name": { "type": "string" },
        "institution_id": { "type": "string" },
        "disclosed": { "type": "boolean", "default": false }
      }
    },
    "disability_profile": {
      "type": "object",
      "properties": {
        "categories": {
          "type": "array",
          "items": {
            "enum": ["visual", "hearing", "motor", "cognitive", "learning", "mental_health", "temporary"]
          }
        },
        "disclosed": { "type": "boolean", "default": false }
      }
    },
    "display_preferences": {
      "type": "object",
      "properties": {
        "screen_reader": {
          "type": "object",
          "properties": {
            "enabled": { "type": "boolean" },
            "reader": { "enum": ["nvda", "jaws", "voiceover", "talkback", "narrator", "orca"] },
            "rate": { "enum": ["slow", "medium", "fast", "very_fast"] },
            "verbosity": { "enum": ["low", "medium", "high"] }
          }
        },
        "magnification": {
          "type": "object",
          "properties": {
            "enabled": { "type": "boolean" },
            "level": { "type": "number", "minimum": 1, "maximum": 10 },
            "focus_tracking": { "type": "boolean" }
          }
        },
        "text_settings": {
          "type": "object",
          "properties": {
            "font_size": { "enum": ["normal", "large", "x-large", "xx-large"] },
            "font_family": { "enum": ["default", "sans-serif", "serif", "dyslexia"] },
            "line_spacing": { "type": "number", "minimum": 1, "maximum": 3 },
            "letter_spacing": { "type": "number", "minimum": 0, "maximum": 0.5 },
            "word_spacing": { "type": "number", "minimum": 0, "maximum": 1 }
          }
        },
        "color_settings": {
          "type": "object",
          "properties": {
            "high_contrast": { "type": "boolean" },
            "invert_colors": { "type": "boolean" },
            "colorblind_filter": {
              "enum": ["none", "deuteranopia", "protanopia", "tritanopia"]
            },
            "theme": { "enum": ["light", "dark", "sepia", "custom"] }
          }
        },
        "reading_guide": {
          "type": "object",
          "properties": {
            "enabled": { "type": "boolean" },
            "type": { "enum": ["line_highlight", "ruler", "mask"] }
          }
        }
      }
    },
    "control_preferences": {
      "type": "object",
      "properties": {
        "input_method": {
          "enum": ["keyboard", "mouse", "touch", "voice", "eye_gaze", "switch", "bci"]
        },
        "timing": {
          "type": "object",
          "properties": {
            "extended_time_multiplier": { "type": "number", "minimum": 1, "maximum": 5 },
            "unlimited_time": { "type": "boolean" },
            "auto_advance_delay": { "type": "integer", "minimum": 0 }
          }
        },
        "click_settings": {
          "type": "object",
          "properties": {
            "target_size": { "enum": ["normal", "large", "x-large"] },
            "sticky_keys": { "type": "boolean" },
            "double_click_delay": { "type": "integer", "minimum": 0, "maximum": 2000 }
          }
        }
      }
    },
    "content_preferences": {
      "type": "object",
      "properties": {
        "captions": { "type": "boolean" },
        "transcripts": { "type": "boolean" },
        "audio_description": { "type": "boolean" },
        "sign_language": { "enum": ["none", "asl", "bsl", "ksl", "auslan", "other"] },
        "text_to_speech": {
          "type": "object",
          "properties": {
            "enabled": { "type": "boolean" },
            "voice": { "type": "string" },
            "rate": { "type": "number", "minimum": 0.5, "maximum": 2 }
          }
        },
        "simplification": {
          "type": "object",
          "properties": {
            "enabled": { "type": "boolean" },
            "reading_level": { "enum": ["basic", "intermediate", "advanced"] },
            "chunked_content": { "type": "boolean" }
          }
        }
      }
    },
    "assessment_accommodations": {
      "type": "object",
      "properties": {
        "extended_time": { "type": "boolean" },
        "time_multiplier": { "type": "number" },
        "breaks_allowed": { "type": "boolean" },
        "separate_location": { "type": "boolean" },
        "read_aloud": { "type": "boolean" },
        "scribe": { "type": "boolean" },
        "spell_check": { "type": "boolean" }
      }
    },
    "wia_integrations": {
      "type": "object",
      "properties": {
        "aac_profile_id": { "type": "string" },
        "bci_profile_id": { "type": "string" },
        "eye_gaze_profile_id": { "type": "string" },
        "sync_enabled": { "type": "boolean" }
      }
    }
  }
}

4.2 Course Schema

4.2.1 Complete Course Schema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://wiastandards.com/schemas/edu/course.schema.json",
  "title": "WIA EDU Course",
  "type": "object",
  "required": ["course_id", "schema_version", "title"],
  "properties": {
    "course_id": { "type": "string" },
    "schema_version": { "type": "string", "const": "1.0.0" },
    "title": { "type": "string" },
    "description": { "type": "string" },
    "accessibility_statement": {
      "type": "object",
      "properties": {
        "commitment": { "type": "string" },
        "wcag_conformance": { "enum": ["A", "AA", "AAA"] },
        "conformance_date": { "type": "string", "format": "date" },
        "known_issues": {
          "type": "array",
          "items": {
            "type": "object",
            "properties": {
              "description": { "type": "string" },
              "impact": { "enum": ["low", "medium", "high"] },
              "workaround": { "type": "string" }
            }
          }
        },
        "contact_email": { "type": "string", "format": "email" }
      }
    },
    "accommodations_available": {
      "type": "object",
      "properties": {
        "timing": {
          "type": "object",
          "properties": {
            "extended_time": { "type": "boolean" },
            "flexible_deadlines": { "type": "boolean" },
            "breaks": { "type": "boolean" }
          }
        },
        "format": {
          "type": "object",
          "properties": {
            "large_print": { "type": "boolean" },
            "braille": { "type": "boolean" },
            "audio": { "type": "boolean" },
            "sign_language": { "type": "boolean" }
          }
        },
        "support": {
          "type": "object",
          "properties": {
            "note_taking": { "type": "boolean" },
            "live_captioning": { "type": "boolean" },
            "interpreter": { "type": "boolean" }
          }
        }
      }
    },
    "udl_options": {
      "type": "object",
      "properties": {
        "engagement": {
          "type": "object",
          "properties": {
            "choice_available": { "type": "boolean" },
            "gamification": { "type": "boolean" },
            "collaboration_options": {
              "type": "array",
              "items": { "enum": ["individual", "pairs", "small_group", "class"] }
            }
          }
        },
        "representation": {
          "type": "object",
          "properties": {
            "modalities_available": {
              "type": "array",
              "items": { "enum": ["text", "audio", "video", "interactive", "tactile"] }
            }
          }
        },
        "action_expression": {
          "type": "object",
          "properties": {
            "response_formats": {
              "type": "array",
              "items": { "enum": ["written", "verbal", "multimedia", "demonstration"] }
            }
          }
        }
      }
    },
    "modules": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "module_id": { "type": "string" },
          "title": { "type": "string" },
          "content_items": { "type": "array", "items": { "type": "string" } }
        }
      }
    }
  }
}

4.3 Content Schema

4.3.1 Complete Content Schema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://wiastandards.com/schemas/edu/content.schema.json",
  "title": "WIA EDU Content",
  "type": "object",
  "required": ["content_id", "schema_version", "type"],
  "properties": {
    "content_id": { "type": "string" },
    "schema_version": { "type": "string", "const": "1.0.0" },
    "title": { "type": "string" },
    "type": {
      "enum": ["video", "audio", "text", "interactive", "image", "document", "assessment"]
    },
    "dublin_core": {
      "type": "object",
      "properties": {
        "creator": { "type": "string" },
        "publisher": { "type": "string" },
        "language": { "type": "string" },
        "rights": { "type": "string" }
      }
    },
    "accessibility": {
      "type": "object",
      "properties": {
        "accessibility_features": {
          "type": "array",
          "items": {
            "enum": [
              "captions", "transcript", "audio_description", "alternative_text",
              "structural_navigation", "sign_language", "braille", "tactile",
              "reading_order", "long_description", "synchronized_media"
            ]
          }
        },
        "accessibility_hazards": {
          "type": "array",
          "items": {
            "enum": ["no_flashing_hazard", "no_motion_simulation_hazard",
                     "no_sound_hazard", "flashing", "motion_simulation", "sound"]
          }
        },
        "access_mode": {
          "type": "array",
          "items": { "enum": ["auditory", "visual", "textual", "tactile"] }
        },
        "access_mode_sufficient": {
          "type": "array",
          "items": {
            "type": "array",
            "items": { "enum": ["auditory", "visual", "textual", "tactile"] }
          }
        },
        "wcag_conformance": {
          "type": "object",
          "properties": {
            "level": { "enum": ["A", "AA", "AAA"] },
            "version": { "type": "string" },
            "evaluation_date": { "type": "string", "format": "date" }
          }
        }
      }
    },
    "alternatives": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "type": { "enum": ["transcript", "captions", "audio_description",
                             "sign_language", "braille", "simplified"] },
          "language": { "type": "string" },
          "location": { "type": "string", "format": "uri" },
          "quality_verified": { "type": "boolean" }
        }
      }
    }
  }
}

4.4 Assessment Schema

4.4.1 Complete Assessment Schema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://wiastandards.com/schemas/edu/assessment.schema.json",
  "title": "WIA EDU Assessment",
  "type": "object",
  "required": ["assessment_id", "schema_version", "type"],
  "properties": {
    "assessment_id": { "type": "string" },
    "schema_version": { "type": "string", "const": "1.0.0" },
    "title": { "type": "string" },
    "type": { "enum": ["quiz", "exam", "assignment", "project", "discussion"] },
    "timing": {
      "type": "object",
      "properties": {
        "base_time_minutes": { "type": "integer" },
        "allows_extended_time": { "type": "boolean" },
        "allows_unlimited_time": { "type": "boolean" },
        "allows_breaks": { "type": "boolean" }
      }
    },
    "accommodations_available": {
      "type": "object",
      "properties": {
        "timing": {
          "type": "object",
          "properties": {
            "extended_time": { "type": "boolean" },
            "unlimited_time": { "type": "boolean" },
            "stop_clock_for_breaks": { "type": "boolean" },
            "flexible_scheduling": { "type": "boolean" }
          }
        },
        "presentation": {
          "type": "object",
          "properties": {
            "large_print": { "type": "boolean" },
            "high_contrast": { "type": "boolean" },
            "screen_reader": { "type": "boolean" },
            "text_to_speech": { "type": "boolean" },
            "braille": { "type": "boolean" },
            "sign_language_video": { "type": "boolean" },
            "line_reader": { "type": "boolean" }
          }
        },
        "response": {
          "type": "object",
          "properties": {
            "keyboard_only": { "type": "boolean" },
            "speech_to_text": { "type": "boolean" },
            "scribe": { "type": "boolean" },
            "spell_check": { "type": "boolean" },
            "audio_response": { "type": "boolean" }
          }
        },
        "setting": {
          "type": "object",
          "properties": {
            "separate_location": { "type": "boolean" },
            "small_group": { "type": "boolean" },
            "reduced_distractions": { "type": "boolean" }
          }
        }
      }
    },
    "questions": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "question_id": { "type": "string" },
          "type": { "enum": ["multiple_choice", "true_false", "short_answer",
                             "essay", "matching", "fill_blank"] },
          "accessibility": {
            "type": "object",
            "properties": {
              "screen_reader_hint": { "type": "string" },
              "cognitive_load": { "enum": ["low", "medium", "high"] },
              "requires_vision": { "type": "boolean" },
              "requires_hearing": { "type": "boolean" },
              "alternative_available": { "type": "boolean" }
            }
          }
        }
      }
    }
  }
}

4.5 Chapter Summary

Key Takeaways:

  1. Learner Profile: Comprehensive preferences for display, control, content, and AT
  2. Course Schema: Accessibility statements, accommodations, and UDL options
  3. Content Schema: AccessForAll DRD with features, hazards, and alternatives
  4. Assessment Schema: Timing, presentation, response, and setting accommodations
  5. All schemas follow JSON Schema draft 2020-12 for validation