src/Entity/SubjectReference.php line 28

Open in your IDE?
  1. <?php
  3. namespace App\Entity;
  5. use App\Repository\SubjectReferenceRepository;
  6. use Doctrine\Common\Collections\ArrayCollection;
  7. use Doctrine\Common\Collections\Collection;
  8. use Doctrine\ORM\Mapping as ORM;
  9. use App\Entity\Traits\Timestampable;
  11. /**
  12.  * Référentiel national d'une matière pour une ClassOption donnée,
  13.  * pour une "version du programme" (SchoolYear) donnée.
  14.  *
  15.  * Exemple : "Mathématiques" pour la ClassOption "3ème", coef 4,
  16.  * version programme 2025-2026 → 1 SubjectReference.
  17.  *
  18.  * Reprend volontairement les mêmes propriétés que Subject (name, nameEn,
  19.  * coef, year, subjectGroup) à l'exception de tout ce qui rattache Subject
  20.  * à une instance concrète (school, classe, prof, notes...).
  21.  *
  22.  * Le superadmin crée ces référentiels et leurs Chapter associés.
  23.  * Chaque Subject réel "hérite" de la progression via
  24.  * SubjectReferenceRepository::findForSubject().
  25.  */
  26. #[ORM\HasLifecycleCallbacks]
  27. #[ORM\Entity(repositoryClass: SubjectReferenceRepository::class)]
  28. class SubjectReference
  29. {
  30.     use Timestampable;
  32.     #[ORM\Id]
  33.     #[ORM\GeneratedValue]
  34.     #[ORM\Column]
  35.     private ?int $id = null;
  37.     #[ORM\Column(length: 255)]
  38.     private ?string $name = null;
  40.     #[ORM\Column(length: 255, nullable: true)]
  41.     private ?string $nameEn = null;
  43.     /**
  44.      * Coefficient de référence de la matière pour cette ClassOption.
  45.      * Sert d'indication / valeur par défaut ; chaque Subject réel garde
  46.      * son propre coef (qui peut différer selon l'école).
  47.      */
  48.     #[ORM\Column(nullable: true)]
  49.     private ?float $coef = null;
  51.     #[ORM\ManyToOne(inversedBy: 'subjectReferences')]
  52.     #[ORM\JoinColumn(nullable: false)]
  53.     private ?ClassOption $classOption = null;
  55.     /**
  56.      * Groupe de matières national (équivalent national de SubjectGroup).
  57.      */
  58.     #[ORM\ManyToOne(inversedBy: 'subjectReferences')]
  59.     private ?SubjectGroupReference $subjectGroupReference = null;
  61.     /**
  62.      * "Version du programme national" : permet de faire évoluer le
  63.      * programme d'une année à l'autre sans perdre l'historique.
  64.      * Ex : SubjectReference "Maths - 3ème" version 2025-2026
  65.      *      vs           "Maths - 3ème" version 2026-2027.
  66.      */
  67.     #[ORM\ManyToOne(inversedBy: 'subjectReferences')]
  68.     #[ORM\JoinColumn(nullable: false)]
  69.     private ?SchoolYear $year = null;
  71.     #[ORM\OneToMany(mappedBy: 'subjectReference', targetEntity: Chapter::class, cascade: ['persist', 'remove'], orphanRemoval: true)]
  72.     #[ORM\OrderBy(['position' => 'ASC'])]
  73.     private Collection $chapters;
  75.     #[ORM\ManyToOne]
  76.     private ?User $author = null;
  78.     #[ORM\OneToMany(mappedBy: 'reference', targetEntity: Subject::class)]
  79.     private Collection $subjects;
  81.     public function __construct()
  82.     {
  83.         $this->chapters = new ArrayCollection();
  84.         $this->subjects = new ArrayCollection();
  85.     }
  87.     public function __toString(): string
  88.     {
  89.         return $this->name . ' (' . ($this->classOption?->getName() ?? '') . ')';
  90.     }
  92.     public function getId(): ?int
  93.     {
  94.         return $this->id;
  95.     }
  97.     public function getName(): ?string
  98.     {
  99.         return $this->name;
  100.     }
  102.     public function setName(string $name): static
  103.     {
  104.         $this->name = $name;
  106.         return $this;
  107.     }
  109.     public function getNameEn(): ?string
  110.     {
  111.         return $this->nameEn;
  112.     }
  114.     public function setNameEn(?string $nameEn): static
  115.     {
  116.         $this->nameEn = $nameEn;
  118.         return $this;
  119.     }
  121.     public function getCoef(): ?float
  122.     {
  123.         return $this->coef;
  124.     }
  126.     public function setCoef(?float $coef): static
  127.     {
  128.         $this->coef = $coef;
  130.         return $this;
  131.     }
  133.     public function getClassOption(): ?ClassOption
  134.     {
  135.         return $this->classOption;
  136.     }
  138.     public function setClassOption(?ClassOption $classOption): static
  139.     {
  140.         $this->classOption = $classOption;
  142.         return $this;
  143.     }
  145.     public function getSubjectGroupReference(): ?SubjectGroupReference
  146.     {
  147.         return $this->subjectGroupReference;
  148.     }
  150.     public function setSubjectGroupReference(?SubjectGroupReference $subjectGroupReference): static
  151.     {
  152.         $this->subjectGroupReference = $subjectGroupReference;
  154.         return $this;
  155.     }
  157.     public function getYear(): ?SchoolYear
  158.     {
  159.         return $this->year;
  160.     }
  162.     public function setYear(?SchoolYear $year): static
  163.     {
  164.         $this->year = $year;
  166.         return $this;
  167.     }
  169.     /**
  170.      * @return Collection<int, Chapter>
  171.      */
  172.     public function getChapters(): Collection
  173.     {
  174.         return $this->chapters;
  175.     }
  177.     public function addChapter(Chapter $chapter): static
  178.     {
  179.         if (!$this->chapters->contains($chapter)) {
  180.             $this->chapters->add($chapter);
  181.             $chapter->setSubjectReference($this);
  182.         }
  184.         return $this;
  185.     }
  187.     public function removeChapter(Chapter $chapter): static
  188.     {
  189.         if ($this->chapters->removeElement($chapter)) {
  190.             if ($chapter->getSubjectReference() === $this) {
  191.                 $chapter->setSubjectReference(null);
  192.             }
  193.         }
  195.         return $this;
  196.     }
  198.     public function getAuthor(): ?User
  199.     {
  200.         return $this->author;
  201.     }
  203.     public function setAuthor(?User $author): static
  204.     {
  205.         $this->author = $author;
  207.         return $this;
  208.     }
  210.     /**
  211.      * @return Collection<int, Subject>
  212.      */
  213.     public function getSubjects(): Collection
  214.     {
  215.         return $this->subjects;
  216.     }
  218.     public function addSubject(Subject $subject): static
  219.     {
  220.         if (!$this->subjects->contains($subject)) {
  221.             $this->subjects->add($subject);
  222.             $subject->setReference($this);
  223.         }
  225.         return $this;
  226.     }
  228.     public function removeSubject(Subject $subject): static
  229.     {
  230.         if ($this->subjects->removeElement($subject)) {
  231.             // set the owning side to null (unless already changed)
  232.             if ($subject->getReference() === $this) {
  233.                 $subject->setReference(null);
  234.             }
  235.         }
  237.         return $this;
  238.     }
  239. }