Managing Content Experts

What Content Experts Can Do

Inviting Content Experts

UI Workflow (Recommended)

API Workflow

POST /api/school/class/{classId}/invite-expert
Authorization: Bearer {token}
Content-Type: application/json

{
  "email": "expert@university.edu"
}

async function inviteContentExpert(classId, expertEmail) {
  const response = await fetch(`/api/school/class/${classId}/invite-expert`, {
    method: 'POST',
    credentials: 'include',
    headers: { 'Content-Type': 'application/json' },
    body: JSON.stringify({ email: expertEmail })
  });

  if (!response.ok) {
    const error = await response.json();
    throw new Error(error.error || 'Failed to invite expert');
  }

  const result = await response.json();
  console.log('Expert invited:', result.class.contentExperts);
  return result.class;
}

await inviteContentExpert('class-ailc-abc123', 'expert@university.edu');

Success Response

{
  "success": true,
  "class": {
    "id": "class-ailc-abc123",
    "title": "AI Literacy - Fall 2025",
    "teacherEmail": "owner@school.edu",
    "contentExperts": ["expert@university.edu"],
    ...
  }
}

Content Expert Dashboard View

When a teacher is invited as a content expert, they will see a new section on their dashboard titled "Content Expert Invitations".

What Experts See

Accessing Content Editor

Removing Content Experts

Class owners can remove content experts at any time. This immediately revokes their editing access.

UI Workflow

API Workflow

POST /api/school/class/{classId}/remove-expert
Authorization: Bearer {token}
Content-Type: application/json

{
  "email": "expert@university.edu"
}

async function removeContentExpert(classId, expertEmail) {
  if (!confirm(`Remove ${expertEmail} as content expert?`)) {
    return;
  }

  const response = await fetch(`/api/school/class/${classId}/remove-expert`, {
    method: 'POST',
    credentials: 'include',
    headers: { 'Content-Type': 'application/json' },
    body: JSON.stringify({ email: expertEmail })
  });

  if (!response.ok) {
    throw new Error('Failed to remove expert');
  }

  const result = await response.json();
  console.log('Expert removed. Updated list:', result.class.contentExperts);
  return result.class;
}

await removeContentExpert('class-ailc-abc123', 'expert@university.edu');

What Happens When an Expert is Removed

• Expert's email removed from contentExperts array in xAPI statement
• Class no longer appears in expert's "Content Expert Invitations" section
• Expert loses access to content editor for this class
• Expert's previous edits remain in version history (audit trail preserved)
• Owner can re-invite the same expert later if needed

Content Versioning & Collaboration

All content edits by experts are versioned and tracked in Google Cloud Storage (GCS) with full metadata about who made changes and when.

Version Control System

GCS Folder Structure

uals-storage/cache/
└── class-{classId}/
    ├── ke/                       # Knowledge Explorer
    │   └── {hash}/
    │       ├── 1/content.json   # Version 1
    │       ├── 2/content.json   # Version 2
    │       ├── 3/content.json   # Version 3
    │       └── 4/content.json   # Version 4 (newest)
    ├── spl/                      # Socratic Playground
    │   └── {hash}/
    │       └── [1-4]/content.json
    └── sata/                     # SBCAT Assessments
        └── {hash}/
            └── [1-4]/content.json

Version Metadata Example

{
  "hash": "a1b2c3d4e5f6",
  "system": "ke",
  "classId": "class-ailc-abc123",
  "versions": [
    {
      "versionNumber": 1,
      "createdAt": "2025-11-01T10:00:00.000Z",
      "createdBy": "owner@school.edu",
      "createdByName": "Dr. Jane Smith"
    },
    {
      "versionNumber": 2,
      "createdAt": "2025-11-15T14:30:00.000Z",
      "createdBy": "expert@university.edu",
      "createdByName": "Prof. John Doe"
    }
  ],
  "activeVersion": 2
}

Collaboration Best Practices

Communication Strategies

Common Issues

Expert Can't Access Content Editor

Possible Causes & Solutions:

1. Email mismatch: Verify the expert is logging in with the exact email address used in the invitation (case-sensitive).
2. Removed from list: Check if the expert was removed from the contentExperts array by the owner.
3. Cache issue: Expert should refresh the dashboard to see updated invitation list.
4. Owner changed: If ownership was transferred, the new owner must re-invite the expert (invitations don't transfer with ownership).

Duplicate Invitations

Solution:

The system should prevent duplicates, but if this occurs, remove all instances via API and re-invite once.

Expert's Edits Not Appearing

Possible Causes & Solutions:

1. Version not active: Check which version is set as active. Expert may have created a new version without marking it active.
2. Different content hash: If config changed, edits may be on a different hash. Check version history.
3. GCS sync delay: Allow 1-2 seconds for GCS write operations to complete, then refresh.