src/Entity/ProjectOrderTasks.php line 16

Open in your IDE?
  1. <?php
  3. namespace App\Entity;
  5. use App\Repository\ProjectOrderTasksRepository;
  6. use Doctrine\Common\Collections\ArrayCollection;
  7. use Doctrine\Common\Collections\Collection;
  8. use Doctrine\Common\Collections\Selectable;
  9. use Doctrine\ORM\Mapping as ORM;
  10. use Symfony\Component\Serializer\Annotation\Groups;
  11. use Symfony\Component\Serializer\Annotation\SerializedName;
  13. /**
  14.  * @ORM\Entity(repositoryClass=ProjectOrderTasksRepository::class)
  15.  */
  16. class ProjectOrderTasks
  17. {
  18.     /**
  19.      * @ORM\Id
  20.      * @ORM\GeneratedValue
  21.      * @ORM\Column(type="integer")
  22.      * @Groups({
  23.      *     "project_order_task@base",
  24.      *     "project_order_task@core"
  25.      * })
  26.      */
  27.     private $id;
  29.     /**
  30.      * @ORM\Column(type="integer")
  31.      * @Groups({
  32.      *      "project_order_task@base",
  33.      *      "project_order_task@core"
  34.      *  })
  35.      */
  36.     private $task_index;
  38.     /**
  39.      * @ORM\Column(type="string", length=255)
  40.      * @Groups({
  41.      *      "project_order_task@base",
  42.      *      "project_order_task@core"
  43.      *  })
  44.      */
  45.     private $title;
  47.     /**
  48.      * @ORM\Column(type="text", nullable=true)
  49.      * @Groups({
  50.      *      "project_order_task@base",
  51.      *      "project_order_task@core"
  52.      *  })
  53.      */
  54.     private $description;
  56.     /**
  57.      * @ORM\Column(type="float")
  58.      * @Groups({
  59.      *      "project_order_task@core"
  60.      *  })
  61.      */
  62.     private $progress_weight;
  64.     /**
  65.      * @ORM\Column(type="integer", nullable=true)
  66.      * @Groups({
  67.      *      "project_order_task@core"
  68.      *  })
  69.      */
  70.     private $duration_days;
  72.     /**
  73.      * @deprecated never use this controlling over job
  74.      * @ORM\Column(type="date_immutable", nullable=true, options={"comment": "deprecated -> Redundant field; value is dynamically calculated based on completed job weights."})
  75.      * @Groups({
  76.      *      "project_order_task@core"
  77.      *  })
  78.      */
  79.     private $started_at;
  81.     /**
  82.      * @deprecated never use this controlling over job
  83.      * @ORM\Column(type="date_immutable", nullable=true, options={"comment": "deprecated -> Redundant field; value is dynamically calculated based on completed job weights."})
  84.      * @Groups({
  85.      *      "project_order_task@core"
  86.      *  })
  87.      */
  88.     private $completed_at;
  90.     /**
  91.      * @ORM\ManyToOne(targetEntity=ProjectOrders::class, inversedBy="project_order_tasks")
  92.      * @ORM\JoinColumn(nullable=false, onDelete="CASCADE")
  93.      * @Groups({
  94.      *        "project_order_task@order"
  95.      *    })
  96.      */
  97.     private $project_order;
  99.     /**
  100.      * @ORM\OneToMany(targetEntity=ProjectOrderTaskJobs::class, mappedBy="order_task", cascade={"persist"}, orphanRemoval=true )
  101.      * @Groups({
  102.      *       "project_order_task@task_jobs"
  103.      *   })
  104.      */
  105.     private $task_jobs;
  107.     /**
  108.      * Uretim asamasi (Produktionsstatus) — TODO #109.
  109.      *
  110.      * ILISKI, string KOPYA DEGIL (kullanici karari 2026-08-19). Once kod
  111.      * string olarak tutuluyordu; gerekcesi "asama silinirse gecmis bozulmasin"
  112.      * idi. SILME TAMAMEN IPTAL EDILINCE o senaryo ortadan kalkti, geriye
  113.      * yalnizca iki alani (kod + etiket iliskisi) senkron tutma zorunlulugu
  114.      * kaldi — yani tutarsizlik riski. Tek alan, tek gercek.
  115.      *
  116.      * 🪤 `onDelete` VERILMEDI, BILEREK: Doctrine varsayilani RESTRICT'tir, yani
  117.      * bir task'a bagli asamayi DB'nin KENDISI sildirmez. "Bagli asama silinmez,
  118.      * yalnizca `active=false` yapilir" kurali boylece yorumda degil SEMADA
  119.      * yasiyor; kimse kodu okumadan da ihlal edemez.
  120.      *
  121.      * Etiket bedavaya gelir: serializer iliskiyi gezip `code` + `label`'i ayni
  122.      * payload'a koyar (`task_fulfillment_stage@base`), FE ikinci istek atmaz.
  123.      *
  124.      * @ORM\ManyToOne(targetEntity=TaskFulfillmentStage::class)
  125.      * @ORM\JoinColumn(nullable=true)
  126.      * @Groups({
  127.      *     "project_order_task@base",
  128.      *     "project_order_task@core"
  129.      * })
  130.      */
  131.     private $fulfillment_stage;
  133.     /**
  134.      * @ORM\OneToOne(targetEntity=ProjectOrderTaskFulfillment::class, mappedBy="task", cascade={"persist", "remove"})
  135.      * @Groups({
  136.      *     "project_order_task@fulfillment"
  137.      * })
  138.      */
  139.     private $task_fulfillment;
  141.     /**
  142.      * @ORM\ManyToOne(targetEntity=WorkerActivities::class, inversedBy="project_order_tasks")
  143.      * @Groups({
  144.      *         "project_order_task@responsible_person"
  145.      *  })
  146.      */
  147.     private $responsible_person;
  151.     public function __construct()
  152.     {
  153.         $this->task_jobs = new ArrayCollection();
  154.     }
  158.     public function getId(): ?int
  159.     {
  160.         return $this->id;
  161.     }
  163.     public function getTaskIndex(): ?int
  164.     {
  165.         return $this->task_index;
  166.     }
  168.     public function setTaskIndex(int $task_index): self
  169.     {
  170.         $this->task_index = $task_index;
  172.         return $this;
  173.     }
  175.     public function getTitle(): ?string
  176.     {
  177.         return $this->title;
  178.     }
  180.     public function setTitle(string $title): self
  181.     {
  182.         $this->title = $title;
  184.         return $this;
  185.     }
  187.     public function getDescription(): ?string
  188.     {
  189.         return $this->description;
  190.     }
  192.     public function setDescription(?string $description): self
  193.     {
  194.         $this->description = $description;
  196.         return $this;
  197.     }
  199.     public function getProgressWeight(): ?float
  200.     {
  201.         return $this->progress_weight;
  202.     }
  204.     public function setProgressWeight(float $progress_weight): self
  205.     {
  206.         $this->progress_weight = $progress_weight;
  208.         return $this;
  209.     }
  211.     public function getDurationDays(): ?int
  212.     {
  213.         return $this->duration_days;
  214.     }
  216.     public function setDurationDays(?int $duration_days): self
  217.     {
  218.         $this->duration_days = $duration_days;
  220.         return $this;
  221.     }
  223.     public function getStartedAt(): ?\DateTimeImmutable
  224.     {
  225.         return $this->started_at;
  226.     }
  228.     public function setStartedAt(?\DateTimeImmutable $started_at): self
  229.     {
  230.         $this->started_at = $started_at;
  232.         return $this;
  233.     }
  235.     public function getCompletedAt(): ?\DateTimeImmutable
  236.     {
  237.         return $this->completed_at;
  238.     }
  240.     public function setCompletedAt(?\DateTimeImmutable $completed_at): self
  241.     {
  242.         $this->completed_at = $completed_at;
  244.         return $this;
  245.     }
  247.     public function getProjectOrder(): ?ProjectOrders
  248.     {
  249.         return $this->project_order;
  250.     }
  252.     public function setProjectOrder(?ProjectOrders $project_order): self
  253.     {
  254.         $this->project_order = $project_order;
  256.         return $this;
  257.     }
  259.     /**
  260.      * TaskExecution servisi (ağ içi `internal/executions`) + owner FE için sanal alan — task'ın
  261.      * bağlı olduğu siparişin sipariş numarası. DB kolonu DEĞİL, `project_order->order_nr`'dan türer.
  262.      * `project_order` nullable=false olduğu için normalde her zaman dolu döner; savunma amaçlı
  263.      * null-safe. T55: çok-kelimeli sanal getter camelCase serialize olur → `@SerializedName` ZORUNLU.
  264.      *
  265.      * @Groups({
  266.      *     "project_order_task@core"
  267.      * })
  268.      * @SerializedName("order_nr")
  269.      */
  270.     public function getOrderNr(): ?string
  271.     {
  272.         return $this->project_order ? $this->project_order->getOrderNr() : null;
  273.     }
  275.     /**
  276.      * /**
  277.      *  ⚠️ IMPORTANT – Collection index / Serializer issue
  278.      *
  279.      *  Problem:
  280.      *  --------
  281.      *  ProjectOrderTaskJobs koleksiyonu (Doctrine ArrayCollection) üzerinde
  282.      *  BİRDEN FAZLA remove işlemi yapıldığında, Doctrine elemanları silerken
  283.      *  array indexlerini yeniden sıralamaz.
  284.      *
  285.      *  Örnek:
  286.      *    [0 => JobA, 1 => JobB, 2 => JobC]
  287.      *    JobB silinirse →
  288.      *    [0 => JobA, 2 => JobC]   // index boşluğu oluşur ❌
  289.      *
  290.      *  Symfony Serializer bu yapıyı:
  291.      *    - indexler ardışık değilse → associative object `{}` olarak,
  292.      *    - indexler 0..n ise → JSON array `[]` olarak serialize eder.
  293.      *
  294.      *  Bu nedenle çoklu silme sonrası FE tarafında:
  295.      *    task_jobs: { "1": {...} }
  296.      *  gibi HATALI bir çıktı oluşur.
  297.      *
  298.      *  Çözüm:
  299.      *  ------
  300.      *  Serializer'a gönderilmeden önce collection MUTLAKA reindex edilmelidir.
  301.      *  Bu da getter seviyesinde yapılır:
  302.      *
  303.      *    return new ArrayCollection(array_values($this->task_jobs->toArray()));
  304.      *
  305.      *  Böylece:
  306.      *    - Doctrine iç davranışı bozulmaz
  307.      *    - Serializer her zaman `[...]` JSON array üretir
  308.      *    - FE tarafında index problemi yaşanmaz
  309.      *
  310.      *  Not:
  311.      *  ----
  312.      *  Bu problem serializer flag'leri (preserve_empty_objects vb.)
  313.      *  ile çözülemez; sorun serialization değil, collection index yapısıdır.
  314.      * /
  315.      * @return Collection<int, ProjectOrderTaskJobs>&Selectable
  316.      */
  317.     public function getTaskJobs(): Collection
  318.     {
  319.         return new ArrayCollection(array_values($this->task_jobs->toArray()));
  320.     }
  322.     public function addProjectOrderTaskJob(ProjectOrderTaskJobs $projectOrderTaskJob): self
  323.     {
  324.         if (!$this->task_jobs->contains($projectOrderTaskJob)) {
  325.             $this->task_jobs[] = $projectOrderTaskJob;
  326.             $projectOrderTaskJob->setOrderTask($this);
  327.         }
  329.         return $this;
  330.     }
  332.     /**
  333.      * @see ProjectOrderTasks::getTaskJobs()
  334.     */
  335.     public function removeProjectOrderTaskJob(ProjectOrderTaskJobs $projectOrderTaskJob): self
  336.     {
  337.         if ($this->task_jobs->removeElement($projectOrderTaskJob)) {
  338.             // set the owning side to null (unless already changed)
  339.             if ($projectOrderTaskJob->getOrderTask() === $this) {
  340.                 $projectOrderTaskJob->setOrderTask(null);
  341.             }
  342.         }
  344.         return $this;
  345.     }
  347.     public function getFulfillmentStage(): ?TaskFulfillmentStage
  348.     {
  349.         return $this->fulfillment_stage;
  350.     }
  352.     public function setFulfillmentStage(?TaskFulfillmentStage $fulfillment_stage): self
  353.     {
  354.         $this->fulfillment_stage = $fulfillment_stage;
  356.         return $this;
  357.     }
  359.     public function getTaskFulfillment(): ?ProjectOrderTaskFulfillment
  360.     {
  361.         return $this->task_fulfillment;
  362.     }
  364.     public function setTaskFulfillment(?ProjectOrderTaskFulfillment $task_fulfillment): self
  365.     {
  366.         // set the owning side of the relation if necessary
  367.         if ($task_fulfillment->getTask() !== $this) {
  368.             $task_fulfillment->setTask($this);
  369.         }
  371.         $this->task_fulfillment = $task_fulfillment;
  373.         return $this;
  374.     }
  376.     public function getResponsiblePerson(): ?WorkerActivities
  377.     {
  378.         return $this->responsible_person;
  379.     }
  381.     public function setResponsiblePerson(?WorkerActivities $responsible_person): self
  382.     {
  383.         $this->responsible_person = $responsible_person;
  385.         return $this;
  386.     }
  387. }