# Remote Reviewer xAPI Profile

Version: 1.3.0  
Canonical Profile JSON-LD: `https://app.remotereviewer.com.au/xapiprofile/profile.jsonld`  
Human-readable page: `https://app.remotereviewer.com.au/xapiprofile/`

## Purpose

This profile describes the xAPI statements actually emitted by Remote Reviewer for:

- media playback interactions
- reviewer comments
- checklist or task-set checks
- transcript storage
- AI report storage
- annotated media artefact storage

It is intended to load cleanly in xAPI profile viewers such as `https://tools.xapi.ly/profiles/#/` and to provide readable labels and definitions for the custom Remote Reviewer vocabulary used in emitted statements.

## Canonical Resources

- JSON-LD download: [profile.jsonld](profile.jsonld)
- Human-readable landing page: [index.html](index.html)
- Example statements: [examples/](examples/)

## Alignment Notes

This profile has been aligned to the application’s emitted statement IRIs in `app/Services/XapiService.php`.

The published RR profile follows the current xAPI Profiles 1.0 JSON-LD shape used by the ongoing IEEE xAPI Profiles work, while keeping the standard profile identifiers used in profile documents:

- `@context`: `https://w3id.org/xapi/profiles/context`
- `conformsTo`: `https://w3id.org/xapi/profiles#1.0`
- current specification source: `https://opensource.ieee.org/xapi/xapi-profiles/-/blob/main/xapi-profiles-about.md`

Important corrections made in version `1.2.0`:

- the canonical profile identifier now points to the downloadable JSON-LD profile document
- the app’s profile category reference now points to that canonical profile JSON-LD URL
- the profile now uses the same verb and extension IRIs the app actually emits
- the previous mismatch between documented RR custom verbs and emitted DOD-ISD / RR IRIs has been removed
- `seeAlso` now points to a real human-readable document
- the published profile now covers the full emitted set, including `initialized`, `completed`, `voided`, attachments, playback extensions, reviewer/runtime context, transcript storage, AI reports, and annotated artefacts

Added in version `1.3.0`:

- new RR-native verb `http://id.remotereviewer.com.au/verb/redacted` for the background face-blur feature, replacing the previously emitted non-existent `https://w3id.org/xapi/dod-isd/verbs/redacted` IRI (the DOD-ISD vocabulary has no `redacted` verb). The new IRI follows the same `http://id.remotereviewer.com.au/verb/<name>` pattern as `savetranscript`.
- new result extension `http://id.remotereviewer.com.au/extension/face_blur` carrying the blur strategy, blurred-region count, attempt, and trigger metadata
- new `Face-blur redaction` statement template

## Main Vocabulary Covered

### Verbs

- `http://adlnet.gov/expapi/verbs/commented`
- `https://w3id.org/xapi/dod-isd/verbs/checked`
- `https://w3id.org/xapi/dod-isd/verbs/stored`
- `http://id.remotereviewer.com.au/verb/savetranscript`
- `http://id.remotereviewer.com.au/verb/redacted`
- `https://w3id.org/xapi/video/verbs/played`
- `https://w3id.org/xapi/video/verbs/paused`
- `https://w3id.org/xapi/video/verbs/seeked`

### Activity Types

- `https://w3id.org/xapi/video/activity-type/video`
- `https://w3id.org/xapi/audio/activity-type/audio`

### Remote Reviewer Extensions

- `http://id.remotereviewer.com.au/extension/rr`
- `http://id.remotereviewer.com.au/extension/reviewer`
- `http://id.remotereviewer.com.au/extension/current-working-attempt`
- `http://id.remotereviewer.com.au/extension/media-path`
- `http://id.remotereviewer.com.au/extension/savetranscript`
- `http://id.remotereviewer.com.au/extension/ai_report`
- `http://id.remotereviewer.com.au/extension/ai_report_model`
- `http://id.remotereviewer.com.au/extension/markup_uuid`
- `http://id.remotereviewer.com.au/extension/markup_type`
- `http://id.remotereviewer.com.au/extension/markup_colour`
- `http://id.remotereviewer.com.au/extension/markup_geometry`
- `http://id.remotereviewer.com.au/extension/markup_stroke_width`
- `http://id.remotereviewer.com.au/extension/annotated_video_asset`
- `http://id.remotereviewer.com.au/extension/face_blur`

## Viewer Usage

You can inspect the RR profile in the xAPI profiles viewer by loading:

`https://app.remotereviewer.com.au/xapiprofile/profile.jsonld`

## Download

The JSON-LD file is intended to be directly downloadable from:

`/xapiprofile/profile.jsonld`