Guía de Uso por Roles y Protocolos de Calidad
Este documento detalla todas las herramientas activas en la plataforma, qué acciones tiene permitidas cada rol y el paso a paso exacto para ejecutarlas.
Perfil: Administrador / Dirección General
Acceso total a finanzas, configuración, IA, RRHH y control global.
A. Configuración Global y Fiscalidad (`/ajustes`)
Configura la razón social, CIF, tipos de IVA/IGIC por defecto, y vincula las credenciales de Google Calendar y tokens de WhatsApp/Telegram.
B. Gestión de Usuarios y Tarifas Horarias (`/users`)
Alta y baja de empleados. Es fundamental asignar el Coste por Hora (€/h) a cada operario para que el ERP compute automáticamente los costes reales de mano de obra en cada orden.
C. Control Analítico de Costes y Margen (`/costes/margen`)
Supervisa en tiempo real el Margen Bruto y EBITDA mensual (Facturación Neta vs Costes Fijos + Costes Variables Directos e Indirectos).
Perfil: Gobernanta / Jefatura de Operaciones
Planificación de cuadrantes, rutas óptimas, auditoría visual y validación de check-in.
A. Cuadrante Semanal y Optimización de Rutas (`/cuadrante`)
1. Asignar servicios a las operarias en el cuadrante interactivo.
2. Pulsar `⚡ Optimizar Rutas IA` para agrupar villas por cercanía GPS (Haversine) y sincronizar al instante con Google Calendar.
3. Descargar el `Parte Diario` en PDF para el equipo.
B. Auditoría Visual con Zilo Vision IA (`/ordenes/{id}`)
Al terminar un servicio, pulsar `🤖 Auditar Calidad con IA`. La visión artificial revisa lencería, mamparas y grifos, calificando de 0 a 100% antes de autorizar el check-in del huésped.
C. Aprobación de Vacaciones (`/vacaciones/admin`)
Revisión de solicitudes con conteo automático de días hábiles descontando festivos de España. Aprobación o denegación con 1 clic.
Perfil: Finanzas & Comercial
Presupuestos inteligentes, cotizaciones con margen garantizado y facturación oficial.
A. Emisión de Cotizaciones y Facturas (`/comercial/facturas`)
Crear facturas con desglose automático de IVA/IGIC y retenciones. Generación y descarga de PDF oficial con 1 clic.
B. Imputación de Gastos Fijos y Proveedores (`/costes`)
Registrar facturas de compras, alquileres, suministros o consumibles generales para mantener actualizado el PyG.
Perfil: Jefe de Obra & Reformas
Control predictivo de gasto, tickets de materiales, subcontratas y benchmark de presupuestos.
A. Seguimiento y Escenarios Predictivos (`/reformas/{id}`)
El panel Zilo AI proyecta 3 escenarios (Optimista, Esperado, Pesimista) correlacionando el ritmo actual de gasto con obras anteriores. Alerta si las compras de fontanería o albañilería van con sobrecoste.
B. Registro de Gastos y Facturas de Almacén (`/reformas/{id}/gastos`)
Subir fotos de albaranes de Leroy Merlin / ferretería asignando la categoría (materiales, mano de obra, subcontrata). El coste real se actualiza en vivo.
C. Benchmark de Presupuestos Futuros Ideales
Al presupuestar una nueva obra, Zilo AI sugiere el reparto ideal (40% mano de obra, 38% materiales, 14% subcontrata, 8% contingencia) y fija el PVP recomendado para garantizar un 30% de beneficio neto.
Perfil: Operario / Personal de Limpieza y Mantenimiento
Operativa diaria sin pantallas: fichaje GPS y partes de trabajo por WhatsApp.
A. Fichaje Móvil con Geolocalización GPS (`/fichaje`)
Al llegar a la villa, pulsar `Iniciar Jornada`. Al terminar el turno, pulsar `Cerrar Jornada`. Cumplimiento legal automático.
B. Notificación de Fin de Servicio por WhatsApp
Enviar un audio por WhatsApp al bot de Zilo: "Zilo, acabo de terminar Villa Roma, todo limpio y llaves en el cajetín".
Guía de Comandos de Voz & WhatsApp con Zilo AI
Ejemplos de frases naturales que Zilo AI entiende y ejecuta en la base de datos.
"Zilo, ¿cómo va el gasto de la reforma REF-2609-001 y qué escenario proyectas?"
"Zilo, calcúlame el presupuesto ideal para una reforma con 12.000€ de coste base y margen del 35%."
"Zilo, la bomba AstralPool de Villa Iconic da error E04, ¿cómo purgo el filtro?"
"Zilo, ¿cuántos días de vacaciones me quedan y solicita del 15 al 20 de octubre?"