From 65ccbd555ac78c30cfb13bad767442efd04ac64f Mon Sep 17 00:00:00 2001
From: Tajim <com.tajim@gmail.com>
Date: Wed, 26 Aug 2026 11:52:13 +0600
Subject: [PATCH 1/4] feat(db): add resource_completions table and model
 relationships

---
 app/Models/Resource.php                       |  5 +++
 app/Models/ResourceCompletion.php             | 24 ++++++++++++++
 app/Models/User.php                           | 10 ++++++
 ...4000_create_resource_completions_table.php | 31 +++++++++++++++++++
 4 files changed, 70 insertions(+)
 create mode 100644 app/Models/ResourceCompletion.php
 create mode 100644 database/migrations/2026_08_26_114000_create_resource_completions_table.php

diff --git a/app/Models/Resource.php b/app/Models/Resource.php
index c5956d8..c3e4c12 100644
--- a/app/Models/Resource.php
+++ b/app/Models/Resource.php
@@ -47,4 +47,9 @@ public function user()
     {
         return $this->belongsTo(User::class);
     }
+
+    public function completions()
+    {
+        return $this->hasMany(ResourceCompletion::class);
+    }
 }
diff --git a/app/Models/ResourceCompletion.php b/app/Models/ResourceCompletion.php
new file mode 100644
index 0000000..47d784c
--- /dev/null
+++ b/app/Models/ResourceCompletion.php
@@ -0,0 +1,24 @@
+<?php
+
+namespace App\Models;
+
+use Illuminate\Database\Eloquent\Model;
+use Illuminate\Database\Eloquent\Relations\BelongsTo;
+
+class ResourceCompletion extends Model
+{
+    protected $fillable = [
+        'resource_id',
+        'user_id',
+    ];
+
+    public function resource(): BelongsTo
+    {
+        return $this->belongsTo(Resource::class);
+    }
+
+    public function user(): BelongsTo
+    {
+        return $this->belongsTo(User::class);
+    }
+}
diff --git a/app/Models/User.php b/app/Models/User.php
index 88a954c..206f211 100644
--- a/app/Models/User.php
+++ b/app/Models/User.php
@@ -82,4 +82,14 @@ public function blogs(): HasMany
     {
         return $this->hasmany(Blog::class);
     }
+
+    public function resourceCompletions(): HasMany
+    {
+        return $this->hasMany(ResourceCompletion::class);
+    }
+
+    public function completedResources()
+    {
+        return $this->belongsToMany(Resource::class, 'resource_completions');
+    }
 }
diff --git a/database/migrations/2026_08_26_114000_create_resource_completions_table.php b/database/migrations/2026_08_26_114000_create_resource_completions_table.php
new file mode 100644
index 0000000..90053b1
--- /dev/null
+++ b/database/migrations/2026_08_26_114000_create_resource_completions_table.php
@@ -0,0 +1,31 @@
+<?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('resource_completions', function (Blueprint $table) {
+            $table->id();
+            $table->foreignId('resource_id')->constrained()->cascadeOnDelete();
+            $table->foreignId('user_id')->constrained()->cascadeOnDelete();
+            $table->timestamps();
+
+            $table->unique(['resource_id', 'user_id']);
+        });
+    }
+
+    /**
+     * Reverse the migrations.
+     */
+    public function down(): void
+    {
+        Schema::dropIfExists('resource_completions');
+    }
+};

From 7ed5337733c1e8674dee4628af74db9aa35a29f1 Mon Sep 17 00:00:00 2001
From: Tajim <com.tajim@gmail.com>
Date: Wed, 26 Aug 2026 11:52:15 +0600
Subject: [PATCH 2/4] feat(resource): add completion toggle endpoint and
 completers query

---
 app/Http/Controllers/ResourceController.php | 38 +++++++++++++++++++--
 routes/web.php                              |  1 +
 2 files changed, 36 insertions(+), 3 deletions(-)

diff --git a/app/Http/Controllers/ResourceController.php b/app/Http/Controllers/ResourceController.php
index 357e07c..80f4b2e 100644
--- a/app/Http/Controllers/ResourceController.php
+++ b/app/Http/Controllers/ResourceController.php
@@ -3,13 +3,12 @@
 namespace App\Http\Controllers;
 
 use App\Models\Resource;
+use App\Models\ResourceCompletion;
 use Illuminate\Support\Facades\Cache;
 use Inertia\Inertia;
 
 class ResourceController extends Controller
 {
-    //
-
     public function show($id)
     {
         $data = Cache::rememberForever("resource_{$id}", function () use ($id) {
@@ -32,6 +31,39 @@ public function show($id)
             ];
         });
 
-        return Inertia::render('Resource', $data);
+        $isCompleted = auth()->check()
+            ? ResourceCompletion::where('resource_id', $id)->where('user_id', auth()->id())->exists()
+            : false;
+
+        $completionsCount = ResourceCompletion::where('resource_id', $id)->count();
+
+        $completers = ResourceCompletion::where('resource_id', $id)
+            ->with('user:id,name,image_path,institution')
+            ->latest()
+            ->take(10)
+            ->get()
+            ->pluck('user')
+            ->filter()
+            ->values();
+
+        return Inertia::render('Resource', array_merge($data, [
+            'isCompleted' => $isCompleted,
+            'completionsCount' => $completionsCount,
+            'completers' => $completers,
+        ]));
+    }
+
+    public function toggleComplete(Resource $resource)
+    {
+        $user = auth()->user();
+        $existing = $resource->completions()->where('user_id', $user->id)->first();
+
+        if ($existing) {
+            $existing->delete();
+        } else {
+            $resource->completions()->create(['user_id' => $user->id]);
+        }
+
+        return back();
     }
 }
diff --git a/routes/web.php b/routes/web.php
index 783c8b3..a5d4787 100644
--- a/routes/web.php
+++ b/routes/web.php
@@ -25,6 +25,7 @@
     Route::post('/blogs/{blog}/react', [BlogController::class, 'toggleReaction'])->name('blogs.react');
     Route::post('/blogs/{blog}/comments', [BlogController::class, 'storeComment'])->name('blogs.comments.store');
     Route::delete('/blogs/comments/{comment}', [BlogController::class, 'destroyComment'])->name('blogs.comments.destroy');
+    Route::post('/resources/{resource}/complete', [ResourceController::class, 'toggleComplete'])->name('resources.complete');
 });
 
 Route::prefix('admin')

From a054da7ca05a9e1b5acbe6733228a3adeefefe4b Mon Sep 17 00:00:00 2001
From: Tajim <com.tajim@gmail.com>
Date: Wed, 26 Aug 2026 11:52:19 +0600
Subject: [PATCH 3/4] test(resource): add feature tests for guest redirection
 and user completion toggle

---
 tests/Feature/ResourceCompletionTest.php | 72 ++++++++++++++++++++++++
 1 file changed, 72 insertions(+)
 create mode 100644 tests/Feature/ResourceCompletionTest.php

diff --git a/tests/Feature/ResourceCompletionTest.php b/tests/Feature/ResourceCompletionTest.php
new file mode 100644
index 0000000..39e04aa
--- /dev/null
+++ b/tests/Feature/ResourceCompletionTest.php
@@ -0,0 +1,72 @@
+<?php
+
+use App\Models\Node;
+use App\Models\Resource;
+use App\Models\Subject;
+use App\Models\User;
+
+test('guests are redirected when attempting to toggle completion', function () {
+    $subject = Subject::create([
+        'name' => 'Physics',
+        'slug' => 'physics',
+        'course' => 'hsc',
+        'tailwind_format' => 'bg-indigo-500',
+        'icon' => 'atom',
+    ]);
+    $node = Node::create([
+        'subject_id' => $subject->id,
+        'name' => 'Chapter 1',
+        'slug' => 'chapter-1',
+    ]);
+    $resource = Resource::create([
+        'node_id' => $node->id,
+        'resource_type' => 'image',
+        'title' => 'Vectors Handnote',
+        'file_path' => 'resources/sample.jpg',
+    ]);
+
+    $this->post("/resources/{$resource->id}/complete")
+        ->assertRedirect('/login');
+});
+
+test('authenticated user can toggle resource completion status', function () {
+    $user = User::factory()->create();
+    $subject = Subject::create([
+        'name' => 'Physics',
+        'slug' => 'physics',
+        'course' => 'hsc',
+        'tailwind_format' => 'bg-indigo-500',
+        'icon' => 'atom',
+    ]);
+    $node = Node::create([
+        'subject_id' => $subject->id,
+        'name' => 'Chapter 1',
+        'slug' => 'chapter-1',
+    ]);
+    $resource = Resource::create([
+        'node_id' => $node->id,
+        'resource_type' => 'image',
+        'title' => 'Vectors Handnote',
+        'file_path' => 'resources/sample.jpg',
+    ]);
+
+    // Mark as done
+    $this->actingAs($user)
+        ->post("/resources/{$resource->id}/complete")
+        ->assertRedirect();
+
+    $this->assertDatabaseHas('resource_completions', [
+        'resource_id' => $resource->id,
+        'user_id' => $user->id,
+    ]);
+
+    // Undo / Unmark
+    $this->actingAs($user)
+        ->post("/resources/{$resource->id}/complete")
+        ->assertRedirect();
+
+    $this->assertDatabaseMissing('resource_completions', [
+        'resource_id' => $resource->id,
+        'user_id' => $user->id,
+    ]);
+});

From ca73ed463c51a088ccf6c35d4cfa6f013369ed4c Mon Sep 17 00:00:00 2001
From: Tajim <com.tajim@gmail.com>
Date: Wed, 26 Aug 2026 11:52:22 +0600
Subject: [PATCH 4/4] feat(resource): add mark as done action, completers
 modal, and optimistic UI

---
 resources/js/pages/Resource.vue | 293 +++++++++++++++++++++++++++++++-
 1 file changed, 289 insertions(+), 4 deletions(-)

diff --git a/resources/js/pages/Resource.vue b/resources/js/pages/Resource.vue
index df4e7bf..7654429 100644
--- a/resources/js/pages/Resource.vue
+++ b/resources/js/pages/Resource.vue
@@ -1,5 +1,5 @@
 <script setup lang="ts">
-import { Head, Link, usePage } from '@inertiajs/vue3';
+import { Head, Link, router, usePage } from '@inertiajs/vue3';
 import {
     Download,
     AlertCircle,
@@ -13,6 +13,7 @@ import {
     LogIn,
     X,
     ExternalLink,
+    CheckCircle2,
 } from 'lucide-vue-next';
 import { computed, ref, watch } from 'vue';
 import YouTubePlayer from '../components/YouTubePlayer.vue';
@@ -30,11 +31,109 @@ const props = defineProps({
         type: Number,
         default: null,
     },
+    isCompleted: {
+        type: Boolean,
+        default: false,
+    },
+    completionsCount: {
+        type: Number,
+        default: 0,
+    },
+    completers: {
+        type: Array as () => any[],
+        default: () => [],
+    },
 });
 
 const page = usePage();
 const user = computed(() => page.props.auth?.user);
 const showAuthModal = ref(false);
+const showCompletersModal = ref(false);
+const authModalMessage = ref('Please sign in to continue.');
+
+// Optimistic Completion state
+const localIsCompleted = ref(props.isCompleted);
+const localCompletionsCount = ref(props.completionsCount);
+const localCompleters = ref<any[]>([...(props.completers || [])]);
+const isTogglingCompletion = ref(false);
+
+watch(
+    () => props.isCompleted,
+    (val) => {
+        localIsCompleted.value = val;
+    },
+);
+
+watch(
+    () => props.completionsCount,
+    (val) => {
+        localCompletionsCount.value = val;
+    },
+);
+
+watch(
+    () => props.completers,
+    (val) => {
+        localCompleters.value = [...(val || [])];
+    },
+);
+
+const handleToggleComplete = () => {
+    if (!user.value) {
+        authModalMessage.value =
+            'Please sign in to mark study materials as completed and track your syllabus progress.';
+        showAuthModal.value = true;
+
+        return;
+    }
+
+    if (isTogglingCompletion.value) {
+        return;
+    }
+
+    // Optimistic update
+    if (localIsCompleted.value) {
+        localIsCompleted.value = false;
+        localCompletionsCount.value = Math.max(
+            0,
+            localCompletionsCount.value - 1,
+        );
+        localCompleters.value = localCompleters.value.filter(
+            (c: any) => c.id !== user.value?.id,
+        );
+    } else {
+        localIsCompleted.value = true;
+        localCompletionsCount.value += 1;
+
+        if (user.value) {
+            localCompleters.value = [
+                {
+                    id: user.value.id,
+                    name: user.value.name,
+                    image_url: user.value.image_url,
+                    image_path: user.value.image_path,
+                    institution: user.value.institution,
+                },
+                ...localCompleters.value.filter(
+                    (c: any) => c.id !== user.value.id,
+                ),
+            ];
+        }
+    }
+
+    isTogglingCompletion.value = true;
+    router.post(
+        `/resources/${props.resource.id}/complete`,
+        {},
+        {
+            preserveScroll: true,
+            preserveState: true,
+            onFinish: () => {
+                isTogglingCompletion.value = false;
+            },
+        },
+    );
+};
 
 const isImageLoaded = ref(false);
 
@@ -47,6 +146,8 @@ watch(
 
 const handleDownload = () => {
     if (!user.value) {
+        authModalMessage.value =
+            'Please sign in to download full-resolution study materials.';
         showAuthModal.value = true;
 
         return;
@@ -216,6 +317,78 @@ watch(isFullscreen, (val) => {
 
             <!-- Right: Action Buttons -->
             <div class="flex shrink-0 items-center gap-2">
+                <!-- Mark as Done / Completed Button (Auth-guarded) -->
+                <div class="flex items-center gap-1.5">
+                    <button
+                        @click="handleToggleComplete"
+                        type="button"
+                        class="inline-flex h-9 cursor-pointer items-center gap-1.5 rounded-xl border px-3 text-xs font-semibold shadow-xs transition active:scale-95"
+                        :class="
+                            localIsCompleted
+                                ? 'border-emerald-500/40 bg-emerald-50 text-emerald-700 hover:bg-emerald-100 dark:border-emerald-500/30 dark:bg-emerald-950/40 dark:text-emerald-300 dark:hover:bg-emerald-950/60'
+                                : 'border-slate-200 bg-white text-slate-700 hover:border-emerald-200 hover:bg-emerald-50/70 hover:text-emerald-600 dark:border-gray-800 dark:bg-gray-900 dark:text-gray-300 dark:hover:border-emerald-900/50 dark:hover:bg-emerald-950/30 dark:hover:text-emerald-400'
+                        "
+                        :title="
+                            localIsCompleted
+                                ? 'Marked as completed (click to undo)'
+                                : 'Mark as done'
+                        "
+                    >
+                        <CheckCircle2
+                            class="h-3.5 w-3.5 stroke-[2.2] transition-colors"
+                            :class="
+                                localIsCompleted
+                                    ? 'fill-emerald-600/20 text-emerald-600 dark:text-emerald-400'
+                                    : ''
+                            "
+                        />
+                        <span class="text-xs font-semibold">{{
+                            localIsCompleted ? 'Done' : 'Mark as Done'
+                        }}</span>
+                    </button>
+
+                    <!-- Completers Avatar Stack & Counter Trigger -->
+                    <button
+                        v-if="localCompletionsCount > 0"
+                        @click="showCompletersModal = true"
+                        type="button"
+                        class="flex h-9 cursor-pointer items-center gap-1.5 rounded-xl border border-slate-200 bg-white px-2 py-1 text-xs font-semibold text-slate-600 shadow-xs transition hover:border-slate-300 hover:bg-slate-50 active:scale-95 dark:border-gray-800 dark:bg-gray-900 dark:text-gray-400 dark:hover:bg-gray-800"
+                        title="View students who completed this"
+                    >
+                        <div class="flex -space-x-1.5 overflow-hidden">
+                            <div
+                                v-for="completer in localCompleters.slice(0, 3)"
+                                :key="completer.id"
+                                class="inline-block h-5 w-5 rounded-full ring-2 ring-white dark:ring-gray-900"
+                            >
+                                <img
+                                    v-if="
+                                        completer.image_url ||
+                                        completer.image_path
+                                    "
+                                    :src="
+                                        completer.image_url ||
+                                        '/storage/' + completer.image_path
+                                    "
+                                    :alt="completer.name"
+                                    class="h-full w-full rounded-full object-cover"
+                                />
+                                <div
+                                    v-else
+                                    class="flex h-full w-full items-center justify-center rounded-full bg-emerald-100 text-[9px] font-bold text-emerald-800 dark:bg-emerald-900 dark:text-emerald-200"
+                                >
+                                    {{ completer.name?.charAt(0) || 'U' }}
+                                </div>
+                            </div>
+                        </div>
+                        <span
+                            class="text-xs font-bold text-slate-700 dark:text-gray-300"
+                        >
+                            {{ localCompletionsCount }}
+                        </span>
+                    </button>
+                </div>
+
                 <!-- Watch on YouTube Action (For Video Resources) -->
                 <a
                     v-if="
@@ -517,7 +690,7 @@ watch(isFullscreen, (val) => {
         </div>
     </Teleport>
 
-    <!-- Minimal Sign-in Dialog for Guests (Download Auth Guard) -->
+    <!-- Minimal Sign-in Dialog for Guests (Download & Completion Auth Guard) -->
     <Teleport to="body">
         <Transition
             enter-active-class="transition duration-150 ease-out"
@@ -547,8 +720,7 @@ watch(isFullscreen, (val) => {
                         Sign in required
                     </h3>
                     <p class="mt-1 text-xs text-slate-500 dark:text-gray-400">
-                        Please sign in to download full-resolution study
-                        materials.
+                        {{ authModalMessage }}
                     </p>
 
                     <div class="mt-4 flex items-center gap-2">
@@ -571,6 +743,119 @@ watch(isFullscreen, (val) => {
             </div>
         </Transition>
     </Teleport>
+
+    <!-- Students who Completed Modal -->
+    <Teleport to="body">
+        <Transition
+            enter-active-class="transition duration-150 ease-out"
+            enter-from-class="opacity-0 scale-95"
+            enter-to-class="opacity-100 scale-100"
+            leave-active-class="transition duration-100 ease-in"
+            leave-from-class="opacity-100 scale-100"
+            leave-to-class="opacity-0 scale-95"
+        >
+            <div
+                v-if="showCompletersModal"
+                class="fixed inset-0 z-[100] flex items-center justify-center bg-slate-900/40 p-4 backdrop-blur-xs dark:bg-black/50"
+                @click.self="showCompletersModal = false"
+            >
+                <div
+                    class="relative w-full max-w-sm rounded-2xl border border-slate-200 bg-white p-5 shadow-2xl dark:border-gray-800 dark:bg-gray-900"
+                >
+                    <button
+                        @click="showCompletersModal = false"
+                        class="absolute top-3.5 right-3.5 cursor-pointer rounded-lg p-1 text-slate-400 hover:text-slate-600 dark:text-gray-500 dark:hover:text-gray-300"
+                    >
+                        <X class="h-4 w-4" />
+                    </button>
+
+                    <div class="mb-4 flex items-center gap-2.5">
+                        <div
+                            class="flex h-8 w-8 items-center justify-center rounded-xl bg-emerald-50 text-emerald-600 dark:bg-emerald-950/60 dark:text-emerald-400"
+                        >
+                            <CheckCircle2 class="h-4 w-4 stroke-[2.2]" />
+                        </div>
+                        <div>
+                            <h3
+                                class="text-sm font-bold text-slate-900 dark:text-gray-100"
+                            >
+                                Completed By
+                            </h3>
+                            <p
+                                class="text-[11px] font-medium text-slate-500 dark:text-gray-400"
+                            >
+                                {{ localCompletionsCount }} student{{
+                                    localCompletionsCount === 1 ? '' : 's'
+                                }}
+                                marked this as done
+                            </p>
+                        </div>
+                    </div>
+
+                    <div
+                        class="-mx-1 max-h-72 divide-y divide-slate-100 overflow-y-auto px-1 dark:divide-gray-800/80"
+                    >
+                        <div
+                            v-if="localCompleters.length === 0"
+                            class="py-6 text-center text-xs text-slate-500 dark:text-gray-400"
+                        >
+                            No completions recorded yet.
+                        </div>
+
+                        <div
+                            v-for="completer in localCompleters"
+                            :key="completer.id"
+                            class="flex items-center gap-3 py-2.5"
+                        >
+                            <div
+                                class="flex h-9 w-9 shrink-0 items-center justify-center overflow-hidden rounded-full bg-emerald-50 font-semibold text-emerald-700 dark:bg-emerald-950/60 dark:text-emerald-300"
+                            >
+                                <img
+                                    v-if="
+                                        completer.image_url ||
+                                        completer.image_path
+                                    "
+                                    :src="
+                                        completer.image_url ||
+                                        '/storage/' + completer.image_path
+                                    "
+                                    :alt="completer.name"
+                                    class="h-full w-full object-cover"
+                                />
+                                <span v-else class="text-xs uppercase">
+                                    {{ completer.name?.charAt(0) || 'U' }}
+                                </span>
+                            </div>
+                            <div class="min-w-0 flex-1">
+                                <p
+                                    class="truncate text-xs font-semibold text-slate-900 dark:text-gray-100"
+                                >
+                                    {{ completer.name }}
+                                </p>
+                                <p
+                                    v-if="completer.institution"
+                                    class="truncate text-[11px] text-slate-500 dark:text-gray-400"
+                                >
+                                    {{ completer.institution }}
+                                </p>
+                            </div>
+                        </div>
+
+                        <div
+                            v-if="
+                                localCompletionsCount > localCompleters.length
+                            "
+                            class="py-3 text-center text-xs font-medium text-slate-500 dark:text-gray-400"
+                        >
+                            and
+                            {{ localCompletionsCount - localCompleters.length }}
+                            more...
+                        </div>
+                    </div>
+                </div>
+            </div>
+        </Transition>
+    </Teleport>
 </template>
 
 <style scoped></style>