Implementación de Alojamiento Compartido (cPanel)

La Consola de Tienda prefiere un VPS (Docker o LEMP), pero también funciona en un alojamiento compartido capaz. El alojamiento compartido significa que no hay acceso root, generalmente MySQL en lugar de PostgreSQL, sin Redis y sin procesos de larga duración; esta página cubre exactamente qué cambios.

Capacidades Mínimas del Host

PHP 8.4 con las extensiones estándar de Laravel (la mayoría de los selectores de PHP de cPanel las incluyen)
MySQL 8.0+ o MariaDB 10.6+ (PostgreSQL preferido donde esté disponible)
Trabajos cron (al menos cada minuto)
Se recomienda encarecidamente el acceso SSH para composer y artisan

Paso 1: Subir y Apuntar la Raíz del Documento

Sube y extrae tu zip con licencia fuera de public_html, luego apunta la raíz del documento del (sub)dominio al directorio public/ de la app desde cPanel → Dominios. Nunca expongas la raíz de la aplicación en sí.

Paso 2: Configurar .env para Alojamiento Compartido

DB_CONNECTION=mysql
DB_HOST=127.0.0.1
DB_PORT=3306
DB_DATABASE=cpaneluser_storeconsole
DB_USERNAME=cpaneluser_sc
DB_PASSWORD=your_password

QUEUE_CONNECTION=database
CACHE_STORE=database
SESSION_DRIVER=database
BROADCAST_CONNECTION=null

Estos controladores son de primera clase: la cola, la caché y las tablas de sesión se envían en las migraciones predeterminadas, por lo que no se requiere Redis.

Paso 3: Migrar y Construir

php artisan migrate --seed
npm run build   # or build locally and upload public/build

Paso 4: Entradas de Cron (reemplaza Horizon y systemd)

Agrega dos trabajos cron en cPanel → Trabajos Cron:

* * * * * php /home/USER/storeconsole/artisan schedule:run
* * * * * php /home/USER/storeconsole/artisan queue:work database --stop-when-empty --max-time=55

La segunda entrada drena cada cola una vez por minuto y sale, lo cual es seguro bajo los límites de procesos de alojamiento compartido. Horizon y su panel de control no se utilizan en alojamiento compartido.

Qué se Degrada — y Cómo

Las características semánticas de IA (búsqueda vectorial, embeddings) necesitan PostgreSQL + pgvector; en MySQL se apagan limpiamente mientras que las herramientas de chat, generación e informes de IA siguen funcionando a través de tu proveedor configurado
El chat en tiempo real & notificaciones utilizan Reverb/WebSockets en un VPS; sin él, la interfaz vuelve automáticamente a la consulta periódica (BROADCAST_CONNECTION=null)
Los trabajos en segundo plano se ejecutan hasta un minuto más tarde que en un trabajador dedicado; aceptable para correos, facturas e informes; las tiendas pesadas deberían mudarse a un VPS

Cuándo Actualizar a un VPS

Múdate a un VPS cuando habilites POS o despacho de entrega (sensible a la latencia), confíes en la búsqueda de IA o proceses más de unos pocos pedidos por minuto. Tus datos migran con un volcado de base de datos estándar; no se necesita reinstalación.