src/Entity/Capsule.php line 21

Open in your IDE?
  1. <?php
  3. namespace App\Entity;
  5. use App\Entity\Traits\Timestampable;
  6. use App\Repository\CapsuleRepository;
  7. use Doctrine\Common\Collections\ArrayCollection;
  8. use Doctrine\Common\Collections\Collection;
  9. use Doctrine\ORM\Mapping as ORM;
  11. // Contenu pédagogique numérique interactif (module Apprentissage) : une suite
  12. // ordonnée de CapsuleBlock consultée par l'élève, avec éventuellement des
  13. // activités auto-corrigées. Rattachée à une Subject (donc à une classe/école/
  14. // année via Subject) et, optionnellement, à un SubjectLesson existant du
  15. // cahier de texte pour "digitaliser" ce point précis du programme — une
  16. // capsule sans subjectLesson est un contenu/exercice libre. Entité neuve et
  17. // isolée : aucun rapport avec Lesson/SubjectLesson/LessonProgress au-delà de
  18. // ce lien optionnel purement additif.
  19. #[ORM\HasLifecycleCallbacks]
  20. #[ORM\Entity(repositoryClass: CapsuleRepository::class)]
  21. class Capsule
  22. {
  23.     use Timestampable;
  25.     #[ORM\Id]
  26.     #[ORM\GeneratedValue]
  27.     #[ORM\Column]
  28.     private ?int $id = null;
  30.     #[ORM\ManyToOne(inversedBy: 'capsules')]
  31.     #[ORM\JoinColumn(nullable: false, onDelete: 'CASCADE')]
  32.     private ?Subject $subject = null;
  34.     #[ORM\ManyToOne(inversedBy: 'capsules')]
  35.     #[ORM\JoinColumn(nullable: true, onDelete: 'SET NULL')]
  36.     private ?SubjectLesson $subjectLesson = null;
  38.     #[ORM\Column(length: 255)]
  39.     private ?string $title = null;
  41.     #[ORM\Column(type: 'text', nullable: true)]
  42.     private ?string $description = null;
  44.     #[ORM\Column]
  45.     private int $position = 0;
  47.     #[ORM\Column]
  48.     private bool $published = false;
  50.     #[ORM\Column(type: 'datetime', nullable: true)]
  51.     private ?\DateTimeInterface $publishedAt = null;
  53.     // Temps limite (en secondes) de consultation de l'ENSEMBLE de la capsule,
  54.     // cumulé sur toutes les sessions de l'élève (voir
  55.     // StudentCapsuleProgress::timeSpentSeconds). Null = pas de limite. Une
  56.     // fois atteint, le mobile verrouille l'écran et soumet automatiquement
  57.     // les tentatives d'activité en cours (voir StudentActivityAttempt::autoSubmitted).
  58.     #[ORM\Column(nullable: true)]
  59.     private ?int $timeLimitSeconds = null;
  61.     // Compétence évaluée par TOUTE la capsule (module Apprentissage,
  62.     // indépendant du système trimestriel — voir LearningCompetency). Niveau
  63.     // le plus large de la chaîne de résolution : une Activity ou une Question
  64.     // peuvent avoir leur propre compétence, plus spécifique, qui prime alors
  65.     // sur celle-ci (voir Question::getEffectiveLearningCompetency()). Choix
  66.     // proposés limités aux compétences de subjectLesson — vide si la capsule
  67.     // n'est pas rattachée à une leçon/TD.
  68.     #[ORM\ManyToOne]
  69.     #[ORM\JoinColumn(nullable: true, onDelete: 'SET NULL')]
  70.     private ?LearningCompetency $learningCompetency = null;
  72.     // Trimestre auquel rattacher la capsule pour permettre à l'élève de
  73.     // filtrer les capsules par trimestre + matière côté mobile. Sans rapport
  74.     // avec le système de notation (Quarter est simplement réutilisé comme
  75.     // référentiel de périodes déjà connu de l'école) — null = visible sur
  76.     // tous les trimestres.
  77.     #[ORM\ManyToOne]
  78.     #[ORM\JoinColumn(nullable: true, onDelete: 'SET NULL')]
  79.     private ?Quarter $quarter = null;
  81.     // Photo de couverture affichée sur la carte de la capsule (web et
  82.     // mobile) — chemin relatif sous le même répertoire média que les blocs
  83.     // (voir CapsuleBlockController::moveMediaFile). Null = visuel par défaut.
  84.     #[ORM\Column(length: 255, nullable: true)]
  85.     private ?string $coverPath = null;
  87.     #[ORM\ManyToOne]
  88.     #[ORM\JoinColumn(nullable: false)]
  89.     private ?User $author = null;
  91.     #[ORM\ManyToOne]
  92.     private ?User $editor = null;
  94.     #[ORM\OneToMany(mappedBy: 'capsule', targetEntity: CapsuleBlock::class, cascade: ['persist', 'remove'], orphanRemoval: true)]
  95.     #[ORM\OrderBy(['position' => 'ASC'])]
  96.     private Collection $blocks;
  98.     public function __construct()
  99.     {
  100.         $this->blocks = new ArrayCollection();
  101.     }
  103.     public function __toString(): string
  104.     {
  105.         return $this->title ?? '';
  106.     }
  108.     public function getId(): ?int
  109.     {
  110.         return $this->id;
  111.     }
  113.     public function getSubject(): ?Subject
  114.     {
  115.         return $this->subject;
  116.     }
  118.     public function setSubject(?Subject $subject): static
  119.     {
  120.         $this->subject = $subject;
  122.         return $this;
  123.     }
  125.     public function getSubjectLesson(): ?SubjectLesson
  126.     {
  127.         return $this->subjectLesson;
  128.     }
  130.     public function setSubjectLesson(?SubjectLesson $subjectLesson): static
  131.     {
  132.         $this->subjectLesson = $subjectLesson;
  134.         return $this;
  135.     }
  137.     public function getTitle(): ?string
  138.     {
  139.         return $this->title;
  140.     }
  142.     public function setTitle(string $title): static
  143.     {
  144.         $this->title = $title;
  146.         return $this;
  147.     }
  149.     public function getDescription(): ?string
  150.     {
  151.         return $this->description;
  152.     }
  154.     public function setDescription(?string $description): static
  155.     {
  156.         $this->description = $description;
  158.         return $this;
  159.     }
  161.     public function getPosition(): int
  162.     {
  163.         return $this->position;
  164.     }
  166.     public function setPosition(int $position): static
  167.     {
  168.         $this->position = $position;
  170.         return $this;
  171.     }
  173.     public function isPublished(): bool
  174.     {
  175.         return $this->published;
  176.     }
  178.     public function setPublished(bool $published): static
  179.     {
  180.         $this->published = $published;
  182.         return $this;
  183.     }
  185.     public function getPublishedAt(): ?\DateTimeInterface
  186.     {
  187.         return $this->publishedAt;
  188.     }
  190.     public function setPublishedAt(?\DateTimeInterface $publishedAt): static
  191.     {
  192.         $this->publishedAt = $publishedAt;
  194.         return $this;
  195.     }
  197.     public function getTimeLimitSeconds(): ?int
  198.     {
  199.         return $this->timeLimitSeconds;
  200.     }
  202.     public function setTimeLimitSeconds(?int $timeLimitSeconds): static
  203.     {
  204.         $this->timeLimitSeconds = $timeLimitSeconds;
  206.         return $this;
  207.     }
  209.     public function getLearningCompetency(): ?LearningCompetency
  210.     {
  211.         return $this->learningCompetency;
  212.     }
  214.     public function setLearningCompetency(?LearningCompetency $learningCompetency): static
  215.     {
  216.         $this->learningCompetency = $learningCompetency;
  218.         return $this;
  219.     }
  221.     public function getQuarter(): ?Quarter
  222.     {
  223.         return $this->quarter;
  224.     }
  226.     public function setQuarter(?Quarter $quarter): static
  227.     {
  228.         $this->quarter = $quarter;
  230.         return $this;
  231.     }
  233.     public function getCoverPath(): ?string
  234.     {
  235.         return $this->coverPath;
  236.     }
  238.     public function setCoverPath(?string $coverPath): static
  239.     {
  240.         $this->coverPath = $coverPath;
  242.         return $this;
  243.     }
  245.     public function getAuthor(): ?User
  246.     {
  247.         return $this->author;
  248.     }
  250.     public function setAuthor(?User $author): static
  251.     {
  252.         $this->author = $author;
  254.         return $this;
  255.     }
  257.     public function getEditor(): ?User
  258.     {
  259.         return $this->editor;
  260.     }
  262.     public function setEditor(?User $editor): static
  263.     {
  264.         $this->editor = $editor;
  266.         return $this;
  267.     }
  269.     /** @return Collection<int, CapsuleBlock> */
  270.     public function getBlocks(): Collection
  271.     {
  272.         return $this->blocks;
  273.     }
  275.     public function addBlock(CapsuleBlock $block): static
  276.     {
  277.         if (!$this->blocks->contains($block)) {
  278.             $this->blocks->add($block);
  279.             $block->setCapsule($this);
  280.         }
  282.         return $this;
  283.     }
  285.     public function removeBlock(CapsuleBlock $block): static
  286.     {
  287.         if ($this->blocks->removeElement($block)) {
  288.             if ($block->getCapsule() === $this) {
  289.                 $block->setCapsule(null);
  290.             }
  291.         }
  293.         return $this;
  294.     }
  295. }