add article model & factory

Author: gwleuverink

app/Models/Article.php

@@ -0,0 +1,27 @@
+<?php
+
+namespace App\Models;
+
+use Illuminate\Contracts\Database\Eloquent\Builder;
+use Illuminate\Database\Eloquent\Factories\HasFactory;
+use Illuminate\Database\Eloquent\Model;
+use Illuminate\Database\Eloquent\Relations\BelongsTo;
+
+class Article extends Model
+{
+    use HasFactory;
+
+    protected $casts = [
+        'published_at' => 'datetime',
+    ];
+
+    public function scopePublished(Builder $query): void
+    {
+        $query->whereDate('published_at', '<=', now());
+    }
+
+    public function author(): BelongsTo
+    {
+        return $this->belongsTo(User::class, 'author_id');
+    }
+}

database/factories/ArticleFactory.php

@@ -0,0 +1,38 @@
+<?php
+
+namespace Database\Factories;
+
+use App\Models\Article;
+use App\Models\User;
+use Illuminate\Database\Eloquent\Factories\Factory;
+
+/**
+ * @extends Factory<Article>
+ */
+class ArticleFactory extends Factory
+{
+    public function definition(): array
+    {
+        return [
+            'author_id' => User::factory(),
+            'slug' => fake()->unique()->slug(3),
+            'title' => fake()->sentence(),
+            'excerpt' => fake()->paragraph(1, false),
+            'content' => implode(PHP_EOL.PHP_EOL, fake()->paragraphs()),
+        ];
+    }
+
+    public function published(): static
+    {
+        return $this->state(fn () => [
+            'published_at' => now(),
+        ]);
+    }
+
+    public function scheduled(): static
+    {
+        return $this->state(fn () => [
+            'published_at' => now()->addMinute(),
+        ]);
+    }
+}

database/migrations/2025_07_08_083141_create_articles_table.php

@@ -0,0 +1,41 @@
+<?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('articles', function (Blueprint $table) {
+            $table->id();
+
+            $table->unsignedBigInteger('author_id')
+                ->nullable();
+
+            $table->foreign('author_id')
+                ->references('id')->on('users')
+                ->nullOnDelete();
+
+            $table->string('slug')->unique();
+            $table->string('title', 255);
+            $table->string('excerpt', 400);
+            $table->text('content');
+
+            $table->timestamp('published_at')->default(now());
+            $table->timestamps();
+        });
+    }
+
+    /**
+     * Reverse the migrations.
+     */
+    public function down(): void
+    {
+        Schema::dropIfExists('articles');
+    }
+};