feat(GAT-8233): DAR answer add new field (#1553)

Author: dnhdruk

app/Http/Controllers/Api/V1/UserDataAccessApplicationController.php

@@ -953,11 +953,13 @@ public function storeAnswers(CreateUserDataAccessApplicationAnswer $request, int
                         'question_id' => $answer['question_id'],
                         'application_id' => $id,
                     ])->delete();
+
                     DataAccessApplicationAnswer::create([
                         'question_id' => $answer['question_id'],
                         'application_id' => $id,
                         'answer' => $answer['answer'],
                         'contributor_id' => $jwtUser['id'],
+                        'answer_index' => isset($answer['answer_index']) ? $answer['answer_index'] : null,
                     ]);
                 }
             } else {

app/Http/Traits/DataAccessApplicationHelpers.php

@@ -130,6 +130,7 @@ public function updateDataAccessApplication(DataAccessApplication $application,
                 'application_id' => $id,
                 'answer' => $answer['answer'],
                 'contributor_id' => $input['applicant_id'],
+                'answer_index' => isset($answer['answer_index']) ? $answer['answer_index'] : null,
             ]);
         }
     }
@@ -162,6 +163,7 @@ public function editDataAccessApplication(DataAccessApplication $application, ar
                 'application_id' => $id,
                 'answer' => $answer['answer'],
                 'contributor_id' => $application->applicant_id,
+                'answer_index' => isset($answer['answer_index']) ? $answer['answer_index'] : null,
             ]);
         }
     }

app/Models/DataAccessApplicationAnswer.php

@@ -26,6 +26,7 @@ class DataAccessApplicationAnswer extends Model
         'application_id',
         'answer',
         'contributor_id',
+        'answer_index',
     ];
 
     protected $casts = [

app/Models/QuestionBankVersion.php

@@ -22,7 +22,6 @@ class QuestionBankVersion extends Model
      *
      * @var string
      */
-
     protected $table = 'question_bank_versions';
 
     public $timestamps = true;
@@ -47,25 +46,33 @@ class QuestionBankVersion extends Model
     /**
      * The question this version is associated with.
      */
-    public function question(): belongsTo
+    public function question(): BelongsTo
     {
         return $this->belongsTo(QuestionBank::class, 'question_id');
     }
 
     /**
-     * @return belongsToMany<QuestionBankVersion, $this>
+     * The child versions associated with this version.
+     *
+     * @return BelongsToMany<QuestionBankVersion, QuestionBankVersion>
      */
-    public function childVersions(): belongsToMany
+    public function childVersions(): BelongsToMany
     {
-        return $this->belongsToMany(
+        /** @var BelongsToMany<QuestionBankVersion, QuestionBankVersion> $relation */
+        $relation = $this->belongsToMany(
             QuestionBankVersion::class,
             'question_bank_version_has_child_version',
             'parent_qbv_id',
             'child_qbv_id'
         )->withPivot('condition');
+
+        return $relation;
     }
 
-    public function parentVersion(): belongsTo
+    /**
+     * The parent version associated with this version.
+     */
+    public function parentVersion(): BelongsTo
     {
         return $this->belongsTo(
             QuestionBankVersion::class,

database/migrations/2026_02_23_145530_add_answer_index_to_dar_application_answers_table.php

@@ -0,0 +1,27 @@
+<?php
+
+use Illuminate\Database\Migrations\Migration;
+use Illuminate\Database\Schema\Blueprint;
+use Illuminate\Support\Facades\Schema;
+
+return new class () extends Migration {
+    /**
+     * Run the migrations.
+     */
+    public function up(): void
+    {
+        Schema::table('dar_application_answers', function (Blueprint $table) {
+            $table->integer('answer_index')->nullable();
+        });
+    }
+
+    /**
+     * Reverse the migrations.
+     */
+    public function down(): void
+    {
+        Schema::table('dar_application_answers', function (Blueprint $table) {
+            $table->dropColumn('answer_index');
+        });
+    }
+};