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 Lesson 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.     /**
  52.      * Horaire hebdomadaire de référence (nombre d'heures de cours par
  53.      * semaine) pour cette matière du programme national, facultatif.
  54.      */
  55.     #[ORM\Column(nullable: true)]
  56.     private ?float $horaire = null;
  58.     #[ORM\ManyToOne(inversedBy: 'subjectReferences')]
  59.     #[ORM\JoinColumn(nullable: false)]
  60.     private ?ClassOption $classOption = null;
  62.     /**
  63.      * Groupe de matières national (équivalent national de SubjectGroup).
  64.      */
  65.     #[ORM\ManyToOne(inversedBy: 'subjectReferences')]
  66.     private ?SubjectGroupReference $subjectGroupReference = null;
  68.     /**
  69.      * "Version du programme national" : permet de faire évoluer le
  70.      * programme d'une année à l'autre sans perdre l'historique.
  71.      * Ex : SubjectReference "Maths - 3ème" version 2025-2026
  72.      *      vs           "Maths - 3ème" version 2026-2027.
  73.      */
  74.     #[ORM\ManyToOne(inversedBy: 'subjectReferences')]
  75.     #[ORM\JoinColumn(nullable: false)]
  76.     private ?SchoolYear $year = null;
  78.     #[ORM\OneToMany(mappedBy: 'subjectReference', targetEntity: Lesson::class, cascade: ['persist', 'remove'], orphanRemoval: true)]
  79.     #[ORM\OrderBy(['position' => 'ASC'])]
  80.     private Collection $lessons;
  82.     #[ORM\OneToMany(mappedBy: 'subjectReference', targetEntity: Module::class, cascade: ['persist', 'remove'], orphanRemoval: true)]
  83.     #[ORM\OrderBy(['position' => 'ASC'])]
  84.     private Collection $modules;
  86.     #[ORM\OneToMany(mappedBy: 'subjectReference', targetEntity: LearningUnit::class, cascade: ['persist', 'remove'], orphanRemoval: true)]
  87.     #[ORM\OrderBy(['position' => 'ASC'])]
  88.     private Collection $learningUnits;
  90.     #[ORM\OneToMany(mappedBy: 'subjectReference', targetEntity: CompetenceReference::class, cascade: ['persist', 'remove'], orphanRemoval: true)]
  91.     #[ORM\OrderBy(['quarterNumber' => 'ASC', 'position' => 'ASC'])]
  92.     private Collection $competenceReferences;
  94.     /**
  95.      * Sous-matières du programme national (écoles primaires/maternelles) —
  96.      * voir SubjectComponentReference.
  97.      */
  98.     #[ORM\OneToMany(mappedBy: 'subjectReference', targetEntity: SubjectComponentReference::class, cascade: ['persist', 'remove'], orphanRemoval: true)]
  99.     #[ORM\OrderBy(['position' => 'ASC'])]
  100.     private Collection $subjectComponentReferences;
  102.     #[ORM\ManyToOne]
  103.     private ?User $author = null;
  105.     #[ORM\OneToMany(mappedBy: 'reference', targetEntity: Subject::class)]
  106.     private Collection $subjects;
  108.     public function __construct()
  109.     {
  110.         $this->lessons = new ArrayCollection();
  111.         $this->subjects = new ArrayCollection();
  112.         $this->competenceReferences = new ArrayCollection();
  113.         $this->subjectComponentReferences = new ArrayCollection();
  114.         $this->modules = new ArrayCollection();
  115.         $this->learningUnits = new ArrayCollection();
  116.     }
  118.     public function __toString(): string
  119.     {
  120.         return $this->name . ' (' . ($this->classOption?->getName() ?? '') . ')';
  121.     }
  123.     public function getId(): ?int
  124.     {
  125.         return $this->id;
  126.     }
  128.     public function getName(): ?string
  129.     {
  130.         return $this->name;
  131.     }
  133.     public function setName(string $name): static
  134.     {
  135.         $this->name = $name;
  137.         return $this;
  138.     }
  140.     public function getNameEn(): ?string
  141.     {
  142.         return $this->nameEn;
  143.     }
  145.     public function setNameEn(?string $nameEn): static
  146.     {
  147.         $this->nameEn = $nameEn;
  149.         return $this;
  150.     }
  152.     public function getCoef(): ?float
  153.     {
  154.         return $this->coef;
  155.     }
  157.     public function setCoef(?float $coef): static
  158.     {
  159.         $this->coef = $coef;
  161.         return $this;
  162.     }
  164.     public function getHoraire(): ?float
  165.     {
  166.         return $this->horaire;
  167.     }
  169.     public function setHoraire(?float $horaire): static
  170.     {
  171.         $this->horaire = $horaire;
  173.         return $this;
  174.     }
  176.     public function getClassOption(): ?ClassOption
  177.     {
  178.         return $this->classOption;
  179.     }
  181.     public function setClassOption(?ClassOption $classOption): static
  182.     {
  183.         $this->classOption = $classOption;
  185.         return $this;
  186.     }
  188.     public function getSubjectGroupReference(): ?SubjectGroupReference
  189.     {
  190.         return $this->subjectGroupReference;
  191.     }
  193.     public function setSubjectGroupReference(?SubjectGroupReference $subjectGroupReference): static
  194.     {
  195.         $this->subjectGroupReference = $subjectGroupReference;
  197.         return $this;
  198.     }
  200.     public function getYear(): ?SchoolYear
  201.     {
  202.         return $this->year;
  203.     }
  205.     public function setYear(?SchoolYear $year): static
  206.     {
  207.         $this->year = $year;
  209.         return $this;
  210.     }
  212.     /**
  213.      * @return Collection<int, Lesson>
  214.      */
  215.     public function getLessons(): Collection
  216.     {
  217.         return $this->lessons;
  218.     }
  220.     public function addLesson(Lesson $lesson): static
  221.     {
  222.         if (!$this->lessons->contains($lesson)) {
  223.             $this->lessons->add($lesson);
  224.             $lesson->setSubjectReference($this);
  225.         }
  227.         return $this;
  228.     }
  230.     public function removeLesson(Lesson $lesson): static
  231.     {
  232.         if ($this->lessons->removeElement($lesson)) {
  233.             if ($lesson->getSubjectReference() === $this) {
  234.                 $lesson->setSubjectReference(null);
  235.             }
  236.         }
  238.         return $this;
  239.     }
  241.     /**
  242.      * @return Collection<int, CompetenceReference>
  243.      */
  244.     public function getCompetenceReferences(): Collection
  245.     {
  246.         return $this->competenceReferences;
  247.     }
  249.     public function addCompetenceReference(CompetenceReference $competenceReference): static
  250.     {
  251.         if (!$this->competenceReferences->contains($competenceReference)) {
  252.             $this->competenceReferences->add($competenceReference);
  253.             $competenceReference->setSubjectReference($this);
  254.         }
  256.         return $this;
  257.     }
  259.     public function removeCompetenceReference(CompetenceReference $competenceReference): static
  260.     {
  261.         if ($this->competenceReferences->removeElement($competenceReference)) {
  262.             if ($competenceReference->getSubjectReference() === $this) {
  263.                 $competenceReference->setSubjectReference(null);
  264.             }
  265.         }
  267.         return $this;
  268.     }
  270.     /**
  271.      * @return Collection<int, SubjectComponentReference>
  272.      */
  273.     public function getSubjectComponentReferences(): Collection
  274.     {
  275.         return $this->subjectComponentReferences;
  276.     }
  278.     public function addSubjectComponentReference(SubjectComponentReference $subjectComponentReference): static
  279.     {
  280.         if (!$this->subjectComponentReferences->contains($subjectComponentReference)) {
  281.             $this->subjectComponentReferences->add($subjectComponentReference);
  282.             $subjectComponentReference->setSubjectReference($this);
  283.         }
  285.         return $this;
  286.     }
  288.     public function removeSubjectComponentReference(SubjectComponentReference $subjectComponentReference): static
  289.     {
  290.         if ($this->subjectComponentReferences->removeElement($subjectComponentReference)) {
  291.             if ($subjectComponentReference->getSubjectReference() === $this) {
  292.                 $subjectComponentReference->setSubjectReference(null);
  293.             }
  294.         }
  296.         return $this;
  297.     }
  299.     public function getAuthor(): ?User
  300.     {
  301.         return $this->author;
  302.     }
  304.     public function setAuthor(?User $author): static
  305.     {
  306.         $this->author = $author;
  308.         return $this;
  309.     }
  311.     /** @return Collection<int, Module> */
  312.     public function getModules(): Collection
  313.     {
  314.         return $this->modules;
  315.     }
  317.     /** @return Collection<int, LearningUnit> */
  318.     public function getLearningUnits(): Collection
  319.     {
  320.         return $this->learningUnits;
  321.     }
  323.     /**
  324.      * @return Collection<int, Subject>
  325.      */
  326.     public function getSubjects(): Collection
  327.     {
  328.         return $this->subjects;
  329.     }
  331.     public function addSubject(Subject $subject): static
  332.     {
  333.         if (!$this->subjects->contains($subject)) {
  334.             $this->subjects->add($subject);
  335.             $subject->setReference($this);
  336.         }
  338.         return $this;
  339.     }
  341.     public function removeSubject(Subject $subject): static
  342.     {
  343.         if ($this->subjects->removeElement($subject)) {
  344.             // set the owning side to null (unless already changed)
  345.             if ($subject->getReference() === $this) {
  346.                 $subject->setReference(null);
  347.             }
  348.         }
  350.         return $this;
  351.     }
  352. }