extended metadata on questionnaires

lib/submissions.php

@@ -131,7 +131,10 @@ function qdb_record_submission_after_submit(
     int $structureRevision = 1,
     ?array $structureManifest = null,
     ?array $questionIdsToCopy = null,
-    ?int $submittedAt = null
+    ?int $submittedAt = null,
+    ?int $programCycleNumber = null,
+    ?string $programSessionID = null,
+    ?int $programSessionNumber = null
 ): string {
     $version = qdb_next_submission_version($pdo, $clientCode, $questionnaireID);
     $submissionID = bin2hex(random_bytes(16));
@@ -155,11 +158,13 @@ function qdb_record_submission_after_submit(
             submissionID, clientCode, questionnaireID, version, submittedAt,
             submittedByUserID, submittedByRole, assignedByCoach,
             status, startedAt, completedAt, sumPoints,
+            programCycleNumber, programSessionID, programSessionNumber,
             structureRevision, structureSnapshotJson
         ) VALUES (
             :sid, :cc, :qn, :ver, :sat,
             :uid, :role, :abc,
             :st, :sa, :ca, :sp,
+            :pcn, :psid, :psn,
             :srev, :snap
         )'
     )->execute([
@@ -175,6 +180,9 @@ function qdb_record_submission_after_submit(
         ':sa'   => $startedAt,
         ':ca'   => $completedAt,
         ':sp'   => $sumPoints,
+        ':pcn'  => $programCycleNumber,
+        ':psid' => $programSessionID,
+        ':psn'  => $programSessionNumber,
         ':srev' => max(1, $structureRevision),
         ':snap' => $snapshotJson,
     ]);