slot-booking/app/Http/Resources/HoldResource.php
Dmitriy 16f3f851b1 feat: slot booking API with hot cache and oversell protection
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>
2026-07-31 14:47:18 +03:00

30 lines
713 B
PHP

<?php
declare(strict_types=1);
namespace App\Http\Resources;
use App\Models\Hold;
use Illuminate\Http\Request;
use Illuminate\Http\Resources\Json\JsonResource;
/**
* @mixin Hold
*/
final class HoldResource extends JsonResource
{
/**
* @return array<string, mixed>
*/
public function toArray(Request $request): array
{
return [
'hold_id' => $this->id,
'slot_id' => $this->slot_id,
'status' => $this->status->value,
'expires_at' => $this->expires_at->toIso8601String(),
'confirmed_at' => $this->confirmed_at?->toIso8601String(),
'cancelled_at' => $this->cancelled_at?->toIso8601String(),
];
}
}