🖥️ Equipos

Objetivo Principal: Mantener el catálogo de los activos de la instalación —qué equipos hay, de qué tipo son, en qué estado están y qué importancia tienen— y reunir en la ficha de cada uno sus tareas, sus alarmas, su documentación y su bitácora.

Todavía sin captura

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.

Se llega desde la pestaña "Equipos" de la barra de pestañas de Cuenta. La pestaña la ven todos los perfiles: cualquier usuario con acceso puede consultar el catálogo y abrir la ficha de un equipo. Lo que cambia con el perfil son las acciones: crear equipos, crear tareas desde la pestaña "Tareas", generar un plan con IA, subir documentación y escribir en la bitácora solo está al alcance de los perfiles Mantenimiento, Administrador y Admin Global. Con el perfil Usuario esos botones no llegan a mostrarse.

🧩 Despiece de Elementos Funcionales

Catálogo de equipos

Nombre del Elemento	Tipo	Destino / Acción	Descripción Funcional
Pestaña "Equipos"	Navegación por pestañas	Abrir el catálogo	Punto de entrada a la pantalla desde la barra de pestañas de Cuenta, que se mantiene visible en la parte superior del catálogo para volver a cualquier otra sección de la cuenta.
Título "Equipos" y contador	Encabezado informativo	—	Encabeza la pantalla e indica, a su derecha, cuántos equipos devuelve el listado con los filtros aplicados, en la forma “N equipos”.
Botón "Crear equipo"	Botón de acción	Abrir la ventana de alta	Abre la ventana “Crear equipo” para dar de alta un activo en el catálogo. Solo se muestra a los perfiles Mantenimiento, Administrador y Admin Global.
Desplegable de estado	Filtro	Acotar el listado por estado	Filtra el catálogo por la situación del equipo. Opciones: “Todos los estados”, “Planificado”, “Activo”, “En mantenimiento” y “Retirado”. Al cambiarlo, el listado vuelve a la primera página.
Desplegable de tipo	Filtro	Acotar el listado por tipo de activo	Filtra el catálogo por la naturaleza del activo. Opciones: “Todos los tipos”, “Maquina”, “Linea”, “Aula”, “HVAC”, “Sensor group” y “Otro”. Al cambiarlo, el listado vuelve a la primera página.
Aviso de activos sin ficha	Aviso destacado con acción	Abrir la ventana de alta	Franja azul que aparece cuando la plataforma detecta activos que ya están enviando datos pero no tienen ficha en el catálogo: “Se detectaron N activos con telemetría sin ficha de equipo.”. Incluye el botón “Crear ficha”, que abre la misma ventana “Crear equipo”, donde esos activos aparecen como sugerencias. Solo se muestra a los perfiles con permiso de edición.
Tabla de equipos	Tabla	Consultar el catálogo	Lista los equipos con las columnas “Asset ID”, “Nombre”, “Tipo”, “Estado”, “Criticidad”, “Fabricante” y “Variables”. El estado y la criticidad se muestran como etiquetas de color; el fabricante y las variables muestran un guion cuando no hay dato.
Fila de equipo	Fila pulsable	Abrir la ficha del equipo	Al pulsar cualquier punto de la fila se abre la ficha completa de ese equipo.
Paginación	Controles de navegación	Recorrer el catálogo	El listado muestra 25 equipos por página. Cuando hay más, aparecen debajo el indicador “Página N de M” y los botones “Anterior” y “Siguiente”, desactivados en los extremos.
Estado sin resultados	Estado vacío	—	Cuando ningún equipo coincide con los filtros aparece “Sin equipos” y el texto “Aún no hay equipos registrados con estos filtros.”. A los perfiles con permiso de edición se les ofrece además el botón “Crear el primero”.
Estado de error	Aviso de error	Reintentar la consulta	Si el catálogo no puede cargarse aparece el mensaje “Error cargando equipos. Intenta de nuevo.”.

Ventana "Crear equipo"

Nombre del Elemento	Tipo	Destino / Acción	Descripción Funcional
Campo "Asset ID"	Campo de texto con sugerencias	Identificar el activo	Identificador único del equipo dentro del catálogo. Obligatorio. El desplegable propone los activos detectados que aún no tienen ficha, indicando el nombre sugerido y cuántas variables envían; también se puede escribir uno nuevo (marcador de posición “Ej: MAQ08_EMBALADORA”). Admite letras, números, guion, guion bajo y punto, hasta 128 caracteres; si se incumple, avisa con “Solo letras, numeros, guion, guion bajo y punto (max 128)”. Si ya existe un equipo con ese identificador, avisa con “Ya existe un equipo con ese asset_id”.
Aviso de variables detectadas	Aviso informativo	—	Al elegir uno de los activos sugeridos aparece la línea “Variables detectadas: …” con las señales que ese activo ya está enviando, y se rellenan solos el nombre propuesto y el tipo.
Campo "Nombre"	Campo de texto	Nombrar el equipo	Nombre con el que se verá el equipo en el resto de la plataforma (marcador de posición “Ej: Embaladora Linea 1”). Obligatorio.
Desplegable "Tipo"	Selector	Clasificar el activo	Naturaleza del activo: “Maquina”, “Linea”, “Aula”, “HVAC”, “Sensor group” u “Otro”. Obligatorio; por defecto “Maquina”.
Campos "Sitio (site_id)" y "Dominio (domain_id)"	Campos de texto	Situar el equipo	Emplazamiento y ámbito al que pertenece el equipo. Ambos son obligatorios y vienen rellenados con los valores de la instalación cuando la plataforma puede deducirlos.
Botón "Mas opciones"	Botón de despliegue	Mostrar u ocultar los campos avanzados	Despliega los campos opcionales; una vez abierto, pasa a llamarse “Ocultar opciones avanzadas”.
Desplegable "Estado"	Selector (avanzado)	Fijar la situación del equipo	“Planificado”, “Activo”, “En mantenimiento” o “Retirado”. Por defecto “Activo”.
Desplegable "Criticidad"	Selector (avanzado)	Fijar la importancia del equipo	Escala de cuatro niveles: “P1 - Critico”, “P2 - Alto”, “P3 - Medio” y “P4 - Bajo”. Por defecto “P3 - Medio”. Es el valor que después ordena la atención en alarmas y tareas.
Campos "Fabricante", "Modelo" y "Ubicacion"	Campos de texto (avanzados)	Completar la ficha	Datos descriptivos opcionales. La ubicación admite texto libre (marcador de posición “Ej: Linea 1, sector embalaje”).
Botones "Cancelar" y "Crear equipo"	Botones de acción	Descartar o guardar el alta	“Cancelar” cierra la ventana sin guardar. “Crear equipo” da de alta el activo; la confirmación llega como el aviso “Equipo creado”. Si falla, aparece “No se pudo crear el equipo” con el motivo.

Ficha de un equipo

Nombre del Elemento	Tipo	Destino / Acción	Descripción Funcional
Botón de volver	Botón de acción	Regresar al catálogo	Flecha situada a la izquierda de la cabecera, con la etiqueta accesible “Volver”. La ficha no muestra la barra de pestañas de Cuenta, así que este botón es la vía para volver al catálogo.
Cabecera de la ficha	Panel informativo	—	Reúne el nombre del equipo, su identificador, su estado y su criticidad como etiquetas de color y, debajo, el fabricante, el modelo y el emplazamiento. Cuando no hay fabricante registrado se lee “Sin fabricante”.
Aviso de equipo planificado	Aviso informativo	—	Franja amarilla que aparece solo si el equipo está en estado planificado: “Este equipo esta en estado planificado — el sensor aun no esta instalado o no publica telemetria.”.
Aviso de fuentes no disponibles	Aviso informativo	—	Franja naranja con el texto “Algunas fuentes de datos no estan disponibles” y el detalle de cuáles. Indica que parte de la información de la ficha —alarmas, tareas, documentos— puede estar incompleta en ese momento.
Pestañas de la ficha	Navegación por pestañas	Cambiar de sección dentro del equipo	Seis pestañas: “Resumen”, “Operacion”, “Tareas”, “Alarmas”, “Conocimiento” y “Bitácora”. Se abre siempre en “Resumen”.
Pestaña "Resumen"	Panel de contenido	—	Cuando el equipo tiene datos, empieza con las tarjetas “Tareas abiertas”, “Alarmas activas”, “Alarmas 24h”, “MTTA (min)” y “MTTR (min)”, y sigue con “Variables en vivo”, que lista las señales del equipo con su último valor. Después vienen siempre los bloques de datos “Identidad”, “Comercial”, “Ciclo de vida”, “Fisico”, “Ownership”, “Telemetria” y “Tags”. Los campos sin dato muestran un guion.
Pestaña "Operacion"	Panel de contenido	Actuar sobre el día a día del equipo	Ofrece los botones “Crear tarea para este equipo” y “Ver todas las tareas” —este último abre la lista de tareas ya filtrada por el equipo— y tres listas con su contador: “Alarmas activas”, “Tareas abiertas” y “Eventos programados”. Cada lista muestra como mucho diez elementos y, si no hay ninguno, el texto correspondiente (“Sin alarmas activas asociadas a este equipo.”, “Sin tareas abiertas para este equipo.” o “Sin eventos programados para este equipo.”).
Pestaña "Tareas"	Panel de contenido	Gestionar las tareas del equipo	Lista las tareas abiertas del equipo con su estado, su prioridad y su fecha de vencimiento; al pulsar una se abre su detalle. Encabezándola, y solo para los perfiles con permiso de edición, los botones “Crear tarea” y “Generar plan IA”. Si no hay ninguna, se lee “Sin tareas abiertas para este equipo.”.
Ventana "Generar plan de mantenimiento con IA"	Ventana de asistente	Proponer y crear una tarea con checklist	Se abre con “Generar plan IA”. Se elige el “Tipo de tarea” (“Mantenimiento”, “Inspeccion” o “Incidencia”) y se ajusta el “Tipo de equipo” —viene propuesto y admite descripciones genéricas como bomba, motor o compresor—. El botón “Generar checklist” devuelve una propuesta de pasos bajo el rótulo “Checklist propuesto (N)”, cada uno con un botón para quitarlo. “Crear tarea con checklist” crea la tarea ya vinculada al equipo y etiquetada como IA; permanece desactivado mientras no haya ningún paso. Lo que produce es una única tarea, no una programación que se repita: el mantenimiento recurrente se define desde los planes de mantenimiento preventivo. Si la propuesta viene vacía avisa con “Sin sugerencias para ese tipo”, y si el servicio no responde, con “No se pudo generar el plan”.
Pestaña "Alarmas"	Panel de contenido	Consultar las alarmas del equipo	Muestra las tarjetas “Activas”, “Alarmas 24h”, “MTTA (min)” y “MTTR (min)” y, debajo, dos listas con su contador: “Activas” e “Historial reciente”. Al pulsar una alarma se abre su detalle en el centro de alarmas. Sin datos se leen “Sin alarmas activas para este equipo.” y “Sin historial de alarmas.”.
Pestaña "Conocimiento"	Panel de contenido	Reunir la documentación del equipo	Se divide en “Manuales y documentos”, con lo que ya está indexado del equipo, y “Conocimiento curado (Brain)”, con las entradas escritas a mano. Si no hay documentos se lee “Sin documentos indexados. Sube un manual para que el copilot lo cite.”, y si no hay entradas curadas, “Sin conocimiento curado todavia. Anade procedimientos, contactos o excepciones.”.
Subida de documentación	Zona de carga	Añadir un manual al equipo	Recuadro “Subir manual o documentación” con el botón “Seleccionar archivo”. Admite PDF, Markdown, HTML y texto. Al terminar confirma con “Documento ingerido”; si falla, avisa con “No se pudo subir el documento” y “Revisa el formato o intenta de nuevo”. Solo se muestra a los perfiles con permiso de edición.
Botón "Anadir al Brain"	Botón de acción	Escribir conocimiento propio del equipo	Abre un formulario con “Titulo” y “Contenido” —texto libre con formato Markdown, pensado para pasos, contactos y excepciones— que se guarda con “Guardar en el Brain”. Ambos campos deben estar rellenos. Solo para los perfiles con permiso de edición.
Pestaña "Bitácora"	Panel de contenido	Registrar lo que le pasa al equipo	Cronología de notas, cada una con su tipo, su autor y su fecha. Si no hay ninguna se lee “Sin notas todavia. Las notas se indexan en el conocimiento del equipo.”.
Formulario de nota	Formulario	Añadir una entrada a la bitácora	Un desplegable “Tipo de nota” (“Observacion”, “Incidencia”, “Mantenimiento” o “Inspeccion”), un área de texto y el botón “Anadir nota”, que permanece desactivado mientras el texto esté vacío. La confirmación llega como “Nota anadida”. Solo aparece a los perfiles con permiso de edición, que son también los únicos que ven el botón de papelera para borrar una nota.

💡 Guía de Uso

Entra en Cuenta y abre la pestaña “Equipos”. La pantalla arranca con el catálogo completo, ordenado en una tabla y acompañado del número de equipos que devuelve. Para acotarlo, usa los dos desplegables de la parte superior: el de estado —para dejar fuera, por ejemplo, lo que ya está retirado— y el de tipo, para quedarte solo con las máquinas, con las líneas o con las aulas. Cada cambio devuelve el listado a la primera página, y si la combinación no deja nada verás “Sin equipos”.

Si el aviso azul te dice que hay activos enviando datos sin ficha de equipo, merece la pena atenderlo: significa que la instalación está midiendo algo que el catálogo todavía no nombra, de modo que sus alarmas y sus tareas no pueden agruparse por equipo. Pulsa “Crear ficha”, despliega el campo “Asset ID” y elige uno de los activos propuestos; el nombre y el tipo se rellenan solos y verás la lista de variables que ya llegan de él. Completa lo que falte —el nombre es lo que leerá el resto de la organización—, revisa en “Mas opciones” el estado y la criticidad, y pulsa “Crear equipo”. La criticidad no es decorativa: es la escala de P1 a P4 que después ordena a qué se atiende primero.

Con el equipo dado de alta, pulsa su fila para abrir la ficha. “Resumen” es la foto fija: los indicadores de carga de trabajo y de alarmas, las variables con su último valor y todos los datos registrados del activo. “Operacion” es la foto del momento: qué alarmas tiene abiertas, qué tareas quedan pendientes y qué hay programado, con acceso directo a crear una tarea ya vinculada al equipo. Ten en cuenta que la ficha no dispone hoy de un botón para editar ni para borrar el equipo: los datos que se ven son los que se registraron al crearlo.

Para el mantenimiento planificado, abre “Tareas” y pulsa “Generar plan IA”. Elige el tipo de tarea, describe en una palabra de qué clase de equipo se trata y pulsa “Generar checklist”: la propuesta aparece como una lista numerada de la que puedes quitar los pasos que no apliquen. Solo cuando quede algo en la lista se activa “Crear tarea con checklist”, que crea la tarea vinculada al equipo. Comprueba el resultado en la propia pestaña “Tareas”, donde la tarea nueva aparece de inmediato, o en la gestión de tareas si prefieres verla junto al resto; el formulario completo de alta está descrito en Nueva Tarea.

Las dos últimas pestañas son las que hacen que la ficha valga con el tiempo. En “Conocimiento” se suben los manuales del fabricante y se escriben los procedimientos propios, y en “Bitácora” se anota lo que va ocurriendo, clasificado como observación, incidencia, mantenimiento o inspección. Todo lo que se guarda ahí queda asociado al equipo y disponible para consultarlo desde la propia ficha. Si el asistente de la plataforma está activo en tu instalación, además reconoce el equipo que tienes abierto y puede resumir su estado, proponer un plan de mantenimiento o anotar una nota en la bitácora; en los dos últimos casos siempre te pedirá confirmación antes de escribir nada.

Si alguna acción no aparece donde la esperas, lo más probable es que sea cuestión de permisos: el catálogo y las fichas están abiertos a todos los perfiles, pero crear equipos, subir documentación y escribir en la bitácora requiere el perfil Mantenimiento o superior. La configuración técnica de las señales que alimentan a estos equipos está en Señales, una pestaña aparte con sus propias restricciones.