<?php
// database/migrations/2024_01_15_000000_create_produits_table.php
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('produits', function (Blueprint $table) {
            $table->id();                                          // bigint auto-increment
            $table->string('nom', 120);
            $table->text('description')->nullable();
            $table->decimal('prix', 10, 2);
            $table->unsignedInteger('stock')->default(0);
            $table->boolean('est_disponible')->default(true);
            $table->json('metadonnees')->nullable();
            $table->foreignId('categorie_id')                      // clé étrangère typée
                ->constrained('categories')
                ->cascadeOnDelete();
            $table->timestamps();                                  // created_at / updated_at
            $table->softDeletes();                                 // deleted_at (suppression logique)

            $table->index(['categorie_id', 'est_disponible']);      // index composite
            $table->unique('sku');
        });
    }

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

// Migration d'altération d'une table existante
return new class extends Migration {
    public function up(): void {
        Schema::table('produits', function (Blueprint $table) {
            $table->string('sku', 40)->after('nom');
            $table->index('sku');
        });
    }

    public function down(): void {
        Schema::table('produits', function (Blueprint $table) {
            $table->dropIndex(['sku']);
            $table->dropColumn('sku');
        });
    }
};

<?php
// database/factories/ProduitFactory.php : génère des données réalistes pour les tests/seeds
namespace Database\Factories;

use Illuminate\Database\Eloquent\Factories\Factory;

class ProduitFactory extends Factory {
    public function definition(): array {
        return [
            'nom' => $this->faker->words(3, true),
            'prix' => $this->faker->randomFloat(2, 5, 500),
            'stock' => $this->faker->numberBetween(0, 200),
            'sku' => strtoupper($this->faker->bothify('???-####')),
            'categorie_id' => \App\Models\Categorie::factory(),
        ];
    }

    // State personnalisé réutilisable : Produit::factory()->epuise()->create()
    public function epuise(): static {
        return $this->state(fn (array $attributs) => ['stock' => 0, 'est_disponible' => false]);
    }
}

// database/seeders/DatabaseSeeder.php
namespace Database\Seeders;

use Illuminate\Database\Seeder;
use App\Models\{Categorie, Produit};

class DatabaseSeeder extends Seeder {
    public function run(): void {
        Categorie::factory(5)->create()->each(function ($categorie) {
            Produit::factory(20)->for($categorie)->create();
        });

        Produit::factory(10)->epuise()->create();
    }
}

php artisan make:migration create_produits_table
php artisan migrate                 # applique les migrations en attente
php artisan migrate:rollback        # annule le dernier batch de migrations
php artisan migrate:fresh --seed    # DROP toutes les tables, remigre, puis seed (dev uniquement !)
php artisan db:seed --class=DatabaseSeeder