Create Model for Term Of Use acceptance

app/Jobs/UserCreateJob.php

@@ -2,7 +2,9 @@
 
 namespace App\Jobs;
 
+use App\TermsOfUseVersion;
 use App\User;
+use App\UserTermsOfUseAcceptance;
 use Illuminate\Support\Facades\Hash;
 
 class UserCreateJob extends Job {
@@ -30,6 +32,12 @@ public function handle() {
             'verified' => $this->verified,
         ]);
 
+        UserTermsOfUseAcceptance::create([
+            'user_id' => $user->id,
+            'tou_version' => TermsOfUseVersion::latest(),
+            'tou_accepted_at' => now(),
+        ]);
+
         return $user;
     }
 }

app/Jobs/UserTouAcceptanceJob.php

@@ -0,0 +1,42 @@
+<?php
+
+namespace App\Jobs;
+
+use App\TermsOfUseVersion;
+use App\User;
+use App\UserTermsOfUseAcceptance;
+use Illuminate\Bus\Batchable;
+use Illuminate\Bus\Queueable;
+use Illuminate\Contracts\Queue\ShouldQueue;
+use Illuminate\Foundation\Bus\Dispatchable;
+use Illuminate\Queue\InteractsWithQueue;
+use Illuminate\Queue\Middleware\WithoutOverlapping;
+use Illuminate\Queue\SerializesModels;
+use Illuminate\Support\Facades\Log;
+use Throwable;
+
+class UserTouAcceptanceJob extends Job {
+    use Batchable;
+    use Dispatchable;
+
+    private $users;
+
+    public function __construct($users) {
+        $this->users = $users;
+    }
+    public function handle(): void {
+        $this->users = User::all();
+        foreach ($this->users as $user) {
+            try {
+                UserTermsOfUseAcceptance::create([
+                    'user_id' => $user->id,
+                    'tou_version' => TermsOfUseVersion::latest(),
+                    'tou_accepted_at' => $user->created_at,
+                ]);
+            } catch (Throwable $exception) {
+                Log::error('Failure processing user ' . $user->getAttribute('email') . ' for UserTouAcceptanceJob: ' . $exception->getMessage());
+                $this->fail($exception);
+            }
+        }
+    }
+}

app/TermsOfUseVersion.php

@@ -0,0 +1,26 @@
+<?php
+
+namespace App;
+
+enum TermsOfUseVersion: string {
+    // case v2 = 'yyyy-mm-dd';
+    // case v1 = 'yyyy-mm-dd';
+    case v0 = '2025-08-21';
+
+    public static function latest(): self {
+        $latestVersion = self::v0;
+        $latestNum = 0;
+        foreach (self::cases() as $case) {
+            if (!str_starts_with($case->name, 'v')) {
+                continue;
+            }
+            $n = (int) substr($case->name, 1);
+            if ($n > $latestNum) {
+                $latestNum = $n;
+                $latestVersion = $case;
+            }
+        }
+
+        return $latestVersion;
+    }
+}

app/User.php

@@ -98,6 +98,10 @@ public function managesWikis(): \Illuminate\Database\Eloquent\Relations\BelongsT
         return $this->belongsToMany(Wiki::class, 'wiki_managers');
     }
 
+    public function touAcceptances(): \Illuminate\Database\Eloquent\Relations\BelongsToMany {
+        return $this->belongsToMany(UserTermsOfUseAcceptance::class, 'tou_acceptances');
+    }
+
     public function hasVerifiedEmail() {
         return (bool) $this->verified;
     }

app/UserTermsOfUseAcceptance.php

@@ -0,0 +1,27 @@
+<?php
+
+namespace App;
+
+use Illuminate\Database\Eloquent\Factories\HasFactory;
+use Illuminate\Database\Eloquent\Model;
+
+class UserTermsOfUseAcceptance extends Model {
+    use HasFactory;
+
+    const FIELDS = [
+        'user_id',
+        'tou_version',
+        'tou_accepted_at',
+    ];
+
+    protected $fillable = self::FIELDS;
+
+    protected $visible = self::FIELDS;
+
+    protected $casts = [
+        'tou_version' => TermsOfUseVersion::class,
+        'tou_accepted_at' => 'datetime',
+    ];
+
+    protected $table = 'tou_acceptances';
+}

database/migrations/2025_09_29_194758_tou_acceptances.php

@@ -0,0 +1,29 @@
+<?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('tou_acceptances', function (Blueprint $table) {
+            $table->id();
+            $table->unsignedInteger('user_id');
+            $table->string('tou_version', 10);
+            $table->timestamp('tou_accepted_at');
+            $table->timestamps();
+            $table->unique(['user_id', 'tou_version']);
+            $table->foreign('user_id')->references('id')->on('users')->cascadeOnDelete();
+        });
+    }
+
+    /**
+     * Reverse the migrations.
+     */
+    public function down(): void {
+        Schema::dropIfExists('tou_acceptances');
+    }
+};

tests/Jobs/UserTouAcceptanceJobTest.php

@@ -0,0 +1,37 @@
+<?php
+
+namespace Tests\Unit\Jobs;
+
+use App\Jobs\UserTouAcceptanceJob;
+use App\TermsOfUseVersion;
+use App\User;
+use App\UserTermsOfUseAcceptance;
+use Illuminate\Foundation\Testing\RefreshDatabase;
+use Illuminate\Support\Carbon;
+use Tests\TestCase;
+
+class UserTouAcceptanceJobTest extends TestCase{
+    use RefreshDatabase;
+
+    public function testTouAcceptanceJob(): void{
+        $t1 = Carbon::parse('2025-01-01 10:00:00');
+        $t2 = Carbon::parse('2025-01-02 11:00:00');
+        $t3 = Carbon::parse('2025-01-03 12:00:00');
+
+        $u1 = User::factory()->create(['created_at' => $t1]);
+        $u2 = User::factory()->create(['created_at' => $t2]);
+        $u3 = User::factory()->create(['created_at' => $t3]);
+
+        (new UserTouAcceptanceJob([]))->handle();
+
+        $latest = TermsOfUseVersion::latest()->value;
+
+        $this->assertDatabaseHas('tou_acceptances', ['user_id' => $u1->id, 'tou_version' => $latest]);
+        $this->assertDatabaseHas('tou_acceptances', ['user_id' => $u2->id, 'tou_version' => $latest]);
+        $this->assertDatabaseHas('tou_acceptances', ['user_id' => $u3->id, 'tou_version' => $latest]);
+
+        $this->assertTrue($t1->equalTo(UserTermsOfUseAcceptance::where('user_id', $u1->id)->firstOrFail()->tou_accepted_at));
+        $this->assertTrue($t2->equalTo(UserTermsOfUseAcceptance::where('user_id', $u2->id)->firstOrFail()->tou_accepted_at));
+        $this->assertTrue($t3->equalTo(UserTermsOfUseAcceptance::where('user_id', $u3->id)->firstOrFail()->tou_accepted_at));
+    }
+}

tests/Routes/User/UserTermsOfUseAcceptanceTest.php

@@ -0,0 +1,31 @@
+<?php
+
+namespace Tests\Routes\User;
+
+use App\Jobs\UserCreateJob;
+use App\TermsOfUseVersion;
+use App\UserTermsOfUseAcceptance;
+use Illuminate\Foundation\Testing\RefreshDatabase;
+use Tests\TestCase;
+
+class UserTermsOfUseAcceptanceTest extends TestCase {
+    use RefreshDatabase;
+
+    public function testUserCreationCreatesTouAcceptance(): void {
+        $email = 'test+' . uniqid('', true) . '@example.com';
+        $user = (new UserCreateJob($email, 'thisisapassword123', true))->handle();
+
+        $this->assertDatabaseHas('tou_acceptances', [
+            'user_id' => $user->id,
+            'tou_version' => TermsOfUseVersion::latest()->value,
+        ]);
+
+        $rows = UserTermsOfUseAcceptance::where('user_id', $user->id)->get();
+        $this->assertCount(1, $rows);
+        $acceptance = $rows->first();
+
+        $this->assertInstanceOf(TermsOfUseVersion::class, $acceptance->tou_version);
+        $this->assertSame(TermsOfUseVersion::latest(), $acceptance->tou_version);
+        $this->assertNotNull($acceptance->tou_accepted_at);
+    }
+}