Dmitriy
16f3f851b1
GET /slots/availability, POST /slots/{id}/hold, POST /holds/{id}/confirm
and DELETE /holds/{id} on Laravel 12 and MySQL 8.
- availability cached for 10s behind a single-flight lock with a stale
copy, invalidated after commit on confirm and cancel
- oversell prevented by a conditional decrement, verified by the number
of affected rows rather than a preceding select
- idempotency enforced by a unique index on holds.idempotency_key
- active holds counted with an expires_at filter, so no background
cleanup is required for correctness
- 27 feature tests against MySQL, service documentation, Postman collection
Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
52 lines
1.3 KiB
PHP
52 lines
1.3 KiB
PHP
<?php
|
||
|
||
declare(strict_types=1);
|
||
|
||
namespace App\Exceptions;
|
||
|
||
use App\Enums\HoldStatus;
|
||
use App\Models\Hold;
|
||
use RuntimeException;
|
||
|
||
/**
|
||
* Доменные отказы бронирования. Сопоставление с ответами HTTP — в bootstrap/app.php.
|
||
*/
|
||
final class SlotBookingException extends RuntimeException
|
||
{
|
||
private function __construct(
|
||
public readonly string $reason,
|
||
public readonly int $status,
|
||
string $message,
|
||
) {
|
||
parent::__construct($message);
|
||
}
|
||
|
||
public static function capacityExhausted(int $slotId): self
|
||
{
|
||
return new self(
|
||
'capacity_exhausted',
|
||
409,
|
||
"Slot {$slotId} has no remaining capacity.",
|
||
);
|
||
}
|
||
|
||
public static function holdNotActive(Hold $hold): self
|
||
{
|
||
$reason = $hold->status === HoldStatus::Cancelled ? 'hold_cancelled' : 'hold_expired';
|
||
|
||
return new self(
|
||
$reason,
|
||
409,
|
||
"Hold {$hold->id} is no longer active and cannot be confirmed.",
|
||
);
|
||
}
|
||
|
||
public static function idempotencyKeyReuse(string $key, int $slotId): self
|
||
{
|
||
return new self(
|
||
'idempotency_key_reuse',
|
||
422,
|
||
"Idempotency-Key {$key} was already used for a different slot than {$slotId}.",
|
||
);
|
||
}
|
||
}
|