feat: Add basic page functionality

app/Http/Controllers/PageController.php

@@ -0,0 +1,91 @@
+<?php
+
+namespace App\Http\Controllers;
+
+use App\Http\Requests\PageRequest;
+use App\Http\Resources\PageCollection;
+use App\Http\Resources\PageResource;
+use App\Models\Page;
+use Illuminate\Http\Request;
+
+class PageController extends Controller
+{
+    /**
+     * Retrieves all pages from the database and returns them as JSON.
+     *
+     * @return \Illuminate\Http\JsonResponse
+     */
+    public function index()
+    {
+        // Return the retrieved pages as a JSON response
+        return new PageCollection(Page::all());
+    }
+
+    /**
+     * Returns the page with the given ID.
+     *
+     * @param  App\Models\Page  $page
+     * @return App\Http\Resources\PageResource
+     */
+    public function show(Page $page)
+    {
+        return new PageResource($page);
+    }
+
+    /**
+     * Create a new page in the database.
+     *
+     * @param  App\Http\Requests\PageRequest  $request;
+     * @return App\Http\Resources\PageResource
+     */
+    public function store(PageRequest $request)
+    {
+        $validatedData = $request->validated(); // Uses PageRequest validation
+
+        // Create new page instance and fill it with validated data
+        $page = new Page;
+        $page->fill($validatedData);
+        $page->save();
+
+        return new PageResource($page);
+    }
+
+    /**
+     * Update a page with new data and saves it as a new version.
+     *
+     * @param  App\Models\Page  $page
+     * @return \Illuminate\Http\JsonResponse
+     */
+    public function update(PageRequest $request, Page $page)
+    {
+        // Save current version
+        $page->versions()->create([
+            'title' => $page->title,
+            'slug' => $page->slug,
+            'content' => $page->content,
+            'version_number' => $page->versions()->count() + 1,
+            'edited_by' => auth()->id(), // The user ID of the current authenticated user
+            'public' => $page->public,
+        ]);
+
+        // Update live page with new data from request
+
+        $page->updateOrFail($request->safe()->only(['title', 'slug', 'content', 'public', 'author_id']));
+
+        // Return updated page as JSON response
+        return new PageResource($page);
+    }
+
+    /**
+     * Deletes a page and its associated data from the database.
+     *
+     * @param  App\Models\Page  $page
+     * @return \Illuminate\Http\JsonResponse
+     */
+    public function destroy(Page $page)
+    {
+        $page->delete();
+
+        return response()->json(['message' => 'Page deleted successfully'], 200);
+    }
+}

app/Http/Controllers/PageVersionController.php

@@ -0,0 +1,43 @@
+<?php
+
+namespace App\Http\Controllers;
+
+use App\Http\Resources\PageVersionCollection;
+use App\Http\Resources\PageVersionResource;
+use App\Models\Page;
+use App\Models\PageVersion;
+
+class PageVersionController extends Controller
+{
+    /**
+     * Get all page versions
+     */
+    /**
+     * Retrieves a collection of page versions.
+     *
+     * @param  \Illuminate\Http\Request  $request
+     * @return \App\Http\Resources\PageVersionCollection
+     */
+    public function index(Page $page)
+    {
+        // If a page ID is provided, filter the results to only include versions for that page
+        if ($page) {
+            // Use Eloquent's where method to retrieve all page versions with the specified page ID
+            $page_versions = PageVersion::where('page_id', $page->id)->get();
+        } else {
+            // If no page ID is provided, retrieve all page versions
+            $page_versions = PageVersion::all();
+        }
+
+        // Return a collection of page versions as a PageVersionCollection resource
+        return new PageVersionCollection($page_versions);
+    }
+
+    /**
+     * Display one page version
+     */
+    public function show(Page $page, string $version_number)
+    {
+        return new PageVersionResource(PageVersion::where('page_id', $page->id)->where('version_number', $version_number)->get());
+    }
+}

app/Http/Requests/PageRequest.php

@@ -0,0 +1,33 @@
+<?php
+
+namespace App\Http\Requests;
+
+use Illuminate\Foundation\Http\FormRequest;
+
+class PageRequest extends FormRequest
+{
+    /**
+     * Determine if the user is authorized to make this request.
+     */
+    public function authorize(): bool
+    {
+        return true;
+    }
+
+    /**
+     * Get the validation rules that apply to the request.
+     *
+     * @return array<string, \Illuminate\Contracts\Validation\ValidationRule|array<mixed>|string>
+     */
+    public function rules(): array
+    {
+        return [
+            'title' => 'required', // Page title is required
+            'content' => 'json|required', // Page content is required
+            // 'event_id' => 'required|integer', // Event ID is required and must be an integer
+            'author_id' => 'uuid|required', // User ID is required and must be a UUID
+            'public' => 'boolean',
+            'slug' => 'required|alpha_dash:ascii|unique:pages,slug,'.$this->slug.',slug', // Slug is required and must contain only ASCII characters and underscores/dashes
+        ];
+    }
+}

app/Http/Resources/PageCollection.php

@@ -0,0 +1,19 @@
+<?php
+
+namespace App\Http\Resources;
+
+use Illuminate\Http\Request;
+use Illuminate\Http\Resources\Json\ResourceCollection;
+
+class PageCollection extends ResourceCollection
+{
+    /**
+     * Transform the resource collection into an array.
+     *
+     * @return array<int|string, mixed>
+     */
+    public function toArray(Request $request): array
+    {
+        return parent::toArray($request);
+    }
+}

app/Http/Resources/PageResource.php

@@ -0,0 +1,19 @@
+<?php
+
+namespace App\Http\Resources;
+
+use Illuminate\Http\Request;
+use Illuminate\Http\Resources\Json\JsonResource;
+
+class PageResource extends JsonResource
+{
+    /**
+     * Transform the resource into an array.
+     *
+     * @return array<string, mixed>
+     */
+    public function toArray(Request $request): array
+    {
+        return parent::toArray($request);
+    }
+}

app/Http/Resources/PageVersionCollection.php

@@ -0,0 +1,19 @@
+<?php
+
+namespace App\Http\Resources;
+
+use Illuminate\Http\Request;
+use Illuminate\Http\Resources\Json\ResourceCollection;
+
+class PageVersionCollection extends ResourceCollection
+{
+    /**
+     * Transform the resource collection into an array.
+     *
+     * @return array<int|string, mixed>
+     */
+    public function toArray(Request $request): array
+    {
+        return parent::toArray($request);
+    }
+}

app/Http/Resources/PageVersionResource.php

@@ -0,0 +1,19 @@
+<?php
+
+namespace App\Http\Resources;
+
+use Illuminate\Http\Request;
+use Illuminate\Http\Resources\Json\JsonResource;
+
+class PageVersionResource extends JsonResource
+{
+    /**
+     * Transform the resource into an array.
+     *
+     * @return array<string, mixed>
+     */
+    public function toArray(Request $request): array
+    {
+        return parent::toArray($request);
+    }
+}

app/Models/Page.php

@@ -0,0 +1,31 @@
+<?php
+
+namespace App\Models;
+
+use Illuminate\Database\Eloquent\Factories\HasFactory;
+use Illuminate\Database\Eloquent\Model;
+use Illuminate\Database\Eloquent\Relations\HasMany;
+
+class Page extends Model
+{
+    use HasFactory;
+
+    protected $fillable = [
+        'title',
+        'slug',
+        'public',
+        'content',
+        'published_at',
+        'author_id',
+    ];
+
+    public function versions(): HasMany
+    {
+        return $this->hasMany(PageVersion::class);
+    }
+
+    public function latestVersion()
+    {
+        return $this->versions()->latest('created_at')->first();
+    }
+}

app/Models/PageVersion.php

@@ -0,0 +1,24 @@
+<?php
+
+namespace App\Models;
+
+use Illuminate\Database\Eloquent\Model;
+use Illuminate\Database\Eloquent\Relations\BelongsTo;
+
+class PageVersion extends Model
+{
+    protected $fillable = [
+        'page_id',
+        'title',
+        'slug',
+        'content',
+        'public',
+        'version_number',
+        'edited_by',
+    ];
+
+    public function page(): BelongsTo
+    {
+        return $this->belongsTo(Page::class);
+    }
+}

database/factories/PageFactory.php

@@ -0,0 +1,28 @@
+<?php
+
+namespace Database\Factories;
+
+use App\Models\User;
+use Illuminate\Database\Eloquent\Factories\Factory;
+
+/**
+ * @extends \Illuminate\Database\Eloquent\Factories\Factory<\App\Models\Page>
+ */
+class PageFactory extends Factory
+{
+    /**
+     * Define the model's default state.
+     *
+     * @return array<string, mixed>
+     */
+    public function definition(): array
+    {
+        return [
+            'title' => $this->faker->sentence,
+            'content' => '{"content": "'.$this->faker->paragraph.'"}',
+            'slug' => $this->faker->unique()->slug,
+            'published_at' => now(),
+            'author_id' => User::factory(),
+        ];
+    }
+}

database/migrations/2025_06_24_173701_create_pages_table.php

@@ -0,0 +1,33 @@
+<?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('pages', function (Blueprint $table) {
+            $table->id();
+            $table->string('title');
+            $table->string('slug')->unique();
+            $table->jsonb('content'); // WYSIWYG editor stores data in JSON format.
+            $table->boolean('public')->default(false); // The page is by default not public, but can be set to public if needed.
+            $table->timestamp('published_at')->nullable(); // Do we need this?
+            $table->uuid('author_id')->constrained('users')->onDelete('cascade');
+            $table->timestamps();
+        });
+    }
+
+    /**
+     * Reverse the migrations.
+     */
+    public function down(): void
+    {
+        Schema::dropIfExists('pages');
+    }
+};