feat: Initial commit for Saqel Platform architecture, backend, Docker, and documentation

backend/app/Http/Controllers/Api/V1/QuizAttemptController.php

@@ -0,0 +1,35 @@
+<?php
+
+namespace App\Http\Controllers\Api\V1;
+
+use App\Http\Controllers\Controller;
+use App\Models\Lesson;
+use App\Models\Quiz;
+use App\Services\ProgressTrackingService;
+use Illuminate\Http\JsonResponse;
+use Illuminate\Http\Request;
+
+class QuizAttemptController extends Controller
+{
+    public function __construct(private readonly ProgressTrackingService $tracking) {}
+
+    public function store(Request $request, Lesson $lesson, Quiz $quiz): JsonResponse
+    {
+        abort_unless($quiz->lesson_id === $lesson->id, 404);
+
+        $validated = $request->validate([
+            'answers' => ['required', 'array', 'min:1'],
+            'answers.*.question_id' => ['required', 'integer'],
+            'answers.*.selected_option_id' => ['nullable', 'integer'],
+            'answers.*.time_spent_seconds' => ['nullable', 'integer', 'min:0', 'max:7200'],
+        ]);
+
+        $result = $this->tracking->recordQuizAttempt(
+            student: $request->user(),
+            quiz: $quiz,
+            submittedAnswers: $validated['answers'],
+        );
+
+        return response()->json($result);
+    }
+}