<?php

use Illuminate\Database\Migrations\Migration;
use Illuminate\Database\Schema\Blueprint;
use Illuminate\Support\Facades\Schema;

/**
 * Plan Credits — per-cycle consumable grants.
 *
 * Convention: presence = granted. Missing row for (plan, credit_key) = plan does not
 * grant that credit. `amount_per_cycle = NULL` = unlimited.
 *
 * See docs/payment-order-plan-subscription-saas/SUBSCRIPTION-COMPREHENSIVE-DESIGN.md §3.1.
 */
return new class extends Migration
{
    public function up(): void
    {
        Schema::create('plan_credits', function (Blueprint $table) {
            $table->id();
            $table->unsignedInteger('plan_id');
            $table->string('credit_key', 64);
            $table->integer('amount_per_cycle')->nullable()->comment('NULL = unlimited');
            $table->timestamps();

            $table->foreign('plan_id')->references('id')->on('plans')->onDelete('cascade');
            $table->unique(['plan_id', 'credit_key']);
        });
    }

    public function down(): void
    {
        Schema::dropIfExists('plan_credits');
    }
};