🏗️ Stack Técnico — Laravel Inventario API

# Instalar Laravel 12
composer create-project laravel/laravel example-app "^12.0"

// config/auth.php
'guards' => [
    'api' => [
        'driver'   => 'jwt',
        'provider' => 'usuarios',
    ],
],
'providers' => [
    'usuarios' => [
        'driver' => 'eloquent',
        'model'  => App\Models\Usuario::class,
    ],
],

# Publicar config y generar secret
php artisan vendor:publish --provider="Tymon\JWTAuth\Providers\LaravelServiceProvider"
php artisan jwt:secret

JWT_SECRET=tu_secret_aqui
JWT_TTL=60           # Access token: 60 minutos
REFRESH_TOKEN_TTL=43200  # Refresh token: 30 días

php artisan tinker

# Ejemplos de uso
>>> App\Models\Usuario::find(1)->load('rol')
>>> App\Models\Producto::where('activo', true)->count()
>>> Hash::make('Password123!')

// database/factories/ProductoFactory.php
public function definition(): array
{
    return [
        'cod_producto'       => fake()->unique()->bothify('PROD-####'),
        'nombre'             => fake()->words(3, true),
        'marca'              => fake()->company(),
        'precio_minorista'   => fake()->randomFloat(2, 10, 500),
        'precio_mayorista'   => fake()->randomFloat(2, 5, 400),
        'stock_minimo'       => fake()->numberBetween(5, 50),
    ];
}

# Levantar el entorno completo
./vendor/bin/sail up -d

# Ejecutar comandos dentro del contenedor
./vendor/bin/sail artisan migrate
./vendor/bin/sail artisan db:seed
./vendor/bin/sail php artisan tinker

# Formatear todos los archivos PHP
./vendor/bin/pint

# Solo verificar sin modificar
./vendor/bin/pint --test

# Formatear un archivo específico
./vendor/bin/pint app/Models/Usuario.php

// pint.json (configuración)
{
    "preset": "laravel",
    "rules": {
        "ordered_imports": true,
        "no_unused_imports": true
    }
}

# Ver todos los logs en tiempo real
php artisan pail

# Filtrar por nivel
php artisan pail --level=error

# Filtrar por mensaje
php artisan pail --filter="JWT"

// Ejemplo de mock en test
$repository = Mockery::mock(ProductoRepositoryInterface::class);
$repository->shouldReceive('findById')
           ->with(1)
           ->andReturn($producto);

// tests/Feature/ProductoTest.php
it('puede crear un producto', function () {
    $payload = [
        'cod_producto'     => 'PROD-001',
        'nombre'           => 'Laptop HP',
        'categoria_id'     => 1,
        'precio_minorista' => 1500.00,
        'precio_mayorista' => 1200.00,
        'stock_minimo'     => 5,
    ];

    $this->actingAs($this->admin, 'api')
         ->postJson('/api/v1/productos', $payload)
         ->assertStatus(201)
         ->assertJsonPath('data.cod_producto', 'PROD-001');
});

it('rechaza crear producto con código duplicado', function () {
    Producto::factory()->create(['cod_producto' => 'PROD-001']);

    $this->actingAs($this->admin, 'api')
         ->postJson('/api/v1/productos', ['cod_producto' => 'PROD-001', ...])
         ->assertStatus(422);
});

# Correr todos los tests
php artisan test

# Con cobertura de código
php artisan test --coverage

# Solo un archivo
php artisan test tests/Feature/ProductoTest.php

# En paralelo
php artisan test --parallel

# docker-compose.yml (sail)
services:
  mysql:
    image: mysql/mysql-server:8.0
    ports:
      - '${FORWARD_DB_PORT:-3302}:3306'
    environment:
      MYSQL_DATABASE: ${DB_DATABASE}
      MYSQL_USER: ${DB_USERNAME}
      MYSQL_PASSWORD: ${DB_PASSWORD}
    volumes:
      - sail-mysql:/var/lib/mysql

DB_CONNECTION=mysql
DB_HOST=127.0.0.1
DB_PORT=3302
DB_DATABASE=laravel
DB_USERNAME=sail
DB_PASSWORD=password

// config/cors.php
return [
    'paths'               => ['api/*'],
    'allowed_methods'     => ['*'],
    'allowed_origins'     => [env('FRONTEND_URL', 'http://localhost:3000')],
    'allowed_headers'     => ['*'],
    'supports_credentials' => true,  // necesario para cookies httpOnly
];

# ── Configuración inicial ────────────────────────────────
composer install
cp .env.example .env
php artisan key:generate
php artisan jwt:secret

# ── Base de datos ────────────────────────────────────────
php artisan migrate                    # Crear tablas
php artisan migrate:fresh --seed       # Reset + datos de prueba
php artisan db:seed --class=ProductionSeeder  # Seed de producción

# ── Servidor de desarrollo ───────────────────────────────
php artisan serve                      # http://localhost:8000
composer dev                           # servidor + queue + vite concurrentes

# ── Testing ──────────────────────────────────────────────
php artisan test
php artisan test --parallel
php artisan test --coverage --min=80

# ── Calidad de código ────────────────────────────────────
./vendor/bin/pint                      # Formatear código
php artisan pail --level=error         # Ver logs de error en tiempo real

# ── Documentación ───────────────────────────────────────
# Swagger UI disponible en http://localhost:8000/docs (solo APP_ENV=local)