Saltar a contenido

Onboarding (Tutorial)

Objetivo: dejar el entorno listo (backend + frontend + pruebas) replicando lo que valida la CI.

Prerrequisitos

  • PHP 8.2+, Composer 2.x
  • Node.js 20+ y npm
  • PostgreSQL (local por defecto 5432; pruebas usan .env.testing con 5434)

Backend

# Variables de entorno
cp .env.example .env
php artisan key:generate

# Dependencias PHP
composer install

# Migraciones y seeders (BD local por defecto en 5432)
php artisan migrate --seed

Frontend

npm ci
npm run build

Pruebas (testing)

  • Fuente única: .env.testing (Postgres 127.0.0.1:5434, DB boilerplate_laravel12_test).
php artisan migrate --env=testing
vendor/bin/pest

Verificación local (antes de commitear)

npm run lint:ci && npm run typecheck && npm run format:check \
  && composer run analyse && vendor/bin/pint -n --test \
  && npm run build && php artisan test -q

CI/CD

Troubleshooting

  • Si no ves el botón "copy" en snippets, prueba desactivar temporalmente navigation.instant en mkdocs.yml.
  • Al mover páginas, agrega redirects en mkdocs.yml (plugin redirects).