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;
  169.     /**
  170.      * @ORM\OneToMany(targetEntity=CreditCost::class, mappedBy="administrator")
  171.      */
  172.     private Collection $creditCosts;
  174.     /**
  175.      * @ORM\Column(type="string", length=255, nullable=true)
  176.      */
  177.     private string $onboardingStatus = OnboardingStatusEnum::IN_PROGRESS;
  179.     /**
  180.      * @ORM\Column(type="integer", name="stat_nb_credit_purchased")
  181.      */
  182.     private int $nbCreditPurchased = 0;
  183.     /**
  184.      * @ORM\Column(type="integer", name="stat_nb_lead_delivered")
  185.      */
  186.     private int $nbLeadDelivered = 0;
  188.     /**
  189.      * @ORM\Column(type="integer", name="stat_nb_sales")
  190.      */
  191.     private int $nbSales = 0;
  193.     public function __construct()
  194.     {
  195.         parent::__construct();
  196.         $this->isEmailNotification = true;
  197.         $this->isSmsNotification = true;
  198.         $this->hasBeenPremium = false;
  199.         $this->orders = new ArrayCollection();
  200.         $this->freelancerAssistants = new ArrayCollection();
  201.         $this->comments = new ArrayCollection();
  202.         $this->setBusinessModel(BusinessModelEnum::NONE);
  203.     }
  205.     /**
  206.      * @return mixed
  207.      */
  208.     public function getUpdatedAt(): ?DateTimeInterface
  209.     {
  210.         return $this->updatedAt;
  211.     }
  213.     /**
  214.      * @param mixed $updatedAt
  215.      */
  216.     public function setUpdatedAt(?DateTimeInterface $updatedAt): self
  217.     {
  218.         $this->updatedAt = $updatedAt;
  220.         return $this;
  221.     }
  223.     public function getPicturePath(): ?string
  224.     {
  225.         return $this->picturePath;
  226.     }
  228.     public function setPicturePath(?string $picturePath)
  229.     {
  230.         $this->picturePath = $picturePath;
  232.         return $this;
  233.     }
  235.     public function hasPicture()
  236.     {
  237.         return !is_null($this->picturePath);
  238.     }
  240.     public function setPictureFile(File $picturePath = null)
  241.     {
  242.         $this->pictureFile = $picturePath;
  244.         if ($picturePath) {
  245.             $this->updatedAt = new DateTime('now');
  246.         }
  247.     }
  249.     public function getPictureFile()
  250.     {
  251.         return $this->pictureFile;
  252.     }
  254.     /**
  255.      * Représente l'entité par son nom et son type (admin ou freelance)
  256.      * @return string
  257.      */
  258.     public function getLabelWithType()
  259.     {
  260.         return $this->getName() . ' [Indépendant]';
  261.     }
  263.     public function getNameAndEmailUser()
  264.     {
  265.         if ($this->getUser() !== null) {
  266.             return strtoupper($this->getName()) . ' [' . $this->getUser()->getEmail() . ']';
  268.         } else {
  269.             return $this->getName();
  270.         }
  271.     }
  273.     public function getId(): ?int
  274.     {
  275.         return $this->id;
  276.     }
  278.     public function getVatNumber(): ?string
  279.     {
  280.         return $this->vatNumber;
  281.     }
  283.     public function setVatNumber(string $vatNumber): self
  284.     {
  285.         $this->vatNumber = $vatNumber;
  287.         return $this;
  288.     }
  290.     public function setNbCredit(int $nbCredit): self
  291.     {
  292.         $this->nbCredit = $nbCredit;
  293.         $this->updateCustomerStatus();
  294.         return $this;
  295.     }
  297.     public function setNbPendingLead(int $nbPendingLead): self
  298.     {
  299.         $this->nbPendingLead = $nbPendingLead;
  300.         $this->updateCustomerStatus();
  301.         return $this;
  302.     }
  304.     /**
  305.      * when nbCredit or nbPendingLead is updated, we check if this freelancer is still a customer
  306.      * - freelance must be enabled
  307.      * AND
  308.      *      - freelance must have enough credit to receive leads
  309.      *      OR
  310.      *      - freelance must have opted-in for "pay as you go" credit && have less than 2 pending credit costs
  311.      */
  312.     public function updateCustomerStatus()
  313.     {
  314.         if ($this->isEnabled() && (($this->nbCredit - $this->nbPendingLead) > 0 || ($this->isPayAsYouGo() && !$this->isPayAsYouGoThresholdReached()))) {
  315.             $this->setIsCustomer(true);
  316.         } else {
  317.             $this->setIsCustomer(false);
  318.         }
  319.     }
  321.     public function getNbPendingLead(): ?int
  322.     {
  323.         return $this->nbPendingLead;
  324.     }
  326.     public function getSiretNumber(): ?string
  327.     {
  328.         return $this->siretNumber;
  329.     }
  331.     public function setSiretNumber(string $siretNumber): self
  332.     {
  333.         $siretNumber = str_replace(' ', '', $siretNumber);
  334.         $this->siretNumber = $siretNumber;
  336.         return $this;
  337.     }
  339.     public function getPhoneNumberSmsNotification(): ?string
  340.     {
  341.         return $this->phoneNumberSmsNotification;
  342.     }
  344.     public function setPhoneNumberSmsNotification(?string $phoneNumberSmsNotification): self
  345.     {
  346.         $this->phoneNumberSmsNotification = $phoneNumberSmsNotification;
  348.         return $this;
  349.     }
  351.     public function mustBeNotifiedBySms(): ?bool
  352.     {
  353.         return $this->getIsSmsNotification() && $this->getPhoneNumberSmsNotification();
  354.     }
  356.     /**
  357.      * @return string
  358.      * @deprecated use Formatter->phoneNumberInternationalFormat instead
  359.      */
  360.     public function getPhoneNumberSmsNotificationFormatted()
  361.     {
  362.         return wordwrap($this->getPhoneNumberSmsNotification(), 2, ' ', true);
  363.     }
  365.     public function getEmailNotification(): ?string
  366.     {
  367.         return $this->emailNotification;
  368.     }
  370.     public function setEmailNotification(?string $emailNotification): self
  371.     {
  372.         $this->emailNotification = $emailNotification;
  374.         return $this;
  375.     }
  377.     public function mustBeNotifiedByEmail(): ?bool
  378.     {
  379.         return $this->getIsEmailNotification() && !empty($this->getEmailNotification());
  380.     }
  383.     // Returns an array with every mail addresses for a store
  384.     public function getEmailList(): array
  385.     {
  386.         // Optim: use constant for delimiter?
  387.         return explode(";", $this->getEmailNotification());
  388.     }
  390.     public function getIsSmsNotification(): ?bool
  391.     {
  392.         return $this->isSmsNotification;
  393.     }
  395.     public function setIsSmsNotification(bool $isSmsNotification): self
  396.     {
  397.         $this->isSmsNotification = $isSmsNotification;
  399.         return $this;
  400.     }
  402.     public function getIsEmailNotification(): ?bool
  403.     {
  404.         return $this->isEmailNotification;
  405.     }
  407.     public function setIsEmailNotification(bool $isEmailNotification): self
  408.     {
  409.         $this->isEmailNotification = $isEmailNotification;
  411.         return $this;
  412.     }
  414.     /**
  415.      * @return bool
  416.      */
  417.     public function isHasBeenPremium(): bool
  418.     {
  419.         return $this->hasBeenPremium;
  420.     }
  422.     /**
  423.      * @param bool $hasBeenPremium
  424.      */
  425.     public function setHasBeenPremium(bool $hasBeenPremium): void
  426.     {
  427.         $this->hasBeenPremium = $hasBeenPremium;
  428.     }
  430.     /**
  431.      * @return Collection|Order[]
  432.      */
  433.     public function getOrders(): Collection
  434.     {
  435.         return $this->orders;
  436.     }
  438.     public function addOrder(Order $order): self
  439.     {
  440.         if (!$this->orders->contains($order)) {
  441.             $this->orders[] = $order;
  442.             $order->setFreelancer($this);
  443.         }
  445.         return $this;
  446.     }
  448.     public function removeOrder(Order $order): self
  449.     {
  450.         if ($this->orders->contains($order)) {
  451.             $this->orders->removeElement($order);
  452.             // set the owning side to null (unless already changed)
  453.             if ($order->getFreelancer() === $this) {
  454.                 $order->setFreelancer(null);
  455.             }
  456.         }
  458.         return $this;
  459.     }
  462.     /**
  463.      * @return bool
  464.      */
  465.     public function isEnabled(): bool
  466.     {
  467.         return $this->isEnabled;
  468.     }
  470.     /**
  471.      * @param bool $isEnabled
  472.      */
  473.     public function setIsEnabled(bool $isEnabled): void
  474.     {
  475.         $this->isEnabled = $isEnabled;
  476.         $this->updateCustomerStatus();
  477.     }
  479.     public function getHasBeenPremium(): ?bool
  480.     {
  481.         return $this->hasBeenPremium;
  482.     }
  484.     public function getIsEnabled(): ?bool
  485.     {
  486.         return $this->isEnabled;
  487.     }
  489.     /**
  490.      * @return Collection|FreelancerAssistant[]
  491.      */
  492.     public function getFreelancerAssistants(): Collection
  493.     {
  494.         return $this->freelancerAssistants;
  495.     }
  497.     public function addFreelancerAssistant(FreelancerAssistant $freelancerAssistant): self
  498.     {
  499.         if (!$this->freelancerAssistants->contains($freelancerAssistant)) {
  500.             $this->freelancerAssistants[] = $freelancerAssistant;
  501.             $freelancerAssistant->setFreelancer($this);
  502.         }
  504.         return $this;
  505.     }
  507.     public function removeFreelancerAssistant(FreelancerAssistant $freelancerAssistant): self
  508.     {
  509.         if ($this->freelancerAssistants->contains($freelancerAssistant)) {
  510.             $this->freelancerAssistants->removeElement($freelancerAssistant);
  511.             // set the owning side to null (unless already changed)
  512.             if ($freelancerAssistant->getFreelancer() === $this) {
  513.                 $freelancerAssistant->setFreelancer(null);
  514.             }
  515.         }
  517.         return $this;
  518.     }
  520.     public function getSoldOutAt(): ?DateTimeInterface
  521.     {
  522.         return $this->soldOutAt;
  523.     }
  525.     public function setSoldOutAt(?DateTimeInterface $soldOutAt): self
  526.     {
  527.         $this->soldOutAt = $soldOutAt;
  529.         return $this;
  530.     }
  532.     public function getNbCreditSms(): ?int
  533.     {
  534.         return $this->nbCreditSms;
  535.     }
  537.     public function setNbCreditSms(?int $nbCreditSms): self
  538.     {
  539.         $this->nbCreditSms = $nbCreditSms;
  541.         return $this;
  542.     }
  544.     /**
  545.      * @return Collection|FreelancerComment[]
  546.      */
  547.     public function getComments(): Collection
  548.     {
  549.         return $this->comments;
  550.     }
  552.     public function addComment(FreelancerComment $comment): self
  553.     {
  554.         if (!$this->comments->contains($comment)) {
  555.             $this->comments[] = $comment;
  556.             $comment->setFreelancer($this);
  557.         }
  559.         return $this;
  560.     }
  562.     public function removeComment(FreelancerComment $comment): self
  563.     {
  564.         if ($this->comments->contains($comment)) {
  565.             $this->comments->removeElement($comment);
  566.             // set the owning side to null (unless already changed)
  567.             if ($comment->getFreelancer() === $this) {
  568.                 $comment->setFreelancer(null);
  569.             }
  570.         }
  572.         return $this;
  573.     }
  575.     public function getLastCommentExtract(): ?string
  576.     {
  577.         return !$this->comments->isEmpty() ? substr($this->comments->last()->getComment(), 0, 30) : null;
  578.     }
  580.     public function getLogoPath(): ?string
  581.     {
  582.         return $this->logoPath;
  583.     }
  585.     public function setLogoPath(?string $logoPath): self
  586.     {
  587.         $this->logoPath = $logoPath;
  588.         return $this;
  589.     }
  591.     public function getBusinessSoftware(): ?int
  592.     {
  593.         return $this->businessSoftware;
  594.     }
  596.     public function setBusinessSoftware(?int $businessSoftware): self
  597.     {
  598.         $this->businessSoftware = $businessSoftware;
  599.         return $this;
  600.     }
  602.     public function getBusinessSoftwareName(): string
  603.     {
  604.         if (is_null($this->getBusinessSoftware())) {
  605.             return 'Aucune';
  606.         }
  607.         return FreelancerBusinessSoftwareEnum::getItemName($this->getBusinessSoftware());
  608.     }
  610.     public function setLogoFile(File $logoPath = null)
  611.     {
  612.         $this->logoFile = $logoPath;
  614.         if ($logoPath) {
  615.             $this->updatedAt = new DateTime('now');
  616.         }
  617.     }
  619.     public function getLogoFile()
  620.     {
  621.         return $this->logoFile;
  622.     }
  624.     public function setBusinessModel(int $businessModel): void
  625.     {
  626.         parent::setBusinessModel($businessModel);
  628.         $this->updateCustomerStatus();
  629.     }
  633.     public function hasAllStoresIndexableTemporary(): bool
  634.     {
  635.         //if a deadline is set, stores remain indexable
  636.         return !is_null($this->businessModelDeadline);// && $this->businessModelDeadline->format('Y-m-d H:i:s') == self::BUSINESS_MODEL_FAKE_DEADLINE;
  637.     }
  639.     public function markAsAllStoresIndexableTemporary(): void
  640.     {
  641.         $this->setBusinessModelDeadline(new DateTime(self::BUSINESS_MODEL_FAKE_DEADLINE));
  642.     }
  646.     public function getCreditCosts(): Collection
  647.     {
  648.         return $this->creditCosts;
  649.     }
  651.     public function addCreditCost(CreditCost $creditCost): self
  652.     {
  653.         if (!$this->creditCosts->contains($creditCost)) {
  654.             $this->creditCosts->add($creditCost);
  655.             $creditCost->setAdministrator($this);
  656.         }
  658.         return $this;
  659.     }
  661.     public function getPendingCreditCosts(): Collection
  662.     {
  663.         return $this->creditCosts->filter(function (CreditCost $creditCost) {
  664.             return $creditCost->isPending();
  665.         });
  666.     }
  668.     public function getNbPendingCreditCosts(): int
  669.     {
  670.         return $this->getPendingCreditCosts()->count();
  671.     }
  673.     public function isPayAsYouGoThresholdReached(): bool
  674.     {
  675.         if (is_null($this->getPayAsYouGoCapping())) {
  676.             return false;
  677.         }
  678.         return $this->getNbPendingCreditCosts() + $this->getNbPendingLead() >= $this->getPayAsYouGoCapping();
  679.     }
  681.     public function setCreditCosts(Collection $creditCosts): void
  682.     {
  683.         $this->creditCosts = $creditCosts;
  684.     }
  686.     public function getPayAsYouGoCapping(): ?int
  687.     {
  688.         if (is_null($this->payAsYouGoCapping)) {
  689.             return self::PAYASYOUGO_CAPPING_DEFAULT;
  690.         }
  691.         return $this->payAsYouGoCapping;
  692.     }
  694.     public function setPayAsYouGoCapping(?int $payAsYouGoCapping): void
  695.     {
  696.         $this->payAsYouGoCapping = $payAsYouGoCapping;
  697.         $this->updateCustomerStatus();
  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.     }
  753. }