KnowledgeEquityResponse Model and Migration

Adds a Model, Migration and some happy path tests.

n.b. this uses the laravel Blueprint[1] rather than manually defining tables and columns.

[1] https://laravel.com/docs/10.x/migrations

Bug: T419209

Author: tarrow

app/KnowledgeEquityResponse.php

@@ -0,0 +1,21 @@
+<?php
+
+namespace App;
+
+use Illuminate\Database\Eloquent\Factories\HasFactory;
+use Illuminate\Database\Eloquent\Model;
+use Illuminate\Database\Eloquent\Relations\BelongsTo;
+
+class KnowledgeEquityResponse extends Model {
+    use HasFactory;
+
+    protected $fillable = [
+        'wiki_id',
+        'selectedOption',
+        'freeTextResponse',
+    ];
+
+    public function wiki(): BelongsTo {
+        return $this->belongsTo(Wiki::class);
+    }
+}

database/migrations/2026_03_06_160019_create_knowledge_equity_responses_table.php

@@ -0,0 +1,35 @@
+<?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::create('knowledge_equity_responses', function (Blueprint $table) {
+            $table->id();
+            $table->timestamps();
+            $table->unsignedInteger('wiki_id');
+            $table
+                ->foreign('wiki_id')
+                ->references('id')
+                ->on('wikis')
+                // Explicitly use the eloquent default options.
+                // restrict rather than cascading chosen to not result in unexpectedly deleting Knowledge Equity Responses when we delete a wiki
+                ->restrictOnDelete()
+                ->restrictOnUpdate();
+            $table->enum('selectedOption', ['yes', 'no', 'unsure', 'unsaid']);
+            $table->string('freeTextResponse', 3000)->nullable();
+        });
+    }
+
+    /**
+     * Reverse the migrations.
+     */
+    public function down(): void {
+        Schema::dropIfExists('knowledge_equity_responses');
+    }
+};

tests/KnowledgeEquityResponseTest.php

@@ -0,0 +1,80 @@
+<?php
+
+namespace Tests;
+
+use App\KnowledgeEquityResponse;
+use App\Wiki;
+use Illuminate\Database\QueryException;
+use Illuminate\Foundation\Testing\RefreshDatabase;
+use Str;
+
+class KnowledgeEquityResponseTest extends TestCase {
+    use RefreshDatabase;
+
+    protected Wiki $wiki;
+
+    protected function setUp(): void {
+        parent::setUp();
+        $this->wiki = Wiki::factory()->create();
+    }
+
+    public function testCreateValidKnowledgeEquityResponse(): void {
+        $knowledgeEquityResponse = new KnowledgeEquityResponse([
+            'wiki_id' => $this->wiki->id,
+            'selectedOption' => 'yes',
+            'freeTextResponse' => 'Because it just does',
+        ]);
+
+        $knowledgeEquityResponse->save();
+
+        $this->assertDatabaseHas('knowledge_equity_responses', [
+            'wiki_id' => $this->wiki->id,
+            'selectedOption' => 'yes',
+            'freeTextResponse' => 'Because it just does',
+        ]);
+    }
+
+    public function testCreateValidKnowledgeEquityResponseNoFreeText(): void {
+        $knowledgeEquityResponse = new KnowledgeEquityResponse([
+            'wiki_id' => $this->wiki->id,
+            'selectedOption' => 'yes',
+        ]);
+
+        $knowledgeEquityResponse->save();
+
+        $this->assertDatabaseHas('knowledge_equity_responses', [
+            'wiki_id' => $this->wiki->id,
+            'selectedOption' => 'yes',
+        ]);
+    }
+
+    public function testCreateValidKnowledgeEquityResponse3000CharFreeText(): void {
+        $longFreeText = Str::random(3000);
+        $knowledgeEquityResponse = new KnowledgeEquityResponse([
+            'wiki_id' => $this->wiki->id,
+            'selectedOption' => 'yes',
+            'freeTextResponse' => $longFreeText,
+        ]);
+
+        $knowledgeEquityResponse->save();
+
+        $this->assertDatabaseHas('knowledge_equity_responses', [
+            'wiki_id' => $this->wiki->id,
+            'selectedOption' => 'yes',
+        ]);
+    }
+
+    public function testDeleteValidKnowledgeEquityResponsePreventsWikiDeletion(): void {
+        $knowledgeEquityResponse = new KnowledgeEquityResponse([
+            'wiki_id' => $this->wiki->id,
+            'selectedOption' => 'yes',
+        ]);
+
+        $knowledgeEquityResponse->save();
+
+        $this->wiki->delete();
+        $this->assertThrows(function () {
+            $this->wiki->forceDelete();
+        }, QueryException::class);
+    }
+}