🖥️ Mantenimiento preventivo
Objetivo Principal: Definir planes que crean solos las tareas de mantenimiento recurrente de un equipo —con su título, su checklist y su prioridad ya preparados— para que el trabajo periódico no dependa de que alguien se acuerde de darlo de alta.
Esta página describe una pantalla que aún no está fotografiada en el manual, así que el despiece no numera los elementos sobre una imagen. Lo que se cuenta aquí está contrastado con la versión 0.4.46 de la aplicación.
El listado de planes de mantenimiento preventivo no aparece en el menú lateral ni tiene enlace desde ninguna otra pantalla de la versión 0.4.46, y el copiloto tampoco puede abrirlo. Hoy solo se llega a él con el enlace directo, que debe facilitar el administrador de la plataforma. Lo que sí está señalizado es lo que llega después: las tareas que estos planes generan aparecen en Tareas como cualquier otra y se trabajan desde su panel de detalle.
🧩 Despiece de Elementos Funcionales
| Nombre del Elemento | Tipo | Destino / Acción | Descripción Funcional |
|---|---|---|---|
| Título "Planes de mantenimiento preventivo" | Cabecera | — | Encabeza la pantalla. A su derecha, en gris, el recuento de planes dados de alta ("4 planes", "1 plan"). |
| Botón "Generar tareas ahora" | CTA Secundario | Crear en el momento las tareas vencidas | Recorre todos los planes activos y crea la tarea de los que ya han vencido. Al terminar avisa con "Tareas generadas" y el número creado; si falla, con "Error al generar tareas" y el motivo. Es la única forma de que un plan produzca tareas: la plataforma no las genera sola en segundo plano. |
| Botón "Crear plan" | CTA Principal | Abrir la ventana de alta | Abre la ventana "Nuevo plan PM" con el formulario en blanco. |
| Tabla de planes | Tabla de datos | Consultar y editar los planes | Columnas Nombre, Equipo, Disparador, Próximo vencimiento y Estado. "Equipo" muestra el identificador del equipo asociado, o un guion si el plan no está ligado a ninguno. "Disparador" resume la regla en una frase ("Cada 30 días (flotante)", "Cada 500 unidades en ..."). "Próximo vencimiento" es la fecha en la que toca, en formato día/mes/año. |
| Distintivo de estado del plan | Indicador de estado | — | Última columna de cada fila: "Activo" en verde cuando el plan está en marcha y "Pausado" en gris cuando no. Solo los planes activos entran en la generación de tareas. |
| Botón de edición de la fila | Acción | Abrir la ventana de edición | Icono de lápiz al final de cada fila. Abre la ventana "Editar plan PM" con los datos del plan cargados. |
| Estado vacío "Sin planes PM" | Mensaje de estado | Crear el primer plan | Cuando no hay ningún plan, la pantalla muestra "Sin planes PM" con el texto "Aún no hay planes de mantenimiento preventivo. Crea el primero para empezar a programar tareas automáticas." y el botón "Crear el primero". |
| Aviso de error del listado | Mensaje de estado | Reintentar | Banda roja con el texto "Error cargando los planes. Intenta de nuevo." y un botón "Reintentar" que vuelve a pedir el listado sin recargar la pantalla. |
| Ventana "Nuevo plan PM" / "Editar plan PM" — datos generales | Ventana modal | Identificar el plan | "Nombre del plan" es obligatorio (si se deja vacío avisa con "El nombre es obligatorio"). "Descripción" es libre. "Equipo (asset_id)" es un buscador de equipos con el texto de ayuda "Buscar equipo o dejar vacío". "Lead time (días)" adelanta la creación de la tarea los días que se indiquen respecto al vencimiento. La casilla "Plan activo" viene marcada; al desmarcarla el plan queda pausado. |
| Ventana "Nuevo plan PM" — bloque "Disparador" | Sección del formulario | Definir cuándo toca | "Tipo" ofrece "Tiempo (cada N días/semanas/meses)", "Contador (cada N unidades)" y "Evento (stub)". "Anclaje" ofrece "Fijo (schedule no se desplaza)" —la cadencia se cuenta desde el vencimiento anterior, aunque la tarea se haga tarde— y "Flotante (desde la última completada)". Con tipo "Tiempo" aparecen "Intervalo" y "Unidad" (Días, Semanas, Meses); con tipo "Contador", "Variable / Medidor (meter_ref)" y "Umbral (threshold)", con la ayuda "Incremento acumulado que activa el plan". |
| Ventana "Nuevo plan PM" — bloque "Plantilla de tarea generada" | Sección del formulario | Definir la tarea que se creará | Todo lo que tendrá la tarea cuando se genere: "Título de la tarea" (obligatorio), "Descripción de la tarea", "Tipo de tarea" (Mantenimiento, Inspección, Calibración, Otro), "Prioridad" (Baja, Media, Alta, Crítica), "Categoría" (General, Eléctrico, Mecánico, Hidráulico, Neumático, Seguridad), "Checklist (una línea por ítem)" —cada línea del recuadro se convierte en un punto del checklist— y "Duración estimada (min)". |
| Botones de la ventana | Acciones | Guardar o descartar | "Cancelar" cierra sin guardar. El botón principal es "Crear plan" en el alta y "Guardar cambios" en la edición; al terminar avisa con "Plan creado" o "Plan actualizado", y con "No se pudo guardar el plan" si algo falla. |
| Botón "Generar plan IA" de la ficha de un equipo | CTA Secundario | Proponer un checklist con IA | Vive en la pestaña "Tareas" de la ficha de cada equipo, en Equipos, y solo lo ven los perfiles con permiso de edición: Mantenimiento, Administrador y Admin Global. Abre la ventana "Generar plan de mantenimiento con IA", donde se elige "Tipo de tarea" (Mantenimiento, Inspeccion, Incidencia) y se escribe el "Tipo de equipo" (con la ayuda "Ej: bomba, motor, compresor..."); "Generar checklist" propone los puntos, que pueden quitarse uno a uno, y "Crear tarea con checklist" crea la tarea, ya asociada al equipo y marcada con la etiqueta "IA". Crea una única tarea, no un plan recurrente. |
💡 Guía de Uso
Los planes de mantenimiento preventivo están reservados a los perfiles Mantenimiento, Administrador y Admin Global. Quien puede abrir la pantalla puede además crear y editar planes y lanzar la generación de tareas; los perfiles Usuario no tienen acceso.
Un plan es una plantilla con fecha. Se compone de dos mitades: el disparador, que dice cuándo toca, y la plantilla de tarea generada, que dice qué se creará cuando toque. Al guardar un plan de tipo "Tiempo", la plataforma calcula el primer vencimiento sumando el intervalo indicado a la fecha de alta, y lo muestra en la columna "Próximo vencimiento". Cada vez que el plan produce una tarea, esa fecha avanza: con anclaje "Fijo" se cuenta desde el vencimiento anterior, de modo que un retraso no desplaza el calendario; con anclaje "Flotante" se cuenta desde el momento en que se generó la tarea.
En la versión 0.4.46 solo el disparador "Tiempo" llega a generar tareas. Los tipos "Contador" y "Evento" se pueden guardar y se ven en el listado, pero no producen nada todavía; un plan configurado así se queda esperando indefinidamente.
Y la generación no es automática: aunque un plan esté activo y vencido, la tarea no aparece hasta que alguien pulsa "Generar tareas ahora". Conviene fijar una rutina —por ejemplo, al empezar la semana— y dejarla asignada a una persona.
El recorrido normal es este. Pulsa "Crear plan"; ponle un nombre reconocible ("Mantenimiento mensual del compresor" es mejor que "Plan 3"); asocia el equipo desde el buscador "Equipo (asset_id)" para que la tarea nazca ya ligada a él; en "Disparador" elige "Tiempo", escribe el intervalo y su unidad y decide el anclaje; y en "Plantilla de tarea generada" escribe el título que quieres ver luego en el tablero de tareas y pega el checklist, una línea por punto. Si quieres que la tarea aparezca con antelación —para poder prepararla—, usa "Lead time (días)": con 3, la tarea se crea tres días antes de la fecha de vencimiento. Guarda con "Crear plan".
Para comprobar que ha funcionado, mira la columna "Próximo vencimiento" del plan recién creado: si está vacía, el disparador no es de tipo "Tiempo" o le falta el intervalo, y ese plan no generará nada. Cuando llegue la fecha, pulsa "Generar tareas ahora": el aviso te dirá cuántas tareas se han creado. Si dice cero teniendo planes vencidos, revisa que estén marcados como "Activo" y que su disparador sea de tiempo.
Las tareas creadas no se quedan en esta pantalla: aparecen en Tareas, en el listado y en el tablero, con el título, la descripción, el checklist, la prioridad, la categoría y el equipo que definiste en la plantilla, y con la fecha de vencimiento del plan como fecha límite. A partir de ahí se asignan, se trabajan y se cierran igual que una tarea creada a mano, tal como se explica en Crear Tarea. Un detalle a tener en cuenta al cerrarlas: hoy la tarea generada no guarda una marca visible que la distinga de las demás, así que si necesitas identificarlas de un vistazo, dales en la plantilla un título con un prefijo propio.
Conviene no confundir dos cosas que suenan parecido. El plan de mantenimiento preventivo es recurrente: se configura una vez y produce una tarea cada vez que vence. El botón "Generar plan IA" de la pestaña "Tareas" de la ficha de un equipo hace algo distinto y puntual: propone con inteligencia artificial un checklist adecuado al tipo de equipo y crea una sola tarea con él, sin repetición ni fecha futura. Es un buen atajo para preparar el contenido de un mantenimiento; si quieres que se repita, copia ese checklist en la plantilla de un plan.