src/Entity/StockMovement.php line 14

Open in your IDE?
  1. <?php
  3. namespace App\Entity;
  5. use Doctrine\ORM\Mapping as ORM;
  7. /**
  8.  * Historique des mouvements de stock.
  9.  * Chaque enregistrement représente une modification (entrée, sortie, ajustement...).
  10.  *
  11.  * @ORM\Entity(repositoryClass="App\Repository\StockMovementRepository")
  12.  * @ORM\Table(name="stock_movement")
  13.  */
  14. class StockMovement
  15. {
  16.     /** 
  17.      * Identifiant unique du mouvement.
  18.      * Auto-incrémenté par la base.
  19.      * 
  20.      * @ORM\Id()
  21.      * @ORM\GeneratedValue()
  22.      * @ORM\Column(type="integer")
  23.      */
  24.     private int $id;
  26.     /** 
  27.      * Identifiant du produit concerné.
  28.      * Permet de regrouper les mouvements par produit.
  29.      * 
  30.      * @ORM\Column(type="integer", nullable=true)
  31.      */
  32.     private ?int $produit_id = null;
  34.     /** 
  35.      * Identifiant de la déclinaison du produit.
  36.      * Null si le mouvement concerne un produit sans déclinaison.
  37.      * 
  38.      * @ORM\Column(type="integer", nullable=true)
  39.      */
  40.     private ?int $declination_produit_id = null;
  42.     /** 
  43.      * Nom ou code de l'entrepôt concerné.
  44.      * Exemple : "Principal", "Nabeul", "Sous-sol".
  45.      * 
  46.      * @ORM\Column(type="string", length=255, nullable=true)
  47.      */
  48.     private ?string $storehouse = null;
  50.     /** 
  51.      * Date et heure du mouvement.
  52.      * 
  53.      * @ORM\Column(type="datetime")
  54.      */
  55.     private \DateTimeInterface $created_at;
  57.     /** 
  58.      * Type de source à l’origine du mouvement :
  59.      * - "manual" → modale manuelle
  60.      * - "commande" → commande client
  61.      * - "reception" → entrée fournisseur
  62.      * - "retour" → retour client
  63.      * - "inventaire" → ajustement inventaire
  64.      * - "correction" → correction administrative
  65.      * 
  66.      * @ORM\Column(type="string", length=50, nullable=true)
  67.      */
  68.     private ?string $source_type = null;
  70.     /** 
  71.      * Identifiant de la source du mouvement (facultatif).
  72.      * Ex : id du document (commande, réception, retour...).
  73.      * 
  74.      * @ORM\Column(type="integer", nullable=true)
  75.      */
  76.     private ?int $source_id = null;
  78.     /** 
  79.      * Variation du stock disponible (qté entrée/sortie).
  80.      * Exemples : +5 pour une entrée, -3 pour une sortie.
  81.      * 
  82.      * @ORM\Column(type="decimal", precision=18, scale=3)
  83.      */
  84.     private string $delta_available;
  86.     /** 
  87.      * Variation du stock réservé (commandes en attente).
  88.      * Exemples : +2 quand une commande réserve du stock, -2 quand elle est annulée.
  89.      * 
  90.      * @ORM\Column(type="decimal", precision=18, scale=3, options={"default":"0.000"})
  91.      */
  92.     private string $delta_reserved = '0.000';
  94.     /** 
  95.      * Stock disponible avant le mouvement.
  96.      * 
  97.      * @ORM\Column(type="decimal", precision=18, scale=3)
  98.      */
  99.     private string $qty_before_available;
  101.     /** 
  102.      * Stock disponible après le mouvement.
  103.      * 
  104.      * @ORM\Column(type="decimal", precision=18, scale=3)
  105.      */
  106.     private string $qty_after_available;
  108.     /** 
  109.      * Stock réservé avant le mouvement.
  110.      * 
  111.      * @ORM\Column(type="decimal", precision=18, scale=3)
  112.      */
  113.     private string $qty_before_reserved;
  115.     /** 
  116.      * Stock réservé après le mouvement.
  117.      * 
  118.      * @ORM\Column(type="decimal", precision=18, scale=3)
  119.      */
  120.     private string $qty_after_reserved;
  122.     /** 
  123.      * Motif du mouvement (sélectionné depuis la modale).
  124.      * Exemples : "ajustement", "perte", "retour_client", "transfert".
  125.      * 
  126.      * @ORM\Column(type="string", length=255, nullable=true)
  127.      */
  128.     private ?string $reason = null;
  130.     /** 
  131.      * Identifiant de l’utilisateur qui a effectué le mouvement.
  132.      * 
  133.      * @ORM\Column(type="integer", nullable=true)
  134.      */
  135.     private ?int $actor_id = null;
  137.     /** 
  138.      * Informations complémentaires stockées en JSON.
  139.      * Peut contenir :
  140.      *  - note ou commentaire
  141.      *  - référence produit / déclinaison
  142.      *  - IP ou origine UI
  143.      * 
  144.      * @ORM\Column(type="text", nullable=true)
  145.      */
  146.     private ?string $note = null;
  148.     
  150.     /* ========================== GETTERS / SETTERS ========================== */
  152.     public function getId(): ?int { return $this->id; }
  154.     public function getProduitId(): ?int { return $this->produit_id; }
  155.     public function setProduitId(?int $produit_id): self { $this->produit_id = $produit_id; return $this; }
  157.     public function getDeclinationProduitId(): ?int { return $this->declination_produit_id; }
  158.     public function setDeclinationProduitId(?int $declination_produit_id): self { $this->declination_produit_id = $declination_produit_id; return $this; }
  160.     public function getStorehouse(): ?string { return $this->storehouse; }
  161.     public function setStorehouse(?string $storehouse): self { $this->storehouse = $storehouse; return $this; }
  163.     public function getCreatedAt(): \DateTimeInterface { return $this->created_at; }
  164.     public function setCreatedAt(\DateTimeInterface $created_at): self { $this->created_at = $created_at; return $this; }
  166.     public function getSourceType(): ?string { return $this->source_type; }
  167.     public function setSourceType(?string $source_type): self { $this->source_type = $source_type; return $this; }
  169.     public function getSourceId(): ?int { return $this->source_id; }
  170.     public function setSourceId(?int $source_id): self { $this->source_id = $source_id; return $this; }
  172.     public function getDeltaAvailable(): string { return $this->delta_available; }
  173.     public function setDeltaAvailable(string $delta_available): self { $this->delta_available = $delta_available; return $this; }
  175.     public function getDeltaReserved(): string { return $this->delta_reserved; }
  176.     public function setDeltaReserved(string $delta_reserved): self { $this->delta_reserved = $delta_reserved; return $this; }
  178.     public function getQtyBeforeAvailable(): string { return $this->qty_before_available; }
  179.     public function setQtyBeforeAvailable(string $qty_before_available): self { $this->qty_before_available = $qty_before_available; return $this; }
  181.     public function getQtyAfterAvailable(): string { return $this->qty_after_available; }
  182.     public function setQtyAfterAvailable(string $qty_after_available): self { $this->qty_after_available = $qty_after_available; return $this; }
  184.     public function getQtyBeforeReserved(): string { return $this->qty_before_reserved; }
  185.     public function setQtyBeforeReserved(string $qty_before_reserved): self { $this->qty_before_reserved = $qty_before_reserved; return $this; }
  187.     public function getQtyAfterReserved(): string { return $this->qty_after_reserved; }
  188.     public function setQtyAfterReserved(string $qty_after_reserved): self { $this->qty_after_reserved = $qty_after_reserved; return $this; }
  190.     public function getReason(): ?string { return $this->reason; }
  191.     public function setReason(?string $reason): self { $this->reason = $reason; return $this; }
  193.     public function getActorId(): ?int { return $this->actor_id; }
  194.     public function setActorId(?int $actor_id): self { $this->actor_id = $actor_id; return $this; }
  196.     public function getNote(): ?string { return $this->note; }
  197.     public function setNote(?string $note): self { $this->note = $note; return $this; }
  198. }