src/Entity/Freelancer.php line 27

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 Symfony\Component\Validator\Context\ExecutionContextInterface;
  18. use Vich\UploaderBundle\Mapping\Annotation as Vich;
  19. use Gedmo\Mapping\Annotation as Gedmo;
  21. /**
  22.  * @ORM\Entity(repositoryClass="App\Repository\FreelancerRepository")
  23.  * @ORM\EntityListeners({"App\Listener\FreelancerListener"})
  24.  * @Gedmo\Loggable(logEntryClass="App\Entity\LogEntry")
  25.  * @Vich\Uploadable
  26.  */
  27. class Freelancer extends Administrator implements CreditOwnerInterface
  28. {
  29.     use CreditOwnerTrait;
  31.     public const CREDIT_ALMOST_DOWN = 2;
  33.     private const PAYASYOUGO_CAPPING_DEFAULT = 5;
  35.     /**
  36.      * Fake deadline used to identify freelance who have their store indexable till they reach 0 credit
  37.      */
  38.     public const BUSINESS_MODEL_FAKE_DEADLINE = '2030-01-01 00:00:00';
  40.     /**
  41.      * Deadline relacing the 2 months previously used before passing businessModel from 'credit' to 'none'
  42.      */
  43.     public const BUSINESS_FORCED_DEADLINE = '2025-05-20 00:00:00';
  45.     /**
  46.      * @ORM\Column(type="string", length=25, nullable=true)
  47.      */
  48.     private $vatNumber;
  50.     /**
  51.      * @Assert\NotBlank()
  52.      * @Assert\Regex(pattern="/^\d{14}$/", message="Le numéro de SIRET n'est pas valide.")
  53.      * @ORM\Column(type="string", length=25)
  54.      */
  55.     private $siretNumber;
  57.     /**
  58.      * @Assert\Regex(pattern="/^(?:\+33|0)\s*[1-9](?:[\s.-]*\d{2}){4}$/", message="Le numéro de téléphone n'est pas valide.")
  59.      * @ORM\Column(type="string", length=255, nullable=true)
  60.      */
  61.     private $phoneNumberSmsNotification;
  63.     /**
  64.      * @ORM\Column(type="string", length=255, nullable=true)
  65.      */
  66.     private $emailNotification;
  68.     /**
  69.      * @var boolean
  70.      * @ORM\Column(type="boolean")
  71.      */
  72.     private $isSmsNotification;
  74.     /**
  75.      * @var boolean
  76.      * @ORM\Column(type="boolean")
  77.      */
  78.     private $isEmailNotification;
  80.     /**
  81.      * specify if this freelancer has already been an premium member (even if nbCredit is null)
  82.      * @var boolean
  83.      * @ORM\Column(type="boolean", options={"default" : false})
  84.      */
  85.     private $hasBeenPremium;
  87.     /**
  88.      * @ORM\Column(type="datetime", nullable=true)
  89.      */
  90.     private $soldOutAt;
  92.     /**
  93.      * specify if this freelancer is active and can receive prospect
  94.      * @var boolean
  95.      * @ORM\Column(type="boolean", options={"default" : true})
  96.      */
  97.     private $isEnabled = 1;
  99.     /**
  100.      * @ORM\OneToMany(targetEntity="App\Entity\Order", mappedBy="freelancer", cascade={"remove"})
  101.      */
  102.     private $orders;
  104.     /**
  105.      * @ORM\OneToMany(targetEntity=FreelancerAssistant::class, mappedBy="freelancer")
  106.      */
  107.     private $freelancerAssistants;
  109.     /**
  110.      * @ORM\Column(type="datetime", nullable=true)
  111.      */
  112.     private $updatedAt;
  114.     /**
  115.      * @ORM\Column(type="string", length=255, nullable=true)
  116.      */
  117.     private $picturePath;
  119.     /**
  120.      * @assert\File( mimeTypes = {"image/jpeg", "image/png", "image/gif", "image/jpg","image/webp"})
  121.      * @Vich\UploadableField(mapping="freelancer_images", fileNameProperty="picturePath")
  122.      * @var File
  123.      */
  124.     private $pictureFile;
  126.     /**
  127.      * @ORM\Column(type="string", length=255, nullable=true)
  128.      */
  129.     private $logoPath;
  131.     /**
  132.      * @assert\File( mimeTypes = {"image/jpeg", "image/png", "image/gif", "image/jpg","image/webp"})
  133.      * @Vich\UploadableField(mapping="freelancer_logo", fileNameProperty="logoPath")
  134.      * @var File
  135.      */
  136.     private $logoFile;
  138.     /**
  139.      * @ORM\Column(type="integer")
  140.      */
  141.     private $nbPendingLead;
  143.     /**
  144.      * @ORM\Column(type="integer", nullable=true)
  145.      */
  146.     private $nbCreditSms;
  148.     /**
  149.      * @ORM\OneToMany(targetEntity=FreelancerComment::class, mappedBy="freelancer", orphanRemoval=true)
  150.      */
  151.     private $comments;
  153.     /**
  154.      * @ORM\Column(type="integer", nullable=true)
  155.      */
  156.     private $businessSoftware;
  158.     /**
  159.      * @ORM\Column(type="integer", nullable=true)
  160.      * @Assert\Range(
  161.      *      min = 1,
  162.      *      max = 99,
  163.      *      notInRangeMessage = "Le nombre de contact doit être entre {{ min }} et {{ max }}",
  164.      * )
  165.      */
  166.     private ?int $payAsYouGoCapping = self::PAYASYOUGO_CAPPING_DEFAULT;
  168.     /**
  169.      * @ORM\OneToMany(targetEntity=CreditCost::class, mappedBy="administrator")
  170.      */
  171.     private Collection $creditCosts;
  173.     /**
  174.      * @ORM\Column(type="string", length=255, nullable=true)
  175.      */
  176.     private string $onboardingStatus = OnboardingStatusEnum::IN_PROGRESS;
  178.     /**
  179.      * @ORM\Column(type="integer", name="stat_nb_credit_purchased")
  180.      */
  181.     private int $nbCreditPurchased = 0;
  182.     /**
  183.      * @ORM\Column(type="integer", name="stat_nb_lead_delivered")
  184.      */
  185.     private int $nbLeadDelivered = 0;
  187.     /**
  188.      * @ORM\Column(type="integer", name="stat_nb_sales")
  189.      */
  190.     private int $nbSales = 0;
  192.     /**
  193.      * @ORM\Column(type="boolean", options={"default" : false})
  194.      */
  195.     private bool $schedulingAppointment = false;
  198.     public function __construct()
  199.     {
  200.         parent::__construct();
  201.         $this->isEmailNotification = true;
  202.         $this->isSmsNotification = true;
  203.         $this->hasBeenPremium = false;
  204.         $this->orders = new ArrayCollection();
  205.         $this->freelancerAssistants = new ArrayCollection();
  206.         $this->comments = new ArrayCollection();
  207.         $this->setBusinessModel(BusinessModelEnum::NONE);
  208.     }
  210.     public function setBusinessModel(int $businessModel): void
  211.     {
  212.         parent::setBusinessModel($businessModel);
  214.         $this->updateCustomerStatus();
  215.     }
  217.     /**
  218.      * when nbCredit or nbPendingLead is updated, we check if this freelancer is still a customer
  219.      * - freelance must be enabled
  220.      * AND
  221.      *      - freelance must have enough credit to receive leads
  222.      *      OR
  223.      *      - freelance must have opted-in for "pay as you go" credit && have less than 2 pending credit costs
  224.      */
  225.     public function updateCustomerStatus()
  226.     {
  227.         if ($this->isEnabled() && (($this->nbCredit - $this->nbPendingLead) > 0 || ($this->isPayAsYouGo() && !$this->isPayAsYouGoThresholdReached()))) {
  228.             $this->setIsCustomer(true);
  229.         } else {
  230.             $this->setIsCustomer(false);
  231.         }
  232.     }
  234.     /**
  235.      * @return bool
  236.      */
  237.     public function isEnabled(): bool
  238.     {
  239.         return $this->isEnabled;
  240.     }
  242.     public function isPayAsYouGoThresholdReached(): bool
  243.     {
  244.         if (is_null($this->getPayAsYouGoCapping())) {
  245.             return false;
  246.         }
  247.         return $this->getNbPendingCreditCosts() + $this->getNbPendingLead() >= $this->getPayAsYouGoCapping();
  248.     }
  250.     public function getPayAsYouGoCapping(): ?int
  251.     {
  252.         if (is_null($this->payAsYouGoCapping)) {
  253.             return self::PAYASYOUGO_CAPPING_DEFAULT;
  254.         }
  255.         return $this->payAsYouGoCapping;
  256.     }
  258.     public function setPayAsYouGoCapping(?int $payAsYouGoCapping): void
  259.     {
  260.         $this->payAsYouGoCapping = $payAsYouGoCapping;
  261.         $this->updateCustomerStatus();
  262.     }
  264.     public function getNbPendingCreditCosts(): int
  265.     {
  266.         return $this->getPendingCreditCosts()->count();
  267.     }
  269.     public function getPendingCreditCosts(): Collection
  270.     {
  271.         return $this->creditCosts->filter(function (CreditCost $creditCost) {
  272.             return $creditCost->isPending();
  273.         });
  274.     }
  276.     public function getNbPendingLead(): ?int
  277.     {
  278.         return $this->nbPendingLead;
  279.     }
  281.     public function setNbPendingLead(int $nbPendingLead): self
  282.     {
  283.         $this->nbPendingLead = $nbPendingLead;
  284.         $this->updateCustomerStatus();
  285.         return $this;
  286.     }
  288.     /**
  289.      * @Assert\Callback()
  290.      */
  291.     public function validate(ExecutionContextInterface $context, $payload)
  292.     {
  293.         //if freelancer has a businessModel, he must have a paiement method
  294.         if ($this->getBusinessModel() !== BusinessModelEnum::NONE) {
  295.             if (!$this->getUser() ||
  296.                 $this->getUser()->getPaymentMethods()->isEmpty()) {
  297.                 $context->buildViolation('Au moins un moyen de paiement doit être connu pour pouvoir choisir un modèle économique.')
  298.                     ->atPath('businessModel')
  299.                     ->addViolation();;
  300.             }
  301.         }
  302.     }
  304.     /**
  305.      * @return mixed
  306.      */
  307.     public function getUpdatedAt(): ?DateTimeInterface
  308.     {
  309.         return $this->updatedAt;
  310.     }
  312.     /**
  313.      * @param mixed $updatedAt
  314.      */
  315.     public function setUpdatedAt(?DateTimeInterface $updatedAt): self
  316.     {
  317.         $this->updatedAt = $updatedAt;
  319.         return $this;
  320.     }
  322.     public function getPicturePath(): ?string
  323.     {
  324.         return $this->picturePath;
  325.     }
  327.     public function setPicturePath(?string $picturePath)
  328.     {
  329.         $this->picturePath = $picturePath;
  331.         return $this;
  332.     }
  334.     public function hasPicture()
  335.     {
  336.         return !is_null($this->picturePath);
  337.     }
  339.     public function getPictureFile()
  340.     {
  341.         return $this->pictureFile;
  342.     }
  344.     public function setPictureFile(File $picturePath = null)
  345.     {
  346.         $this->pictureFile = $picturePath;
  348.         if ($picturePath) {
  349.             $this->updatedAt = new DateTime('now');
  350.         }
  351.     }
  353.     /**
  354.      * Représente l'entité par son nom et son type (admin ou freelance)
  355.      * @return string
  356.      */
  357.     public function getLabelWithType()
  358.     {
  359.         return $this->getName() . ' [Indépendant]';
  360.     }
  362.     public function getNameAndEmailUser()
  363.     {
  364.         if ($this->getUser() !== null) {
  365.             return strtoupper($this->getName()) . ' [' . $this->getUser()->getEmail() . ']';
  367.         } else {
  368.             return $this->getName();
  369.         }
  370.     }
  372.     public function getId(): ?int
  373.     {
  374.         return $this->id;
  375.     }
  377.     public function getVatNumber(): ?string
  378.     {
  379.         return $this->vatNumber;
  380.     }
  382.     public function setVatNumber(string $vatNumber): self
  383.     {
  384.         $this->vatNumber = $vatNumber;
  386.         return $this;
  387.     }
  389.     public function setNbCredit(int $nbCredit): self
  390.     {
  391.         $this->nbCredit = $nbCredit;
  392.         $this->updateCustomerStatus();
  393.         return $this;
  394.     }
  396.     public function getSiretNumber(): ?string
  397.     {
  398.         return $this->siretNumber;
  399.     }
  401.     public function setSiretNumber(string $siretNumber): self
  402.     {
  403.         $siretNumber = str_replace(' ', '', $siretNumber);
  404.         $this->siretNumber = $siretNumber;
  406.         return $this;
  407.     }
  410.     // Returns an array with every mail addresses for a store
  412.     public function mustBeNotifiedBySms(): ?bool
  413.     {
  414.         return $this->getIsSmsNotification() && $this->getPhoneNumberSmsNotification();
  415.     }
  417.     public function getIsSmsNotification(): ?bool
  418.     {
  419.         return $this->isSmsNotification;
  420.     }
  422.     public function setIsSmsNotification(bool $isSmsNotification): self
  423.     {
  424.         $this->isSmsNotification = $isSmsNotification;
  426.         return $this;
  427.     }
  429.     public function getPhoneNumberSmsNotification(): ?string
  430.     {
  431.         return $this->phoneNumberSmsNotification;
  432.     }
  434.     public function setPhoneNumberSmsNotification(?string $phoneNumberSmsNotification): self
  435.     {
  436.         $this->phoneNumberSmsNotification = $phoneNumberSmsNotification;
  438.         return $this;
  439.     }
  441.     /**
  442.      * @return string
  443.      * @deprecated use Formatter->phoneNumberInternationalFormat instead
  444.      */
  445.     public function getPhoneNumberSmsNotificationFormatted()
  446.     {
  447.         return wordwrap($this->getPhoneNumberSmsNotification(), 2, ' ', true);
  448.     }
  450.     public function mustBeNotifiedByEmail(): ?bool
  451.     {
  452.         return $this->getIsEmailNotification() && !empty($this->getEmailNotification());
  453.     }
  455.     public function getIsEmailNotification(): ?bool
  456.     {
  457.         return $this->isEmailNotification;
  458.     }
  460.     public function setIsEmailNotification(bool $isEmailNotification): self
  461.     {
  462.         $this->isEmailNotification = $isEmailNotification;
  464.         return $this;
  465.     }
  467.     public function getEmailNotification(): ?string
  468.     {
  469.         return $this->emailNotification;
  470.     }
  472.     public function setEmailNotification(?string $emailNotification): self
  473.     {
  474.         $this->emailNotification = $emailNotification;
  476.         return $this;
  477.     }
  479.     public function getEmailList(): array
  480.     {
  481.         // Optim: use constant for delimiter?
  482.         return explode(";", $this->getEmailNotification());
  483.     }
  485.     /**
  486.      * @return bool
  487.      */
  488.     public function isHasBeenPremium(): bool
  489.     {
  490.         return $this->hasBeenPremium;
  491.     }
  493.     public function getHasBeenPremium(): ?bool
  494.     {
  495.         return $this->hasBeenPremium;
  496.     }
  498.     /**
  499.      * @param bool $hasBeenPremium
  500.      */
  501.     public function setHasBeenPremium(bool $hasBeenPremium): void
  502.     {
  503.         $this->hasBeenPremium = $hasBeenPremium;
  504.     }
  506.     /**
  507.      * @return Collection|Order[]
  508.      */
  509.     public function getOrders(): Collection
  510.     {
  511.         return $this->orders;
  512.     }
  514.     public function addOrder(Order $order): self
  515.     {
  516.         if (!$this->orders->contains($order)) {
  517.             $this->orders[] = $order;
  518.             $order->setFreelancer($this);
  519.         }
  521.         return $this;
  522.     }
  524.     public function removeOrder(Order $order): self
  525.     {
  526.         if ($this->orders->contains($order)) {
  527.             $this->orders->removeElement($order);
  528.             // set the owning side to null (unless already changed)
  529.             if ($order->getFreelancer() === $this) {
  530.                 $order->setFreelancer(null);
  531.             }
  532.         }
  534.         return $this;
  535.     }
  537.     public function getIsEnabled(): ?bool
  538.     {
  539.         return $this->isEnabled;
  540.     }
  542.     /**
  543.      * @param bool $isEnabled
  544.      */
  545.     public function setIsEnabled(bool $isEnabled): void
  546.     {
  547.         $this->isEnabled = $isEnabled;
  548.         $this->updateCustomerStatus();
  549.     }
  551.     /**
  552.      * @return Collection|FreelancerAssistant[]
  553.      */
  554.     public function getFreelancerAssistants(): Collection
  555.     {
  556.         return $this->freelancerAssistants;
  557.     }
  559.     public function addFreelancerAssistant(FreelancerAssistant $freelancerAssistant): self
  560.     {
  561.         if (!$this->freelancerAssistants->contains($freelancerAssistant)) {
  562.             $this->freelancerAssistants[] = $freelancerAssistant;
  563.             $freelancerAssistant->setFreelancer($this);
  564.         }
  566.         return $this;
  567.     }
  569.     public function removeFreelancerAssistant(FreelancerAssistant $freelancerAssistant): self
  570.     {
  571.         if ($this->freelancerAssistants->contains($freelancerAssistant)) {
  572.             $this->freelancerAssistants->removeElement($freelancerAssistant);
  573.             // set the owning side to null (unless already changed)
  574.             if ($freelancerAssistant->getFreelancer() === $this) {
  575.                 $freelancerAssistant->setFreelancer(null);
  576.             }
  577.         }
  579.         return $this;
  580.     }
  582.     public function getSoldOutAt(): ?DateTimeInterface
  583.     {
  584.         return $this->soldOutAt;
  585.     }
  587.     public function setSoldOutAt(?DateTimeInterface $soldOutAt): self
  588.     {
  589.         $this->soldOutAt = $soldOutAt;
  591.         return $this;
  592.     }
  594.     public function getNbCreditSms(): ?int
  595.     {
  596.         return $this->nbCreditSms;
  597.     }
  599.     public function setNbCreditSms(?int $nbCreditSms): self
  600.     {
  601.         $this->nbCreditSms = $nbCreditSms;
  603.         return $this;
  604.     }
  606.     /**
  607.      * @return Collection|FreelancerComment[]
  608.      */
  609.     public function getComments(): Collection
  610.     {
  611.         return $this->comments;
  612.     }
  614.     public function addComment(FreelancerComment $comment): self
  615.     {
  616.         if (!$this->comments->contains($comment)) {
  617.             $this->comments[] = $comment;
  618.             $comment->setFreelancer($this);
  619.         }
  621.         return $this;
  622.     }
  624.     public function removeComment(FreelancerComment $comment): self
  625.     {
  626.         if ($this->comments->contains($comment)) {
  627.             $this->comments->removeElement($comment);
  628.             // set the owning side to null (unless already changed)
  629.             if ($comment->getFreelancer() === $this) {
  630.                 $comment->setFreelancer(null);
  631.             }
  632.         }
  634.         return $this;
  635.     }
  637.     public function getLastCommentExtract(): ?string
  638.     {
  639.         return !$this->comments->isEmpty() ? substr($this->comments->last()->getComment(), 0, 30) : null;
  640.     }
  642.     public function getLogoPath(): ?string
  643.     {
  644.         return $this->logoPath;
  645.     }
  647.     public function setLogoPath(?string $logoPath): self
  648.     {
  649.         $this->logoPath = $logoPath;
  650.         return $this;
  651.     }
  653.     public function getBusinessSoftwareName(): string
  654.     {
  655.         if (is_null($this->getBusinessSoftware())) {
  656.             return 'Aucune';
  657.         }
  658.         return FreelancerBusinessSoftwareEnum::getItemName($this->getBusinessSoftware());
  659.     }
  661.     public function getBusinessSoftware(): ?int
  662.     {
  663.         return $this->businessSoftware;
  664.     }
  666.     public function setBusinessSoftware(?int $businessSoftware): self
  667.     {
  668.         $this->businessSoftware = $businessSoftware;
  669.         return $this;
  670.     }
  672.     public function getLogoFile()
  673.     {
  674.         return $this->logoFile;
  675.     }
  677.     public function setLogoFile(File $logoPath = null)
  678.     {
  679.         $this->logoFile = $logoPath;
  681.         if ($logoPath) {
  682.             $this->updatedAt = new DateTime('now');
  683.         }
  684.     }
  686.     public function hasAllStoresIndexableTemporary(): bool
  687.     {
  688.         //if a deadline is set, stores remain indexable
  689.         return !is_null($this->businessModelDeadline);// && $this->businessModelDeadline->format('Y-m-d H:i:s') == self::BUSINESS_MODEL_FAKE_DEADLINE;
  690.     }
  692.     public function markAsAllStoresIndexableTemporary(): void
  693.     {
  694.         $this->setBusinessModelDeadline(new DateTime(self::BUSINESS_MODEL_FAKE_DEADLINE));
  695.     }
  697.     public function getCreditCosts(): Collection
  698.     {
  699.         return $this->creditCosts;
  700.     }
  702.     public function setCreditCosts(Collection $creditCosts): void
  703.     {
  704.         $this->creditCosts = $creditCosts;
  705.     }
  707.     public function addCreditCost(CreditCost $creditCost): self
  708.     {
  709.         if (!$this->creditCosts->contains($creditCost)) {
  710.             $this->creditCosts->add($creditCost);
  711.             $creditCost->setAdministrator($this);
  712.         }
  714.         return $this;
  715.     }
  717.     public function getOnboardingStatus(): string
  718.     {
  719.         return $this->onboardingStatus;
  720.     }
  722.     public function setOnboardingStatus(string $onboardingStatus): void
  723.     {
  724.         $this->onboardingStatus = $onboardingStatus;
  725.     }
  727.     public function getNbCreditPurchased(): int
  728.     {
  729.         return $this->nbCreditPurchased;
  730.     }
  732.     public function setNbCreditPurchased(int $nbCreditPurchased): void
  733.     {
  734.         $this->nbCreditPurchased = $nbCreditPurchased;
  735.     }
  737.     public function getNbLeadDelivered(): int
  738.     {
  739.         return $this->nbLeadDelivered;
  740.     }
  742.     public function setNbLeadDelivered(int $nbLeadDelivered): void
  743.     {
  744.         $this->nbLeadDelivered = $nbLeadDelivered;
  745.     }
  747.     public function getNbSales(): int
  748.     {
  749.         return $this->nbSales;
  750.     }
  752.     public function setNbSales(int $nbSales): void
  753.     {
  754.         $this->nbSales = $nbSales;
  755.     }
  757.     /**
  758.      */
  759.     public function hasAtLeastOneIndexableStore(): bool
  760.     {
  761.         return $this->getStores()->exists(function ($key, $store) {
  762.             return $store->hasCurrentStoreIndexation();
  763.         });
  764.     }
  766.     public function getAgeCapping(): ?int
  767.     {
  768.         return 50;
  769.     }
  771.     public function isSchedulingAppointment(): bool
  772.     {
  773.         return $this->schedulingAppointment;
  774.     }
  776.     public function setSchedulingAppointment(bool $schedulingAppointment): void
  777.     {
  778.         $this->schedulingAppointment = $schedulingAppointment;
  779.     }
  780. }