src/Entity/Activity.php line 20

Open in your IDE?
  1. <?php
  3. namespace App\Entity;
  5. use App\Entity\Traits\Timestampable;
  6. use App\Repository\ActivityRepository;
  7. use Doctrine\Common\Collections\ArrayCollection;
  8. use Doctrine\Common\Collections\Collection;
  9. use Doctrine\ORM\Mapping as ORM;
  11. // Activité interactive auto-corrigée (QCM, vrai/faux, réponse courte,
  12. // association, remise en ordre) portée par un CapsuleBlock de type
  13. // `activity`. Association optionnelle à une LearningCompetency — PAS à
  14. // App\Entity\Competence (système de notation trimestriel existant) : sur
  15. // demande explicite, cette compétence-ci n'a aucun rapport avec le trimestre,
  16. // elle sert seulement à suivre la progression continue de l'élève sur un
  17. // savoir-faire au travers de plusieurs activités (voir StudentActivityAttempt).
  18. #[ORM\HasLifecycleCallbacks]
  19. #[ORM\Entity(repositoryClass: ActivityRepository::class)]
  20. class Activity
  21. {
  22.     use Timestampable;
  24.     public const TYPE_QCM = 'qcm';
  25.     public const TYPE_TRUE_FALSE = 'true_false';
  26.     public const TYPE_SHORT_ANSWER = 'short_answer';
  27.     public const TYPE_MATCHING = 'matching';
  28.     public const TYPE_ORDERING = 'ordering';
  30.     #[ORM\Id]
  31.     #[ORM\GeneratedValue]
  32.     #[ORM\Column]
  33.     private ?int $id = null;
  35.     #[ORM\Column(length: 20)]
  36.     private ?string $type = null;
  38.     #[ORM\Column(type: 'text', nullable: true)]
  39.     private ?string $instructions = null;
  41.     #[ORM\ManyToOne]
  42.     #[ORM\JoinColumn(nullable: true, onDelete: 'SET NULL')]
  43.     private ?LearningCompetency $learningCompetency = null;
  45.     #[ORM\Column(nullable: true)]
  46.     private ?int $maxAttempts = null;
  48.     // Temps limite (en secondes) pour répondre à CETTE activité (quiz
  49.     // chronométré), indépendant de Capsule::timeLimitSeconds — les deux sont
  50.     // cumulables. Null = pas de limite propre à l'activité.
  51.     #[ORM\Column(nullable: true)]
  52.     private ?int $timeLimitSeconds = null;
  54.     #[ORM\ManyToOne]
  55.     #[ORM\JoinColumn(nullable: false)]
  56.     private ?User $author = null;
  58.     #[ORM\ManyToOne]
  59.     private ?User $editor = null;
  61.     // Côté inverse de CapsuleBlock::$activity (qui porte la FK) — permet de
  62.     // remonter school/year/subject pour le scoping des endpoints de sync
  63.     // (Activity n'a pas de lien direct vers Subject/School/SchoolYear).
  64.     #[ORM\OneToOne(mappedBy: 'activity')]
  65.     private ?CapsuleBlock $block = null;
  67.     #[ORM\OneToMany(mappedBy: 'activity', targetEntity: Question::class, cascade: ['persist', 'remove'], orphanRemoval: true)]
  68.     #[ORM\OrderBy(['position' => 'ASC'])]
  69.     private Collection $questions;
  71.     public function __construct()
  72.     {
  73.         $this->questions = new ArrayCollection();
  74.     }
  76.     public function getId(): ?int
  77.     {
  78.         return $this->id;
  79.     }
  81.     public function getType(): ?string
  82.     {
  83.         return $this->type;
  84.     }
  86.     public function setType(string $type): static
  87.     {
  88.         $this->type = $type;
  90.         return $this;
  91.     }
  93.     public function getInstructions(): ?string
  94.     {
  95.         return $this->instructions;
  96.     }
  98.     public function setInstructions(?string $instructions): static
  99.     {
  100.         $this->instructions = $instructions;
  102.         return $this;
  103.     }
  105.     public function getLearningCompetency(): ?LearningCompetency
  106.     {
  107.         return $this->learningCompetency;
  108.     }
  110.     public function setLearningCompetency(?LearningCompetency $learningCompetency): static
  111.     {
  112.         $this->learningCompetency = $learningCompetency;
  114.         return $this;
  115.     }
  117.     public function getMaxAttempts(): ?int
  118.     {
  119.         return $this->maxAttempts;
  120.     }
  122.     public function setMaxAttempts(?int $maxAttempts): static
  123.     {
  124.         $this->maxAttempts = $maxAttempts;
  126.         return $this;
  127.     }
  129.     public function getTimeLimitSeconds(): ?int
  130.     {
  131.         return $this->timeLimitSeconds;
  132.     }
  134.     public function setTimeLimitSeconds(?int $timeLimitSeconds): static
  135.     {
  136.         $this->timeLimitSeconds = $timeLimitSeconds;
  138.         return $this;
  139.     }
  141.     public function getAuthor(): ?User
  142.     {
  143.         return $this->author;
  144.     }
  146.     public function setAuthor(?User $author): static
  147.     {
  148.         $this->author = $author;
  150.         return $this;
  151.     }
  153.     public function getEditor(): ?User
  154.     {
  155.         return $this->editor;
  156.     }
  158.     public function setEditor(?User $editor): static
  159.     {
  160.         $this->editor = $editor;
  162.         return $this;
  163.     }
  165.     public function getBlock(): ?CapsuleBlock
  166.     {
  167.         return $this->block;
  168.     }
  170.     /** @return Collection<int, Question> */
  171.     public function getQuestions(): Collection
  172.     {
  173.         return $this->questions;
  174.     }
  176.     public function addQuestion(Question $question): static
  177.     {
  178.         if (!$this->questions->contains($question)) {
  179.             $this->questions->add($question);
  180.             $question->setActivity($this);
  181.         }
  183.         return $this;
  184.     }
  186.     public function removeQuestion(Question $question): static
  187.     {
  188.         if ($this->questions->removeElement($question)) {
  189.             if ($question->getActivity() === $this) {
  190.                 $question->setActivity(null);
  191.             }
  192.         }
  194.         return $this;
  195.     }
  196. }