From dc30bd827db10273e71419acd06fe52572952fb8 Mon Sep 17 00:00:00 2001
From: Patricia Romaniuc <romaniucpatricia@yahoo.com>
Date: Wed, 24 Dec 2025 14:24:25 +0100
Subject: [PATCH] feat(inline-dropdown): add trace log for scoring in outcome
 function PD-5436

---
 .../controller/src/__tests__/index.test.js    |  2 +-
 .../inline-dropdown/controller/src/index.js   | 71 ++++++++++++++++---
 2 files changed, 63 insertions(+), 10 deletions(-)

diff --git a/packages/inline-dropdown/controller/src/__tests__/index.test.js b/packages/inline-dropdown/controller/src/__tests__/index.test.js
index 0d157d5338..86efa34f0e 100644
--- a/packages/inline-dropdown/controller/src/__tests__/index.test.js
+++ b/packages/inline-dropdown/controller/src/__tests__/index.test.js
@@ -588,7 +588,7 @@ describe('controller', () => {
           sessionValue,
         );
 
-        expect(result).toEqual(expected);
+        expect(result).toEqual(expect.objectContaining(expected));
       });
     };
 
diff --git a/packages/inline-dropdown/controller/src/index.js b/packages/inline-dropdown/controller/src/index.js
index 8710043afc..6b6e13a271 100644
--- a/packages/inline-dropdown/controller/src/index.js
+++ b/packages/inline-dropdown/controller/src/index.js
@@ -196,6 +196,53 @@ export const getScore = (config, session) => {
   return parseFloat(str);
 };
 
+/**
+ * Generates detailed trace log for scoring evaluation
+ * @param {Object} model - the question model
+ * @param {Object} session - the student session
+ * @param {Object} env - the environment
+ * @returns {Array} traceLog - array of trace messages
+ */
+export const getLogTrace = (model, session, env) => {
+  const traceLog = [];
+  const { value = {} } = session || {};
+  const allCorrectResponses = getAllCorrectResponses(model);
+  const responseAreaKeys = Object.keys(allCorrectResponses);
+  const totalAreas = responseAreaKeys.length;
+  
+  traceLog.push(`${totalAreas} dropdown response area(s) defined in this question.`);
+  
+  if (value && Object.keys(value).length > 0) {
+    const selectedAreas = Object.entries(value).filter(([key, val]) => val && val.trim()).length;
+    traceLog.push(`Student selected options in ${selectedAreas} out of ${totalAreas} dropdown(s).`);
+    
+    responseAreaKeys.forEach((areaKey) => {
+      const studentSelection = (value && value[areaKey]) || '';
+      const correctOptions = allCorrectResponses[areaKey] || [];
+      
+      if (studentSelection.trim()) {
+        traceLog.push(`Dropdown ${parseInt(areaKey) + 1}: student selected '${studentSelection}' (correct options: [${correctOptions.map(opt => `'${opt}'`).join(', ')}]).`);
+      } else {
+        traceLog.push(`Dropdown ${parseInt(areaKey) + 1}: no selection made (correct options: [${correctOptions.map(opt => `'${opt}'`).join(', ')}]).`);
+      }
+    });
+  } else {
+    traceLog.push('Student did not make any selections in the dropdowns.');
+  }
+
+  const partialScoringEnabled = partialScoring.enabled(model, env);
+  traceLog.push(
+    `Scoring method: ${
+      partialScoringEnabled ? 'partial scoring' : 'all-or-nothing scoring'
+    }.`
+  );
+
+  const score = getScore(model, session);
+  traceLog.push(`Final score: ${score}.`);
+
+  return traceLog;
+}
+
 /**
  *
  * The score is partial by default for checkbox mode, allOrNothing for radio mode.
@@ -211,16 +258,22 @@ export const getScore = (config, session) => {
 export function outcome(model, session, env = {}) {
   return new Promise((resolve) => {
     if (!session || isEmpty(session)) {
-      resolve({ score: 0, empty: true });
-    }
-
-    const partialScoringEnabled = partialScoring.enabled(model, env);
-    const score = getScore(model, session);
+      resolve({ 
+        score: 0, 
+        empty: true, 
+        traceLog: ['Student did not make any selections in the dropdowns. Score is 0.'] 
+      });
+    } else {
+      const traceLog = getLogTrace(model, session, env);
+      const score = getScore(model, session);
+      const partialScoringEnabled = partialScoring.enabled(model, env);
 
-    resolve({
-      score: partialScoringEnabled ? score : Math.floor(score),
-      empty: false,
-    });
+      resolve({
+        score: partialScoringEnabled ? score : Math.floor(score),
+        empty: false,
+        traceLog
+      });
+    }
   });
 }