v3.0.2: Survey editor, specific source pills, rating scale labels

Survey question editor:
- New admin page (survey_admin.php) for editing survey questions
- Supports global default and per-course survey overrides
- Add, edit, delete, reorder questions via drag or arrow buttons
- Question types: multiple choice (with options editor), open text, rating scale
- Rating scale supports min/max labels (e.g. "Not at all" / "Very happy")
- Live preview button shows how students will see the survey
- Course scope selector to switch between global and per-course surveys
- Reset to defaults / remove course override actions
- Registered in Moodle admin menu, linked from plugin settings

Rating question fix:
- Question 5 now reads "(1 = not at all, 5 = very happy)"
- Rating UI shows min/max text labels next to the number buttons
- DB migration updates existing surveys with scale labels

Specific source attribution:
- Source pills show activity name instead of generic "From: Course Materials"
- AI cites specific activities using cmid from course structure
- SSE meta event includes modules map for URL/title lookup

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

Author: caswelltom

amd/build/ui.min.js

@@ -4160,10 +4160,17 @@ define([
                 inputs.push({type: 'multiple_choice', index: idx, container: optContainer});
 
             } else if (q.type === 'rating') {
+                var ratingWrap = document.createElement('div');
                 var ratingRow = document.createElement('div');
                 ratingRow.style.cssText = 'display:flex;gap:8px;align-items:center';
                 var min = q.min || 1;
                 var max = q.max || 5;
+                if (q.min_label) {
+                    var minLbl = document.createElement('span');
+                    minLbl.style.cssText = 'font-size:11px;color:#94a3b8;white-space:nowrap';
+                    minLbl.textContent = q.min_label;
+                    ratingRow.appendChild(minLbl);
+                }
                 for (var r = min; r <= max; r++) {
                     (function(val) {
                         var btn = document.createElement('button');
@@ -4185,7 +4192,14 @@ define([
                         ratingRow.appendChild(btn);
                     })(r);
                 }
-                qDiv.appendChild(ratingRow);
+                if (q.max_label) {
+                    var maxLbl = document.createElement('span');
+                    maxLbl.style.cssText = 'font-size:11px;color:#94a3b8;white-space:nowrap';
+                    maxLbl.textContent = q.max_label;
+                    ratingRow.appendChild(maxLbl);
+                }
+                ratingWrap.appendChild(ratingRow);
+                qDiv.appendChild(ratingWrap);
                 inputs.push({type: 'rating', index: idx, container: ratingRow});
 
             } else {

amd/build/ui.min.js.map

@@ -52,9 +52,11 @@ class survey_manager {
         ],
         [
             'type' => 'rating',
-            'text' => 'Overall, how happy were you with the AI tutor?',
+            'text' => 'Overall, how happy were you with the AI tutor? (1 = not at all, 5 = very happy)',
             'min' => 1,
             'max' => 5,
+            'min_label' => 'Not at all',
+            'max_label' => 'Very happy',
         ],
     ];
 

amd/src/ui.js

@@ -299,5 +299,31 @@ function xmldb_local_ai_course_assistant_upgrade($oldversion) {
         upgrade_plugin_savepoint(true, 2026031200, 'local', 'ai_course_assistant');
     }
 
+    // v3.0.2: Update default survey rating question to include scale labels.
+    if ($oldversion < 2026031202) {
+        $surveys = $DB->get_records('local_ai_course_assistant_surveys');
+        foreach ($surveys as $survey) {
+            $questions = json_decode($survey->questions, true);
+            if (!is_array($questions)) {
+                continue;
+            }
+            $changed = false;
+            foreach ($questions as &$q) {
+                if (($q['type'] ?? '') === 'rating' && strpos($q['text'], '1 = ') === false) {
+                    $q['text'] = $q['text'] . ' (1 = not at all, 5 = very happy)';
+                    $q['min_label'] = 'Not at all';
+                    $q['max_label'] = 'Very happy';
+                    $changed = true;
+                }
+            }
+            unset($q);
+            if ($changed) {
+                $DB->set_field('local_ai_course_assistant_surveys', 'questions',
+                    json_encode($questions), ['id' => $survey->id]);
+            }
+        }
+        upgrade_plugin_savepoint(true, 2026031202, 'local', 'ai_course_assistant');
+    }
+
     return true;
 }

classes/survey_manager.php

@@ -675,7 +675,8 @@
     $settings->add(new admin_setting_heading(
         'local_ai_course_assistant/survey_heading',
         'Student Survey',
-        'Configure the in-chat student experience survey. Surveys can be customized per course via the analytics dashboard.'
+        'Configure the in-chat student experience survey. '
+        . '<a href="' . (new moodle_url('/local/ai_course_assistant/survey_admin.php'))->out() . '" class="btn btn-sm btn-outline-primary ml-2">Edit Survey Questions &rarr;</a>'
     ));
 
     $settings->add(new admin_setting_configcheckbox(
@@ -716,6 +717,14 @@
         'moodle/site:config'
     ));
 
+    // Register the Survey Editor admin page.
+    $ADMIN->add('localplugins', new admin_externalpage(
+        'local_ai_course_assistant_survey',
+        'SOLA Survey Editor',
+        new moodle_url('/local/ai_course_assistant/survey_admin.php'),
+        'moodle/site:config'
+    ));
+
     // Register the RAG admin page as a separate entry in the admin menu.
     $ADMIN->add('localplugins', new admin_externalpage(
         'local_ai_course_assistant_ragadmin',