src/Entity/ProjectOrderTaskJobs.php line 12

Open in your IDE?
  1. <?php
  3. namespace App\Entity;
  5. use App\Repository\ProjectOrderTaskJobsRepository;
  6. use Doctrine\ORM\Mapping as ORM;
  7. use Symfony\Component\Serializer\Annotation\Groups;
  9. /**
  10.  * @ORM\Entity(repositoryClass=ProjectOrderTaskJobsRepository::class)
  11.  */
  12. class ProjectOrderTaskJobs
  13. {
  14.     /**
  15.      * @ORM\Id
  16.      * @ORM\GeneratedValue
  17.      * @ORM\Column(type="integer")
  18.      * @Groups({
  19.      *     "project_order_task_job@base",
  20.      *     "project_order_task_job@core"
  21.      * })
  22.      */
  23.     private $id;
  25.     /**
  26.      * @ORM\ManyToOne(targetEntity=ProjectOrderTasks::class, inversedBy="project_order_task_jobs")
  27.      * @ORM\JoinColumn(onDelete="CASCADE")
  28.      */
  29.     // TODO Replace with task $order_task > $task !!!
  30.     private $order_task;
  32.     /**
  33.      * @ORM\Column(type="float", nullable=true)
  34.      * @Groups({
  35.      *     "project_order_task_job@core"
  36.      *  })
  37.      */
  38.     private $job_weight;
  40.     /**
  41.      * @ORM\Column(type="integer")
  42.      * @Groups({
  43.      *      "project_order_task_job@core"
  44.      *   })
  45.      */
  46.     private $job_index;
  48.     /**
  49.      * @ORM\Column(type="date_immutable", nullable=true)
  50.      * @Groups({
  51.      *      "project_order_task_job@core"
  52.      *   })
  53.      */
  54.     private $start_at;
  56.     /**
  57.      * @ORM\Column(type="date_immutable", nullable=true)
  58.      * @Groups({
  59.      *       "project_order_task_job@core"
  60.      *    })
  61.      */
  62.     private $end_at;
  64.     /**
  65.      * @ORM\Column(type="float", nullable=true)
  66.      * @Groups({
  67.      *      "project_order_task_job@core"
  68.      *   })
  69.      */
  70.     private $rating;
  72.     /**
  73.      * @ORM\Column(type="integer", nullable=true)
  74.      * @Groups({
  75.      *      "project_order_task_job@core"
  76.      *   })
  77.      */
  78.     private $real_days;
  80.     /**
  81.      * @ORM\Column(type="text", nullable=true)
  82.      * @Groups({
  83.      *      "project_order_task_job@core"
  84.      *   })
  85.      */
  86.     private $job_description;
  88.     /**
  89.      * @ORM\Column(type="float", nullable=true)
  90.      * @Groups({
  91.      *        "project_order_task_job@core"
  92.      *     })
  93.      */
  94.     private $duration_days;
  96.     /**
  97.      * TaskExecution — servisin job'a yazdigi ilerleme notu (K5: yayin sonrasi
  98.      * tek yazar servistir; ERP bu alani salt-okur gosterir).
  99.      * @ORM\Column(type="text", nullable=true)
  100.      * @Groups({
  101.      *      "project_order_task_job@core"
  102.      *   })
  103.      */
  104.     private $note;
  106.     public function getId(): ?int
  107.     {
  108.         return $this->id;
  109.     }
  111.     public function getOrderTask(): ?ProjectOrderTasks
  112.     {
  113.         return $this->order_task;
  114.     }
  116.     public function setOrderTask(?ProjectOrderTasks $order_task): self
  117.     {
  118.         $this->order_task = $order_task;
  120.         return $this;
  121.     }
  123.     public function getJobWeight(): ?float
  124.     {
  125.         return $this->job_weight;
  126.     }
  128.     public function setJobWeight(?float $job_weight): self
  129.     {
  130.         $this->job_weight = $job_weight;
  132.         return $this;
  133.     }
  135.     public function getJobIndex(): ?int
  136.     {
  137.         return $this->job_index;
  138.     }
  140.     public function setJobIndex(int $job_index): self
  141.     {
  142.         $this->job_index = $job_index;
  144.         return $this;
  145.     }
  147.     public function getStartAt(): ?\DateTimeImmutable
  148.     {
  149.         return $this->start_at;
  150.     }
  152.     public function setStartAt(?\DateTimeImmutable $start_at): self
  153.     {
  154.         $this->start_at = $start_at;
  156.         return $this;
  157.     }
  159.     public function getEndAt(): ?\DateTimeImmutable
  160.     {
  161.         return $this->end_at;
  162.     }
  164.     public function setEndAt(?\DateTimeImmutable $end_at): self
  165.     {
  166.         $this->end_at = $end_at;
  168.         return $this;
  169.     }
  171.     /**
  172.      * Tamamlama kilidi — İKİ otoriteden OKUNUR (read-through; order kendi tutmaz):
  173.      *  1) PLAN job'u kilitliyse (WorksPlan = lock otoritesi, mevcut davranış)
  174.      *  2) Task'ın TaskExecution kaydı `published` ise (K5, 2026-08-10 karar) — yayın
  175.      *     sonrası tek yazar servistir, ERP job'u artık kendi ekranından değiştiremez.
  176.      * Unlock yetkisi ilgili otoritededir (plan sahibi / servis).
  177.      *
  178.      * @Groups({
  179.      *       "project_order_task_job@core"
  180.      *    })
  181.      */
  182.     public function getLocked(): bool
  183.     {
  184.         if ($this->source_plan_job !== null && $this->source_plan_job->getLocked()) {
  185.             return true;
  186.         }
  188.         $task = $this->getOrderTask();
  189.         $execution = $task !== null ? $task->getTaskFulfillment() : null;
  191.         return $execution !== null && $execution->getStatus() === \App\Enum\TaskExecutionStatusEnum::PUBLISHED;
  192.     }
  194.     /**
  195.      * Tamamlama kilidi — SERVIS HELPER'ı (serialize EDİLMEZ). Job tamamlanmamış (end_at null)
  196.      * VE başlangıç günü gelmemişse (today < start_at) doldurulur; aksi halde null.
  197.      * Job tamamlama "live request" (job-completion-check endpoint → checkJobCompletion) bunu
  198.      * çağırır; eski serialize-edilen `completion_block` alanı kaldırıldı (FE artık endpoint kullanıyor).
  199.      *
  200.      * @return array|null
  201.      */
  202.     public function getCompletionBlock(): ?array
  203.     {
  204.         if ($this->end_at !== null) {
  205.             return null;
  206.         }
  207.         // Plan-bağlı job: start OTORİTESİ plan (order kopyası stale olabilir — plan ayrı yerde
  208.         // değişip order reload edilmemişse). Canlı check stale start yüzünden haksız blok vermesin.
  209.         $start = $this->source_plan_job !== null ? $this->source_plan_job->getStartAt() : $this->start_at;
  210.         if ($start === null) {
  211.             return null;
  212.         }
  213.         // Tarih-string: bugün == başlangıç günü ise tamamlanabilir (saat bileşeni şişirmesin).
  214.         $todayStr = (new \DateTimeImmutable('today'))->format('Y-m-d');
  215.         if ($start->format('Y-m-d') > $todayStr) {
  216.             return ['reason' => 'not_started', 'start_at' => $start->format('Y-m-d')];
  217.         }
  219.         return null;
  220.     }
  222.     public function getRating(): ?float
  223.     {
  224.         return $this->rating;
  225.     }
  227.     public function setRating(?float $rating): self
  228.     {
  229.         $this->rating = $rating;
  231.         return $this;
  232.     }
  234.     public function getRealDays(): ?int
  235.     {
  236.         return $this->real_days;
  237.     }
  239.     public function setRealDays(?int $real_days): self
  240.     {
  241.         $this->real_days = $real_days;
  243.         return $this;
  244.     }
  246.     public function getJobDescription(): ?string
  247.     {
  248.         return $this->job_description;
  249.     }
  251.     public function setJobDescription(?string $job_description): self
  252.     {
  253.         $this->job_description = $job_description;
  255.         return $this;
  256.     }
  258.     public function getDurationDays(): ?float
  259.     {
  260.         return $this->duration_days;
  261.     }
  263.     public function setDurationDays(?float $duration_days): self
  264.     {
  265.         $this->duration_days = $duration_days;
  267.         return $this;
  268.     }
  270.     public function getNote(): ?string
  271.     {
  272.         return $this->note;
  273.     }
  275.     public function setNote(?string $note): self
  276.     {
  277.         $this->note = $note;
  279.         return $this;
  280.     }
  282.     /**
  283.      * Materialization mapping — bu Order TaskJob hangi WorksPlanJob'dan üretildi.
  284.      * end_at değiştiğinde OrderEndAtBackSyncListener bu kolondan Plan job'una ulaşıp
  285.      * is_end_at'i set eder. Plan job silinirse NULL'a düşer (Order satırı kalır).
  286.      *
  287.      * @ORM\ManyToOne(targetEntity=WorksPlanJob::class)
  288.      * @ORM\JoinColumn(name="source_plan_job_id", referencedColumnName="id", nullable=true, onDelete="SET NULL")
  289.      *
  290.      * NOT: Serialize EDİLMEZ (group YOK) — order FE'sine sızarsa save'de generic
  291.      * hydrator setSourcePlanJob(array) ile patlar. Yalnızca BE Materializer/back-sync kullanır.
  292.      */
  293.     private $source_plan_job;
  295.     public function getSourcePlanJob(): ?WorksPlanJob
  296.     {
  297.         return $this->source_plan_job;
  298.     }
  300.     public function setSourcePlanJob(?WorksPlanJob $source_plan_job): self
  301.     {
  302.         $this->source_plan_job = $source_plan_job;
  304.         return $this;
  305.     }
  306. }