Added quiz features

This commit is contained in:
m.razaghi
2026-08-06 14:20:38 +03:30
parent af21c1c77e
commit 041a3e7bd5
12 changed files with 665 additions and 1 deletions

View File

@@ -0,0 +1,109 @@
<?php
namespace App\Http\Controllers\Admin;
use App\Http\Controllers\Controller;
use App\Models\Quiz;
use App\Models\QuizCategory;
use App\Models\QuizSubject;
use App\Models\Question;
use App\Models\QuestionOption;
use Illuminate\Http\Request;
use Illuminate\Support\Str;
class QuizController extends Controller
{
public function index()
{
$quizzes = Quiz::with('category')->withCount('questions')->latest()->paginate(15);
return view('admin.quizzes.index', compact('quizzes'));
}
public function create()
{
$categories = QuizCategory::where('is_active', true)->get();
return view('admin.quizzes.create', compact('categories'));
}
public function store(Request $request)
{
$validated = $request->validate([
'title' => 'required|string|max:255',
'category_id' => 'required|exists:quiz_categories,id',
'year' => 'nullable|integer',
'type' => 'required|in:multiple_choice,descriptive,mixed',
'duration_minutes' => 'required|integer|min:1',
'has_negative_score' => 'boolean',
'is_free' => 'boolean',
'is_published' => 'boolean',
'description' => 'nullable|string',
]);
$validated['slug'] = Str::slug($validated['title']) . '-' . time();
$validated['has_negative_score'] = $request->has('has_negative_score');
$validated['is_free'] = $request->has('is_free');
$validated['is_published'] = $request->has('is_published');
$quiz = Quiz::create($validated);
return redirect()->route('quizzes.questions.index', $quiz->id)
->with('success', 'آزمون با موفقیت ایجاد شد. اکنون می‌توانید سوالات را اضافه کنید.');
}
public function destroy(Quiz $quiz)
{
$quiz->delete();
return redirect()->route('quizzes.index')->with('success', 'آزمون حذف شد.');
}
// --- Questions Management ---
public function questions(Quiz $quiz)
{
$quiz->load(['questions.options', 'questions.subject']);
$subjects = QuizSubject::all();
return view('admin.quizzes.questions', compact('quiz', 'subjects'));
}
public function storeQuestion(Request $request, Quiz $quiz)
{
$request->validate([
'question_text' => 'required|string',
'type' => 'required|in:multiple_choice,descriptive',
'subject_id' => 'nullable|exists:quiz_subjects,id',
'score' => 'required|numeric|min:0.5',
'solution_explanation' => 'nullable|string',
// Options validation for multiple-choice questions
'options' => 'required_if:type,multiple_choice|array|min:4|max:4',
'options.*' => 'required_if:type,multiple_choice|string',
'correct_option' => 'required_if:type,multiple_choice|integer|between:0,3',
]);
$question = $quiz->questions()->create([
'subject_id' => $request->subject_id,
'question_text' => $request->question_text,
'type' => $request->type,
'score' => $request->score,
'solution_explanation' => $request->solution_explanation,
'order' => $quiz->questions()->count() + 1,
]);
// Save options if question is multiple choice
if ($request->type === 'multiple_choice' && $request->has('options')) {
foreach ($request->options as $index => $optionText) {
$question->options()->create([
'option_text' => $optionText,
'is_correct' => ($index == $request->correct_option),
]);
}
}
return back()->with('success', 'سوال با موفقیت ثبت شد.');
}
public function destroyQuestion(Question $question)
{
$question->delete();
return back()->with('success', 'سوال حذف شد.');
}
}

46
app/Models/Question.php Normal file
View File

@@ -0,0 +1,46 @@
<?php
namespace App\Models;
use Illuminate\Database\Eloquent\Factories\HasFactory;
use Illuminate\Database\Eloquent\Model;
class Question extends Model
{
use HasFactory;
protected $fillable = [
'quiz_id',
'subject_id',
'question_text',
'type',
'score',
'solution_explanation',
'order',
];
protected $casts = [
'score' => 'float',
'order' => 'integer',
];
public function quiz()
{
return $this->belongsTo(Quiz::class, 'quiz_id');
}
public function subject()
{
return $this->belongsTo(QuizSubject::class, 'subject_id');
}
public function options()
{
return $this->hasMany(QuestionOption::class, 'question_id');
}
public function userAnswers()
{
return $this->hasMany(UserQuizAnswer::class, 'question_id');
}
}

View File

@@ -0,0 +1,26 @@
<?php
namespace App\Models;
use Illuminate\Database\Eloquent\Factories\HasFactory;
use Illuminate\Database\Eloquent\Model;
class QuestionOption extends Model
{
use HasFactory;
protected $fillable = [
'question_id',
'option_text',
'is_correct',
];
protected $casts = [
'is_correct' => 'boolean',
];
public function question()
{
return $this->belongsTo(Question::class, 'question_id');
}
}

47
app/Models/Quiz.php Normal file
View File

@@ -0,0 +1,47 @@
<?php
namespace App\Models;
use Illuminate\Database\Eloquent\Factories\HasFactory;
use Illuminate\Database\Eloquent\Model;
class Quiz extends Model
{
use HasFactory;
protected $fillable = [
'category_id',
'title',
'slug',
'year',
'type',
'duration_minutes',
'has_negative_score',
'is_free',
'is_published',
'description',
];
protected $casts = [
'year' => 'integer',
'duration_minutes' => 'integer',
'has_negative_score' => 'boolean',
'is_free' => 'boolean',
'is_published' => 'boolean',
];
public function category()
{
return $this->belongsTo(QuizCategory::class, 'category_id');
}
public function questions()
{
return $this->hasMany(Question::class, 'quiz_id')->orderBy('order');
}
public function attempts()
{
return $this->hasMany(UserQuizAttempt::class, 'quiz_id');
}
}

View File

@@ -0,0 +1,27 @@
<?php
namespace App\Models;
use Illuminate\Database\Eloquent\Factories\HasFactory;
use Illuminate\Database\Eloquent\Model;
class QuizCategory extends Model
{
use HasFactory;
protected $fillable = [
'title',
'slug',
'description',
'is_active',
];
protected $casts = [
'is_active' => 'boolean',
];
public function quizzes()
{
return $this->hasMany(Quiz::class, 'category_id');
}
}

View File

@@ -0,0 +1,21 @@
<?php
namespace App\Models;
use Illuminate\Database\Eloquent\Factories\HasFactory;
use Illuminate\Database\Eloquent\Model;
class QuizSubject extends Model
{
use HasFactory;
protected $fillable = [
'title',
'slug',
];
public function questions()
{
return $this->hasMany(Question::class, 'subject_id');
}
}

View File

@@ -0,0 +1,41 @@
<?php
namespace App\Models;
use Illuminate\Database\Eloquent\Factories\HasFactory;
use Illuminate\Database\Eloquent\Model;
class UserQuizAnswer extends Model
{
use HasFactory;
protected $fillable = [
'attempt_id',
'question_id',
'selected_option_id',
'text_answer',
'is_correct',
'earned_score',
'reviewer_feedback',
];
protected $casts = [
'is_correct' => 'boolean',
'earned_score' => 'float',
];
public function attempt()
{
return $this->belongsTo(UserQuizAttempt::class, 'attempt_id');
}
public function question()
{
return $this->belongsTo(Question::class, 'question_id');
}
public function selectedOption()
{
return $this->belongsTo(QuestionOption::class, 'selected_option_id');
}
}

View File

@@ -0,0 +1,47 @@
<?php
namespace App\Models;
use Illuminate\Database\Eloquent\Factories\HasFactory;
use Illuminate\Database\Eloquent\Model;
class UserQuizAttempt extends Model
{
use HasFactory;
protected $fillable = [
'user_id',
'quiz_id',
'started_at',
'completed_at',
'total_score',
'correct_answers',
'wrong_answers',
'unanswered',
'status',
];
protected $casts = [
'started_at' => 'datetime',
'completed_at' => 'datetime',
'total_score' => 'float',
'correct_answers' => 'integer',
'wrong_answers' => 'integer',
'unanswered' => 'integer',
];
public function user()
{
return $this->belongsTo(User::class, 'user_id');
}
public function quiz()
{
return $this->belongsTo(Quiz::class, 'quiz_id');
}
public function answers()
{
return $this->hasMany(UserQuizAnswer::class, 'attempt_id');
}
}

View File

@@ -0,0 +1,80 @@
@extends('admin.layouts.app')
@section('content')
<div class="card">
<div class="card-header bg-primary text-white">
<h5 class="mb-0 text-white">تعریف آزمون جدید</h5>
</div>
<div class="card-body">
<form action="{{ route('quizzes.store') }}" method="POST">
@csrf
<div class="row g-3">
<div class="col-md-6">
<label class="form-label">عنوان آزمون <span class="text-danger">*</span></label>
<input type="text" name="title" class="form-control" placeholder="مثلاً: آزمون وکالت کانون وکلا سال ۱۴۰۲" required>
</div>
<div class="col-md-6">
<label class="form-label">دسته‌بندی <span class="text-danger">*</span></label>
<select name="category_id" class="form-select" required>
<option value="">انتخاب کنید...</option>
@foreach($categories as $category)
<option value="{{ $category->id }}">{{ $category->title }}</option>
@endforeach
</select>
</div>
<div class="col-md-4">
<label class="form-label">سال برگزاری</label>
<input type="number" name="year" class="form-control" placeholder="1402">
</div>
<div class="col-md-4">
<label class="form-label">نوع سوالات <span class="text-danger">*</span></label>
<select name="type" class="form-select" required>
<option value="multiple_choice">چهار گزینه‌ای (تستی)</option>
<option value="descriptive">تشریحی</option>
<option value="mixed">ترکیبی</option>
</select>
</div>
<div class="col-md-4">
<label class="form-label">مدت زمان (دقیقه)</label>
<input type="number" name="duration_minutes" class="form-control" value="60" required>
</div>
<div class="col-md-12">
<label class="form-label">توضیحات آزمون</label>
<textarea name="description" class="form-control" rows="3" placeholder="توضیحات و راهنمای شرکت در آزمون..."></textarea>
</div>
<div class="col-md-4">
<div class="form-check mt-3">
<input class="form-check-input" type="checkbox" name="has_negative_score" id="negScore" checked>
<label class="form-check-label" for="negScore">محاسبه نمره منفی (برای تستی)</label>
</div>
</div>
<div class="col-md-4">
<div class="form-check mt-3">
<input class="form-check-input" type="checkbox" name="is_free" id="isFree">
<label class="form-check-label" for="isFree">آزمون رایگان است (بدون نیاز به اشتراک)</label>
</div>
</div>
<div class="col-md-4">
<div class="form-check mt-3">
<input class="form-check-input" type="checkbox" name="is_published" id="isPub" checked>
<label class="form-check-label" for="isPub">انتشار فوری روی اپلیکیشن</label>
</div>
</div>
<div class="col-12 mt-4 text-end">
<a href="{{ route('quizzes.index') }}" class="btn btn-light me-2">انصراف</a>
<button type="submit" class="btn btn-success">ثبت و ورود به مرحله ثبت سوالات</button>
</div>
</div>
</form>
</div>
</div>
@endsection

View File

@@ -0,0 +1,71 @@
@extends('admin.layouts.app')
@section('content')
<div class="d-flex justify-content-between align-items-center mb-4">
<h4 class="mb-0">مدیریت آزمون‌ها</h4>
<a href="{{ route('quizzes.create') }}" class="btn btn-primary">+ تعریف آزمون جدید</a>
</div>
<div class="card">
<div class="card-body">
<div class="table-responsive">
<table class="table table-hover align-middle">
<thead>
<tr>
<th>عنوان آزمون</th>
<th>دسته‌بندی</th>
<th>سال</th>
<th>نوع</th>
<th>تعداد سوالات</th>
<th>مدت (دقیقه)</th>
<th>وضعیت</th>
<th>عملیات</th>
</tr>
</thead>
<tbody>
@forelse($quizzes as $quiz)
<tr>
<td><strong>{{ $quiz->title }}</strong></td>
<td><span class="badge bg-soft-info text-info">{{ optional($quiz->category)->title }}</span></td>
<td>{{ $quiz->year ?? '-' }}</td>
<td>
@if($quiz->type === 'multiple_choice')
<span class="badge bg-primary">چهار گزینه‌ای</span>
@elseif($quiz->type === 'descriptive')
<span class="badge bg-warning">تشریحی</span>
@else
<span class="badge bg-secondary">ترکیبی</span>
@endif
</td>
<td>{{ $quiz->questions_count }} سوال</td>
<td>{{ $quiz->duration_minutes }} دقیقه</td>
<td>
@if($quiz->is_published)
<span class="badge bg-success">منتشر شده</span>
@else
<span class="badge bg-secondary">پیش‌نویس</span>
@endif
</td>
<td>
<a href="{{ route('quizzes.questions.index', $quiz->id) }}" class="btn btn-sm btn-info me-1">مدیریت سوالات</a>
<form action="{{ route('quizzes.destroy', $quiz->id) }}" method="POST" class="d-inline" onsubmit="return confirm('آیا از حذف این آزمون اطمینان دارید؟')">
@csrf
@method('DELETE')
<button class="btn btn-sm btn-danger">حذف</button>
</form>
</td>
</tr>
@empty
<tr>
<td colspan="8" class="text-center py-4">هیچ آزمونی ثبت نشده است.</td>
</tr>
@endforelse
</tbody>
</table>
</div>
<div class="mt-3">
{{ $quizzes->links() }}
</div>
</div>
</div>
@endsection

View File

@@ -0,0 +1,140 @@
@extends('admin.layouts.app')
@section('content')
<div class="d-flex justify-content-between align-items-center mb-3">
<h4>مدیریت سوالات: {{ $quiz->title }}</h4>
<a href="{{ route('quizzes.index') }}" class="btn btn-outline-secondary">بازگشت به لیست آزمون‌ها</a>
</div>
<div class="row">
<!-- Form to Add Question -->
<div class="col-lg-5">
<div class="card">
<div class="card-header bg-primary text-white">
<h6 class="mb-0 text-white">افزودن سوال جدید</h6>
</div>
<div class="card-body">
<form action="{{ route('quizzes.questions.store', $quiz->id) }}" method="POST">
@csrf
<div class="mb-3">
<label class="form-label">نوع سوال</label>
<select name="type" id="questionTypeSelect" class="form-select" onchange="toggleOptionFields(this.value)">
<option value="multiple_choice">چهار گزینه‌ای (تستی)</option>
<option value="descriptive">تشریحی</option>
</select>
</div>
<div class="mb-3">
<label class="form-label">درس مربوطه</label>
<select name="subject_id" class="form-select">
<option value="">انتخاب درس (مثلاً: حقوق مدنی)</option>
@foreach($subjects as $subject)
<option value="{{ $subject->id }}">{{ $subject->title }}</option>
@endforeach
</select>
</div>
<div class="mb-3">
<label class="form-label">متن سوال / مسئله حقوقی <span class="text-danger">*</span></label>
<textarea name="question_text" class="form-control" rows="4" required placeholder="صورت سوال یا مسئله حقوقی را وارد کنید..."></textarea>
</div>
<div class="mb-3">
<label class="form-label">بارم / ضریب سوال</label>
<input type="number" step="0.25" name="score" class="form-control" value="1.00" required>
</div>
<!-- Multiple Choice Options Box -->
<div id="optionsContainer">
<h6 class="border-bottom pb-2 mb-3">گزینه‌ها و انتخاب پاسخ صحیح:</h6>
@for($i = 0; $i < 4; $i++)
<div class="input-group mb-2">
<div class="input-group-text">
<input class="form-check-input mt-0" type="radio" name="correct_option" value="{{ $i }}" {{ $i == 0 ? 'checked' : '' }}>
</div>
<input type="text" name="options[]" class="form-control" placeholder="متن گزینه {{ $i + 1 }}">
</div>
@endfor
<small class="text-muted d-block mb-3">دکمه رادیویی کنار هر گزینه نشان‌دهنده گزینه صحیح است.</small>
</div>
<div class="mb-3">
<label class="form-label">پاسخ تشریحی و مستندات مواد قانونی</label>
<textarea name="solution_explanation" class="form-control" rows="3" placeholder="توضیح پاسخ، استدلال و مواد قانونی مربوطه..."></textarea>
</div>
<button type="submit" class="btn btn-success w-100">افزودن سوال</button>
</form>
</div>
</div>
</div>
<!-- Questions List -->
<div class="col-lg-7">
<div class="card">
<div class="card-header bg-dark text-white">
<h6 class="mb-0 text-white">سوالات ثبت شده ({{ $quiz->questions->count() }})</h6>
</div>
<div class="card-body">
@forelse($quiz->questions as $index => $question)
<div class="border rounded p-3 mb-3 bg-light">
<div class="d-flex justify-content-between align-items-center mb-2">
<span class="badge bg-secondary">سوال شماره {{ $index + 1 }}</span>
<div>
@if($question->subject)
<span class="badge bg-info me-1">{{ $question->subject->title }}</span>
@endif
<span class="badge bg-{{ $question->type === 'multiple_choice' ? 'primary' : 'warning' }}">
{{ $question->type === 'multiple_choice' ? 'تستی' : 'تشریحی' }}
</span>
</div>
</div>
<p class="fw-bold mb-2">{{ $question->question_text }}</p>
@if($question->type === 'multiple_choice')
<div class="row g-2 mb-2">
@foreach($question->options as $optIndex => $option)
<div class="col-6">
<div class="p-2 border rounded {{ $option->is_correct ? 'bg-success text-white fw-bold' : 'bg-white' }}">
{{ $optIndex + 1 }}) {{ $option->option_text }}
</div>
</div>
@endforeach
</div>
@endif
@if($question->solution_explanation)
<div class="alert alert-secondary py-2 px-3 mt-2 mb-0 font-size-13">
<strong>پاسخ تشریحی / مستند قانون:</strong> {{ $question->solution_explanation }}
</div>
@endif
<div class="text-end mt-2">
<form action="{{ route('questions.destroy', $question->id) }}" method="POST" class="d-inline" onsubmit="return confirm('آیا این سوال حذف شود؟')">
@csrf
@method('DELETE')
<button class="btn btn-sm btn-outline-danger">حذف سوال</button>
</form>
</div>
</div>
@empty
<p class="text-center text-muted py-4">هنوز سوالی برای این آزمون ثبت نشده است.</p>
@endforelse
</div>
</div>
</div>
</div>
<script>
function toggleOptionFields(type) {
const container = document.getElementById('optionsContainer');
if (type === 'descriptive') {
container.style.display = 'none';
} else {
container.style.display = 'block';
}
}
</script>
@endsection

View File

@@ -31,10 +31,14 @@ use App\Http\Controllers\api\PayController;
use Illuminate\Support\Facades\Route; use Illuminate\Support\Facades\Route;
use App\Http\Controllers\Admin\TicketController; use App\Http\Controllers\Admin\TicketController;
use App\Http\Controllers\Admin\DashboardController; use App\Http\Controllers\Admin\DashboardController;
// 1. Add the QuizController import here
use App\Http\Controllers\Admin\QuizController;
Route::get('payment/callback', [PayController::class, 'callback']); Route::get('payment/callback', [PayController::class, 'callback']);
Route::middleware(['auth', config('jetstream.auth_session')])->group(function () { Route::middleware(['auth', config('jetstream.auth_session')])->group(function () {
Route::get('dashboard', [HomeController::class, 'index'])->name('dashboard');
Route::resource('categories', CategoryController::class); Route::resource('categories', CategoryController::class);
Route::resource('versions', VersionController::class); Route::resource('versions', VersionController::class);
Route::resource('users', UsersController::class); Route::resource('users', UsersController::class);
@@ -60,6 +64,7 @@ Route::middleware(['auth', config('jetstream.auth_session')])->group(function ()
Route::resource('bylaw-node-type', BylawNodeTypeController::class); Route::resource('bylaw-node-type', BylawNodeTypeController::class);
Route::resource('bylaw-node', BylawNodeController::class); Route::resource('bylaw-node', BylawNodeController::class);
Route::resource('bylaw-codification-link', BylawCodificationLinkController::class); Route::resource('bylaw-codification-link', BylawCodificationLinkController::class);
Route::get('suggestions', [SuggestionController::class, 'index'])->name('suggestions.index'); Route::get('suggestions', [SuggestionController::class, 'index'])->name('suggestions.index');
Route::get('tickets', [TicketController::class, 'index'])->name('tickets.index'); Route::get('tickets', [TicketController::class, 'index'])->name('tickets.index');
@@ -67,6 +72,10 @@ Route::middleware(['auth', config('jetstream.auth_session')])->group(function ()
Route::post('tickets/{ticket}/reply', [TicketController::class, 'reply'])->name('tickets.reply'); Route::post('tickets/{ticket}/reply', [TicketController::class, 'reply'])->name('tickets.reply');
Route::post('tickets/{ticket}/close', [TicketController::class, 'close'])->name('tickets.close'); Route::post('tickets/{ticket}/close', [TicketController::class, 'close'])->name('tickets.close');
Route::resource('quizzes', QuizController::class);
Route::get('quizzes/{quiz}/questions', [QuizController::class, 'questions'])->name('quizzes.questions.index');
Route::post('quizzes/{quiz}/questions', [QuizController::class, 'storeQuestion'])->name('quizzes.questions.store');
Route::delete('questions/{question}', [QuizController::class, 'destroyQuestion'])->name('questions.destroy');
Route::get('/dashboard', [DashboardController::class, 'index'])->name('dashboard'); Route::get('/dashboard', [DashboardController::class, 'index'])->name('dashboard');
}); });