Saltar a contenido

Instalación y desarrollo local

Requisitos

  • PHP 8.2+ con las extensiones habituales de Laravel.
  • Composer.
  • Node.js y npm.
  • PostgreSQL y Redis.
  • Opcional: FrankenPHP si quieres reproducir el runtime de producción.

Instalación

composer setup
composer dev

Paso a paso:

cp .env.example .env
composer install
php artisan key:generate
php artisan migrate
npm install
npm run build
php artisan serve

La base de datos de dominio (site) se gestiona fuera de este repositorio. Las migraciones incluidas aquí cubren usuarios, caché, jobs, auditoría y permisos.

Variables relevantes

Variable Uso
APP_URL / ADMIN_URL Dominio del panel Admin y del Backoffice
DB_* / DB_SCHEMA PostgreSQL y esquema site
SESSION_DRIVER / SESSION_CONNECTION Sesiones en Redis
CACHE_STORE / CACHE_PREFIX Caché compartida
OCTANE_SERVER frankenphp en producción
AUDITING_ENABLED Activa OwenIt Auditing
ALERTS_* / TELEGRAM_ALERT_* Alertas operativas
AWS_* / ATHENA_* / SQS_* Reportes, assets y colas

La referencia completa está en Configuración.

Comandos

Comando Uso
composer setup Instala dependencias, .env, key, migraciones y assets
composer dev Servidor, queue, logs y Vite en paralelo
composer test Limpia configuración y ejecuta PHPUnit
vendor/bin/pint Formatea PHP
php artisan pail Logs en tiempo real
php artisan translations:export es,en Exporta traducciones
php artisan filament:upgrade Actualiza assets de Filament

Multi-tenant en local

  • El panel Admin resuelve el tenant por el dominio (bo_domain).
  • El panel Backoffice se sirve en ADMIN_URL.
  • Si el dominio no coincide con una plataforma, revisa PlatformContext y Multi-tenant.

Siguiente paso