src/Entity/Depense.php line 13

Open in your IDE?
  1. <?php
  3. namespace App\Entity;
  5. use Doctrine\Common\Collections\ArrayCollection;
  6. use Doctrine\Common\Collections\Collection;
  7. use App\Service\ComptaService;
  8. use Doctrine\ORM\Mapping as ORM;
  10. /**
  11.  * @ORM\Entity(repositoryClass="App\Repository\DepenseRepository")
  12.  */
  13. class Depense
  14. {
  15.     /*
  16.      * Par quel moyen la dépense est sortie (11/09/2026).
  17.      *
  18.      * Même convention que les paiements de vente
  19.      * (ComptaService::PAIEMENT_COMPTES) : on ne crée pas un second
  20.      * vocabulaire pour dire la même chose.
  21.      *
  22.      * C'est ce mode qui décide de DEUX choses : le compte de trésorerie
  23.      * qui se vide, et le compte du grand livre qui se crédite. Sans lui,
  24.      * une dépense du bureau payée par virement sortait de la caisse.
  25.      */
  26.     public const MODE_ESPECE       = 1;
  27.     public const MODE_BANQUE       = 2;
  28.     public const MODE_MOBILE_MONEY = 3;
  30.     /** @ORM\Column(type="integer", options={"default":1}, name="modepaiementdepense") */
  31.     private $modepaiementdepense = self::MODE_ESPECE;
  33.     /**
  34.      * @ORM\Id()
  35.      * @ORM\GeneratedValue()
  36.      * @ORM\Column(type="integer")
  37.      */
  38.     private $id;
  40.     /**
  41.      * @ORM\Column(type="string", length=200, nullable=true)
  42.      */
  43.     private $beneficiaire;
  45.     /**
  46.      * @ORM\Column(type="integer")
  47.      */
  48.     private $montantdepense = 0;
  50.     /**
  51.      * @ORM\Column(type="text")
  52.      */
  53.     private $descriptiondepense;
  55.     /**
  56.      * @ORM\Column(type="text")
  57.      */
  58.     private $journaldepense;
  60.     /**
  61.      * @ORM\Column(type="datetime", nullable=true)
  62.      */
  63.     private $datecreationdepense;
  65.     /**
  66.      * @ORM\Column(type="datetime", nullable=true)
  67.      */
  68.     private $datemodificationdepense;
  70.     /**
  71.      * @ORM\Column(type="datetime", nullable=true)
  72.      */
  73.     private $datedepense;
  75.     /**
  76.      * @ORM\Column(type="datetime", nullable=true)
  77.      */
  78.     private $datesuppressiondepense;
  80.     /**
  81.      * @ORM\ManyToOne(targetEntity="Magasin")
  82.      * @ORM\JoinColumn(name="magasinid", referencedColumnName="id", nullable=true)
  83.      */
  84.     private $magasinid;
  86.     /**
  87.      * @ORM\ManyToOne(targetEntity="User")
  88.      * @ORM\JoinColumn(name="ajoutepar", referencedColumnName="id", nullable=true)
  89.      */
  90.     private $ajoutepar;
  92.     /**
  93.      * @ORM\ManyToOne(targetEntity="User")
  94.      * @ORM\JoinColumn(name="supprimepar", referencedColumnName="id", nullable=true)
  95.      */
  96.     private $supprimepar;
  98.     /**
  99.      * @ORM\ManyToOne(targetEntity="User")
  100.      * @ORM\JoinColumn(name="modifiepar", referencedColumnName="id", nullable=true)
  101.      */
  102.     private $modifiepar;
  104.     /**
  105.      * @ORM\ManyToOne(targetEntity="Produit")
  106.      * @ORM\JoinColumn(name="produitid", referencedColumnName="id", nullable=true)
  107.      */
  108.     private $produitid;
  110.     /**
  111.      * @ORM\ManyToOne(targetEntity="DepenseCategorie", inversedBy="depenses")
  112.      * @ORM\JoinColumn(name="categorieid", referencedColumnName="id", nullable=true)
  113.      */
  114.     private $categorieid;
  116.     /**
  117.      * @ORM\ManyToOne(targetEntity="CashSession")
  118.      * @ORM\JoinColumn(name="cash_session_id", referencedColumnName="id", nullable=true, onDelete="SET NULL")
  119.      */
  120.     private $cashSession;
  122.     /**
  123.      * Relation vers la table de jointure DepenseVehicule.
  124.      * C'est DepenseVehicule.php qui déclare et possède la table depense_vehicule. 
  125.      *
  126.      * @ORM\OneToMany(
  127.      *     targetEntity="DepenseVehicule",
  128.      *     mappedBy="depense",
  129.      *     cascade={"persist", "remove"},
  130.      *     orphanRemoval=true
  131.      * )
  132.      */
  133.     private $depenseVehicules;
  135.     /**
  136.      * @ORM\OneToMany(targetEntity="DepenseFichier", mappedBy="depenseid", cascade={"persist","remove"})
  137.      */
  138.     private $fichiers;
  140.     /**
  141.      * @ORM\OneToMany(targetEntity="DepenseCommentaire", mappedBy="depenseid", cascade={"persist","remove"})
  142.      */
  143.     private $commentaires;
  145.     public function __construct()
  146.     {
  147.         $this->depenseVehicules = new ArrayCollection();
  148.         $this->fichiers         = new ArrayCollection();
  149.         $this->commentaires     = new ArrayCollection();
  150.     }
  152.     // ── Getters / Setters standards ───────────────────────────────────────────
  154.     public function getId(): ?int
  155.     {
  156.         return $this->id;
  157.     }
  159.     public function getBeneficiaire(): ?string
  160.     {
  161.         return $this->beneficiaire;
  162.     }
  164.     public function setBeneficiaire(?string $v): static
  165.     {
  166.         $this->beneficiaire = $v;
  167.         return $this;
  168.     }
  170.     public function getMontantdepense(): ?int
  171.     {
  172.         return $this->montantdepense;
  173.     }
  175.     public function setMontantdepense(int $v): static
  176.     {
  177.         $this->montantdepense = $v;
  178.         return $this;
  179.     }
  181.     public function getDescriptiondepense(): ?string
  182.     {
  183.         return $this->descriptiondepense;
  184.     }
  186.     public function setDescriptiondepense(string $v): static
  187.     {
  188.         $this->descriptiondepense = $v;
  189.         return $this;
  190.     }
  192.     public function getJournaldepense(): ?string
  193.     {
  194.         return $this->journaldepense;
  195.     }
  197.     public function setJournaldepense(string $v): static
  198.     {
  199.         $this->journaldepense = $v;
  200.         return $this;
  201.     }
  203.     public function getDatecreationdepense(): ?\DateTimeInterface
  204.     {
  205.         return $this->datecreationdepense;
  206.     }
  208.     public function setDatecreationdepense(?\DateTimeInterface $v): static
  209.     {
  210.         $this->datecreationdepense = $v;
  211.         return $this;
  212.     }
  214.     public function getDatedepense(): ?\DateTimeInterface
  215.     {
  216.         return $this->datedepense;
  217.     }
  219.     public function setDatedepense(?\DateTimeInterface $v): static
  220.     {
  221.         $this->datedepense = $v;
  222.         return $this;
  223.     }
  225.     public function getDatesuppressiondepense(): ?\DateTimeInterface
  226.     {
  227.         return $this->datesuppressiondepense;
  228.     }
  230.     public function setDatesuppressiondepense(?\DateTimeInterface $v): static
  231.     {
  232.         $this->datesuppressiondepense = $v;
  233.         return $this;
  234.     }
  236.     public function getDatemodificationdepense(): ?\DateTimeInterface
  237.     {
  238.         return $this->datemodificationdepense;
  239.     }
  241.     public function setDatemodificationdepense(?\DateTimeInterface $v): static
  242.     {
  243.         $this->datemodificationdepense = $v;
  244.         return $this;
  245.     }
  247.     /**
  248.      * Le type de compte de trésorerie que ce mode fait bouger.
  249.      *
  250.      * Vit ici, à côté des constantes, plutôt que dans le résolveur : c'est
  251.      * la dépense qui sait par quel moyen elle est partie, pas la caisse.
  252.      */
  253.     public static function typeCompteDuMode(int $mode): string
  254.     {
  255.         return match ($mode) {
  256.             self::MODE_BANQUE       => TreasuryAccount::TYPE_BANQUE,
  257.             self::MODE_MOBILE_MONEY => TreasuryAccount::TYPE_MOBILE_MONEY,
  258.             default                 => TreasuryAccount::TYPE_CAISSE,
  259.         };
  260.     }
  262.     /** Le compte OHADA de trésorerie correspondant — même table que les ventes. */
  263.     public static function compteTresoDuMode(int $mode): string
  264.     {
  265.         return ComptaService::PAIEMENT_COMPTES[$mode] ?? ComptaService::PAIEMENT_COMPTES[self::MODE_ESPECE];
  266.     }
  268.     public function getModepaiementdepense(): int
  269.     {
  270.         // L'historique n'avait pas de mode : l'espèce est ce que la
  271.         // comptabilité écrivait déjà en dur pour toutes les dépenses.
  272.         return (int) ($this->modepaiementdepense ?: self::MODE_ESPECE);
  273.     }
  275.     public function setModepaiementdepense(?int $v): static
  276.     {
  277.         $this->modepaiementdepense = in_array($v, [self::MODE_ESPECE, self::MODE_BANQUE, self::MODE_MOBILE_MONEY], true)
  278.             ? $v
  279.             : self::MODE_ESPECE;
  281.         return $this;
  282.     }
  284.     public function getMagasinid(): ?Magasin
  285.     {
  286.         return $this->magasinid;
  287.     }
  289.     public function setMagasinid(?Magasin $v): static
  290.     {
  291.         $this->magasinid = $v;
  292.         return $this;
  293.     }
  295.     public function getAjoutepar(): ?User
  296.     {
  297.         return $this->ajoutepar;
  298.     }
  300.     public function setAjoutepar(?User $v): static
  301.     {
  302.         $this->ajoutepar = $v;
  303.         return $this;
  304.     }
  306.     public function getSupprimepar(): ?User
  307.     {
  308.         return $this->supprimepar;
  309.     }
  311.     public function setSupprimepar(?User $v): static
  312.     {
  313.         $this->supprimepar = $v;
  314.         return $this;
  315.     }
  317.     public function getModifiepar(): ?User
  318.     {
  319.         return $this->modifiepar;
  320.     }
  322.     public function setModifiepar(?User $v): static
  323.     {
  324.         $this->modifiepar = $v;
  325.         return $this;
  326.     }
  328.     public function getProduitid(): ?Produit
  329.     {
  330.         return $this->produitid;
  331.     }
  333.     public function setProduitid(?Produit $v): static
  334.     {
  335.         $this->produitid = $v;
  336.         return $this;
  337.     }
  339.     public function getCategorieid(): ?DepenseCategorie
  340.     {
  341.         return $this->categorieid;
  342.     }
  344.     public function setCategorieid(?DepenseCategorie $v): static
  345.     {
  346.         $this->categorieid = $v;
  347.         return $this;
  348.     }
  350.     public function getCashSession(): ?CashSession
  351.     {
  352.         return $this->cashSession;
  353.     }
  355.     public function setCashSession(?CashSession $v): static
  356.     {
  357.         $this->cashSession = $v;
  358.         return $this;
  359.     }
  361.     // ── MULTI-VÉHICULES ───────────────────────────────────────────────────────
  363.     public function getDepenseVehicules(): Collection
  364.     {
  365.         return $this->depenseVehicules;
  366.     }
  368.     public function addDepenseVehicule(DepenseVehicule $dv): static
  369.     {
  370.         if (!$this->depenseVehicules->contains($dv)) {
  371.             $this->depenseVehicules->add($dv);
  372.             $dv->setDepense($this);
  373.         }
  374.         return $this;
  375.     }
  377.     public function removeDepenseVehicule(DepenseVehicule $dv): static
  378.     {
  379.         $this->depenseVehicules->removeElement($dv);
  380.         return $this;
  381.     }
  383.     /**
  384.      * Raccourci pour Twig : retourne les Vehicule directement.
  385.      * Usage : DEPENSE.vehicules
  386.      *
  387.      * @return Vehicule[]
  388.      */
  389.     public function getVehicules(): array
  390.     {
  391.         return array_values(array_filter(
  392.             $this->depenseVehicules
  393.                 ->map(fn(DepenseVehicule $dv) => $dv->getVehicule())
  394.                 ->toArray()
  395.         ));
  396.     }
  398.     /**
  399.      * Synchronise la liste des véhicules depuis le formulaire.
  400.      *
  401.      * @param Vehicule[] $nouveauxVehicules
  402.      * @param User|null  $user
  403.      */
  404.     public function syncVehicules(array $nouveauxVehicules, ?User $user = null): static
  405.     {
  406.         $idsActuels  = $this->depenseVehicules
  407.             ->map(fn(DepenseVehicule $dv) => $dv->getVehicule()?->getId())
  408.             ->toArray();
  410.         $idsNouveaux = array_map(fn(Vehicule $v) => $v->getId(), $nouveauxVehicules);
  412.         // Supprimer les liens absents de la nouvelle liste
  413.         foreach ($this->depenseVehicules->toArray() as $dv) {
  414.             if (!in_array($dv->getVehicule()?->getId(), $idsNouveaux, true)) {
  415.                 $this->depenseVehicules->removeElement($dv);
  416.             }
  417.         }
  419.         // Ajouter les nouveaux liens
  420.         foreach ($nouveauxVehicules as $vehicule) {
  421.             if (!in_array($vehicule->getId(), $idsActuels, true)) {
  422.                 $dv = new DepenseVehicule();
  423.                 $dv->setDepense($this);
  424.                 $dv->setVehicule($vehicule);
  425.                 $dv->setDatecreation(new \DateTime());
  426.                 $dv->setAjoutepar($user);
  427.                 $this->depenseVehicules->add($dv);
  428.             }
  429.         }
  431.         return $this;
  432.     }
  434.     public function hasVehicules(): bool
  435.     {
  436.         return !$this->depenseVehicules->isEmpty();
  437.     }
  439.     /**
  440.      * IDs des véhicules liés — pour pré-cocher les checkboxes.
  441.      *
  442.      * @return int[]
  443.      */
  444.     public function getVehiculesIds(): array
  445.     {
  446.         return array_values(array_filter(
  447.             $this->depenseVehicules
  448.                 ->map(fn(DepenseVehicule $dv) => $dv->getVehicule()?->getId())
  449.                 ->toArray()
  450.         ));
  451.     }
  453.     /**
  454.      * Résumé lisible : "AA-001 · BB-002"
  455.      */
  456.     public function getVehiculesLabel(): string
  457.     {
  458.         $labels = array_filter(
  459.             $this->depenseVehicules
  460.                 ->map(fn(DepenseVehicule $dv) => $dv->getVehicule()?->getImmatriculation())
  461.                 ->toArray()
  462.         );
  463.         return implode(' · ', $labels);
  464.     }
  466.     // ── Fichiers ──────────────────────────────────────────────────────────────
  468.     public function getFichiers(): Collection
  469.     {
  470.         return $this->fichiers;
  471.     }
  473.     public function getFichiersActifs(): Collection
  474.     {
  475.         return $this->fichiers->filter(
  476.             fn(DepenseFichier $f) => $f->getDatesuppression() === null
  477.         );
  478.     }
  480.     public function addFichier(DepenseFichier $f): static
  481.     {
  482.         if (!$this->fichiers->contains($f)) {
  483.             $this->fichiers->add($f);
  484.             $f->setDepenseid($this);
  485.         }
  486.         return $this;
  487.     }
  489.     public function removeFichier(DepenseFichier $f): static
  490.     {
  491.         $this->fichiers->removeElement($f);
  492.         return $this;
  493.     }
  495.     // ── Commentaires ──────────────────────────────────────────────────────────
  497.     public function getCommentaires(): Collection
  498.     {
  499.         return $this->commentaires;
  500.     }
  502.     public function getCommentairesActifs(): Collection
  503.     {
  504.         return $this->commentaires->filter(
  505.             fn(DepenseCommentaire $c) => $c->getDatesuppression() === null
  506.         );
  507.     }
  509.     public function addCommentaire(DepenseCommentaire $c): static
  510.     {
  511.         if (!$this->commentaires->contains($c)) {
  512.             $this->commentaires->add($c);
  513.             $c->setDepenseid($this);
  514.         }
  515.         return $this;
  516.     }
  518.     public function removeCommentaire(DepenseCommentaire $c): static
  519.     {
  520.         $this->commentaires->removeElement($c);
  521.         return $this;
  522.     }
  524.     /**
  525.      * Snapshot scalaire pour le journal d'actions.
  526.      */
  527.     public function toArray(): array
  528.     {
  529.         $fichiers     = [];
  530.         foreach ($this->getFichiersActifs() as $f) { $fichiers[] = $f->getId(); }
  531.         $commentaires = [];
  532.         foreach ($this->getCommentairesActifs() as $c) { $commentaires[] = $c->getId(); }
  534.         return [
  535.             'id'                       => $this->id,
  536.             'beneficiaire'             => $this->beneficiaire,
  537.             'montantdepense'           => $this->montantdepense,
  538.             'descriptiondepense'       => $this->descriptiondepense,
  539.             'magasinid'                => $this->magasinid    ? $this->magasinid->getId()    : null,
  540.             'modepaiementdepense'      => $this->getModepaiementdepense(),
  541.             'categorieid'              => $this->categorieid  ? $this->categorieid->getId()  : null,
  542.             'ajoutepar'                => $this->ajoutepar    ? $this->ajoutepar->getId()    : null,
  543.             'modifiepar'               => $this->modifiepar   ? $this->modifiepar->getId()   : null,
  544.             'supprimepar'              => $this->supprimepar  ? $this->supprimepar->getId()  : null,
  545.             'datedepense'              => $this->datedepense              ? $this->datedepense->format(\DateTimeInterface::ATOM)              : null,
  546.             'datecreationdepense'      => $this->datecreationdepense      ? $this->datecreationdepense->format(\DateTimeInterface::ATOM)      : null,
  547.             'datemodificationdepense'  => $this->datemodificationdepense  ? $this->datemodificationdepense->format(\DateTimeInterface::ATOM)  : null,
  548.             'datesuppressiondepense'   => $this->datesuppressiondepense   ? $this->datesuppressiondepense->format(\DateTimeInterface::ATOM)   : null,
  549.             'fichiers'                 => $fichiers,
  550.             'commentaires'             => $commentaires,
  551.             'vehicules_ids'            => $this->getVehiculesIds(),
  552.             'produitid'                => $this->produitid ? $this->produitid->getId() : null,
  553.             'cash_session_id'          => $this->cashSession ? $this->cashSession->getId() : null,
  554.         ];
  555.     }
  556. }