feat: `histories` table

app/HasHistory.php

@@ -0,0 +1,11 @@
+<?php
+
+namespace App;
+
+trait HasHistory
+{
+    public static function bootHasHistory()
+    {
+        static::observe(HistoryObserver::class);
+    }
+}

app/HistoryAction.php

@@ -0,0 +1,10 @@
+<?php
+
+namespace App;
+
+enum HistoryAction: string
+{
+    case Insert = 'insert';
+    case Update = 'update';
+    case Delete = 'delete';
+}

app/HistoryObserver.php

@@ -0,0 +1,40 @@
+<?php
+
+namespace App;
+use App\Models\History;
+
+class HistoryObserver
+{
+    public function created($model)
+    {
+        History::create([
+            'model_id' => $model->id,
+            'model_name' => $model->getTable(),
+            'before' => null,
+            'after' => $model->toArray(),
+            'action' => HistoryAction::Insert,
+        ]);
+    }
+
+    public function updating($model)
+    {
+        History::create([
+            'model_id' => $model->id,
+            'model_name' => $model->getTable(),
+            'before' => $model->getRawOriginal(),
+            'after' => $model->getAttributes(),
+            'action' => HistoryAction::Update,
+        ]);
+    }
+
+    public function deleting($model)
+    {
+        History::create([
+            'model_id' => $model->id,
+            'model_name' => $model->getTable(),
+            'before' => $model->getRawOriginal(),
+            'after' => null,
+            'action' => HistoryAction::Delete,
+        ]);
+    }
+}

app/Models/History.php

@@ -0,0 +1,30 @@
+<?php
+
+namespace App\Models;
+
+use App\HistoryAction;
+use App\UuidId;
+use Illuminate\Database\Eloquent\Factories\HasFactory;
+use Illuminate\Database\Eloquent\Model;
+
+class History extends Model
+{
+    use HasFactory, UuidId;
+
+    protected $fillable = [
+        'model_id',
+        'model_name',
+        'before',
+        'after',
+        'action',
+    ];
+
+    protected function casts()
+    {
+        return [
+            'action' => HistoryAction::class,
+            'before' => 'array',
+            'after' => 'array',
+        ];
+    }
+}

app/Models/User.php

@@ -3,15 +3,15 @@
 namespace App\Models;
 
 // use Illuminate\Contracts\Auth\MustVerifyEmail;
+use App\HasHistory;
 use App\UuidId;
 use Illuminate\Database\Eloquent\Factories\HasFactory;
 use Illuminate\Foundation\Auth\User as Authenticatable;
 use Illuminate\Notifications\Notifiable;
-use Infocyph\UID\UUID;
 
 class User extends Authenticatable
 {
-    use HasFactory, Notifiable, UuidId;
+    use HasFactory, Notifiable, UuidId, HasHistory;
 
     /**
      * The attributes that are mass assignable.

database/migrations/0001_01_01_000000_create_users_table.php

@@ -2,6 +2,7 @@
 
 use Illuminate\Database\Migrations\Migration;
 use Illuminate\Database\Schema\Blueprint;
+use Illuminate\Database\Schema\Builder;
 use Illuminate\Support\Facades\Schema;
 
 return new class extends Migration
@@ -11,6 +12,8 @@ return new class extends Migration
      */
     public function up(): void
     {
+        Builder::defaultMorphKeyType('uuid');
+
         Schema::create('users', function (Blueprint $table) {
             $table->uuid('id')->primary();
             $table->string('last_name');

database/migrations/2024_08_29_211556_create_histories_table.php

@@ -0,0 +1,32 @@
+<?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('histories', function (Blueprint $table) {
+            $table->uuid('id');
+            $table->uuid('model_id');
+            $table->string('model_name', 250);
+            $table->jsonb('before');
+            $table->jsonb('after');
+            $table->enum('action', [ 'insert', 'update', 'delete' ]);
+            $table->timestamps();
+        });
+    }
+
+    /**
+     * Reverse the migrations.
+     */
+    public function down(): void
+    {
+        Schema::dropIfExists('histories');
+    }
+};