Scores/README.md
Juan Felipe Zapata Moreno be89d18e74 Init
2025-07-01 10:36:19 -06:00

3.0 KiB

Acerca de Template Laravel Vue

Template es una plantilla que contiene un administrador con elementos simples como formularios, botones, tablas entre otros para acelerar el desarrollo. Permite tener preparada la gestión de usuarios, perfiles, entre otras cosas.

Este proyecto tiene como núcleo Laravel 10, Intertiajs y Vuejs 3.

Instalar proyecto

Requerimientos

Para instalar este proyecto se requiere tener instalado como mínimo las siguientes dependencias:

  • Composer 2.5.7
  • Nodejs 18.17.0
  • NPM 9.6.7
  • La base de datos es a discreción del usuario.

Instalación

El proyecto es capas de configurarse a si mismo si todas las dependencias están satisfechas. Para instalar el proyecto corra: composer env:prod o si lo prefiere: composer env:dev Se instalara el ambiente de producción o desarrollo respectivamente.

Una vez configurado el archivo .env con la base de datos, puede sembrar la base de datos: composer db:prod o si desea instalarla con el modo desarrollo: composer db:dev

Notificaciones en tiempo real

Si se desea aprovechar el servicio de notificaciones en tiempo real integrado, se requiere instalar SOKETI y PM2. npm install -g @soketi/soketi npm install -g pm2 También puede ejecutar el instalador integrado: php artisan composer notification:install En caso de error, procure usar privilegios de super usuario.

Para iniciar el servicio debe iniciarlo con el comando: php artisan notification:start O si desea detenerlo: php artisan notification:stop En caso de una desactivación permanente, puede eliminar la instancia: php artisan notification:destroy

Puede configurar libremente el servidor de notificaciones como usted desee con el archivo soketi.json. Entre los parámetros editables están:

  • Puerto
  • ID de la instancia
  • KEY de la instancia
  • SECRETE de la instancia

El archivo de configuración se crea automáticamente al instalar el proyecto. Recuerde colocar los datos que edite de soketi.json en la configuración de PUSHER en el .env.

El nombre de la instancia del servicio de notificaciones dentro de PM2 sera el mismo que se establezca en PUSHER_APP_KEY dentro del .env. Es posible que sea conveniente modificar este dato si desea correr dos o más instancias de la aplicación dentro del mismo servidor para evitar que las notificaciones se compartan entre instancias. En caso contrario no es necesario modificar nada.

La aplicación puede funcionar bien con el establecimiento de un proxy inverso mediante NGINX si se requiere establecer un subdominio o dominio como puerta de enlace al servidor de notificaciones.

Por default las notificaciones están desactivadas. Se activan cambiando la variable de entorno PUSHER_NOTIFICATIONS de false a true.

Autor

Este proyecto fue desarrollado por Moisés de Jesús Cortés Castellanos. Si tiene alguna duda o recomendación, enviar a ing.moisesdejesuscortesc@notsoweb.com.