2026-10-01 10:50:32 +02:00
|
|
|
<?php
|
|
|
|
|
|
|
|
|
|
declare(strict_types=1);
|
|
|
|
|
|
2026-11-14 20:26:22 +01:00
|
|
|
use App\Attributes\Locked;
|
2026-11-14 22:00:11 +01:00
|
|
|
use App\Contracts\HandlesFailure;
|
2026-11-14 20:26:22 +01:00
|
|
|
use App\Contracts\HandlesLockTimeout;
|
2026-11-14 22:00:11 +01:00
|
|
|
use App\Contracts\HandlesSuccess;
|
2026-11-14 20:26:22 +01:00
|
|
|
use App\Contracts\ProvidesLockKey;
|
2026-11-10 14:28:00 +01:00
|
|
|
use App\Cqs\Actions\Orders\FinalizeOrder;
|
|
|
|
|
use App\Cqs\Actions\Orders\FinalizeOrderInput;
|
2026-11-14 18:40:25 +01:00
|
|
|
use App\Cqs\Actions\Orders\FinalizeOrderOutput;
|
|
|
|
|
use App\Enums\FinalizeOrderStatus;
|
2026-10-01 10:50:32 +02:00
|
|
|
use Domain\Builders\OrderBuilderCompleted;
|
|
|
|
|
use Domain\Enums\OrderStatus;
|
2026-11-14 18:40:25 +01:00
|
|
|
use Domain\Exceptions\OrderTunnel\ExpiredPickupTimeSlotException;
|
|
|
|
|
use Domain\Exceptions\OrderTunnel\OrderLimitExceededException;
|
2026-11-14 22:00:11 +01:00
|
|
|
use Domain\Exceptions\OrderTunnel\RegateExportFailedException;
|
2026-11-14 18:40:25 +01:00
|
|
|
use Domain\Exceptions\OrderTunnel\UnorderableProductException;
|
|
|
|
|
use Domain\Exceptions\OrderTunnel\WeeklyLimitExceededException;
|
2026-10-01 10:50:32 +02:00
|
|
|
use Domain\Models\Entities\Order;
|
|
|
|
|
use Domain\Models\ValueObjects\DeliveryAddress;
|
|
|
|
|
use Domain\Models\ValueObjects\Entities\OrderId;
|
|
|
|
|
use Domain\Models\ValueObjects\Entities\ShopId;
|
2026-11-14 20:26:22 +01:00
|
|
|
use Domain\Models\ValueObjects\Entities\ShopperId;
|
2026-10-01 10:50:32 +02:00
|
|
|
use Domain\Models\ValueObjects\Matricule;
|
|
|
|
|
use Domain\Models\ValueObjects\OrderEmployee;
|
|
|
|
|
use Domain\Models\ValueObjects\OrderReference;
|
|
|
|
|
use Domain\Models\ValueObjects\PickupTimeSlot;
|
2026-10-02 12:14:48 +02:00
|
|
|
use Domain\Models\ValueObjects\ShopperEstablishmentCode;
|
|
|
|
|
use Domain\Models\ValueObjects\ShopperServiceCode;
|
|
|
|
|
use Domain\Models\ValueObjects\ShopperSiteCode;
|
2026-10-01 10:50:32 +02:00
|
|
|
use Domain\Services\OrderTunnelService;
|
|
|
|
|
use Money\Money;
|
|
|
|
|
use Ramsey\Uuid\Uuid;
|
|
|
|
|
|
|
|
|
|
describe('FinalizeOrder', function (): void {
|
|
|
|
|
it('finalizes order and returns reference via OrderTunnelService', function (): void {
|
|
|
|
|
// GIVEN
|
|
|
|
|
$input = new FinalizeOrderInput();
|
|
|
|
|
|
2026-10-03 10:51:42 +02:00
|
|
|
$orderReference = new OrderReference(Uuid::uuid7());
|
2026-10-01 10:50:32 +02:00
|
|
|
$builder = \Mockery::mock(OrderBuilderCompleted::class);
|
|
|
|
|
$order = new Order(
|
|
|
|
|
id: new OrderId(Uuid::uuid7()),
|
|
|
|
|
shopId: new ShopId(Uuid::uuid7()),
|
|
|
|
|
reference: $orderReference,
|
|
|
|
|
employee: new OrderEmployee(
|
2026-10-02 12:14:48 +02:00
|
|
|
matricule: new Matricule('1234567'),
|
2026-10-01 10:50:32 +02:00
|
|
|
firstname: 'Jean',
|
|
|
|
|
lastname: 'Dupont',
|
2026-10-02 12:14:48 +02:00
|
|
|
facility: new ShopperEstablishmentCode('ETAB01'),
|
|
|
|
|
site: new ShopperSiteCode('SITEA'),
|
|
|
|
|
service: new ShopperServiceCode('101'),
|
2026-10-01 10:50:32 +02:00
|
|
|
),
|
|
|
|
|
deliveryAddress: new DeliveryAddress(
|
|
|
|
|
name: 'Shop',
|
|
|
|
|
address: '1 rue Test',
|
|
|
|
|
postcode: '75001',
|
|
|
|
|
city: 'Paris',
|
|
|
|
|
),
|
|
|
|
|
pickupTimeSlot: new PickupTimeSlot(now(), new \DateInterval('PT1H')),
|
|
|
|
|
status: OrderStatus::WAITING,
|
|
|
|
|
total: Money::EUR(1000),
|
|
|
|
|
lines: [],
|
|
|
|
|
);
|
|
|
|
|
|
|
|
|
|
$orderTunnelService = \Mockery::mock(OrderTunnelService::class);
|
|
|
|
|
$orderTunnelService->shouldReceive('getBuilderCompletedOrFail')
|
|
|
|
|
->once()
|
|
|
|
|
->andReturn($builder);
|
|
|
|
|
$orderTunnelService->shouldReceive('finalizeOrder')
|
|
|
|
|
->once()
|
|
|
|
|
->with($builder)
|
|
|
|
|
->andReturn($order);
|
|
|
|
|
|
|
|
|
|
$action = new FinalizeOrder($orderTunnelService);
|
|
|
|
|
|
|
|
|
|
// WHEN
|
|
|
|
|
$result = $action($input);
|
|
|
|
|
|
|
|
|
|
// THEN
|
2026-11-14 18:40:25 +01:00
|
|
|
expect($result)->toBeInstanceOf(FinalizeOrderOutput::class)
|
|
|
|
|
->and($result->status)->toBe(FinalizeOrderStatus::SUCCESS)
|
|
|
|
|
->and($result->orderReference)->not->toBeNull()
|
|
|
|
|
->and($result->orderReference?->value)->toBe($orderReference->value);
|
|
|
|
|
});
|
|
|
|
|
|
2026-11-14 22:00:11 +01:00
|
|
|
it('returns expiredTimeSlot output when finalizeOrder throws ExpiredPickupTimeSlotException', function (): void {
|
2026-11-14 18:40:25 +01:00
|
|
|
// GIVEN
|
|
|
|
|
$input = new FinalizeOrderInput();
|
|
|
|
|
$builder = \Mockery::mock(OrderBuilderCompleted::class);
|
|
|
|
|
$orderTunnelService = \Mockery::mock(OrderTunnelService::class);
|
2026-11-14 22:00:11 +01:00
|
|
|
$orderTunnelService->shouldReceive('getBuilderCompletedOrFail')->once()->andReturn($builder);
|
2026-11-14 18:40:25 +01:00
|
|
|
$orderTunnelService->shouldReceive('finalizeOrder')
|
|
|
|
|
->once()
|
|
|
|
|
->with($builder)
|
|
|
|
|
->andThrow(new ExpiredPickupTimeSlotException('Invalid or unavailable time slot'));
|
|
|
|
|
|
|
|
|
|
$action = new FinalizeOrder($orderTunnelService);
|
|
|
|
|
|
|
|
|
|
// WHEN
|
|
|
|
|
$result = $action($input);
|
|
|
|
|
|
|
|
|
|
// THEN
|
2026-11-14 22:00:11 +01:00
|
|
|
expect($action)->not->toBeInstanceOf(HandlesFailure::class)
|
2026-11-15 16:25:19 +01:00
|
|
|
->and($action)->not->toBeInstanceOf(HandlesSuccess::class)
|
2026-11-14 22:00:11 +01:00
|
|
|
->and($result)->toBeInstanceOf(FinalizeOrderOutput::class)
|
2026-11-14 18:40:25 +01:00
|
|
|
->and($result->status)->toBe(FinalizeOrderStatus::EXPIRED_TIME_SLOT)
|
|
|
|
|
->and($result->orderReference)->toBeNull()
|
|
|
|
|
->and($result->errorMessage)->toBe('Invalid or unavailable time slot');
|
|
|
|
|
});
|
|
|
|
|
|
2026-11-14 22:00:11 +01:00
|
|
|
it('returns unorderableProduct output when finalizeOrder throws UnorderableProductException', function (): void {
|
2026-11-14 18:40:25 +01:00
|
|
|
// GIVEN
|
|
|
|
|
$input = new FinalizeOrderInput();
|
|
|
|
|
$builder = \Mockery::mock(OrderBuilderCompleted::class);
|
|
|
|
|
$orderTunnelService = \Mockery::mock(OrderTunnelService::class);
|
2026-11-14 22:00:11 +01:00
|
|
|
$orderTunnelService->shouldReceive('getBuilderCompletedOrFail')->once()->andReturn($builder);
|
2026-11-14 18:40:25 +01:00
|
|
|
$orderTunnelService->shouldReceive('finalizeOrder')
|
|
|
|
|
->once()
|
|
|
|
|
->with($builder)
|
|
|
|
|
->andThrow(new UnorderableProductException('One or more products in your basket are no longer available for order.'));
|
|
|
|
|
|
|
|
|
|
$action = new FinalizeOrder($orderTunnelService);
|
|
|
|
|
|
|
|
|
|
// WHEN
|
|
|
|
|
$result = $action($input);
|
|
|
|
|
|
|
|
|
|
// THEN
|
|
|
|
|
expect($result)->toBeInstanceOf(FinalizeOrderOutput::class)
|
|
|
|
|
->and($result->status)->toBe(FinalizeOrderStatus::UNORDERABLE_PRODUCT)
|
|
|
|
|
->and($result->orderReference)->toBeNull()
|
|
|
|
|
->and($result->errorMessage)->toBe('One or more products in your basket are no longer available for order.');
|
|
|
|
|
});
|
|
|
|
|
|
2026-11-14 22:00:11 +01:00
|
|
|
it('returns orderLimitExceeded output when finalizeOrder throws OrderLimitExceededException', function (): void {
|
2026-11-14 18:40:25 +01:00
|
|
|
// GIVEN
|
|
|
|
|
$input = new FinalizeOrderInput();
|
|
|
|
|
$builder = \Mockery::mock(OrderBuilderCompleted::class);
|
|
|
|
|
$orderTunnelService = \Mockery::mock(OrderTunnelService::class);
|
2026-11-14 22:00:11 +01:00
|
|
|
$orderTunnelService->shouldReceive('getBuilderCompletedOrFail')->once()->andReturn($builder);
|
2026-11-14 18:40:25 +01:00
|
|
|
$orderTunnelService->shouldReceive('finalizeOrder')
|
|
|
|
|
->once()
|
|
|
|
|
->with($builder)
|
|
|
|
|
->andThrow(new OrderLimitExceededException());
|
|
|
|
|
|
|
|
|
|
$action = new FinalizeOrder($orderTunnelService);
|
|
|
|
|
|
|
|
|
|
// WHEN
|
|
|
|
|
$result = $action($input);
|
|
|
|
|
|
|
|
|
|
// THEN
|
|
|
|
|
expect($result)->toBeInstanceOf(FinalizeOrderOutput::class)
|
|
|
|
|
->and($result->status)->toBe(FinalizeOrderStatus::ORDER_LIMIT_EXCEEDED)
|
|
|
|
|
->and($result->orderReference)->toBeNull()
|
|
|
|
|
->and($result->errorMessage)->toBe('The total amount of this order has been exceeded. Please modify it to validate.');
|
|
|
|
|
});
|
|
|
|
|
|
2026-11-14 22:00:11 +01:00
|
|
|
it('returns weeklyLimitExceeded output when finalizeOrder throws WeeklyLimitExceededException', function (): void {
|
2026-11-14 18:40:25 +01:00
|
|
|
// GIVEN
|
|
|
|
|
$input = new FinalizeOrderInput();
|
|
|
|
|
$builder = \Mockery::mock(OrderBuilderCompleted::class);
|
|
|
|
|
$orderTunnelService = \Mockery::mock(OrderTunnelService::class);
|
2026-11-14 22:00:11 +01:00
|
|
|
$orderTunnelService->shouldReceive('getBuilderCompletedOrFail')->once()->andReturn($builder);
|
2026-11-14 18:40:25 +01:00
|
|
|
$orderTunnelService->shouldReceive('finalizeOrder')
|
|
|
|
|
->once()
|
|
|
|
|
->with($builder)
|
|
|
|
|
->andThrow(new WeeklyLimitExceededException());
|
|
|
|
|
|
|
|
|
|
$action = new FinalizeOrder($orderTunnelService);
|
|
|
|
|
|
|
|
|
|
// WHEN
|
|
|
|
|
$result = $action($input);
|
|
|
|
|
|
|
|
|
|
// THEN
|
|
|
|
|
expect($result)->toBeInstanceOf(FinalizeOrderOutput::class)
|
|
|
|
|
->and($result->status)->toBe(FinalizeOrderStatus::WEEKLY_LIMIT_EXCEEDED)
|
|
|
|
|
->and($result->orderReference)->toBeNull()
|
|
|
|
|
->and($result->errorMessage)->toBe('The total amount for this delivery date has been exceeded. Please modify it to validate.');
|
2026-10-01 10:50:32 +02:00
|
|
|
});
|
2026-11-14 20:26:22 +01:00
|
|
|
|
2026-11-14 22:00:11 +01:00
|
|
|
it('propagates RegateExportFailedException so ActionExecutorService rolls back the transaction', function (): void {
|
|
|
|
|
// GIVEN
|
|
|
|
|
$input = new FinalizeOrderInput();
|
|
|
|
|
$builder = \Mockery::mock(OrderBuilderCompleted::class);
|
|
|
|
|
$orderTunnelService = \Mockery::mock(OrderTunnelService::class);
|
|
|
|
|
$orderTunnelService->shouldReceive('getBuilderCompletedOrFail')->once()->andReturn($builder);
|
|
|
|
|
$orderTunnelService->shouldReceive('finalizeOrder')
|
|
|
|
|
->once()
|
|
|
|
|
->with($builder)
|
|
|
|
|
->andThrow(new RegateExportFailedException('SMTP transport error'));
|
|
|
|
|
|
|
|
|
|
$action = new FinalizeOrder($orderTunnelService);
|
|
|
|
|
|
|
|
|
|
// WHEN
|
|
|
|
|
expect(fn () => $action($input))
|
|
|
|
|
// THEN
|
|
|
|
|
->toThrow(RegateExportFailedException::class, 'SMTP transport error');
|
|
|
|
|
});
|
|
|
|
|
|
2026-11-14 20:26:22 +01:00
|
|
|
it('has Locked attribute with expected TTL and wait seconds and implements lock contracts', function (): void {
|
|
|
|
|
// GIVEN
|
|
|
|
|
$orderTunnelService = \Mockery::mock(OrderTunnelService::class);
|
|
|
|
|
$action = new FinalizeOrder($orderTunnelService);
|
|
|
|
|
$reflection = new \ReflectionClass(FinalizeOrder::class);
|
|
|
|
|
$attributes = $reflection->getAttributes(Locked::class);
|
|
|
|
|
|
|
|
|
|
// WHEN
|
|
|
|
|
$locked = ($attributes[0] ?? null)?->newInstance();
|
|
|
|
|
|
|
|
|
|
// THEN
|
|
|
|
|
expect($locked)->toBeInstanceOf(Locked::class)
|
|
|
|
|
->and($locked->ttlSeconds)->toBe(30)
|
|
|
|
|
->and($locked->waitSeconds)->toBe(10)
|
|
|
|
|
->and($locked->key)->toBeNull()
|
|
|
|
|
->and($action)->toBeInstanceOf(ProvidesLockKey::class)
|
|
|
|
|
->and($action)->toBeInstanceOf(HandlesLockTimeout::class);
|
|
|
|
|
});
|
|
|
|
|
|
|
|
|
|
it('builds lockKey from input shopperId when provided', function (): void {
|
|
|
|
|
// GIVEN
|
|
|
|
|
$shopperId = new ShopperId(Uuid::uuid7());
|
|
|
|
|
$input = new FinalizeOrderInput(shopperId: $shopperId);
|
|
|
|
|
$orderTunnelService = \Mockery::mock(OrderTunnelService::class);
|
|
|
|
|
$orderTunnelService->shouldNotReceive('getBuilderCompletedOrFail');
|
|
|
|
|
|
|
|
|
|
$action = new FinalizeOrder($orderTunnelService);
|
|
|
|
|
|
|
|
|
|
// WHEN
|
|
|
|
|
$key = $action->lockKey($input);
|
|
|
|
|
|
|
|
|
|
// THEN
|
|
|
|
|
expect($key)->toBe("order:finalize:shopper:{$shopperId->value}");
|
|
|
|
|
});
|
|
|
|
|
|
|
|
|
|
it('builds lockKey from completed builder when input shopperId is null', function (): void {
|
|
|
|
|
// GIVEN
|
|
|
|
|
$shopperId = new ShopperId(Uuid::uuid7());
|
|
|
|
|
$input = new FinalizeOrderInput();
|
|
|
|
|
|
|
|
|
|
$builder = \Mockery::mock(OrderBuilderCompleted::class);
|
|
|
|
|
$builder->shouldReceive('getShopperId')
|
|
|
|
|
->once()
|
|
|
|
|
->andReturn($shopperId);
|
|
|
|
|
|
|
|
|
|
$orderTunnelService = \Mockery::mock(OrderTunnelService::class);
|
|
|
|
|
$orderTunnelService->shouldReceive('getBuilderCompletedOrFail')
|
|
|
|
|
->once()
|
|
|
|
|
->andReturn($builder);
|
|
|
|
|
|
|
|
|
|
$action = new FinalizeOrder($orderTunnelService);
|
|
|
|
|
|
|
|
|
|
// WHEN
|
|
|
|
|
$key = $action->lockKey($input);
|
|
|
|
|
|
|
|
|
|
// THEN
|
|
|
|
|
expect($key)->toBe("order:finalize:shopper:{$shopperId->value}");
|
|
|
|
|
});
|
|
|
|
|
|
|
|
|
|
it('returns lockTimeout output on lock timeout', function (): void {
|
|
|
|
|
// GIVEN
|
|
|
|
|
$input = new FinalizeOrderInput();
|
|
|
|
|
$orderTunnelService = \Mockery::mock(OrderTunnelService::class);
|
|
|
|
|
|
|
|
|
|
$action = new FinalizeOrder($orderTunnelService);
|
|
|
|
|
|
|
|
|
|
// WHEN
|
|
|
|
|
$result = $action->onLockTimeout($input);
|
|
|
|
|
|
|
|
|
|
// THEN
|
|
|
|
|
expect($result)->toBeInstanceOf(FinalizeOrderOutput::class)
|
|
|
|
|
->and($result->status)->toBe(FinalizeOrderStatus::LOCK_TIMEOUT)
|
|
|
|
|
->and($result->orderReference)->toBeNull()
|
|
|
|
|
->and($result->errorMessage)->toBeNull();
|
|
|
|
|
});
|
2026-10-01 10:50:32 +02:00
|
|
|
});
|