Asistente guiado de puesta en marcha

El proyecto incorpora un wizard de instalación para dejar operativo el sistema en entorno propio con una secuencia sencilla y robusta.

Pasos del asistente

Instalación

Secuencia funcional del wizard desde la comprobación inicial hasta la finalización del despliegue.

Verifica versión de PHP, extensiones necesarias, permisos de escritura y compatibilidad general del servidor antes de iniciar la instalación.

Recoge servidor, puerto, nombre de base de datos, usuario y contraseña para crear o verificar la estructura necesaria en MySQL o MariaDB.

Configura nombre de empresa, identidad visual, URL base (aconsejamos tudomio/public para mayor compatibilidad entre servidores Apache y Nginx) y parámetros generales del entorno para dejar preparada la instancia inicial.

Crea la cuenta del administrador principal que se utilizará para acceder al panel y gestionar el sistema desde el primer arranque.

Introduce la configuración SMTP para recuperación de contraseña, comunicaciones del sistema y validaciones posteriores. Es muy importante utilizar SMTP para asegurar la privacidad RGPD. Ver consejos.

Permite fijar coordenadas, radio máximo de fichaje, precisión GPS mínima y parámetros de jornada directamente desde el asistente. Ver consejos.

Ejecuta la creación final de tablas, carga de datos base, generación del entorno y activación de la lógica necesaria para arrancar la aplicación.

Confirma el resultado final, muestra el resumen de la instalación completada y deja el sistema listo para acceder al área de administración y al área de usuario. Ver consejos para la carpeta Install.

Requisitos y parámetros

Configuración

Bloques de configuración que el asistente recopila para dejar preparada una instalación limpia y funcional desde el primer acceso.

La instalación requiere un servidor con PHP 8.1 o superior, MySQL o MariaDB, las extensiones PDO, PDO MySQL, OpenSSL, mbstring y JSON activas, soporte para GD o Imagick, permisos de escritura en la raíz del proyecto y en public/assets/uploads, además de mod_rewrite o URL rewriting habilitado en Apache.

Se definen credenciales, nombre de base de datos, conexión y estructura persistente del sistema para MySQL 8.0 o superior y MariaDB 10.5 o superior.

Nombre comercial, CIF, Dirección postal, identidad de marca, logo y datos básicos para personalizar la instancia instalada.

Email, credenciales iniciales y punto de acceso principal para la administración del sistema.

Host, puerto, cifrado (SSL o TLS), remitente y cuenta SMTP para las notificaciones y la recuperación segura de contraseña. Ver consejos.

Coordenadas de oficina, distancia máxima de fichaje y precisión mínima para validación geográfica del registro horario. Ver consejos

Horario base, fin de jornada, días de vacaciones por defecto y datos de operación para la configuración inicial.

Eliminar carpeta Install. Ver consejos.
Consejos de instalación

Recomendaciones para una puesta en marcha estable

Antes de terminar la instalación conviene revisar algunos ajustes prácticos para evitar incidencias habituales y dejar el sistema bien afinado desde el primer acceso.

Consejos

Es una de las partes más importantes de la instalación. Conviene dejar el correo saliente operativo desde el primer momento para recuperación segura de contraseña, avisos internos, resolución de incidencias y comunicaciones del sistema. Si el servidor no permite envío fiable, lo recomendable es usar una cuenta SMTP autenticada con SSL o TLS.

Si aparecen mensajes de precisión GPS insuficiente, normalmente no se debe a un fallo del sistema, sino a la exactitud que devuelve el dispositivo en ese momento. Para pruebas puede relajarse temporalmente este valor en el campo min_accuracy de la tabla configuracion, aunque en producción conviene mantenerlo lo más ajustado posible sin bloquear la operativa real. En interiores, con mala cobertura o en equipos modestos, es necesario encontrar un equilibrio razonable. En dispositivos móviles la geolocalización suele funcionar correctamente, pero en ordenadores de escritorio, especialmente cuando la cobertura WiFi es deficiente, el navegador puede llegar a situar al usuario a varios kilómetros de su posición real. En entornos de teletrabajo, y especialmente en zonas rurales, es recomendable realizar el fichaje desde un dispositivo móvil.

Estos dos parámetros deben revisarse juntos. Un radio muy pequeño combinado con una exigencia alta de precisión puede generar rechazos innecesarios. Para oficinas fijas conviene ser más estricto; para comerciales, desplazamientos o entornos con cobertura irregular puede interesar ampliar el radio o aplicar radios individuales por empleado cuando realmente sea necesario.

Como criterio práctico, trabajar con 5 decimales suele dar una precisión suficiente para este tipo de control horario sin introducir ruido innecesario. Es importante que el valor capturado en instalación y el valor guardado luego en configuración mantengan el mismo criterio para evitar diferencias aparentes entre una pantalla y otra.

Tras la instalación, gran parte de la configuración técnica queda centralizada en el archivo .env situado en la raíz del proyecto instalado. Si se modifica manualmente, conviene revisar con calma las variables sensibles y no tocar valores sin copia previa. Es el punto natural para correo, URL base, base de datos y otros parámetros del entorno.

La interfaz permite personalizar la identidad visual desde el panel de administración. Después de cualquier cambio de color hay que pulsar siempre en guardar configuración para que los nuevos valores queden persistidos y se apliquen correctamente en todo el sistema.

Para obtener un resultado limpio y escalable, lo ideal es subir el logotipo en SVG siempre que exista una versión correcta. Como alternativa funcionan bien PNG y JPG con buena resolución, fondo controlado y proporciones horizontales. Cuanto más limpio sea el original, mejor quedará en cabecera, login y paneles.

Si durante las pruebas aparecen comportamientos extraños de geolocalización, conviene comprobar los permisos del navegador, la precisión del GPS del dispositivo, la cobertura real y si se está simulando la ubicación. El uso de VPN, proxies o determinadas configuraciones de red puede alterar la posición detectada por el navegador, por lo que es recomendable validar siempre el funcionamiento con pruebas reales desde dispositivos y redes representativas del uso diario.
Soporte profesional

¿Buscas una implantación personalizada?

Si prefieres que realicemos la instalación en tu servidor, necesitas parametrización avanzada o quieres un desarrollo a medida para tu empresa, podemos valorarlo.

Solicitar presupuesto