<?php
namespace App\Entity;
use App\Repository\CompetenceRepository;
use Doctrine\Common\Collections\ArrayCollection;
use Doctrine\Common\Collections\Collection;
use Doctrine\ORM\Mapping as ORM;
use JMS\Serializer\Annotation\Groups;
#[ORM\Entity(repositoryClass: CompetenceRepository::class)]
class Competence
{
#[ORM\Id]
#[ORM\GeneratedValue]
#[ORM\Column]
#[Groups(['note'])]
private ?int $id = null;
// Nullable : une Competence du système "par compétence" est rattachée à un
// Quarter (trimestre), pas à un Exams (séquence) — exam et quarter sont
// mutuellement exclusifs selon le système d'évaluation de la classe.
#[ORM\ManyToOne(inversedBy: 'competences')]
private ?Exams $exam = null;
// Exposé côté API notes (groupe 'note') : l'app mobile affiche le
// trimestre à côté de la matière pour une note de compétence — sans
// séquence (Exams) pour s'y raccrocher visuellement comme en système
// séquentiel, le trimestre est la seule référence temporelle utile ici.
#[ORM\ManyToOne]
#[Groups(['note'])]
private ?Quarter $quarter = null;
// Trace la CompetenceReference nationale (super-admin) dont cette Competence
// a été copiée, pour permettre une synchronisation ultérieure (nouvelles
// compétences ajoutées côté référentiel) sans écraser les personnalisations
// locales déjà faites par l'école — cf. SubjectLessonCopier pour le patron.
#[ORM\ManyToOne]
private ?CompetenceReference $sourceCompetence = null;
#[ORM\ManyToOne(inversedBy: 'competences')]
#[ORM\JoinColumn(nullable: false)]
private ?Subject $subject = null;
#[ORM\Column(type: 'string', length: 255, nullable: true)]
#[Groups(['note'])]
private ?string $content = null;
#[ORM\ManyToOne(inversedBy: 'competences')]
#[ORM\JoinColumn(nullable: false)]
private ?School $school = null;
#[ORM\ManyToOne(inversedBy: 'competences')]
#[ORM\JoinColumn(nullable: false)]
private ?TheClass $classe = null;
#[ORM\ManyToOne(inversedBy: 'competences')]
#[ORM\JoinColumn(nullable: false)]
private ?SchoolYear $year = null;
#[ORM\ManyToOne(inversedBy: 'competences')]
#[ORM\JoinColumn(nullable: false)]
private ?User $author = null;
// Une même compétence évaluée plusieurs fois dans le trimestre : au lieu de
// dupliquer le libellé (fragile — texte ressaisi à l'identique), l'école
// crée une "évaluation supplémentaire" qui pointe vers la Competence
// d'origine (le "leader" du groupe, avec evaluationOf = null). Un seul
// niveau de rattachement (pas de chaîne : voir getGroupLeader()) — chaque
// évaluation reste un Note/ParentNote indépendant, seul l'affichage
// (bulletin, écran de saisie) regroupe les évaluations d'un même leader.
#[ORM\ManyToOne(targetEntity: self::class, inversedBy: 'additionalEvaluations')]
#[ORM\JoinColumn(name: 'evaluation_of_id', nullable: true, onDelete: 'RESTRICT')]
private ?Competence $evaluationOf = null;
/** @var Collection<int, Competence> */
#[ORM\OneToMany(mappedBy: 'evaluationOf', targetEntity: self::class)]
private Collection $additionalEvaluations;
public function __construct()
{
$this->additionalEvaluations = new ArrayCollection();
}
public function getId(): ?int
{
return $this->id;
}
public function getExam(): ?Exams
{
return $this->exam;
}
public function setExam(?Exams $exam): static
{
$this->exam = $exam;
return $this;
}
public function getQuarter(): ?Quarter
{
return $this->quarter;
}
public function setQuarter(?Quarter $quarter): static
{
$this->quarter = $quarter;
return $this;
}
public function getSourceCompetence(): ?CompetenceReference
{
return $this->sourceCompetence;
}
public function setSourceCompetence(?CompetenceReference $sourceCompetence): static
{
$this->sourceCompetence = $sourceCompetence;
return $this;
}
public function getSubject(): ?Subject
{
return $this->subject;
}
public function setSubject(?Subject $subject): static
{
$this->subject = $subject;
return $this;
}
public function getContent(): ?string
{
return $this->content;
}
public function setContent(?string $content): static
{
$this->content = $content;
return $this;
}
public function getSchool(): ?School
{
return $this->school;
}
public function setSchool(?School $school): static
{
$this->school = $school;
return $this;
}
public function getClasse(): ?TheClass
{
return $this->classe;
}
public function setClasse(?TheClass $classe): static
{
$this->classe = $classe;
return $this;
}
public function getYear(): ?SchoolYear
{
return $this->year;
}
public function setYear(?SchoolYear $year): static
{
$this->year = $year;
return $this;
}
public function getAuthor(): ?User
{
return $this->author;
}
public function setAuthor(?User $author): static
{
$this->author = $author;
return $this;
}
public function getEvaluationOf(): ?self
{
return $this->evaluationOf;
}
public function setEvaluationOf(?self $evaluationOf): static
{
$this->evaluationOf = $evaluationOf;
return $this;
}
/** @return Collection<int, Competence> */
public function getAdditionalEvaluations(): Collection
{
return $this->additionalEvaluations;
}
/**
* true si cette Competence est une évaluation supplémentaire d'une autre
* (son libellé n'est pas le sien propre — voir getDisplayContent()).
*/
public function isAdditionalEvaluation(): bool
{
return $this->evaluationOf !== null;
}
/**
* La Competence "leader" du groupe (elle-même si elle est autonome ou
* déjà le leader). Sert de clé de regroupement à l'affichage (bulletin,
* écran de saisie) — un seul niveau, jamais de chaîne d'evaluationOf.
*/
public function getGroupLeader(): self
{
return $this->evaluationOf ?? $this;
}
/**
* Libellé à afficher : le sien propre, ou celui du leader si cette
* Competence est une évaluation supplémentaire (son content est null).
*/
public function getDisplayContent(): ?string
{
return $this->content ?? $this->evaluationOf?->getContent();
}
}