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>
49 lines
1.2 KiB
PHP
49 lines
1.2 KiB
PHP
<?php
|
||
|
||
declare(strict_types=1);
|
||
|
||
namespace App\Http\Requests;
|
||
|
||
use Illuminate\Foundation\Http\FormRequest;
|
||
|
||
/**
|
||
* Валидация заголовка Idempotency-Key у POST /slots/{slot}/hold.
|
||
*/
|
||
final class StoreHoldRequest extends FormRequest
|
||
{
|
||
/**
|
||
* Ключ приходит заголовком — переносим во входные данные, чтобы проверять правилами.
|
||
*/
|
||
protected function prepareForValidation(): void
|
||
{
|
||
$this->merge([
|
||
'idempotency_key' => $this->header('Idempotency-Key'),
|
||
]);
|
||
}
|
||
|
||
/**
|
||
* @return array<string, list<string>>
|
||
*/
|
||
public function rules(): array
|
||
{
|
||
return [
|
||
'idempotency_key' => ['required', 'uuid'],
|
||
];
|
||
}
|
||
|
||
/**
|
||
* @return array<string, string>
|
||
*/
|
||
public function messages(): array
|
||
{
|
||
return [
|
||
'idempotency_key.required' => 'The Idempotency-Key header is required.',
|
||
'idempotency_key.uuid' => 'The Idempotency-Key header must be a valid UUID.',
|
||
];
|
||
}
|
||
|
||
public function idempotencyKey(): string
|
||
{
|
||
return $this->validated()['idempotency_key'];
|
||
}
|
||
}
|