How Users Create Trackable Work

• Step 1: choose a real module or function from the platform
• Step 2: choose the unit style the module allows, such as one round, one passage, one script attempt, or one review packet
• Step 3: set frequency or due timing from approved options
• Step 4: let the system generate the study item and attach completion rules automatically

UI Connection to the Progress System

• Module card: user chooses from real available learning surfaces
• Plan builder sheet: user selects scope, timing, and priority from structured controls
• Generated study item: dashboard and reminders show the created item as part of the progress system
• Completion event: actual learning flow sends validated events back to the tracker

Word List

Counts as: weak-item recovery surface and plan-builder option

• track weak-word backlog and recovery speed
• show backlog severity when threshold is exceeded
• allow optional use in normal mode and stronger prompting in recovery mode

Vocabulary Trainer

Counts as: core round and mastery engine, selectable in guided plan builder

• visualize book, level, round, word, and task layers
• show retries, pronunciation gate, and mastery status
• support daily units by round plus mastery

General Reading

Counts as: reading passage completion

• track passage finish, question set, time, and hint use
• never treat hint usage as failure
• show reading target progress as part of daily plan

Scenario Role-Play

Counts as: speaking completion plus improvement signal

• show score breakdown and change from previous attempt
• surface low-score word transfer into Word List
• make retries visible without over-rewarding spam

Daily Recital

Counts as: strongest natural recurring required unit

• should be visually treated as a streak anchor
• simple completion bar and today badge
• ideal location for supportive reminder loops

Recite Your Script

Counts as: assignment-like one-time speaking unit

• show teacher assignment, attempt count, and due state
• support bulk-upload classroom workflows
• make completion validity strict and auditable

Thinking Lab

Counts as: ordered multi-step lesson

• visualize step sequence and checklist completion
• should feel like progress along a path, not random tasks
• support current five-step flow first

ARI

Counts as: support signal, not primary completion by default

• track usage and session support value
• avoid falsely treating chat support as lesson completion
• show in adult digest as context, not as core discipline proof

AI DSE Reading

Counts as: exam-oriented reading completion

• support passage progress, hint usage, and due-state behavior
• treat it as a real progress surface, not an appendix
• prepare space for future group discussion logic

Urgency States

Overdue and stale should become more visible, but not emotionally aggressive. Use structure, highlighting, and recovery wording rather than shame.

Snooze vs Pause vs Rest

• Snooze: move one task out of today's immediate queue
• Pause: temporarily suppress due pressure for a chosen area
• Rest: broader recovery state protecting streak logic and mental load

Example Progress Activity

{
  "activity_id": "act_4839",
  "learner_id": "learner_102",
  "activity_surface": "reading_vocab",
  "activity_subsurface": "vocabulary_trainer",
  "activity_unit_type": "vocab_round",
  "display_name": "Vocabulary Trainer - Level 3 Round 2",
  "completion_rule_json": {
    "required_end_event": "round_completed",
    "minimum_words_mastered": 10
  },
  "validation_source": "server_module_event",
  "due_date": "2026-05-27",
  "tags": ["journey", "daily_goal", "focus_task"],
  "difficulty_band": "core",
  "focus_candidate_boolean": true,
  "status": "active",
  "urgency_state": "due_today"
}

Example Daily Snapshot

{
  "learner_id": "learner_102",
  "local_date": "2026-05-27",
  "scheduled_day_boolean": true,
  "minimum_goal_met": true,
  "all_due_tasks_completed": false,
  "perfect_day_boolean": false,
  "stars_earned_today": 3,
  "catch_up_required": false,
  "primary_surfaces_used": [
    "vocabulary_trainer",
    "daily_recital"
  ]
}

Example Adult Digest

{
  "digest_id": "dig_8112",
  "learner_id": "learner_102",
  "audience_type": "parent",
  "overall_status": "strong_effort_weak_mastery",
  "summary_text": "The learner is showing up, but weak-word recovery is lagging behind new vocabulary exposure.",
  "recommended_next_action": "Review 5 Word List items before optional speaking practice.",
  "weak_surface_list": ["word_list", "scenario_role_play_transfer"]
}

Example Validation Audit

{
  "validation_audit_id": "val_1921",
  "learner_id": "learner_102",
  "activity_id": "act_4839",
  "event_type": "activity_completed",
  "validation_result": "duplicate_ignored",
  "reason_code": "request_id_seen",
  "request_id": "req_9ad7f",
  "created_at": "2026-05-27T18:42:22Z"
}