takeone-youtube-clone/database/migrations/2026_08_08_000002_frame_accurate_timestamps.php

<?php

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

return new class extends Migration
{
    /**
     * Frame-accurate timestamps: the match highlights scrubber lands on
     * frame boundaries (1/fps seconds). Storing these as INTEGER seconds
     * throws away sub-second precision, so we promote the columns to
     * decimal(10,3) — 3 decimals cover up to 1000 fps and centuries of
     * runtime, and existing integer values migrate losslessly.
     */
    public function up(): void
    {
        // MatchRound.start_time_seconds is used to jump to a round's opening
        // frame too, so bring it along.
        Schema::table('match_rounds', function (Blueprint $table) {
            $table->decimal('start_time_seconds', 10, 3)->nullable()->change();
        });

        Schema::table('match_points', function (Blueprint $table) {
            $table->decimal('timestamp_seconds', 10, 3)->change();
        });

        Schema::table('coach_reviews', function (Blueprint $table) {
            $table->decimal('start_time_seconds', 10, 3)->change();
            $table->decimal('end_time_seconds',   10, 3)->nullable()->change();
        });
    }

    public function down(): void
    {
        // Round back to integer on rollback — sub-second data would be
        // truncated but nothing catastrophic happens.
        Schema::table('match_rounds', function (Blueprint $table) {
            $table->integer('start_time_seconds')->nullable()->change();
        });
        Schema::table('match_points', function (Blueprint $table) {
            $table->integer('timestamp_seconds')->change();
        });
        Schema::table('coach_reviews', function (Blueprint $table) {
            $table->integer('start_time_seconds')->change();
            $table->integer('end_time_seconds')->nullable()->change();
        });
    }
};