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>
36 lines
1.2 KiB
PHP
36 lines
1.2 KiB
PHP
<?php
|
||
|
||
declare(strict_types=1);
|
||
|
||
use Illuminate\Database\Migrations\Migration;
|
||
use Illuminate\Database\Schema\Blueprint;
|
||
use Illuminate\Support\Facades\Schema;
|
||
|
||
return new class extends Migration
|
||
{
|
||
public function up(): void
|
||
{
|
||
Schema::create('holds', function (Blueprint $table): void {
|
||
$table->id();
|
||
$table->foreignId('slot_id')->constrained()->cascadeOnDelete();
|
||
|
||
// Уникальный индекс и обеспечивает идемпотентность: две
|
||
// одновременные вставки с одним ключом невозможны.
|
||
$table->uuid('idempotency_key')->unique();
|
||
|
||
$table->enum('status', ['held', 'confirmed', 'cancelled'])->default('held');
|
||
$table->dateTime('expires_at');
|
||
$table->dateTime('confirmed_at')->nullable();
|
||
$table->dateTime('cancelled_at')->nullable();
|
||
$table->timestamps();
|
||
|
||
// Под подсчёт активных холдов слота.
|
||
$table->index(['slot_id', 'status', 'expires_at']);
|
||
});
|
||
}
|
||
|
||
public function down(): void
|
||
{
|
||
Schema::dropIfExists('holds');
|
||
}
|
||
};
|