src/Entity/Question.php line 17

Open in your IDE?
  1. <?php
  3. namespace App\Entity;
  5. use App\Entity\Traits\Timestampable;
  6. use App\Repository\QuestionRepository;
  7. use Doctrine\Common\Collections\ArrayCollection;
  8. use Doctrine\Common\Collections\Collection;
  9. use Doctrine\ORM\Mapping as ORM;
  11. // Question d'une Activity. `type` reprend en général celui de l'Activity
  12. // parente mais reste porté ici pour permettre, à terme, des activités mixtes.
  13. // `matchMode` ne s'applique qu'aux questions de type short_answer (stratégie
  14. // de correction du texte libre : exact|ci [insensible à la casse]|contains).
  15. #[ORM\HasLifecycleCallbacks]
  16. #[ORM\Entity(repositoryClass: QuestionRepository::class)]
  17. class Question
  18. {
  19.     use Timestampable;
  21.     public const MATCH_EXACT = 'exact';
  22.     public const MATCH_CASE_INSENSITIVE = 'ci';
  23.     public const MATCH_CONTAINS = 'contains';
  25.     #[ORM\Id]
  26.     #[ORM\GeneratedValue]
  27.     #[ORM\Column]
  28.     private ?int $id = null;
  30.     #[ORM\ManyToOne(inversedBy: 'questions')]
  31.     #[ORM\JoinColumn(nullable: false, onDelete: 'CASCADE')]
  32.     private ?Activity $activity = null;
  34.     #[ORM\Column(length: 20)]
  35.     private ?string $type = null;
  37.     #[ORM\Column(type: 'text')]
  38.     private ?string $text = null;
  40.     #[ORM\Column]
  41.     private int $position = 0;
  43.     #[ORM\Column(length: 20, nullable: true)]
  44.     private ?string $matchMode = null;
  46.     // Compétence évaluée par CETTE question précise (module Apprentissage) —
  47.     // niveau le plus spécifique de la chaîne de résolution, voir
  48.     // getEffectiveLearningCompetency(). Utile quand un même exercice mélange
  49.     // des questions qui ne testent pas toutes le même savoir-faire.
  50.     #[ORM\ManyToOne]
  51.     #[ORM\JoinColumn(nullable: true, onDelete: 'SET NULL')]
  52.     private ?LearningCompetency $learningCompetency = null;
  54.     #[ORM\OneToMany(mappedBy: 'question', targetEntity: QuestionOption::class, cascade: ['persist', 'remove'], orphanRemoval: true)]
  55.     #[ORM\OrderBy(['position' => 'ASC'])]
  56.     private Collection $options;
  58.     public function __construct()
  59.     {
  60.         $this->options = new ArrayCollection();
  61.     }
  63.     public function getId(): ?int
  64.     {
  65.         return $this->id;
  66.     }
  68.     public function getActivity(): ?Activity
  69.     {
  70.         return $this->activity;
  71.     }
  73.     public function setActivity(?Activity $activity): static
  74.     {
  75.         $this->activity = $activity;
  77.         return $this;
  78.     }
  80.     public function getType(): ?string
  81.     {
  82.         return $this->type;
  83.     }
  85.     public function setType(string $type): static
  86.     {
  87.         $this->type = $type;
  89.         return $this;
  90.     }
  92.     public function getText(): ?string
  93.     {
  94.         return $this->text;
  95.     }
  97.     public function setText(string $text): static
  98.     {
  99.         $this->text = $text;
  101.         return $this;
  102.     }
  104.     public function getPosition(): int
  105.     {
  106.         return $this->position;
  107.     }
  109.     public function setPosition(int $position): static
  110.     {
  111.         $this->position = $position;
  113.         return $this;
  114.     }
  116.     public function getMatchMode(): ?string
  117.     {
  118.         return $this->matchMode;
  119.     }
  121.     public function setMatchMode(?string $matchMode): static
  122.     {
  123.         $this->matchMode = $matchMode;
  125.         return $this;
  126.     }
  128.     public function getLearningCompetency(): ?LearningCompetency
  129.     {
  130.         return $this->learningCompetency;
  131.     }
  133.     public function setLearningCompetency(?LearningCompetency $learningCompetency): static
  134.     {
  135.         $this->learningCompetency = $learningCompetency;
  137.         return $this;
  138.     }
  140.     /**
  141.      * Compétence réellement mesurée par cette question, en remontant la
  142.      * chaîne question → activité → capsule jusqu'à trouver un niveau qui en
  143.      * précise une (le plus spécifique gagne) — voir demande utilisateur :
  144.      * "associer une capsule ou un quiz à cette compétence, ou des questions
  145.      * des exercices à cette compétence".
  146.      */
  147.     public function getEffectiveLearningCompetency(): ?LearningCompetency
  148.     {
  149.         return $this->learningCompetency
  150.             ?? $this->activity?->getLearningCompetency()
  151.             ?? $this->activity?->getBlock()?->getCapsule()?->getLearningCompetency();
  152.     }
  154.     /** @return Collection<int, QuestionOption> */
  155.     public function getOptions(): Collection
  156.     {
  157.         return $this->options;
  158.     }
  160.     public function addOption(QuestionOption $option): static
  161.     {
  162.         if (!$this->options->contains($option)) {
  163.             $this->options->add($option);
  164.             $option->setQuestion($this);
  165.         }
  167.         return $this;
  168.     }
  170.     public function removeOption(QuestionOption $option): static
  171.     {
  172.         if ($this->options->removeElement($option)) {
  173.             if ($option->getQuestion() === $this) {
  174.                 $option->setQuestion(null);
  175.             }
  176.         }
  178.         return $this;
  179.     }
  180. }