> ## Documentation Index
> Fetch the complete documentation index at: https://docs.oxygen.tech/llms.txt
> Use this file to discover all available pages before exploring further.

# Activos

> Registrá y gestioná los equipos de tu planta con jerarquía, parámetros e indicadores de confiabilidad.

## ¿Qué es un Activo?

Un activo es cualquier equipo, máquina o instalación que requiere mantenimiento. En Pulse, cada activo tiene su propio historial de órdenes, indicadores de confiabilidad, parámetros medibles y documentación adjunta.

Puedes organizar los activos en una jerarquía (activo padre → hijo → nieto) que refleja la estructura real de tu planta.

<Tabs>
  <Tab title="Creación">
    ## Crear un activo

    <Steps>
      <Step title="Ir a Gestión de Activos > Activos">
        Haz clic en **Nuevo activo**.
      </Step>

      <Step title="Datos de identificación">
        Completa nombre, fabricante, modelo y número de serie.
      </Step>

      <Step title="Clasificación">
        Asigna tipo, criticidad y estado operativo actual del activo.
      </Step>

      <Step title="Ubicación y jerarquía">
        Asigna la ubicación física y, si corresponde, el activo padre (para crear la jerarquía).
      </Step>

      <Step title="Fecha de instalación">
        Registra cuándo fue instalado el equipo. Es útil para calcular antigüedad y planificar reemplazos.
      </Step>

      <Step title="Propiedades personalizadas">
        Si tu tipo de activo tiene campos específicos (potencia, voltaje, presión máxima, etc.), completalos en la sección de propiedades de clase.
      </Step>

      <Step title="Guardar">
        El activo queda registrado y disponible para asignar órdenes y planes preventivos.
      </Step>
    </Steps>

    {/* TODO: screenshot — formulario de creación de activo */}

    ## Campos del activo

    | Campo                    | Descripción                                                    |
    | ------------------------ | -------------------------------------------------------------- |
    | **Nombre**               | Nombre del equipo                                              |
    | **Fabricante**           | Empresa que lo fabricó                                         |
    | **Modelo**               | Número de modelo                                               |
    | **Número de serie**      | Identificador único del equipo físico                          |
    | **Fecha de instalación** | Cuándo fue puesto en servicio                                  |
    | **Estado**               | Operativo, en mantenimiento, fuera de servicio, etc.           |
    | **Criticidad**           | Impacto en la producción si falla (baja, media, alta, crítica) |
    | **Tipo**                 | Categoría del activo (compresor, motor, bomba, etc.)           |
    | **Activo padre**         | Para armar la jerarquía                                        |
    | **Ubicación**            | Dónde está físicamente el activo                               |
    | **Propiedades de clase** | Campos personalizados según el tipo de activo                  |

    ## Jerarquía de activos

    Los activos pueden organizarse en árbol. Por ejemplo:

    ```
    Línea de Producción 1 (activo padre)
    ├── Compresor Principal (hijo)
    │   ├── Motor eléctrico (nieto)
    │   └── Cabezal compresor (nieto)
    └── Banda transportadora (hijo)
    ```

    Desde el detalle de un activo, la pestaña **Activos hijos** muestra todos los sub-equipos directamente dependientes.

    ## Propiedades de clase

    Las propiedades de clase son campos personalizados que se asocian a un tipo de activo. Por ejemplo, los compresores pueden tener: presión máxima, caudal nominal, tipo de refrigeración.

    Para configurarlas: desde el detalle de un activo > **Campos personalizados** > define los campos para ese tipo.

    <Tip>
      Asigna la **criticidad** correctamente desde el inicio. Los dashboards y rankings de MTBF usan este campo para priorizar en qué activos enfocarse.
    </Tip>

    <Tip>
      Si tienes equipos con muchos sub-componentes, usa la jerarquía de activos. Podrás ver el historial de mantenimiento por componente individual y no solo por equipo completo.
    </Tip>
  </Tab>

  <Tab title="Indicadores">
    ## Indicadores KPI

    La pestaña **Indicadores** muestra métricas de confiabilidad calculadas automáticamente a partir del historial de órdenes:

    | Indicador                   | Descripción                                                                |
    | --------------------------- | -------------------------------------------------------------------------- |
    | **MTTR**                    | Tiempo medio de reparación — promedio de horas que toma resolver una falla |
    | **MTBF**                    | Tiempo medio entre fallas — promedio de horas entre fallas consecutivas    |
    | **Horas de mantenimiento**  | Total de horas trabajadas en el activo en el período                       |
    | **Cantidad de órdenes**     | Número de órdenes ejecutadas                                               |
    | **Cumplimiento preventivo** | % de planes preventivos completados a tiempo                               |
    | **Costo de repuestos**      | Total de materiales utilizados (si tienes permisos para ver costos)        |

    Puedes filtrar los indicadores por rango de fechas.

    {/* TODO: screenshot — tab de indicadores KPI de un activo */}
  </Tab>

  <Tab title="Parámetros">
    ## Parámetros del activo

    Los parámetros son variables medibles del activo (temperatura, presión, vibración, horas de operación, etc.). Se usan para:

    * **Disparar planes preventivos** por uso o condición
    * **Registrar lecturas** y graficar tendencias históricas

    ### Crear un parámetro

    Desde el detalle del activo, pestaña **Parámetros** > **Nuevo parámetro**:

    | Campo                | Descripción                                           |
    | -------------------- | ----------------------------------------------------- |
    | **Nombre**           | Ej. "Temperatura de rodamiento", "Horas de operación" |
    | **Unidad de medida** | Selecciona del catálogo de [unidades](/pulse/units)   |
    | **Valor ideal**      | El valor óptimo de operación                          |
    | **Valor mínimo**     | Límite inferior aceptable                             |
    | **Valor máximo**     | Límite superior aceptable                             |

    ### Registrar lecturas

    Desde el detalle del parámetro puedes ingresar lecturas manuales. Cada lectura queda registrada con fecha y hora. El gráfico histórico muestra la evolución del valor en el tiempo y marca visualmente si está dentro o fuera del rango aceptable.

    {/* TODO: screenshot — gráfico histórico de lecturas de un parámetro */}
  </Tab>

  <Tab title="Documentos">
    ## Spare Parts

    Desde la pestaña **Spare Parts** puedes ver qué materiales del inventario están vinculados a ese activo y consultar el historial de uso.

    {/* TODO: contenido de documentos adjuntos al activo */}
  </Tab>
</Tabs>