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
PlatformContexty Multi-tenant.