feat: add question bank management, quiz finalization, and related backend/frontend functionality

This commit is contained in:
2026-07-04 20:10:03 +02:00
parent d1d1eb3a24
commit c34c25dff7
37 changed files with 2493 additions and 206 deletions
@@ -0,0 +1,215 @@
<?php
declare(strict_types=1);
namespace Tvdt\Tests\Controller\Backoffice;
use Doctrine\ORM\EntityManagerInterface;
use PHPUnit\Framework\Attributes\CoversClass;
use Safe\DateTimeImmutable;
use Symfony\Bundle\FrameworkBundle\KernelBrowser;
use Symfony\Bundle\FrameworkBundle\Test\WebTestCase;
use Symfony\Component\HttpFoundation\Request;
use Tvdt\Controller\Backoffice\QuizController;
use Tvdt\Entity\Answer;
use Tvdt\Entity\Candidate;
use Tvdt\Entity\Question;
use Tvdt\Entity\Quiz;
use Tvdt\Entity\QuizCandidate;
use Tvdt\Entity\Season;
use Tvdt\Entity\User;
#[CoversClass(QuizController::class)]
final class QuizFinalizeTest extends WebTestCase
{
private KernelBrowser $client;
private EntityManagerInterface $entityManager;
protected function setUp(): void
{
$this->client = self::createClient();
$this->entityManager = self::getContainer()->get(EntityManagerInterface::class);
$user = $this->entityManager->getRepository(User::class)->findOneBy(['email' => 'krtek-admin@example.org']);
$this->assertInstanceOf(User::class, $user);
$this->client->loginUser($user);
}
private function getQuizByName(string $name): Quiz
{
$quiz = $this->entityManager->getRepository(Quiz::class)->findOneBy(['name' => $name]);
$this->assertInstanceOf(Quiz::class, $quiz);
return $quiz;
}
private function getKrtekSeason(): Season
{
$season = $this->entityManager->getRepository(Season::class)->findOneBy(['seasonCode' => 'krtek']);
$this->assertInstanceOf(Season::class, $season);
return $season;
}
private function getCsrfTokenFromOverview(Quiz $quiz, string $formActionContains): string
{
$crawler = $this->client->request(Request::METHOD_GET, \sprintf('/backoffice/season/krtek/quiz/%s/overview', $quiz->id));
$this->assertResponseIsSuccessful();
$input = $crawler->filter(\sprintf('form[action*="%s"] input[name="_token"]', $formActionContains));
$this->assertGreaterThan(0, $input->count(), \sprintf('No form found with action containing "%s"', $formActionContains));
return (string) $input->first()->attr('value');
}
public function testFinalizeSetsFinalizedAt(): void
{
$quiz = $this->getQuizByName('Quiz 2');
$this->assertFalse($quiz->isFinalized());
$token = $this->getCsrfTokenFromOverview($quiz, '/finalize');
$this->client->request(Request::METHOD_POST, \sprintf('/backoffice/quiz/%s/finalize', $quiz->id), ['_token' => $token]);
$this->assertResponseRedirects();
$this->entityManager->clear();
$this->assertTrue($this->getQuizByName('Quiz 2')->isFinalized());
}
public function testFinalizeRefusedWhenQuizHasErrors(): void
{
$season = $this->getKrtekSeason();
$invalidQuiz = new Quiz();
$invalidQuiz->name = 'Invalid Quiz';
$question = new Question();
$question->question = 'Vraag zonder goed antwoord';
$question->ordering = 1;
$question->addAnswer(new Answer('Fout'));
$question->addAnswer(new Answer('Ook fout'));
$invalidQuiz->addQuestion($question);
$season->addQuiz($invalidQuiz);
$this->entityManager->persist($invalidQuiz);
$this->entityManager->flush();
// Token intention is shared, so any quiz overview provides it
$token = $this->getCsrfTokenFromOverview($invalidQuiz, '/finalize');
$this->client->request(Request::METHOD_POST, \sprintf('/backoffice/quiz/%s/finalize', $invalidQuiz->id), ['_token' => $token]);
$this->assertResponseRedirects();
$this->entityManager->clear();
$this->assertFalse($this->getQuizByName('Invalid Quiz')->isFinalized());
}
public function testEnableRefusedWhenNotFinalized(): void
{
$quiz = $this->getQuizByName('Quiz 2');
$this->assertFalse($quiz->isFinalized());
$token = $this->getCsrfTokenFromOverview($quiz, '/enable');
$this->client->request(Request::METHOD_POST, \sprintf('/backoffice/season/krtek/quiz/%s/enable', $quiz->id), ['_token' => $token]);
$this->assertResponseRedirects();
$this->entityManager->clear();
$season = $this->getKrtekSeason();
$this->assertInstanceOf(Quiz::class, $season->activeQuiz);
$this->assertSame('Quiz 1', $season->activeQuiz->name);
}
public function testEnableAllowedWhenFinalized(): void
{
$quiz = $this->getQuizByName('Quiz 2');
$quiz->finalizedAt = new DateTimeImmutable();
$this->entityManager->flush();
$token = $this->getCsrfTokenFromOverview($quiz, '/enable');
$this->client->request(Request::METHOD_POST, \sprintf('/backoffice/season/krtek/quiz/%s/enable', $quiz->id), ['_token' => $token]);
$this->assertResponseRedirects();
$this->entityManager->clear();
$season = $this->getKrtekSeason();
$this->assertInstanceOf(Quiz::class, $season->activeQuiz);
$this->assertSame('Quiz 2', $season->activeQuiz->name);
}
public function testUnfinalize(): void
{
$quiz = $this->getQuizByName('Quiz 2');
$quiz->finalizedAt = new DateTimeImmutable();
$this->entityManager->flush();
$token = $this->getCsrfTokenFromOverview($quiz, '/unfinalize');
$this->client->request(Request::METHOD_POST, \sprintf('/backoffice/quiz/%s/unfinalize', $quiz->id), ['_token' => $token]);
$this->assertResponseRedirects();
$this->entityManager->clear();
$this->assertFalse($this->getQuizByName('Quiz 2')->isFinalized());
}
public function testUnfinalizeRefusedWhenQuizIsActive(): void
{
// Quiz 1 is finalized and active in the fixtures; scrape a token from Quiz 2 (same intention)
$quiz2 = $this->getQuizByName('Quiz 2');
$quiz2->finalizedAt = new DateTimeImmutable();
$this->entityManager->flush();
$token = $this->getCsrfTokenFromOverview($quiz2, '/unfinalize');
$quiz1 = $this->getQuizByName('Quiz 1');
$this->client->request(Request::METHOD_POST, \sprintf('/backoffice/quiz/%s/unfinalize', $quiz1->id), ['_token' => $token]);
$this->assertResponseRedirects();
$this->entityManager->clear();
$this->assertTrue($this->getQuizByName('Quiz 1')->isFinalized());
}
public function testUnfinalizeRefusedWhenCandidatesStarted(): void
{
$quiz = $this->getQuizByName('Quiz 2');
$quiz->finalizedAt = new DateTimeImmutable();
$this->entityManager->flush();
// Scrape the token before a candidate starts, since the button disappears afterwards
$token = $this->getCsrfTokenFromOverview($quiz, '/unfinalize');
$candidate = $this->entityManager->getRepository(Candidate::class)->findOneBy(['name' => 'Tom']);
$this->assertInstanceOf(Candidate::class, $candidate);
$quizCandidate = new QuizCandidate($quiz, $candidate);
$quizCandidate->started = new DateTimeImmutable();
$this->entityManager->persist($quizCandidate);
$this->entityManager->flush();
$this->client->request(Request::METHOD_POST, \sprintf('/backoffice/quiz/%s/unfinalize', $quiz->id), ['_token' => $token]);
$this->assertResponseRedirects();
$this->entityManager->clear();
$this->assertTrue($this->getQuizByName('Quiz 2')->isFinalized());
}
public function testClearQuizResetsFinalization(): void
{
$quiz = $this->getQuizByName('Quiz 1');
$this->assertTrue($quiz->isFinalized());
$token = $this->getCsrfTokenFromOverview($quiz, '/clear');
$this->client->request(Request::METHOD_POST, \sprintf('/backoffice/quiz/%s/clear', $quiz->id), ['_token' => $token]);
$this->assertResponseRedirects();
$this->entityManager->clear();
$this->assertFalse($this->getQuizByName('Quiz 1')->isFinalized());
}
}