Starseed/src/Module/Transport/Domain/Entity/CarrierPrice.php

<?php

declare(strict_types=1);

namespace App\Module\Transport\Domain\Entity;

use App\Shared\Domain\Attribute\Auditable;
use App\Shared\Domain\Contract\BlamableInterface;
use App\Shared\Domain\Contract\ClientAddressInterface;
use App\Shared\Domain\Contract\ClientInterface;
use App\Shared\Domain\Contract\SiteInterface;
use App\Shared\Domain\Contract\SupplierAddressInterface;
use App\Shared\Domain\Contract\SupplierInterface;
use App\Shared\Domain\Contract\TimestampableInterface;
use App\Shared\Domain\Trait\TimestampableBlamableTrait;
use Doctrine\ORM\Mapping as ORM;
use Symfony\Component\Serializer\Attribute\Groups;

/**
 * Prix d'un transporteur (1:n) — onglet Prix (M4, RG-4.09→4.11). Une ligne porte
 * soit une branche CLIENT (client + adresse de livraison + site de depart), soit
 * une branche FOURNISSEUR (supplier + adresse d'appro + site de livraison),
 * selon `direction`. La coherence des branches est garantie en BDD par les CHECK
 * chk_carrier_price_client_branch / chk_carrier_price_supplier_branch.
 *
 * Relations cross-module (Client/Supplier/adresses M1-M2, Site Sites) referencees
 * via des contrats Shared (ClientInterface, SupplierInterface, ...) + resolve_target_entities
 * — JAMAIS d'import direct d'une entite d'un autre module (regle ABSOLUE n°1).
 * L'embed JSON au detail passe par les read-groups des entites concretes
 * (client:read / client_address:read / supplier:read / supplier_address:read /
 * site:read), inclus dans le contexte du Get racine de Carrier (§ 4.0).
 *
 * WT3 (ERP-155/157) = LECTURE seule : proprietes en `carrier:item:read`. Les
 * sous-ressources d'ecriture + validation des branches (Processor) : WT8.
 */
#[ORM\Entity]
#[ORM\Table(name: 'carrier_price')]
#[ORM\Index(name: 'idx_carrier_price_carrier', columns: ['carrier_id'])]
#[ORM\Index(name: 'idx_carrier_price_client', columns: ['client_id'])]
#[ORM\Index(name: 'idx_carrier_price_client_address', columns: ['client_delivery_address_id'])]
#[ORM\Index(name: 'idx_carrier_price_departure_site', columns: ['departure_site_id'])]
#[ORM\Index(name: 'idx_carrier_price_supplier', columns: ['supplier_id'])]
#[ORM\Index(name: 'idx_carrier_price_supplier_address', columns: ['supplier_supply_address_id'])]
#[ORM\Index(name: 'idx_carrier_price_delivery_site', columns: ['delivery_site_id'])]
#[ORM\Index(name: 'idx_carrier_price_created_by', columns: ['created_by'])]
#[ORM\Index(name: 'idx_carrier_price_updated_by', columns: ['updated_by'])]
#[Auditable]
class CarrierPrice implements TimestampableInterface, BlamableInterface
{
    use TimestampableBlamableTrait;

    #[ORM\Id]
    #[ORM\GeneratedValue]
    #[ORM\Column]
    #[Groups(['carrier:item:read'])]
    private ?int $id = null;

    #[ORM\ManyToOne(targetEntity: Carrier::class, inversedBy: 'prices')]
    #[ORM\JoinColumn(name: 'carrier_id', referencedColumnName: 'id', nullable: false, onDelete: 'CASCADE')]
    private ?Carrier $carrier = null;

    /** CLIENT|FOURNISSEUR (RG-4.09) — pilote la branche active. */
    #[ORM\Column(length: 12)]
    #[Groups(['carrier:item:read'])]
    private ?string $direction = null;

    // === Branche CLIENT (RG-4.10) ===
    #[ORM\ManyToOne(targetEntity: ClientInterface::class)]
    #[ORM\JoinColumn(name: 'client_id', referencedColumnName: 'id', nullable: true, onDelete: 'RESTRICT')]
    #[Groups(['carrier:item:read'])]
    private ?ClientInterface $client = null;

    #[ORM\ManyToOne(targetEntity: ClientAddressInterface::class)]
    #[ORM\JoinColumn(name: 'client_delivery_address_id', referencedColumnName: 'id', nullable: true, onDelete: 'RESTRICT')]
    #[Groups(['carrier:item:read'])]
    private ?ClientAddressInterface $clientDeliveryAddress = null;

    /** Adresse de depart = un des 3 sites (86/17/82). */
    #[ORM\ManyToOne(targetEntity: SiteInterface::class)]
    #[ORM\JoinColumn(name: 'departure_site_id', referencedColumnName: 'id', nullable: true, onDelete: 'RESTRICT')]
    #[Groups(['carrier:item:read'])]
    private ?SiteInterface $departureSite = null;

    // === Branche FOURNISSEUR (RG-4.11) ===
    #[ORM\ManyToOne(targetEntity: SupplierInterface::class)]
    #[ORM\JoinColumn(name: 'supplier_id', referencedColumnName: 'id', nullable: true, onDelete: 'RESTRICT')]
    #[Groups(['carrier:item:read'])]
    private ?SupplierInterface $supplier = null;

    #[ORM\ManyToOne(targetEntity: SupplierAddressInterface::class)]
    #[ORM\JoinColumn(name: 'supplier_supply_address_id', referencedColumnName: 'id', nullable: true, onDelete: 'RESTRICT')]
    #[Groups(['carrier:item:read'])]
    private ?SupplierAddressInterface $supplierSupplyAddress = null;

    /** Adresse de livraison = un des 3 sites (86/17/82). */
    #[ORM\ManyToOne(targetEntity: SiteInterface::class)]
    #[ORM\JoinColumn(name: 'delivery_site_id', referencedColumnName: 'id', nullable: true, onDelete: 'RESTRICT')]
    #[Groups(['carrier:item:read'])]
    private ?SiteInterface $deliverySite = null;

    // === Commun ===
    /** BENNE|FOND_MOUVANT. */
    #[ORM\Column(name: 'container_type', length: 12)]
    #[Groups(['carrier:item:read'])]
    private ?string $containerType = null;

    /** FORFAIT|TONNE. */
    #[ORM\Column(name: 'pricing_unit', length: 8)]
    #[Groups(['carrier:item:read'])]
    private ?string $pricingUnit = null;

    #[ORM\Column(type: 'decimal', precision: 12, scale: 2)]
    #[Groups(['carrier:item:read'])]
    private ?string $price = null;

    /** EN_COURS|VALIDE|NON_VALIDE. */
    #[ORM\Column(name: 'price_state', length: 12)]
    #[Groups(['carrier:item:read'])]
    private ?string $priceState = null;

    #[ORM\Column(options: ['default' => 0])]
    private int $position = 0;

    public function getId(): ?int
    {
        return $this->id;
    }

    public function getCarrier(): ?Carrier
    {
        return $this->carrier;
    }

    public function setCarrier(?Carrier $carrier): static
    {
        $this->carrier = $carrier;

        return $this;
    }

    public function getDirection(): ?string
    {
        return $this->direction;
    }

    public function setDirection(?string $direction): static
    {
        $this->direction = $direction;

        return $this;
    }

    public function getClient(): ?ClientInterface
    {
        return $this->client;
    }

    public function setClient(?ClientInterface $client): static
    {
        $this->client = $client;

        return $this;
    }

    public function getClientDeliveryAddress(): ?ClientAddressInterface
    {
        return $this->clientDeliveryAddress;
    }

    public function setClientDeliveryAddress(?ClientAddressInterface $clientDeliveryAddress): static
    {
        $this->clientDeliveryAddress = $clientDeliveryAddress;

        return $this;
    }

    public function getDepartureSite(): ?SiteInterface
    {
        return $this->departureSite;
    }

    public function setDepartureSite(?SiteInterface $departureSite): static
    {
        $this->departureSite = $departureSite;

        return $this;
    }

    public function getSupplier(): ?SupplierInterface
    {
        return $this->supplier;
    }

    public function setSupplier(?SupplierInterface $supplier): static
    {
        $this->supplier = $supplier;

        return $this;
    }

    public function getSupplierSupplyAddress(): ?SupplierAddressInterface
    {
        return $this->supplierSupplyAddress;
    }

    public function setSupplierSupplyAddress(?SupplierAddressInterface $supplierSupplyAddress): static
    {
        $this->supplierSupplyAddress = $supplierSupplyAddress;

        return $this;
    }

    public function getDeliverySite(): ?SiteInterface
    {
        return $this->deliverySite;
    }

    public function setDeliverySite(?SiteInterface $deliverySite): static
    {
        $this->deliverySite = $deliverySite;

        return $this;
    }

    public function getContainerType(): ?string
    {
        return $this->containerType;
    }

    public function setContainerType(?string $containerType): static
    {
        $this->containerType = $containerType;

        return $this;
    }

    public function getPricingUnit(): ?string
    {
        return $this->pricingUnit;
    }

    public function setPricingUnit(?string $pricingUnit): static
    {
        $this->pricingUnit = $pricingUnit;

        return $this;
    }

    public function getPrice(): ?string
    {
        return $this->price;
    }

    public function setPrice(?string $price): static
    {
        $this->price = $price;

        return $this;
    }

    public function getPriceState(): ?string
    {
        return $this->priceState;
    }

    public function setPriceState(?string $priceState): static
    {
        $this->priceState = $priceState;

        return $this;
    }

    public function getPosition(): int
    {
        return $this->position;
    }

    public function setPosition(int $position): static
    {
        $this->position = $position;

        return $this;
    }
}