🔄 Version Control

Understanding how UALS manages multiple versions of AI-generated content.

Version System Overview

UALS maintains up to 4 versions per content hash (competency + mode + config):

Version Structure

cache/class-{classId}/ke/{hash}/
├── 1/content.json    ← Version 1 (oldest)
├── 2/content.json    ← Version 2
├── 3/content.json    ← Version 3
├── 4/content.json    ← Version 4 (newest)
└── metadata.json     ← Active version, edit history

💡 Version Rotation When you have 4 versions and generate a new one, the oldest version is deleted to make room. Always keep important versions by editing them (creates a backup).

Setting Active Version

The active version is what students see. Only one version can be active per content item.

Find the Version

Navigate to the competency and content mode (KE/SPL/SATA) in the accordion.

Click [Set Active]

Click the "Set Active" button next to the version you want students to see.

Confirm

The version will now show a ⭐ ACTIVE indicator.

✅ Instant Switch Switching active versions is instant. Students will see the new version immediately on their next request. No regeneration needed.

Comparing Versions

Compare versions side-by-side to choose the best one:

Manual Comparison

Open Version 1 in View mode
Open Version 2 in a new tab
Compare key elements: accuracy, clarity, pedagogy

What to Compare

Aspect	Questions to Ask
Accuracy	Which version has fewer factual errors?
Clarity	Which explains concepts more clearly?
Engagement	Which is more interesting for students?
Difficulty	Which matches the proficiency level better?
Completeness	Which covers all required concepts?

A/B Testing with Versions

Use multiple versions to test different pedagogical approaches:

Example A/B Test

Week 1-2: Version 1 active (simple explanations)
Analyze: Students struggle (60% success rate)

Week 3-4: Switch to Version 3 (more scaffolding)
Analyze: Improvement (78% success rate)

Conclusion: Version 3 is better, keep active

How to Run an A/B Test

Generate Multiple Versions

Use the Cache Generation Wizard to create 4 different versions.

Set Version 1 Active

Start with one version and let students use it for 1-2 weeks.

Check Analytics

Review xAPI analytics for success rates, hint requests, time spent.

Switch to Version 2

Set a different version active and repeat for another 1-2 weeks.

Compare Results

Analyze which version produced better learning outcomes.

Rollback to Previous Version

If a new version has issues, you can instantly switch back:

Navigate to Version List

Find the content item in the accordion.

Select Previous Version

Find the last known good version.

Click [Set Active]

The previous version is immediately active.

💾 Nothing is Lost The problematic version is not deleted. It remains available for future editing or comparison. You can switch back anytime.

Deleting Versions

Remove versions that are no longer needed:

When to Delete

Content is completely wrong or inappropriate
Outdated information that shouldn't be used
Duplicate of another version
Need space for new generations

Deletion Rules

⚠️ Important Restrictions

Cannot delete the active version (switch first)
Deletion is permanent (no undo)
Deletion is logged for audit trail

Version Metadata

Each version stores metadata for tracking:

JSON

{
  "version": 2,
  "generatedAt": "2025-11-25T10:30:00Z",
  "editedBy": "teacher@school.edu",
  "lastEditedAt": "2025-11-25T14:45:00Z",
  "editCount": 3,
  "isActive": true,
  "generationConfig": {
    "proficiency_level": "2/3",
    "competency": "AI Ethics",
    "customPrompt": null
  }
}