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>
56 lines
1.2 KiB
PHP
56 lines
1.2 KiB
PHP
<?php
|
|
|
|
declare(strict_types=1);
|
|
|
|
namespace Database\Factories;
|
|
|
|
use App\Enums\HoldStatus;
|
|
use App\Models\Hold;
|
|
use App\Models\Slot;
|
|
use Illuminate\Database\Eloquent\Factories\Factory;
|
|
use Illuminate\Support\Str;
|
|
|
|
/**
|
|
* @extends Factory<Hold>
|
|
*/
|
|
final class HoldFactory extends Factory
|
|
{
|
|
protected $model = Hold::class;
|
|
|
|
/**
|
|
* @return array<string, mixed>
|
|
*/
|
|
public function definition(): array
|
|
{
|
|
return [
|
|
'slot_id' => Slot::factory(),
|
|
'idempotency_key' => (string) Str::uuid(),
|
|
'status' => HoldStatus::Held,
|
|
'expires_at' => now()->addSeconds((int) config('slots.hold_ttl')),
|
|
];
|
|
}
|
|
|
|
public function expired(): self
|
|
{
|
|
return $this->state(fn (): array => [
|
|
'status' => HoldStatus::Held,
|
|
'expires_at' => now()->subMinute(),
|
|
]);
|
|
}
|
|
|
|
public function confirmed(): self
|
|
{
|
|
return $this->state(fn (): array => [
|
|
'status' => HoldStatus::Confirmed,
|
|
'confirmed_at' => now(),
|
|
]);
|
|
}
|
|
|
|
public function cancelled(): self
|
|
{
|
|
return $this->state(fn (): array => [
|
|
'status' => HoldStatus::Cancelled,
|
|
'cancelled_at' => now(),
|
|
]);
|
|
}
|
|
}
|