220 lines
8.3 KiB
PHP
220 lines
8.3 KiB
PHP
<?php
|
|
|
|
declare(strict_types=1);
|
|
|
|
namespace App\Module\Transport\Domain\Entity;
|
|
|
|
use ApiPlatform\Metadata\ApiResource;
|
|
use ApiPlatform\Metadata\Delete;
|
|
use ApiPlatform\Metadata\Get;
|
|
use ApiPlatform\Metadata\Link;
|
|
use ApiPlatform\Metadata\Patch;
|
|
use ApiPlatform\Metadata\Post;
|
|
use App\Module\Transport\Infrastructure\ApiPlatform\State\Processor\CarrierAddressProcessor;
|
|
use App\Shared\Domain\Attribute\Auditable;
|
|
use App\Shared\Domain\Contract\BlamableInterface;
|
|
use App\Shared\Domain\Contract\TimestampableInterface;
|
|
use App\Shared\Domain\Trait\TimestampableBlamableTrait;
|
|
use App\Shared\Domain\Validation\TextInputPattern;
|
|
use Doctrine\ORM\Mapping as ORM;
|
|
use Symfony\Component\Serializer\Attribute\Groups;
|
|
use Symfony\Component\Validator\Constraints as Assert;
|
|
|
|
/**
|
|
* Adresse d'un transporteur (1:1, OneToOne — decision metier ERP-172) — onglet
|
|
* Adresse (M4). Jumelle de SupplierAddress (M2), version simplifiee (pas de type
|
|
* d'adresse, pas de M2M sites/categories sur l'adresse : les sites du M4 vivent
|
|
* dans l'onglet Prix), et UNIQUE par transporteur (la jumelle M2 est 1:n).
|
|
*
|
|
* Lecture : proprietes en `carrier:item:read` (embarquees au detail du
|
|
* transporteur). Ecriture : groupe `carrier:write:addresses`.
|
|
*
|
|
* Sous-ressource API (ERP-159, spec § 4.5) — jumelle de SupplierAddress (M2) /
|
|
* ProviderAddress (M3), sans address_type ni M2M (les sites du M4 vivent dans
|
|
* l'onglet Prix) :
|
|
* - POST /api/carriers/{carrierId}/address : creation rattachee au
|
|
* transporteur parent (Link toProperty 'carrier'), security
|
|
* transport.carriers.manage. 409 si le transporteur a deja une adresse
|
|
* (CarrierAddressProcessor::guardSingleAddress, avant la contrainte d'unicite).
|
|
* - PATCH / DELETE /api/carrier_addresses/{id} : security
|
|
* transport.carriers.manage.
|
|
* - GET /api/carrier_addresses/{id} : lecture unitaire (security view) — la
|
|
* lecture courante reste via le parent. Pas de GET collection autonome.
|
|
* Tout passe par le CarrierAddressProcessor (rattachement parent + RG-4.05).
|
|
*
|
|
* Regles de l'onglet Adresse :
|
|
* - RG-4.06 : code postal a 4 ou 5 chiffres (Assert\Regex ; pas de controle
|
|
* CP/ville serveur, l'autocomplete BAN est front).
|
|
* - RG-4.05 : si le transporteur est affrete (isChartered), l'adresse devient
|
|
* obligatoire (Pays / CP / Ville / Adresse) — validation conditionnelle portee
|
|
* par le CarrierAddressProcessor (le parent n'est pas disponible a la
|
|
* validation Symfony sur un POST sous-ressource en read:false).
|
|
* - RG-4.07 : masquage du bouton « Valider » si QUALIMAT = front ; le back
|
|
* accepte le PATCH normalement (aucune garde back specifique).
|
|
*
|
|
* Audite (#[Auditable]) + Timestampable / Blamable.
|
|
*/
|
|
#[ApiResource(
|
|
operations: [
|
|
new Get(
|
|
security: "is_granted('transport.carriers.view')",
|
|
normalizationContext: ['groups' => ['carrier:item:read', 'default:read']],
|
|
),
|
|
new Post(
|
|
uriTemplate: '/carriers/{carrierId}/address',
|
|
uriVariables: [
|
|
'carrierId' => new Link(fromClass: Carrier::class, toProperty: 'carrier'),
|
|
],
|
|
// read:false : pas de stade lecture du parent. Le parent est rattache
|
|
// manuellement par CarrierAddressProcessor::linkParent (404 si absent),
|
|
// qui refuse aussi une 2e adresse (RG metier : adresse UNIQUE — 409).
|
|
read: false,
|
|
security: "is_granted('transport.carriers.manage')",
|
|
normalizationContext: ['groups' => ['carrier:item:read', 'default:read']],
|
|
denormalizationContext: ['groups' => ['carrier:write:addresses']],
|
|
processor: CarrierAddressProcessor::class,
|
|
),
|
|
new Patch(
|
|
security: "is_granted('transport.carriers.manage')",
|
|
normalizationContext: ['groups' => ['carrier:item:read', 'default:read']],
|
|
denormalizationContext: ['groups' => ['carrier:write:addresses']],
|
|
processor: CarrierAddressProcessor::class,
|
|
),
|
|
new Delete(
|
|
security: "is_granted('transport.carriers.manage')",
|
|
processor: CarrierAddressProcessor::class,
|
|
),
|
|
],
|
|
)]
|
|
#[ORM\Entity]
|
|
#[ORM\Table(name: 'carrier_address')]
|
|
// Adresse UNIQUE par transporteur (OneToOne owning side) : contrainte d'unicite
|
|
// sur carrier_id (decision metier ERP-172).
|
|
#[ORM\UniqueConstraint(name: 'uniq_carrier_address_carrier', columns: ['carrier_id'])]
|
|
#[ORM\Index(name: 'idx_carrier_address_created_by', columns: ['created_by'])]
|
|
#[ORM\Index(name: 'idx_carrier_address_updated_by', columns: ['updated_by'])]
|
|
#[Auditable]
|
|
class CarrierAddress implements TimestampableInterface, BlamableInterface
|
|
{
|
|
use TimestampableBlamableTrait;
|
|
|
|
#[ORM\Id]
|
|
#[ORM\GeneratedValue]
|
|
#[ORM\Column]
|
|
#[Groups(['carrier:item:read'])]
|
|
private ?int $id = null;
|
|
|
|
#[ORM\OneToOne(targetEntity: Carrier::class, inversedBy: 'address')]
|
|
#[ORM\JoinColumn(name: 'carrier_id', referencedColumnName: 'id', nullable: false, onDelete: 'CASCADE')]
|
|
private ?Carrier $carrier = null;
|
|
|
|
#[ORM\Column(length: 80, options: ['default' => 'France'])]
|
|
#[Assert\Length(max: 80, maxMessage: 'Le pays ne peut dépasser {{ limit }} caractères.', normalizer: 'trim')]
|
|
#[Groups(['carrier:item:read', 'carrier:write:addresses'])]
|
|
private string $country = 'France';
|
|
|
|
// RG-4.06 : code postal a 4 ou 5 chiffres (pas de controle CP/ville serveur,
|
|
// l'autocomplete BAN est front). Le Regex borne deja la longueur (<= 5) : pas
|
|
// de Length redondant (whitelist EXCLUDED_LENGTH_MIRROR). Nullable : obligatoire
|
|
// seulement si affrete (RG-4.05, garde CarrierAddressProcessor).
|
|
#[ORM\Column(name: 'postal_code', length: 20, nullable: true)]
|
|
#[Assert\Regex(pattern: '/^[0-9]{4,5}$/', message: 'Le code postal doit comporter 4 ou 5 chiffres.')]
|
|
#[Groups(['carrier:item:read', 'carrier:write:addresses'])]
|
|
private ?string $postalCode = null;
|
|
|
|
#[ORM\Column(length: 120, nullable: true)]
|
|
#[Assert\Length(max: 120, maxMessage: 'La ville ne peut dépasser {{ limit }} caractères.', normalizer: 'trim')]
|
|
#[Assert\Regex(pattern: TextInputPattern::ADDRESS, message: TextInputPattern::ADDRESS_MESSAGE)]
|
|
#[Groups(['carrier:item:read', 'carrier:write:addresses'])]
|
|
private ?string $city = null;
|
|
|
|
#[ORM\Column(length: 255, nullable: true)]
|
|
#[Assert\Length(max: 255, maxMessage: 'L\'adresse ne peut dépasser {{ limit }} caractères.', normalizer: 'trim')]
|
|
#[Assert\Regex(pattern: TextInputPattern::ADDRESS, message: TextInputPattern::ADDRESS_MESSAGE)]
|
|
#[Groups(['carrier:item:read', 'carrier:write:addresses'])]
|
|
private ?string $street = null;
|
|
|
|
#[ORM\Column(name: 'street_complement', length: 255, nullable: true)]
|
|
#[Assert\Length(max: 255, maxMessage: 'Le complément d\'adresse ne peut dépasser {{ limit }} caractères.', normalizer: 'trim')]
|
|
#[Assert\Regex(pattern: TextInputPattern::ADDRESS, message: TextInputPattern::ADDRESS_MESSAGE)]
|
|
#[Groups(['carrier:item:read', 'carrier:write:addresses'])]
|
|
private ?string $streetComplement = null;
|
|
|
|
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 getCountry(): string
|
|
{
|
|
return $this->country;
|
|
}
|
|
|
|
public function setCountry(string $country): static
|
|
{
|
|
$this->country = $country;
|
|
|
|
return $this;
|
|
}
|
|
|
|
public function getPostalCode(): ?string
|
|
{
|
|
return $this->postalCode;
|
|
}
|
|
|
|
public function setPostalCode(?string $postalCode): static
|
|
{
|
|
$this->postalCode = $postalCode;
|
|
|
|
return $this;
|
|
}
|
|
|
|
public function getCity(): ?string
|
|
{
|
|
return $this->city;
|
|
}
|
|
|
|
public function setCity(?string $city): static
|
|
{
|
|
$this->city = $city;
|
|
|
|
return $this;
|
|
}
|
|
|
|
public function getStreet(): ?string
|
|
{
|
|
return $this->street;
|
|
}
|
|
|
|
public function setStreet(?string $street): static
|
|
{
|
|
$this->street = $street;
|
|
|
|
return $this;
|
|
}
|
|
|
|
public function getStreetComplement(): ?string
|
|
{
|
|
return $this->streetComplement;
|
|
}
|
|
|
|
public function setStreetComplement(?string $streetComplement): static
|
|
{
|
|
$this->streetComplement = $streetComplement;
|
|
|
|
return $this;
|
|
}
|
|
}
|