src/Entity/StudentAnswer.php line 15

Open in your IDE?
  1. <?php
  3. namespace App\Entity;
  5. use App\Entity\Traits\Timestampable;
  6. use App\Repository\StudentAnswerRepository;
  7. use Doctrine\ORM\Mapping as ORM;
  9. // Réponse d'un élève à une Question, dans le cadre d'une StudentActivityAttempt.
  10. // `rawAnswer` porte soit du texte libre (short_answer), soit un JSON encodé
  11. // (tableau d'ids QuestionOption sélectionnés pour qcm/true_false/matching, ou
  12. // tableau d'ids dans l'ordre proposé par l'élève pour ordering).
  13. #[ORM\HasLifecycleCallbacks]
  14. #[ORM\Entity(repositoryClass: StudentAnswerRepository::class)]
  15. class StudentAnswer
  16. {
  17.     use Timestampable;
  19.     #[ORM\Id]
  20.     #[ORM\GeneratedValue]
  21.     #[ORM\Column]
  22.     private ?int $id = null;
  24.     #[ORM\ManyToOne(inversedBy: 'answers')]
  25.     #[ORM\JoinColumn(nullable: false, onDelete: 'CASCADE')]
  26.     private ?StudentActivityAttempt $attempt = null;
  28.     #[ORM\ManyToOne]
  29.     #[ORM\JoinColumn(nullable: false, onDelete: 'CASCADE')]
  30.     private ?Question $question = null;
  32.     #[ORM\Column(type: 'text', nullable: true)]
  33.     private ?string $rawAnswer = null;
  35.     #[ORM\Column(nullable: true)]
  36.     private ?bool $isCorrect = null;
  38.     #[ORM\Column(nullable: true)]
  39.     private ?float $pointsEarned = null;
  41.     // Surclassement manuel par un enseignant, pour les réponses ouvertes
  42.     // (short_answer) que la correction automatique (exact/ci/contains) juge
  43.     // insatisfaisant. Quand renseigné, prime sur pointsEarned/isCorrect pour
  44.     // le calcul du score de la tentative (voir CapsuleGradingService).
  45.     #[ORM\Column(nullable: true)]
  46.     private ?float $teacherPointsEarned = null;
  48.     #[ORM\Column(type: 'text', nullable: true)]
  49.     private ?string $teacherFeedback = null;
  51.     #[ORM\ManyToOne]
  52.     #[ORM\JoinColumn(nullable: true, onDelete: 'SET NULL')]
  53.     private ?User $gradedBy = null;
  55.     #[ORM\Column(type: 'datetime', nullable: true)]
  56.     private ?\DateTimeInterface $gradedAt = null;
  58.     public function getId(): ?int
  59.     {
  60.         return $this->id;
  61.     }
  63.     public function getAttempt(): ?StudentActivityAttempt
  64.     {
  65.         return $this->attempt;
  66.     }
  68.     public function setAttempt(?StudentActivityAttempt $attempt): static
  69.     {
  70.         $this->attempt = $attempt;
  72.         return $this;
  73.     }
  75.     public function getQuestion(): ?Question
  76.     {
  77.         return $this->question;
  78.     }
  80.     public function setQuestion(?Question $question): static
  81.     {
  82.         $this->question = $question;
  84.         return $this;
  85.     }
  87.     public function getRawAnswer(): ?string
  88.     {
  89.         return $this->rawAnswer;
  90.     }
  92.     public function setRawAnswer(?string $rawAnswer): static
  93.     {
  94.         $this->rawAnswer = $rawAnswer;
  96.         return $this;
  97.     }
  99.     public function isCorrect(): ?bool
  100.     {
  101.         return $this->isCorrect;
  102.     }
  104.     public function setIsCorrect(?bool $isCorrect): static
  105.     {
  106.         $this->isCorrect = $isCorrect;
  108.         return $this;
  109.     }
  111.     public function getPointsEarned(): ?float
  112.     {
  113.         return $this->pointsEarned;
  114.     }
  116.     public function setPointsEarned(?float $pointsEarned): static
  117.     {
  118.         $this->pointsEarned = $pointsEarned;
  120.         return $this;
  121.     }
  123.     public function getTeacherPointsEarned(): ?float
  124.     {
  125.         return $this->teacherPointsEarned;
  126.     }
  128.     public function setTeacherPointsEarned(?float $teacherPointsEarned): static
  129.     {
  130.         $this->teacherPointsEarned = $teacherPointsEarned;
  132.         return $this;
  133.     }
  135.     public function getTeacherFeedback(): ?string
  136.     {
  137.         return $this->teacherFeedback;
  138.     }
  140.     public function setTeacherFeedback(?string $teacherFeedback): static
  141.     {
  142.         $this->teacherFeedback = $teacherFeedback;
  144.         return $this;
  145.     }
  147.     public function getGradedBy(): ?User
  148.     {
  149.         return $this->gradedBy;
  150.     }
  152.     public function setGradedBy(?User $gradedBy): static
  153.     {
  154.         $this->gradedBy = $gradedBy;
  156.         return $this;
  157.     }
  159.     public function getGradedAt(): ?\DateTimeInterface
  160.     {
  161.         return $this->gradedAt;
  162.     }
  164.     public function setGradedAt(?\DateTimeInterface $gradedAt): static
  165.     {
  166.         $this->gradedAt = $gradedAt;
  168.         return $this;
  169.     }
  171.     /**
  172.      * Score effectif de cette réponse : la correction manuelle prime sur le
  173.      * calcul automatique quand elle a été saisie.
  174.      */
  175.     public function getEffectivePointsEarned(): ?float
  176.     {
  177.         return $this->teacherPointsEarned ?? $this->pointsEarned;
  178.     }
  180.     /**
  181.      * true seulement pour les réponses ouvertes (short_answer) — les seules
  182.      * pouvant faire l'objet d'une correction manuelle (QCM/vrai-faux/
  183.      * appariement/ordonnancement restent toujours entièrement auto-corrigés).
  184.      */
  185.     public function isManuallyGradable(): bool
  186.     {
  187.         return $this->question?->getType() === Activity::TYPE_SHORT_ANSWER;
  188.     }
  189. }