Fix header comment

[airbundle] / Entity / Session.php

diff --git a/Entity/Session.php b/Entity/Session.php
index 72d1f33f83843f3db7c31ba6266712d72d5a477f..1cba677dd144187b876ec11bc08975ce1ba456af 100644 (file)
--- a/Entity/Session.php
+++ b/Entity/Session.php
@@ -1,61 +1,129 @@
-<?php
+<?php declare(strict_types=1);
+
+/*
+ * this file is part of the rapsys packbundle package.
+ *
+ * (c) raphaël gertz <symfony@rapsys.eu>
+ *
+ * for the full copyright and license information, please view the license
+ * file that was distributed with this source code.
+ */

 
 namespace Rapsys\AirBundle\Entity;
 
 
 namespace Rapsys\AirBundle\Entity;
 

+use Doctrine\Common\Collections\Collection;
+use Doctrine\Common\Collections\ArrayCollection;
+use Doctrine\ORM\Event\PreUpdateEventArgs;
+
+use Rapsys\PackBundle\Util\IntlUtil;
+

 /**
  * Session
  */
 class Session {
        /**
 /**
  * Session
  */
 class Session {
        /**

-        * @var integer
+        * Primary key
+        */
+       private ?int $id = null;
+
+       /**
+        * Begin time
+        */
+       private ?\DateTime $begin = null;
+
+       /**
+        * Computed start datetime
+        */
+       private ?\DateTime $start = null;
+
+       /**
+        * Length time
+        */
+       private ?\DateTime $length = null;
+
+       /**
+        * Computed stop datetime
+        */
+       private ?\DateTime $stop = null;
+
+       /**
+        * Premium
+        */
+       private ?bool $premium = null;
+
+       /**
+        * Rain mm
+        */
+       private ?float $rainfall = null;
+
+       /**
+        * Rain chance
+        */
+       private ?float $rainrisk = null;
+
+       /**
+        * Real feel temperature

         */
         */

-       private $id;
+       private ?float $realfeel = null;

 
        /**
 
        /**

-        * @var \DateTime
+        * Real feel minimum temperature

         */
         */

-       private $date;
+       private ?float $realfeelmin = null;

 
        /**
 
        /**

-        * @var \DateTime
+        * Real feel maximum temperature

         */
         */

-       private $begin;
+       private ?float $realfeelmax = null;

 
        /**
 
        /**

-        * @var \DateTime
+        * Temperature

         */
         */

-       private $end;
+       private ?float $temperature = null;

 
        /**
 
        /**

-        * @var \DateTime
+        * Minimum temperature

         */
         */

-       private $created;
+       private ?float $temperaturemin = null;

 
        /**
 
        /**

-        * @var \DateTime
+        * Maximum temperature

         */
         */

-       private $updated;
+       private ?float $temperaturemax = null;

 
        /**
 
        /**

-        * @var \Doctrine\Common\Collections\Collection
+        * Lock datetime

         */
         */

-       private $applications;
+       private ?\DateTime $locked = null;

 
        /**
 
        /**

-        * @var \Rapsys\AirBundle\Entity\Location
+        * Creation datetime

         */
         */

-       private $location;
+       private \DateTime $created;

 
        /**
 
        /**

-        * @var \Rapsys\AirBundle\Entity\Application
+        * Update datetime

         */
         */

-       private $application;
+       private \DateTime $updated;
+
+       /**
+        * Application instance
+        */
+       private ?Application $application = null;
+
+       /**
+        * Applications collection
+        */
+       private Collection $applications;

 
        /**
         * Constructor
         */
 
        /**
         * Constructor
         */

-       public function __construct() {
-               $this->applications = new \Doctrine\Common\Collections\ArrayCollection();
+       public function __construct(private \DateTime $date, private Location $location, private Slot $slot) {
+               //Set defaults
+               $this->created = new \DateTime('now');
+               $this->updated = new \DateTime('now');
+               $this->applications = new ArrayCollection();

        }
 
        /**
        }
 
        /**


@@ -63,7 +131,7 @@ class Session {
         *
         * @return integer
         */
         *
         * @return integer
         */

-       public function getId() {
+       public function getId(): ?int {

                return $this->id;
        }
 
                return $this->id;
        }
 


@@ -74,7 +142,7 @@ class Session {
         *
         * @return Session
         */
         *
         * @return Session
         */

-       public function setDate($date) {
+       public function setDate(\DateTime $date): Session {

                $this->date = $date;
 
                return $this;
                $this->date = $date;
 
                return $this;


@@ -85,7 +153,7 @@ class Session {
         *
         * @return \DateTime
         */
         *
         * @return \DateTime
         */

-       public function getDate() {
+       public function getDate(): \DateTime {

                return $this->date;
        }
 
                return $this->date;
        }
 


@@ -96,7 +164,7 @@ class Session {
         *
         * @return Session
         */
         *
         * @return Session
         */

-       public function setBegin($begin) {
+       public function setBegin(?\DateTime $begin): Session {

                $this->begin = $begin;
 
                return $this;
                $this->begin = $begin;
 
                return $this;


@@ -107,30 +175,305 @@ class Session {
         *
         * @return \DateTime
         */
         *
         * @return \DateTime
         */

-       public function getBegin() {
+       public function getBegin(): ?\DateTime {

                return $this->begin;
        }
 
        /**
                return $this->begin;
        }
 
        /**

-        * Set end
+        * Get start
+        *
+        * @return \DateTime
+        */
+       public function getStart(): \DateTime {
+               //With start
+               if ($this->start !== null) {
+                       return $this->start;
+               }
+
+               //Clone date
+               $this->start = clone $this->date;
+
+               //Check if after slot
+               //XXX: id=4 <=> title=After
+               if ($this->slot->getId() == 4) {
+                       //Add one day
+                       $this->start->add(new \DateInterval('P1D'));
+               }
+
+               //With begin
+               if ($this->begin !== null) {
+                       //Set start time
+                       $this->start->setTime(intval($this->begin->format('H')), intval($this->begin->format('i')), intval($this->begin->format('s')));
+               }
+
+               //Return start
+               return $this->start;
+       }
+
+       /**
+        * Set length
+        *
+        * @param \DateTime $length
+        *
+        * @return Session
+        */
+       public function setLength(?\DateTime $length): Session {
+               $this->length = $length;
+
+               return $this;
+       }
+
+       /**
+        * Get length
+        *
+        * @return \DateTime
+        */
+       public function getLength(): ?\DateTime {
+               return $this->length;
+       }
+
+       /**
+        * Get stop
+        *
+        * @return \DateTime
+        */
+       public function getStop(): \DateTime {
+               //Check start
+               if ($this->stop !== null) {
+                       return $this->stop;
+               }
+
+               //Get start clone
+               $this->stop = clone $this->getStart();
+
+               //With length
+               if ($this->length !== null) {
+                       //Set stop time
+                       $this->stop->add(new \DateInterval('PT'.$this->length->format('H').'H'.$this->length->format('i').'M'.$this->length->format('s').'S'));
+               }
+
+               //Return date
+               return $this->stop;
+       }
+
+       /**
+        * Set premium
+        *
+        * @param bool $premium
+        *
+        * @return Session
+        */
+       public function setPremium(?bool $premium): Session {
+               $this->premium = $premium;
+
+               return $this;
+       }
+
+       /**
+        * Get premium
+        *
+        * @return bool
+        */
+       public function getPremium(): ?bool {
+               return $this->premium;
+       }
+
+       /**
+        * Set rainfall
+        *
+        * @param float $rainfall
+        *
+        * @return Session
+        */
+       public function setRainfall(?float $rainfall): Session {
+               $this->rainfall = $rainfall;
+
+               return $this;
+       }
+
+       /**
+        * Get rainfall
+        *
+        * @return float
+        */
+       public function getRainfall(): ?float {
+               return $this->rainfall;
+       }
+
+       /**
+        * Set rainrisk
+        *
+        * @param float $rainrisk
+        *
+        * @return Session
+        */
+       public function setRainrisk(?float $rainrisk): Session {
+               $this->rainrisk = $rainrisk;
+
+               return $this;
+       }
+
+       /**
+        * Get rainrisk
+        *
+        * @return float
+        */
+       public function getRainrisk(): ?float {
+               return $this->rainrisk;
+       }
+
+       /**
+        * Set realfeel
+        *
+        * @param float $realfeel
+        *
+        * @return Session
+        */
+       public function setRealfeel(?float $realfeel): Session {
+               $this->realfeel = $realfeel;
+
+               return $this;
+       }
+
+       /**
+        * Get realfeel
+        *
+        * @return float
+        */
+       public function getRealfeel(): ?float {
+               return $this->realfeel;
+       }
+
+       /**
+        * Set realfeelmin
+        *
+        * @param float $realfeelmin
+        *
+        * @return Session
+        */
+       public function setRealfeelmin(?float $realfeelmin): Session {
+               $this->realfeelmin = $realfeelmin;
+
+               return $this;
+       }
+
+       /**
+        * Get realfeelmin
+        *
+        * @return float
+        */
+       public function getRealfeelmin(): ?float {
+               return $this->realfeelmin;
+       }
+
+       /**
+        * Set realfeelmax
+        *
+        * @param float $realfeelmax
+        *
+        * @return Session
+        */
+       public function setRealfeelmax(?float $realfeelmax): Session {
+               $this->realfeelmax = $realfeelmax;
+
+               return $this;
+       }
+
+       /**
+        * Get realfeelmax
+        *
+        * @return float
+        */
+       public function getRealfeelmax(): ?float {
+               return $this->realfeelmax;
+       }
+
+       /**
+        * Set temperature
+        *
+        * @param float $temperature
+        *
+        * @return Session
+        */
+       public function setTemperature(?float $temperature): Session {
+               $this->temperature = $temperature;
+
+               return $this;
+       }
+
+       /**
+        * Get temperature
+        *
+        * @return float
+        */
+       public function getTemperature(): ?float {
+               return $this->temperature;
+       }
+
+       /**
+        * Set temperaturemin
+        *
+        * @param float $temperaturemin
+        *
+        * @return Session
+        */
+       public function setTemperaturemin(?float $temperaturemin): Session {
+               $this->temperaturemin = $temperaturemin;
+
+               return $this;
+       }
+
+       /**
+        * Get temperaturemin
+        *
+        * @return float
+        */
+       public function getTemperaturemin(): ?float {
+               return $this->temperaturemin;
+       }
+
+       /**
+        * Set temperaturemax
+        *
+        * @param float $temperaturemax
+        *
+        * @return Session
+        */
+       public function setTemperaturemax(?float $temperaturemax): Session {
+               $this->temperaturemax = $temperaturemax;
+
+               return $this;
+       }
+
+       /**
+        * Get temperaturemax

         *
         *

-        * @param \DateTime $end
+        * @return float
+        */
+       public function getTemperaturemax(): ?float {
+               return $this->temperaturemax;
+       }
+
+       /**
+        * Set locked
+        *
+        * @param \DateTime $locked

         *
         * @return Session
         */
         *
         * @return Session
         */

-       public function setEnd($end) {
-               $this->end = $end;
+       public function setLocked(?\DateTime $locked): Session {
+               $this->locked = $locked;

 
                return $this;
        }
 
        /**
 
                return $this;
        }
 
        /**

-        * Get end
+        * Get locked

         *
         * @return \DateTime
         */
         *
         * @return \DateTime
         */

-       public function getEnd() {
-               return $this->end;
+       public function getLocked(): ?\DateTime {
+               return $this->locked;

        }
 
        /**
        }
 
        /**


@@ -140,7 +483,7 @@ class Session {
         *
         * @return Session
         */
         *
         * @return Session
         */

-       public function setCreated($created) {
+       public function setCreated(\DateTime $created): Session {

                $this->created = $created;
 
                return $this;
                $this->created = $created;
 
                return $this;


@@ -151,7 +494,7 @@ class Session {
         *
         * @return \DateTime
         */
         *
         * @return \DateTime
         */

-       public function getCreated() {
+       public function getCreated(): \DateTime {

                return $this->created;
        }
 
                return $this->created;
        }
 


@@ -162,7 +505,7 @@ class Session {
         *
         * @return Session
         */
         *
         * @return Session
         */

-       public function setUpdated($updated) {
+       public function setUpdated(\DateTime $updated): Session {

                $this->updated = $updated;
 
                return $this;
                $this->updated = $updated;
 
                return $this;


@@ -173,18 +516,18 @@ class Session {
         *
         * @return \DateTime
         */
         *
         * @return \DateTime
         */

-       public function getUpdated() {
+       public function getUpdated(): \DateTime {

                return $this->updated;
        }
 
        /**
         * Add application
         *
                return $this->updated;
        }
 
        /**
         * Add application
         *

-        * @param \Rapsys\AirBundle\Entity\Application $application
+        * @param Application $application

         *
         * @return Session
         */
         *
         * @return Session
         */

-       public function addApplication(\Rapsys\AirBundle\Entity\Application $application) {
+       public function addApplication(Application $application): Session {

                $this->applications[] = $application;
 
                return $this;
                $this->applications[] = $application;
 
                return $this;


@@ -193,29 +536,29 @@ class Session {
        /**
         * Remove application
         *
        /**
         * Remove application
         *

-        * @param \Rapsys\AirBundle\Entity\Application $application
+        * @param Application $application

         */
         */

-       public function removeApplication(\Rapsys\AirBundle\Entity\Application $application) {
-               $this->applications->removeElement($application);
+       public function removeApplication(Application $application): bool {
+               return $this->applications->removeElement($application);

        }
 
        /**
         * Get applications
         *
        }
 
        /**
         * Get applications
         *

-        * @return \Doctrine\Common\Collections\Collection
+        * @return ArrayCollection

         */
         */

-       public function getApplications() {
+       public function getApplications(): ArrayCollection {

                return $this->applications;
        }
 
        /**
         * Set location
         *
                return $this->applications;
        }
 
        /**
         * Set location
         *

-        * @param \Rapsys\AirBundle\Entity\Location $location
+        * @param Location $location

         *
         * @return Session
         */
         *
         * @return Session
         */

-       public function setLocation(\Rapsys\AirBundle\Entity\Location $location = null) {
+       public function setLocation(Location $location): Session {

                $this->location = $location;
 
                return $this;
                $this->location = $location;
 
                return $this;


@@ -224,25 +567,20 @@ class Session {
        /**
         * Get location
         *
        /**
         * Get location
         *

-        * @return \Rapsys\AirBundle\Entity\Location
+        * @return Location

         */
         */

-       public function getLocation() {
+       public function getLocation(): Location {

                return $this->location;
        }
                return $this->location;
        }

-       /**
-        * @var \Rapsys\AirBundle\Entity\Slot
-        */
-       private $slot;
-

 
        /**
         * Set slot
         *
 
        /**
         * Set slot
         *

-        * @param \Rapsys\AirBundle\Entity\Slot $slot
+        * @param Slot $slot

         *
         * @return Session
         */
         *
         * @return Session
         */

-       public function setSlot(\Rapsys\AirBundle\Entity\Slot $slot = null) {
+       public function setSlot(Slot $slot): Session {

                $this->slot = $slot;
 
                return $this;
                $this->slot = $slot;
 
                return $this;


@@ -251,20 +589,20 @@ class Session {
        /**
         * Get slot
         *
        /**
         * Get slot
         *

-        * @return \Rapsys\AirBundle\Entity\Slot
+        * @return Slot

         */
         */

-       public function getSlot() {
+       public function getSlot(): Slot {

                return $this->slot;
        }
 
        /**
         * Set application
         *
                return $this->slot;
        }
 
        /**
         * Set application
         *

-        * @param \Rapsys\AirBundle\Entity\Application $application
+        * @param Application $application

         *
         * @return Session
         */
         *
         * @return Session
         */

-       public function setApplication(\Rapsys\AirBundle\Entity\Application $application = null) {
+       public function setApplication(?Application $application): Session {

                $this->application = $application;
 
                return $this;
                $this->application = $application;
 
                return $this;


@@ -273,9 +611,126 @@ class Session {
        /**
         * Get application
         *
        /**
         * Get application
         *

-        * @return \Rapsys\AirBundle\Entity\Application
+        * @return Application

         */
         */

-       public function getApplication() {
+       public function getApplication(): ?Application {

                return $this->application;
        }
                return $this->application;
        }

+
+       /**
+        * {@inheritdoc}
+        */
+       public function preUpdate(PreUpdateEventArgs $eventArgs) {
+               //Check that we have a session instance
+               if (($session = $eventArgs->getObject()) instanceof Session) {
+                       //Set updated value
+                       $session->setUpdated(new \DateTime('now'));
+               }
+       }
+
+       /**
+        * Wether if session is a premium day
+        *
+        * Consider as premium a day off for afternoon, the eve for evening and after
+        * Store computed result in premium member for afternoon and evening
+        *
+        * @TODO improve by moving day off computation in IntlUtil or HolidayUtil class ?
+        *
+        * @return bool Whether the date is day off or not
+        */
+       public function isPremium(): bool {
+               //Without date
+               if (empty($date = $this->date)) {
+                       throw new \LogicException('Property date is empty');
+               }
+
+               //Without slot
+               if (empty($slot = $this->slot) || empty($slotTitle = $slot->getTitle())) {
+                       throw new \LogicException('Property slot is empty');
+               }
+
+               //With evening and after slot
+               if ($slotTitle == 'Evening' || $slotTitle == 'After') {
+                       //Evening and after session is considered premium when the eve is a day off
+                       $date = (clone $date)->add(new \DateInterval('P1D'));
+               }
+
+               //Get day number
+               $w = $date->format('w');
+
+               //Check if weekend day
+               if ($w == 0 || $w == 6) {
+                       //With afternoon and evening slot
+                       if ($slotTitle == 'Afternoon' || $slotTitle == 'Evening') {
+                               //Save premium
+                               $this->premium = true;
+                       }
+
+                       //Date is weekend day
+                       return true;
+               }
+
+               //Get date day
+               $d = $date->format('d');
+
+               //Get date month
+               $m = $date->format('m');
+
+               //Check if fixed holiday
+               if (
+                       //Check if 1st january
+                       ($d == 1 && $m == 1) ||
+                       //Check if 1st may
+                       ($d == 1 && $m == 5) ||
+                       //Check if 8st may
+                       ($d == 8 && $m == 5) ||
+                       //Check if 14st july
+                       ($d == 14 && $m == 7) ||
+                       //Check if 15st august
+                       ($d == 15 && $m == 8) ||
+                       //Check if 1st november
+                       ($d == 1 && $m == 11) ||
+                       //Check if 11st november
+                       ($d == 11 && $m == 11) ||
+                       //Check if 25st december
+                       ($d == 25 && $m == 12)
+               ) {
+                       //With afternoon and evening slot
+                       if ($slotTitle == 'Afternoon' || $slotTitle == 'Evening') {
+                               //Save premium
+                               $this->premium = true;
+                       }
+
+                       //Date is a fixed holiday
+                       return true;
+               }
+
+               //Get eastern
+               $eastern = (new IntlUtil())->getEastern($date->format('Y'));
+
+               //Check dynamic holidays
+               if (
+                       (clone $eastern)->add(new \DateInterval('P1D')) == $date ||
+                       (clone $eastern)->add(new \DateInterval('P39D')) == $date ||
+                       (clone $eastern)->add(new \DateInterval('P50D')) == $date
+               ) {
+                       //With afternoon and evening slot
+                       if ($slotTitle == 'Afternoon' || $slotTitle == 'Evening') {
+                               //Save premium
+                               $this->premium = true;
+                       }
+
+                       //Date is a dynamic holiday
+                       return true;
+               }
+
+               //With afternoon and evening slot
+               if ($slotTitle == 'Afternoon' || $slotTitle == 'Evening') {
+                       //Save premium
+                       $this->premium = false;
+               }
+
+               //Date is not a holiday and week day
+               return false;
+       }

 }
 }