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>
18 lines
531 B
PHP
18 lines
531 B
PHP
<?php
|
|
|
|
declare(strict_types=1);
|
|
|
|
use App\Http\Controllers\AvailabilityController;
|
|
use App\Http\Controllers\HoldController;
|
|
use Illuminate\Support\Facades\Route;
|
|
|
|
Route::get('/slots/availability', [AvailabilityController::class, 'index']);
|
|
|
|
Route::post('/slots/{slot}/hold', [HoldController::class, 'store'])
|
|
->whereNumber('slot');
|
|
|
|
Route::post('/holds/{hold}/confirm', [HoldController::class, 'confirm'])
|
|
->whereNumber('hold');
|
|
|
|
Route::delete('/holds/{hold}', [HoldController::class, 'destroy'])
|
|
->whereNumber('hold');
|