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>
43 lines
929 B
PHP
43 lines
929 B
PHP
<?php
|
||
|
||
declare(strict_types=1);
|
||
|
||
namespace Database\Factories;
|
||
|
||
use App\Models\Slot;
|
||
use Illuminate\Database\Eloquent\Factories\Factory;
|
||
|
||
/**
|
||
* @extends Factory<Slot>
|
||
*/
|
||
final class SlotFactory extends Factory
|
||
{
|
||
protected $model = Slot::class;
|
||
|
||
/**
|
||
* @return array<string, mixed>
|
||
*/
|
||
public function definition(): array
|
||
{
|
||
$capacity = 5;
|
||
$startsAt = now()->startOfHour()->addHour();
|
||
|
||
return [
|
||
'starts_at' => $startsAt,
|
||
'ends_at' => $startsAt->copy()->addHour(),
|
||
'capacity' => $capacity,
|
||
'remaining' => $capacity,
|
||
];
|
||
}
|
||
|
||
/**
|
||
* Слот с заданной вместимостью, без броней.
|
||
*/
|
||
public function withCapacity(int $capacity): self
|
||
{
|
||
return $this->state(fn (): array => [
|
||
'capacity' => $capacity,
|
||
'remaining' => $capacity,
|
||
]);
|
||
}
|
||
}
|