src/Entity/Freelancer.php line 26

Open in your IDE?
  1. <?php
  3. namespace App\Entity;
  5. use App\Entity\Enum\BusinessModelEnum;
  6. use App\Entity\Enum\FreelancerBusinessSoftwareEnum;
  7. use App\Entity\Enum\OnboardingStatusEnum;
  8. use App\Entity\Traits\CreditOwnerInterface;
  9. use App\Entity\Traits\CreditOwnerTrait;
  10. use DateTime;
  11. use DateTimeInterface;
  12. use Doctrine\Common\Collections\ArrayCollection;
  13. use Doctrine\Common\Collections\Collection;
  14. use Doctrine\ORM\Mapping as ORM;
  15. use Symfony\Component\HttpFoundation\File\File;
  16. use Symfony\Component\Validator\Constraints as Assert;
  17. use Vich\UploaderBundle\Mapping\Annotation as Vich;
  18. use Gedmo\Mapping\Annotation as Gedmo;
  20. /**
  21.  * @ORM\Entity(repositoryClass="App\Repository\FreelancerRepository")
  22.  * @ORM\EntityListeners({"App\Listener\FreelancerListener"})
  23.  * @Gedmo\Loggable(logEntryClass="App\Entity\LogEntry")
  24.  * @Vich\Uploadable
  25.  */
  26. class Freelancer extends Administrator implements CreditOwnerInterface
  27. {
  28.     use CreditOwnerTrait;
  30.     public const CREDIT_ALMOST_DOWN = 2;
  32.     private const PAYASYOUGO_CAPPING_DEFAULT = 5;
  34.     /**
  35.      * Fake deadline used to identify freelance who have their store indexable till they reach 0 credit
  36.      */
  37.     public const BUSINESS_MODEL_FAKE_DEADLINE = '2030-01-01 00:00:00';
  39.     /**
  40.      * Deadline relacing the 2 months previously used before passing businessModel from 'credit' to 'none'
  41.      */
  42.     public const BUSINESS_FORCED_DEADLINE = '2025-05-20 00:00:00';
  44.     /**
  45.      * @ORM\Column(type="string", length=25, nullable=true)
  46.      */
  47.     private $vatNumber;
  49.     /**
  50.      * @Assert\NotBlank()
  51.      * @Assert\Regex(pattern="/^\d{14}$/", message="Le numéro de SIRET n'est pas valide.")
  52.      * @ORM\Column(type="string", length=25)
  53.      */
  54.     private $siretNumber;
  56.     /**
  57.      * @Assert\Regex(pattern="/^(?:\+33|0)\s*[1-9](?:[\s.-]*\d{2}){4}$/", message="Le numéro de téléphone n'est pas valide.")
  58.      * @ORM\Column(type="string", length=255, nullable=true)
  59.      */
  60.     private $phoneNumberSmsNotification;
  62.     /**
  63.      * @ORM\Column(type="string", length=255, nullable=true)
  64.      */
  65.     private $emailNotification;
  67.     /**
  68.      * @var boolean
  69.      * @ORM\Column(type="boolean")
  70.      */
  71.     private $isSmsNotification;
  73.     /**
  74.      * @var boolean
  75.      * @ORM\Column(type="boolean")
  76.      */
  77.     private $isEmailNotification;
  79.     /**
  80.      * specify if this freelancer has already been an premium member (even if nbCredit is null)
  81.      * @var boolean
  82.      * @ORM\Column(type="boolean", options={"default" : false})
  83.      */
  84.     private $hasBeenPremium;
  86.     /**
  87.      * @ORM\Column(type="datetime", nullable=true)
  88.      */
  89.     private $soldOutAt;
  91.     /**
  92.      * specify if this freelancer is active and can receive prospect
  93.      * @var boolean
  94.      * @ORM\Column(type="boolean", options={"default" : true})
  95.      */
  96.     private $isEnabled = 1;
  98.     /**
  99.      * @ORM\OneToMany(targetEntity="App\Entity\Order", mappedBy="freelancer", cascade={"remove"})
  100.      */
  101.     private $orders;
  103.     /**
  104.      * @ORM\OneToMany(targetEntity=FreelancerAssistant::class, mappedBy="freelancer")
  105.      */
  106.     private $freelancerAssistants;
  108.     /**
  109.      * @ORM\Column(type="datetime", nullable=true)
  110.      */
  111.     private $updatedAt;
  113.     /**
  114.      * @ORM\Column(type="string", length=255, nullable=true)
  115.      */
  116.     private $picturePath;
  118.     /**
  119.      * @assert\File( mimeTypes = {"image/jpeg", "image/png", "image/gif", "image/jpg","image/webp"})
  120.      * @Vich\UploadableField(mapping="freelancer_images", fileNameProperty="picturePath")
  121.      * @var File
  122.      */
  123.     private $pictureFile;
  125.     /**
  126.      * @ORM\Column(type="string", length=255, nullable=true)
  127.      */
  128.     private $logoPath;
  130.     /**
  131.      * @assert\File( mimeTypes = {"image/jpeg", "image/png", "image/gif", "image/jpg","image/webp"})
  132.      * @Vich\UploadableField(mapping="freelancer_logo", fileNameProperty="logoPath")
  133.      * @var File
  134.      */
  135.     private $logoFile;
  137.     /**
  138.      * @ORM\Column(type="integer")
  139.      */
  140.     private $nbPendingLead;
  142.     /**
  143.      * @ORM\Column(type="integer", nullable=true)
  144.      */
  145.     private $nbCreditSms;
  147.     /**
  148.      * @ORM\OneToMany(targetEntity=FreelancerComment::class, mappedBy="freelancer", orphanRemoval=true)
  149.      */
  150.     private $comments;
  152.     /**
  153.      * @ORM\Column(type="integer", nullable=true)
  154.      */
  155.     private $businessSoftware;
  157.     /**
  158.      * @ORM\Column(type="integer", nullable=true)
  159.      * @Assert\Range(
  160.      *      min = 1,
  161.      *      max = 99,
  162.      *      notInRangeMessage = "Le nombre de contact doit être entre {{ min }} et {{ max }}",
  163.      * )
  164.      */
  165.     private ?int $payAsYouGoCapping = self::PAYASYOUGO_CAPPING_DEFAULT;
  167.     /**
  168.      * @ORM\OneToMany(targetEntity=CreditCost::class, mappedBy="administrator")
  169.      */
  170.     private Collection $creditCosts;
  172.     /**
  173.      * @ORM\Column(type="string", length=255, nullable=true)
  174.      */
  175.     private string $onboardingStatus = OnboardingStatusEnum::IN_PROGRESS;
  177.     /**
  178.      * @ORM\Column(type="integer", name="stat_nb_credit_purchased")
  179.      */
  180.     private int $nbCreditPurchased = 0;
  181.     /**
  182.      * @ORM\Column(type="integer", name="stat_nb_lead_delivered")
  183.      */
  184.     private int $nbLeadDelivered = 0;
  186.     /**
  187.      * @ORM\Column(type="integer", name="stat_nb_sales")
  188.      */
  189.     private int $nbSales = 0;
  191.     /**
  192.      * @ORM\Column(type="boolean", options={"default" : false})
  193.      */
  194.     private bool $schedulingAppointment = false;
  197.     public function __construct()
  198.     {
  199.         parent::__construct();
  200.         $this->isEmailNotification = true;
  201.         $this->isSmsNotification = true;
  202.         $this->hasBeenPremium = false;
  203.         $this->orders = new ArrayCollection();
  204.         $this->freelancerAssistants = new ArrayCollection();
  205.         $this->comments = new ArrayCollection();
  206.         $this->setBusinessModel(BusinessModelEnum::NONE);
  207.     }
  209.     public function setBusinessModel(int $businessModel): void
  210.     {
  211.         parent::setBusinessModel($businessModel);
  213.         $this->updateCustomerStatus();
  214.     }
  216.     /**
  217.      * when nbCredit or nbPendingLead is updated, we check if this freelancer is still a customer
  218.      * - freelance must be enabled
  219.      * AND
  220.      *      - freelance must have enough credit to receive leads
  221.      *      OR
  222.      *      - freelance must have opted-in for "pay as you go" credit && have less than 2 pending credit costs
  223.      */
  224.     public function updateCustomerStatus()
  225.     {
  226.         if ($this->isEnabled() && (($this->nbCredit - $this->nbPendingLead) > 0 || ($this->isPayAsYouGo() && !$this->isPayAsYouGoThresholdReached()))) {
  227.             $this->setIsCustomer(true);
  228.         } else {
  229.             $this->setIsCustomer(false);
  230.         }
  231.     }
  233.     /**
  234.      * @return bool
  235.      */
  236.     public function isEnabled(): bool
  237.     {
  238.         return $this->isEnabled;
  239.     }
  241.     public function isPayAsYouGoThresholdReached(): bool
  242.     {
  243.         if (is_null($this->getPayAsYouGoCapping())) {
  244.             return false;
  245.         }
  246.         return $this->getNbPendingCreditCosts() + $this->getNbPendingLead() >= $this->getPayAsYouGoCapping();
  247.     }
  249.     public function getPayAsYouGoCapping(): ?int
  250.     {
  251.         if (is_null($this->payAsYouGoCapping)) {
  252.             return self::PAYASYOUGO_CAPPING_DEFAULT;
  253.         }
  254.         return $this->payAsYouGoCapping;
  255.     }
  257.     public function setPayAsYouGoCapping(?int $payAsYouGoCapping): void
  258.     {
  259.         $this->payAsYouGoCapping = $payAsYouGoCapping;
  260.         $this->updateCustomerStatus();
  261.     }
  263.     public function getNbPendingCreditCosts(): int
  264.     {
  265.         return $this->getPendingCreditCosts()->count();
  266.     }
  268.     public function getPendingCreditCosts(): Collection
  269.     {
  270.         return $this->creditCosts->filter(function (CreditCost $creditCost) {
  271.             return $creditCost->isPending();
  272.         });
  273.     }
  275.     public function getNbPendingLead(): ?int
  276.     {
  277.         return $this->nbPendingLead;
  278.     }
  280.     public function setNbPendingLead(int $nbPendingLead): self
  281.     {
  282.         $this->nbPendingLead = $nbPendingLead;
  283.         $this->updateCustomerStatus();
  284.         return $this;
  285.     }
  287.     /**
  288.      * @return mixed
  289.      */
  290.     public function getUpdatedAt(): ?DateTimeInterface
  291.     {
  292.         return $this->updatedAt;
  293.     }
  295.     /**
  296.      * @param mixed $updatedAt
  297.      */
  298.     public function setUpdatedAt(?DateTimeInterface $updatedAt): self
  299.     {
  300.         $this->updatedAt = $updatedAt;
  302.         return $this;
  303.     }
  305.     public function getPicturePath(): ?string
  306.     {
  307.         return $this->picturePath;
  308.     }
  310.     public function setPicturePath(?string $picturePath)
  311.     {
  312.         $this->picturePath = $picturePath;
  314.         return $this;
  315.     }
  317.     public function hasPicture()
  318.     {
  319.         return !is_null($this->picturePath);
  320.     }
  322.     public function getPictureFile()
  323.     {
  324.         return $this->pictureFile;
  325.     }
  327.     public function setPictureFile(File $picturePath = null)
  328.     {
  329.         $this->pictureFile = $picturePath;
  331.         if ($picturePath) {
  332.             $this->updatedAt = new DateTime('now');
  333.         }
  334.     }
  336.     /**
  337.      * Représente l'entité par son nom et son type (admin ou freelance)
  338.      * @return string
  339.      */
  340.     public function getLabelWithType()
  341.     {
  342.         return $this->getName() . ' [Indépendant]';
  343.     }
  345.     public function getNameAndEmailUser()
  346.     {
  347.         if ($this->getUser() !== null) {
  348.             return strtoupper($this->getName()) . ' [' . $this->getUser()->getEmail() . ']';
  350.         } else {
  351.             return $this->getName();
  352.         }
  353.     }
  355.     public function getId(): ?int
  356.     {
  357.         return $this->id;
  358.     }
  360.     public function getVatNumber(): ?string
  361.     {
  362.         return $this->vatNumber;
  363.     }
  365.     public function setVatNumber(string $vatNumber): self
  366.     {
  367.         $this->vatNumber = $vatNumber;
  369.         return $this;
  370.     }
  372.     public function setNbCredit(int $nbCredit): self
  373.     {
  374.         $this->nbCredit = $nbCredit;
  375.         $this->updateCustomerStatus();
  376.         return $this;
  377.     }
  379.     public function getSiretNumber(): ?string
  380.     {
  381.         return $this->siretNumber;
  382.     }
  384.     public function setSiretNumber(string $siretNumber): self
  385.     {
  386.         $siretNumber = str_replace(' ', '', $siretNumber);
  387.         $this->siretNumber = $siretNumber;
  389.         return $this;
  390.     }
  393.     // Returns an array with every mail addresses for a store
  395.     public function mustBeNotifiedBySms(): ?bool
  396.     {
  397.         return $this->getIsSmsNotification() && $this->getPhoneNumberSmsNotification();
  398.     }
  400.     public function getIsSmsNotification(): ?bool
  401.     {
  402.         return $this->isSmsNotification;
  403.     }
  405.     public function setIsSmsNotification(bool $isSmsNotification): self
  406.     {
  407.         $this->isSmsNotification = $isSmsNotification;
  409.         return $this;
  410.     }
  412.     public function getPhoneNumberSmsNotification(): ?string
  413.     {
  414.         return $this->phoneNumberSmsNotification;
  415.     }
  417.     public function setPhoneNumberSmsNotification(?string $phoneNumberSmsNotification): self
  418.     {
  419.         $this->phoneNumberSmsNotification = $phoneNumberSmsNotification;
  421.         return $this;
  422.     }
  424.     /**
  425.      * @return string
  426.      * @deprecated use Formatter->phoneNumberInternationalFormat instead
  427.      */
  428.     public function getPhoneNumberSmsNotificationFormatted()
  429.     {
  430.         return wordwrap($this->getPhoneNumberSmsNotification(), 2, ' ', true);
  431.     }
  433.     public function mustBeNotifiedByEmail(): ?bool
  434.     {
  435.         return $this->getIsEmailNotification() && !empty($this->getEmailNotification());
  436.     }
  438.     public function getIsEmailNotification(): ?bool
  439.     {
  440.         return $this->isEmailNotification;
  441.     }
  443.     public function setIsEmailNotification(bool $isEmailNotification): self
  444.     {
  445.         $this->isEmailNotification = $isEmailNotification;
  447.         return $this;
  448.     }
  450.     public function getEmailNotification(): ?string
  451.     {
  452.         return $this->emailNotification;
  453.     }
  455.     public function setEmailNotification(?string $emailNotification): self
  456.     {
  457.         $this->emailNotification = $emailNotification;
  459.         return $this;
  460.     }
  462.     public function getEmailList(): array
  463.     {
  464.         // Optim: use constant for delimiter?
  465.         return explode(";", $this->getEmailNotification());
  466.     }
  468.     /**
  469.      * @return bool
  470.      */
  471.     public function isHasBeenPremium(): bool
  472.     {
  473.         return $this->hasBeenPremium;
  474.     }
  476.     public function getHasBeenPremium(): ?bool
  477.     {
  478.         return $this->hasBeenPremium;
  479.     }
  481.     /**
  482.      * @param bool $hasBeenPremium
  483.      */
  484.     public function setHasBeenPremium(bool $hasBeenPremium): void
  485.     {
  486.         $this->hasBeenPremium = $hasBeenPremium;
  487.     }
  489.     /**
  490.      * @return Collection|Order[]
  491.      */
  492.     public function getOrders(): Collection
  493.     {
  494.         return $this->orders;
  495.     }
  497.     public function addOrder(Order $order): self
  498.     {
  499.         if (!$this->orders->contains($order)) {
  500.             $this->orders[] = $order;
  501.             $order->setFreelancer($this);
  502.         }
  504.         return $this;
  505.     }
  507.     public function removeOrder(Order $order): self
  508.     {
  509.         if ($this->orders->contains($order)) {
  510.             $this->orders->removeElement($order);
  511.             // set the owning side to null (unless already changed)
  512.             if ($order->getFreelancer() === $this) {
  513.                 $order->setFreelancer(null);
  514.             }
  515.         }
  517.         return $this;
  518.     }
  520.     public function getIsEnabled(): ?bool
  521.     {
  522.         return $this->isEnabled;
  523.     }
  525.     /**
  526.      * @param bool $isEnabled
  527.      */
  528.     public function setIsEnabled(bool $isEnabled): void
  529.     {
  530.         $this->isEnabled = $isEnabled;
  531.         $this->updateCustomerStatus();
  532.     }
  534.     /**
  535.      * @return Collection|FreelancerAssistant[]
  536.      */
  537.     public function getFreelancerAssistants(): Collection
  538.     {
  539.         return $this->freelancerAssistants;
  540.     }
  542.     public function addFreelancerAssistant(FreelancerAssistant $freelancerAssistant): self
  543.     {
  544.         if (!$this->freelancerAssistants->contains($freelancerAssistant)) {
  545.             $this->freelancerAssistants[] = $freelancerAssistant;
  546.             $freelancerAssistant->setFreelancer($this);
  547.         }
  549.         return $this;
  550.     }
  552.     public function removeFreelancerAssistant(FreelancerAssistant $freelancerAssistant): self
  553.     {
  554.         if ($this->freelancerAssistants->contains($freelancerAssistant)) {
  555.             $this->freelancerAssistants->removeElement($freelancerAssistant);
  556.             // set the owning side to null (unless already changed)
  557.             if ($freelancerAssistant->getFreelancer() === $this) {
  558.                 $freelancerAssistant->setFreelancer(null);
  559.             }
  560.         }
  562.         return $this;
  563.     }
  565.     public function getSoldOutAt(): ?DateTimeInterface
  566.     {
  567.         return $this->soldOutAt;
  568.     }
  570.     public function setSoldOutAt(?DateTimeInterface $soldOutAt): self
  571.     {
  572.         $this->soldOutAt = $soldOutAt;
  574.         return $this;
  575.     }
  577.     public function getNbCreditSms(): ?int
  578.     {
  579.         return $this->nbCreditSms;
  580.     }
  582.     public function setNbCreditSms(?int $nbCreditSms): self
  583.     {
  584.         $this->nbCreditSms = $nbCreditSms;
  586.         return $this;
  587.     }
  589.     /**
  590.      * @return Collection|FreelancerComment[]
  591.      */
  592.     public function getComments(): Collection
  593.     {
  594.         return $this->comments;
  595.     }
  597.     public function addComment(FreelancerComment $comment): self
  598.     {
  599.         if (!$this->comments->contains($comment)) {
  600.             $this->comments[] = $comment;
  601.             $comment->setFreelancer($this);
  602.         }
  604.         return $this;
  605.     }
  607.     public function removeComment(FreelancerComment $comment): self
  608.     {
  609.         if ($this->comments->contains($comment)) {
  610.             $this->comments->removeElement($comment);
  611.             // set the owning side to null (unless already changed)
  612.             if ($comment->getFreelancer() === $this) {
  613.                 $comment->setFreelancer(null);
  614.             }
  615.         }
  617.         return $this;
  618.     }
  620.     public function getLastCommentExtract(): ?string
  621.     {
  622.         return !$this->comments->isEmpty() ? substr($this->comments->last()->getComment(), 0, 30) : null;
  623.     }
  625.     public function getLogoPath(): ?string
  626.     {
  627.         return $this->logoPath;
  628.     }
  630.     public function setLogoPath(?string $logoPath): self
  631.     {
  632.         $this->logoPath = $logoPath;
  633.         return $this;
  634.     }
  636.     public function getBusinessSoftwareName(): string
  637.     {
  638.         if (is_null($this->getBusinessSoftware())) {
  639.             return 'Aucune';
  640.         }
  641.         return FreelancerBusinessSoftwareEnum::getItemName($this->getBusinessSoftware());
  642.     }
  644.     public function getBusinessSoftware(): ?int
  645.     {
  646.         return $this->businessSoftware;
  647.     }
  649.     public function setBusinessSoftware(?int $businessSoftware): self
  650.     {
  651.         $this->businessSoftware = $businessSoftware;
  652.         return $this;
  653.     }
  655.     public function getLogoFile()
  656.     {
  657.         return $this->logoFile;
  658.     }
  660.     public function setLogoFile(File $logoPath = null)
  661.     {
  662.         $this->logoFile = $logoPath;
  664.         if ($logoPath) {
  665.             $this->updatedAt = new DateTime('now');
  666.         }
  667.     }
  669.     public function hasAllStoresIndexableTemporary(): bool
  670.     {
  671.         //if a deadline is set, stores remain indexable
  672.         return !is_null($this->businessModelDeadline);// && $this->businessModelDeadline->format('Y-m-d H:i:s') == self::BUSINESS_MODEL_FAKE_DEADLINE;
  673.     }
  675.     public function markAsAllStoresIndexableTemporary(): void
  676.     {
  677.         $this->setBusinessModelDeadline(new DateTime(self::BUSINESS_MODEL_FAKE_DEADLINE));
  678.     }
  680.     public function getCreditCosts(): Collection
  681.     {
  682.         return $this->creditCosts;
  683.     }
  685.     public function setCreditCosts(Collection $creditCosts): void
  686.     {
  687.         $this->creditCosts = $creditCosts;
  688.     }
  690.     public function addCreditCost(CreditCost $creditCost): self
  691.     {
  692.         if (!$this->creditCosts->contains($creditCost)) {
  693.             $this->creditCosts->add($creditCost);
  694.             $creditCost->setAdministrator($this);
  695.         }
  697.         return $this;
  698.     }
  700.     public function getOnboardingStatus(): string
  701.     {
  702.         return $this->onboardingStatus;
  703.     }
  705.     public function setOnboardingStatus(string $onboardingStatus): void
  706.     {
  707.         $this->onboardingStatus = $onboardingStatus;
  708.     }
  710.     public function getNbCreditPurchased(): int
  711.     {
  712.         return $this->nbCreditPurchased;
  713.     }
  715.     public function setNbCreditPurchased(int $nbCreditPurchased): void
  716.     {
  717.         $this->nbCreditPurchased = $nbCreditPurchased;
  718.     }
  720.     public function getNbLeadDelivered(): int
  721.     {
  722.         return $this->nbLeadDelivered;
  723.     }
  725.     public function setNbLeadDelivered(int $nbLeadDelivered): void
  726.     {
  727.         $this->nbLeadDelivered = $nbLeadDelivered;
  728.     }
  730.     public function getNbSales(): int
  731.     {
  732.         return $this->nbSales;
  733.     }
  735.     public function setNbSales(int $nbSales): void
  736.     {
  737.         $this->nbSales = $nbSales;
  738.     }
  740.     /**
  741.      */
  742.     public function hasAtLeastOneIndexableStore(): bool
  743.     {
  744.         return $this->getStores()->exists(function ($key, $store) {
  745.             return $store->hasCurrentStoreIndexation();
  746.         });
  747.     }
  749.     public function getAgeCapping(): ?int
  750.     {
  751.         return 50;
  752.     }
  754.     public function isSchedulingAppointment(): bool
  755.     {
  756.         return $this->schedulingAppointment;
  757.     }
  759.     public function setSchedulingAppointment(bool $schedulingAppointment): void
  760.     {
  761.         $this->schedulingAppointment = $schedulingAppointment;
  762.     }
  763. }