src/Entity/StudentActivityAttempt.php line 17

Open in your IDE?
  1. <?php
  3. namespace App\Entity;
  5. use App\Entity\Traits\Timestampable;
  6. use App\Repository\StudentActivityAttemptRepository;
  7. use Doctrine\Common\Collections\ArrayCollection;
  8. use Doctrine\Common\Collections\Collection;
  9. use Doctrine\ORM\Mapping as ORM;
  11. // Une tentative d'un élève sur une Activity. `attemptNumber` s'incrémente à
  12. // chaque nouvelle tentative (voir Activity::maxAttempts pour la limite
  13. // éventuelle). `score`/`maxScore`/`success` sont calculés côté serveur à la
  14. // soumission (voir StudentAnswer pour le détail par question).
  15. #[ORM\HasLifecycleCallbacks]
  16. #[ORM\Entity(repositoryClass: StudentActivityAttemptRepository::class)]
  17. class StudentActivityAttempt
  18. {
  19.     use Timestampable;
  21.     #[ORM\Id]
  22.     #[ORM\GeneratedValue]
  23.     #[ORM\Column]
  24.     private ?int $id = null;
  26.     #[ORM\ManyToOne]
  27.     #[ORM\JoinColumn(nullable: false, onDelete: 'CASCADE')]
  28.     private ?Student $student = null;
  30.     #[ORM\ManyToOne]
  31.     #[ORM\JoinColumn(nullable: false, onDelete: 'CASCADE')]
  32.     private ?Activity $activity = null;
  34.     #[ORM\Column]
  35.     private int $attemptNumber = 1;
  37.     #[ORM\Column(nullable: true)]
  38.     private ?float $score = null;
  40.     #[ORM\Column(nullable: true)]
  41.     private ?float $maxScore = null;
  43.     #[ORM\Column(nullable: true)]
  44.     private ?bool $success = null;
  46.     // true = soumise automatiquement par le mobile suite à un dépassement de
  47.     // temps limite (Activity::timeLimitSeconds ou Capsule::timeLimitSeconds),
  48.     // false = soumise volontairement par l'élève. Sert à distinguer les deux
  49.     // cas dans le tableau de résultats enseignant.
  50.     #[ORM\Column(options: ['default' => false])]
  51.     private bool $autoSubmitted = false;
  53.     #[ORM\Column(type: 'datetime', nullable: true)]
  54.     private ?\DateTimeInterface $startedAt = null;
  56.     #[ORM\Column(type: 'datetime', nullable: true)]
  57.     private ?\DateTimeInterface $completedAt = null;
  59.     #[ORM\OneToMany(mappedBy: 'attempt', targetEntity: StudentAnswer::class, cascade: ['persist', 'remove'], orphanRemoval: true)]
  60.     private Collection $answers;
  62.     public function __construct()
  63.     {
  64.         $this->answers = new ArrayCollection();
  65.     }
  67.     public function getId(): ?int
  68.     {
  69.         return $this->id;
  70.     }
  72.     public function getStudent(): ?Student
  73.     {
  74.         return $this->student;
  75.     }
  77.     public function setStudent(?Student $student): static
  78.     {
  79.         $this->student = $student;
  81.         return $this;
  82.     }
  84.     public function getActivity(): ?Activity
  85.     {
  86.         return $this->activity;
  87.     }
  89.     public function setActivity(?Activity $activity): static
  90.     {
  91.         $this->activity = $activity;
  93.         return $this;
  94.     }
  96.     public function getAttemptNumber(): int
  97.     {
  98.         return $this->attemptNumber;
  99.     }
  101.     public function setAttemptNumber(int $attemptNumber): static
  102.     {
  103.         $this->attemptNumber = $attemptNumber;
  105.         return $this;
  106.     }
  108.     public function getScore(): ?float
  109.     {
  110.         return $this->score;
  111.     }
  113.     public function setScore(?float $score): static
  114.     {
  115.         $this->score = $score;
  117.         return $this;
  118.     }
  120.     public function getMaxScore(): ?float
  121.     {
  122.         return $this->maxScore;
  123.     }
  125.     public function setMaxScore(?float $maxScore): static
  126.     {
  127.         $this->maxScore = $maxScore;
  129.         return $this;
  130.     }
  132.     public function isSuccess(): ?bool
  133.     {
  134.         return $this->success;
  135.     }
  137.     public function setSuccess(?bool $success): static
  138.     {
  139.         $this->success = $success;
  141.         return $this;
  142.     }
  144.     public function isAutoSubmitted(): bool
  145.     {
  146.         return $this->autoSubmitted;
  147.     }
  149.     public function setAutoSubmitted(bool $autoSubmitted): static
  150.     {
  151.         $this->autoSubmitted = $autoSubmitted;
  153.         return $this;
  154.     }
  156.     public function getStartedAt(): ?\DateTimeInterface
  157.     {
  158.         return $this->startedAt;
  159.     }
  161.     public function setStartedAt(?\DateTimeInterface $startedAt): static
  162.     {
  163.         $this->startedAt = $startedAt;
  165.         return $this;
  166.     }
  168.     public function getCompletedAt(): ?\DateTimeInterface
  169.     {
  170.         return $this->completedAt;
  171.     }
  173.     public function setCompletedAt(?\DateTimeInterface $completedAt): static
  174.     {
  175.         $this->completedAt = $completedAt;
  177.         return $this;
  178.     }
  180.     /** @return Collection<int, StudentAnswer> */
  181.     public function getAnswers(): Collection
  182.     {
  183.         return $this->answers;
  184.     }
  186.     public function addAnswer(StudentAnswer $answer): static
  187.     {
  188.         if (!$this->answers->contains($answer)) {
  189.             $this->answers->add($answer);
  190.             $answer->setAttempt($this);
  191.         }
  193.         return $this;
  194.     }
  196.     public function removeAnswer(StudentAnswer $answer): static
  197.     {
  198.         if ($this->answers->removeElement($answer)) {
  199.             if ($answer->getAttempt() === $this) {
  200.                 $answer->setAttempt(null);
  201.             }
  202.         }
  204.         return $this;
  205.     }
  206. }