AssetFlow 01 / PREPARACIÓN
Antes de empezar
AssetFlow se instala en tu propio servidor. La compra se realiza en Codester; el hosting, el dominio y el proveedor de correo se contratan por separado.
El paquete incluye el código PHP, dependencias de producción, recursos compilados, instalador y documentación técnica en inglés. No incluye cuentas compartidas, credenciales de administrador ni datos de tu empresa.
Requisitos del servidor
- PHP 8.3 o superior compatible con las dependencias del paquete, con acceso a PHP por consola.
- MySQL 8 o superior y una base de datos nueva, vacía y dedicada. El instalador no tiene certificación para MariaDB.
- HTTPS y raíz pública del sitio apuntando a
assetflow/public. - Extensiones PHP: ctype, curl, dom, fileinfo, filter, gd, hash, mbstring, openssl, PDO/pdo_mysql, session, tokenizer, xml, xmlreader y zip.
- Permisos de escritura para PHP en
storage,bootstrap/cachey, durante la instalación, en el directorio de la aplicación. - Un programador de tareas que ejecute el scheduler cada minuto y una cuenta SMTP para correos.
02 / PUESTA EN MARCHA
Instalar AssetFlow
- Descarga y extrae el paquete. Obtén tu copia desde Codester y extrae la aplicación en un directorio privado. Configura el dominio para servir únicamente su carpeta
public. - Prepara MySQL. Crea una base de datos vacía con utf8mb4 y un usuario dedicado con permisos para crear las tablas de esa base.
- Habilita el instalador. Desde el directorio raíz de la aplicación ejecuta:
El comando muestra un secreto de instalación. Consérvalo de forma privada y abrephp scripts/prepare-install.phphttps://tu-dominio.example/installen el plazo de una hora. No crees un archivo.envni ejecutes migraciones antes del asistente. - Completa el asistente. Elige español o inglés, resuelve los requisitos pendientes e introduce la conexión a MySQL, empresa, URL HTTPS, idioma, zona horaria y primer administrador. Usa una contraseña única de al menos 12 caracteres, con letras y números.
- Inicia sesión. Al finalizar, el instalador crea la configuración y cierra el acceso a instalación. Ingresa con el administrador que acabas de crear.
INSTALLER_UPDATER en la documentación del paquete. No borres los marcadores de instalación ni regeneres APP_KEY para reintentar.03 / AUTOMATIZACIÓN
Correo y tareas automáticas
Configurar correo
En Configuración, abre la sección de entrega de correo, habilita SMTP y completa host, puerto, transporte, usuario, credencial y remitente según tu proveedor. Guarda, envía el correo de prueba y confirma que llegue a la bandeja o a spam.
Las notificaciones automáticas de mantenimiento requieren que el SMTP de la organización esté habilitado. La aceptación por el servidor SMTP no garantiza que el mensaje haya llegado a la bandeja.
Ejecutar el scheduler cada minuto
En Linux, configura una tarea cron con las rutas reales de tu servidor:
* * * * * cd /ruta/privada/assetflow && /usr/bin/php artisan schedule:run >> storage/logs/cron.log 2>&1En Windows, utiliza el Programador de tareas para ejecutar php.exe artisan schedule:run cada minuto, con el directorio de trabajo de la aplicación y sin solapar ejecuciones.
La opción predeterminada ASSETFLOW_CRON_WORKER=true ejecuta un trabajador de cola acotado desde el scheduler. Si administras un trabajador supervisado por separado, usa false para evitar mezclar ambos modos.
Tras dos ciclos, revisa Administración → Salud del sistema. También puedes consultar:
php artisan assetflow:health04 / TU EMPRESA
Primeros pasos
- Configura la empresa. Revisa nombre, idioma, zona horaria, moneda y formato de fecha. Otros usuarios conservan sus preferencias personales.
- Organiza tus activos. Crea ubicaciones y categorías; registra los equipos, sus responsables y los documentos o fotografías necesarios.
- Invita a tu equipo. Crea usuarios y asigna los roles adecuados. Los técnicos deben trabajar con sus propias cuentas.
- Publica una primera orden. Selecciona un activo, prioridad, fechas y responsables. Comprueba que el técnico la vea en Mi trabajo.
- Revisa calendario y reportes. Aplica los filtros de fecha y estado que necesites. Los costes se agrupan por moneda.
05 / TRABAJO DIARIO
Órdenes de trabajo
Crea un borrador desde Órdenes de trabajo o desde un activo. Define tipo, prioridad, fechas, asignados y lista de verificación antes de publicar.
Durante la ejecución puedes responder la lista, adjuntar evidencia y registrar comentarios, tiempos y costes según tus permisos. Completa las respuestas obligatorias antes de cerrar la orden.
Una pausa requiere un motivo y debe reanudarse antes de seguir registrando ejecución. Las órdenes completadas o canceladas conservan su historial y no se reabren. La disponibilidad de acciones depende del rol y del estado.
06 / PLANIFICACIÓN
Mantenimiento preventivo
Crea un plan para un activo, elige su recurrencia, fecha inicial, zona horaria y responsables. Verifica el scheduler antes de confiar en la generación automática.
Los planes por contador dependen de lecturas registradas: generan órdenes al alcanzar los umbrales configurados. Las lecturas son acumulativas; los reinicios y correcciones de contador no están implementados.
07 / EN CAMPO
Móvil y códigos QR
Abre la dirección HTTPS de tu instalación en Chrome para Android e inicia sesión. Cuando el navegador lo permita, utiliza Instalar o Añadir a la pantalla de inicio para crear un acceso.
Escanea el QR de un activo y autentícate si se solicita. Los permisos de usuario siguen aplicándose. Puedes buscar manualmente si no utilizas la cámara.
08 / CONTINUIDAD
Copias y actualizaciones
Respalda juntos la base de datos, el archivo .env con su APP_KEY, los archivos privados y la versión correspondiente de la aplicación. Guarda las copias fuera de la raíz pública y comprueba su restauración en un entorno aislado.
Antes de actualizar, detén las tareas programadas y los trabajadores, activa mantenimiento y verifica la copia de seguridad. Sigue el procedimiento INSTALLER_UPDATER del paquete, conservando configuración y archivos privados.
No utilices el asistente de instalación nueva sobre una base existente. No regeneres APP_KEY: protege secretos cifrados de tu instalación. Comprueba acceso, archivos y salud del sistema antes de volver a habilitar el servicio.
09 / DIAGNÓSTICO
Resolver problemas
El instalador devuelve 404
Puede no estar habilitado, haber caducado o estar cerrado después de un intento. Comprueba si es una instalación nueva y consulta el procedimiento de recuperación del paquete.
No llegan correos o recordatorios
Confirma SMTP en la organización y la llegada del mensaje de prueba. Para automatizaciones, revisa scheduler, trabajador y trabajos fallidos en Salud del sistema.
El idioma no coincide con el de la empresa
Las preferencias personales tienen prioridad sobre el valor predeterminado de la organización. Revisa el idioma de la cuenta que inició sesión.
Una orden no aparece para un técnico
Comprueba que esté publicada, que el técnico esté asignado y activo, y que tenga permisos para verla. Un técnico no recibe acceso global a todos los activos por defecto.
Error 500 o problemas de sesión
Revisa los registros privados y Salud del sistema. Comprueba URL canónica, HTTPS, alcance de cookies y permisos de escritura. Mantén desactivado el modo de depuración público.
Una carga de archivos se rechaza
Revisa el tipo permitido, las dimensiones de imagen, el límite de la aplicación y los límites de carga y petición de PHP.
10 / AYUDA
Documentación incluida y soporte
Esta guía resume el paquete 0.9.0-rc.1. Para procedimientos técnicos completos, abre docs/html/BUYER_GUIDE.html en la aplicación descargada y consulta las guías enlazadas de instalación, despliegue, permisos, API e integraciones.
Al solicitar ayuda, indica versión, PHP/MySQL, tipo de hosting, pasos y un error sin datos sensibles. No publiques contraseñas, tokens, archivos .env ni bases de datos de clientes.