src/Entity/WorksPlanJob.php line 24

Open in your IDE?
  1. <?php
  3. namespace App\Entity;
  5. use App\Repository\WorksPlanJobRepository;
  6. use Doctrine\Common\Collections\ArrayCollection;
  7. use Doctrine\Common\Collections\Collection;
  8. use Doctrine\ORM\Mapping as ORM;
  9. use Symfony\Component\Serializer\Annotation\Context;
  10. use Symfony\Component\Serializer\Annotation\Groups;
  12. /**
  13.  * WorksPlanJob — task altındaki iş birimi (Order'daki ProjectOrderTaskJobs aynası).
  14.  * Planlama otoritesi burada: start_at + should_end_at cascade kaynağı.
  15.  * is_end_at Order'dan listener ile geri akar; cascade tetiklemez (informational).
  16.  *
  17.  * Dependency edge'i child sahibinde — bu job için "ben başlamadan önce şunlar bitsin":
  18.  *  - $parent_dependencies: bu job'a gelen kenarlar (child=$this)
  19.  *  - $child_dependencies:  bu job'tan giden kenarlar (parent=$this)
  20.  *
  21.  * @ORM\Entity(repositoryClass=WorksPlanJobRepository::class)
  22.  * @ORM\Table(name="works_plan_jobs")
  23.  */
  24. class WorksPlanJob
  25. {
  26.     /**
  27.      * @ORM\Id
  28.      * @ORM\GeneratedValue
  29.      * @ORM\Column(type="integer")
  30.      * @Groups({
  31.      *     "works_plan_job@base",
  32.      *     "works_plan_job@core"
  33.      * })
  34.      */
  35.     private $id;
  37.     /**
  38.      * @ORM\ManyToOne(targetEntity=WorksPlanTask::class, inversedBy="jobs")
  39.      * @ORM\JoinColumn(name="works_plan_task_id", referencedColumnName="id", nullable=false, onDelete="CASCADE")
  40.      */
  41.     private $works_plan_task;
  43.     /**
  44.      * @ORM\Column(type="integer")
  45.      * @Groups({
  46.      *     "works_plan_job@base",
  47.      *     "works_plan_job@core"
  48.      * })
  49.      */
  50.     private $job_index;
  52.     /**
  53.      * @ORM\Column(type="text", nullable=true)
  54.      * @Groups({
  55.      *     "works_plan_job@core"
  56.      * })
  57.      */
  58.     private $job_description;
  60.     /**
  61.      * Serbest açıklama/not (başlık=job_description'dan ayrı). Drawer'da düzenlenir.
  62.      *
  63.      * @ORM\Column(type="text", nullable=true)
  64.      * @Groups({
  65.      *     "works_plan_job@core"
  66.      * })
  67.      */
  68.     private $description;
  70.     /**
  71.      * @ORM\Column(type="float")
  72.      * @Groups({
  73.      *     "works_plan_job@core"
  74.      * })
  75.      */
  76.     private $job_weight;
  78.     /**
  79.      * Ağırlık pin: kullanıcı bu job'un yüzdesini bilerek sabitlediyse true.
  80.      * Rebalance pinli job'lara dokunmaz; pinsiz kardeşler kalanı orantılı paylaşır.
  81.      *
  82.      * @ORM\Column(type="boolean", options={"default": false})
  83.      * @Groups({
  84.      *     "works_plan_job@core"
  85.      * })
  86.      */
  87.     private $weight_locked = false;
  89.     /**
  90.      * Tamamlama kilidi (weight_locked'tan FARKLI). Order job tamamlanınca true olur
  91.      * (back-sync). Kilitliyken order job'u değiştiremez; sadece plan yöneticisi unlock eder.
  92.      * Plan = lock otoritesi; materialize ile order'a (project_order_task_jobs.locked) yansır.
  93.      *
  94.      * @ORM\Column(type="boolean", options={"default": false})
  95.      * @Groups({
  96.      *     "works_plan_job@core"
  97.      * })
  98.      */
  99.     private $locked = false;
  101.     /**
  102.      * @ORM\Column(type="date_immutable", nullable=true)
  103.      * @Groups({
  104.      *     "works_plan_job@core"
  105.      * })
  106.      * @Context({"datetime_format"="Y-m-d"})
  107.      */
  108.     private $start_at;
  110.     /**
  111.      * @ORM\Column(type="date_immutable", nullable=true)
  112.      * @Groups({
  113.      *     "works_plan_job@core"
  114.      * })
  115.      * @Context({"datetime_format"="Y-m-d"})
  116.      */
  117.     private $should_end_at;
  119.     /**
  120.      * @ORM\Column(type="date_immutable", nullable=true)
  121.      * @Groups({
  122.      *     "works_plan_job@core"
  123.      * })
  124.      * @Context({"datetime_format"="Y-m-d"})
  125.      */
  126.     private $is_end_at;
  128.     /**
  129.      * Bitiş geri bildirimi / sebep (elle is_end_at girilince). Yalnızca Plan tarafında;
  130.      * Order'a yansımaz (orada gerekmez).
  131.      *
  132.      * @ORM\Column(type="text", nullable=true)
  133.      * @Groups({
  134.      *     "works_plan_job@core"
  135.      * })
  136.      */
  137.     private $is_end_note;
  139.     /**
  140.      * @ORM\Column(type="float")
  141.      * @Groups({
  142.      *     "works_plan_job@core"
  143.      * })
  144.      */
  145.     private $duration_days;
  147.     /**
  148.      * Bu job'a gelen kenarlar (child=$this). UI'da "Bekle: [parent chip] +Ng" listesi.
  149.      *
  150.      * @ORM\OneToMany(targetEntity=WorksPlanJobDependency::class, mappedBy="child_job", cascade={"persist", "remove"}, orphanRemoval=true)
  151.      * @ORM\OrderBy({"dependency_index" = "ASC"})
  152.      * @Groups({
  153.      *     "works_plan_job@dependencies"
  154.      * })
  155.      */
  156.     private $parent_dependencies;
  158.     /**
  159.      * Bu job'tan giden kenarlar (parent=$this). Yalnızca cascade hesabı / cycle detection için.
  160.      * Serialization gerekmez (back-reference).
  161.      *
  162.      * @ORM\OneToMany(targetEntity=WorksPlanJobDependency::class, mappedBy="parent_job", cascade={"persist", "remove"}, orphanRemoval=true)
  163.      */
  164.     private $child_dependencies;
  166.     /**
  167.      * @ORM\OneToMany(targetEntity=WorksPlanJobHistory::class, mappedBy="job", cascade={"persist", "remove"}, orphanRemoval=true)
  168.      * @ORM\OrderBy({"changed_at" = "DESC"})
  169.      * @Groups({
  170.      *     "works_plan_job@history"
  171.      * })
  172.      */
  173.     private $history;
  175.     public function __construct()
  176.     {
  177.         $this->parent_dependencies = new ArrayCollection();
  178.         $this->child_dependencies = new ArrayCollection();
  179.         $this->history = new ArrayCollection();
  180.     }
  182.     public function getId(): ?int
  183.     {
  184.         return $this->id;
  185.     }
  187.     public function getWorksPlanTask(): ?WorksPlanTask
  188.     {
  189.         return $this->works_plan_task;
  190.     }
  192.     public function setWorksPlanTask(?WorksPlanTask $works_plan_task): self
  193.     {
  194.         $this->works_plan_task = $works_plan_task;
  196.         return $this;
  197.     }
  199.     public function getJobIndex(): ?int
  200.     {
  201.         return $this->job_index;
  202.     }
  204.     public function setJobIndex(int $job_index): self
  205.     {
  206.         $this->job_index = $job_index;
  208.         return $this;
  209.     }
  211.     public function getJobDescription(): ?string
  212.     {
  213.         return $this->job_description;
  214.     }
  216.     public function setJobDescription(?string $job_description): self
  217.     {
  218.         $this->job_description = $job_description;
  220.         return $this;
  221.     }
  223.     public function getDescription(): ?string
  224.     {
  225.         return $this->description;
  226.     }
  228.     public function setDescription(?string $description): self
  229.     {
  230.         $this->description = $description;
  232.         return $this;
  233.     }
  235.     public function getJobWeight(): ?float
  236.     {
  237.         return $this->job_weight;
  238.     }
  240.     public function setJobWeight(float $job_weight): self
  241.     {
  242.         $this->job_weight = $job_weight;
  244.         return $this;
  245.     }
  247.     public function getWeightLocked(): bool
  248.     {
  249.         return (bool) $this->weight_locked;
  250.     }
  252.     public function getLocked(): bool
  253.     {
  254.         return (bool) $this->locked;
  255.     }
  257.     public function setLocked(bool $locked): self
  258.     {
  259.         $this->locked = $locked;
  261.         return $this;
  262.     }
  264.     public function setWeightLocked(bool $weight_locked): self
  265.     {
  266.         $this->weight_locked = $weight_locked;
  268.         return $this;
  269.     }
  271.     public function getStartAt(): ?\DateTimeImmutable
  272.     {
  273.         return $this->start_at;
  274.     }
  276.     public function setStartAt(?\DateTimeImmutable $start_at): self
  277.     {
  278.         $this->start_at = $start_at;
  280.         return $this;
  281.     }
  283.     public function getShouldEndAt(): ?\DateTimeImmutable
  284.     {
  285.         return $this->should_end_at;
  286.     }
  288.     public function setShouldEndAt(?\DateTimeImmutable $should_end_at): self
  289.     {
  290.         $this->should_end_at = $should_end_at;
  292.         return $this;
  293.     }
  295.     public function getIsEndAt(): ?\DateTimeImmutable
  296.     {
  297.         return $this->is_end_at;
  298.     }
  300.     public function setIsEndAt(?\DateTimeImmutable $is_end_at): self
  301.     {
  302.         $this->is_end_at = $is_end_at;
  304.         return $this;
  305.     }
  307.     public function getIsEndNote(): ?string
  308.     {
  309.         return $this->is_end_note;
  310.     }
  312.     public function setIsEndNote(?string $is_end_note): self
  313.     {
  314.         $this->is_end_note = $is_end_note;
  316.         return $this;
  317.     }
  319.     public function getDurationDays(): ?float
  320.     {
  321.         return $this->duration_days;
  322.     }
  324.     public function setDurationDays(float $duration_days): self
  325.     {
  326.         $this->duration_days = $duration_days;
  328.         return $this;
  329.     }
  331.     /**
  332.      * @return Collection<int, WorksPlanJobDependency>
  333.      */
  334.     public function getParentDependencies(): Collection
  335.     {
  336.         return new ArrayCollection(array_values($this->parent_dependencies->toArray()));
  337.     }
  339.     public function addParentDependency(WorksPlanJobDependency $dependency): self
  340.     {
  341.         if (!$this->parent_dependencies->contains($dependency)) {
  342.             $this->parent_dependencies[] = $dependency;
  343.             $dependency->setChildJob($this);
  344.         }
  346.         return $this;
  347.     }
  349.     public function removeParentDependency(WorksPlanJobDependency $dependency): self
  350.     {
  351.         if ($this->parent_dependencies->removeElement($dependency)) {
  352.             if ($dependency->getChildJob() === $this) {
  353.                 $dependency->setChildJob(null);
  354.             }
  355.         }
  357.         return $this;
  358.     }
  360.     /**
  361.      * @return Collection<int, WorksPlanJobDependency>
  362.      */
  363.     public function getChildDependencies(): Collection
  364.     {
  365.         return new ArrayCollection(array_values($this->child_dependencies->toArray()));
  366.     }
  368.     /**
  369.      * @return Collection<int, WorksPlanJobHistory>
  370.      */
  371.     public function getHistory(): Collection
  372.     {
  373.         return new ArrayCollection(array_values($this->history->toArray()));
  374.     }
  376.     public function addHistory(WorksPlanJobHistory $entry): self
  377.     {
  378.         if (!$this->history->contains($entry)) {
  379.             $this->history[] = $entry;
  380.             $entry->setJob($this);
  381.         }
  383.         return $this;
  384.     }
  385. }