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

# Mantenimiento

> Referencia de activos, causas, acciones, preventivos y partes de trabajo.

Mantenimiento registra intervenciones sobre activos, conserva historial y conecta tiempos, materiales y costes.

## Conceptos de este grupo

<Columns cols={2}>
  <Card title="Activos" icon="factory" href="/es/conceptos/mantenimiento/activos">
    Máquinas, instalaciones, áreas y equipos mantenibles.
  </Card>

  <Card title="Causas y acciones" icon="list-checks" href="/es/conceptos/mantenimiento/causas-y-acciones">
    Motivos de intervención y tareas reutilizables.
  </Card>

  <Card title="Partes de trabajo" icon="clipboard-list" href="/es/conceptos/mantenimiento/partes-de-trabajo">
    Intervenciones, estados, tiempos, materiales y costes.
  </Card>

  <Card title="Mantenimiento preventivo" icon="calendar-clock" href="/es/conceptos/mantenimiento/mantenimiento-preventivo">
    Programaciones que generan partes recurrentes.
  </Card>
</Columns>

## Entidades

| Concepto                | Uso                                                                 |
| ----------------------- | ------------------------------------------------------------------- |
| Activo                  | Máquina, instalación, área o equipo mantenible.                     |
| Causa                   | Motivo principal o auxiliar de una avería o intervención.           |
| Acción                  | Trabajo o comprobación que debe completarse en un parte.            |
| Programación preventiva | Regla que genera partes según frecuencia, activo y fecha.           |
| Parte de trabajo        | Ejecución real de mantenimiento correctivo, preventivo u otro tipo. |
| Material                | Artículo consumido durante el parte.                                |
| Tiempo                  | Registro de mano de obra de un empleado.                            |

## Permisos

Los permisos de mantenimiento separan consulta, configuración y ejecución. Usa permisos de consulta para perfiles de análisis o soporte, y permisos de edición para perfiles que cambian activos, causas, acciones, preventivos o partes.

| Necesidad                                       | Acceso recomendado                         |
| ----------------------------------------------- | ------------------------------------------ |
| Consultar activos, partes o preventivos         | Lectura de mantenimiento.                  |
| Gestionar activos, causas o acciones            | Edición de configuración de mantenimiento. |
| Ejecutar partes, tiempos, acciones y materiales | Edición de partes de trabajo.              |
| Gestionar programaciones preventivas            | Edición de mantenimiento preventivo.       |
| Subir imágenes o archivos como evidencia        | Permiso para adjuntar archivos.            |

## Partes de trabajo

Un parte de trabajo guarda activo, tipo, causa, acciones, tiempos, materiales y estado. Bold bloquea cambios de cabecera, acciones, tiempos y materiales después de completar o cancelar el parte.

Al añadir un tiempo activo, el parte empieza o se reanuda. Cuando todos los tiempos terminan, el parte queda pausado. Si eliminas todos los tiempos, vuelve a pendiente.

La eficiencia se calcula con tiempo teórico dividido por tiempo real cuando ambos valores son positivos.

| Entidad          | Estado         | Significado                                    |
| ---------------- | -------------- | ---------------------------------------------- |
| Parte de trabajo | **Pendiente**  | Existe, pero todavía no tiene trabajo activo.  |
| Parte de trabajo | **En curso**   | Hay una entrada de tiempo activa.              |
| Parte de trabajo | **Pausado**    | Se trabajó, pero no queda tiempo activo.       |
| Parte de trabajo | **Completado** | La intervención terminó y queda protegida.     |
| Parte de trabajo | **Cancelado**  | La intervención se anuló y no debe ejecutarse. |
| Acción           | **Pendiente**  | Falta completar el resultado requerido.        |
| Acción           | **Completada** | El resultado quedó registrado.                 |

## Causas y acciones

Un parte puede tener causa principal y causas auxiliares. Las causas auxiliares no pueden duplicar la principal ni duplicarse entre sí.

Las acciones pueden requerir distintos resultados:

| Tipo de acción   | Resultado esperado               |
| ---------------- | -------------------------------- |
| Simple           | No requiere resultado.           |
| Sí/no            | Requiere valor booleano.         |
| Número           | Requiere valor decimal.          |
| Texto            | Requiere texto no vacío.         |
| Imagen o archivo | Requiere una URI segura `https`. |

Completar una acción ya completada se bloquea para proteger el historial.

## Reglas principales

* Un parte completado o cancelado bloquea cabecera, acciones, tiempos y materiales.
* Una causa auxiliar no puede duplicar la causa principal ni otra causa auxiliar.
* Completar una acción exige un resultado compatible con su tipo.
* Un material consumido debe tener cantidad positiva.
* Los detalles por lote no pueden duplicarse ni superar la cantidad del material.
* Completar un parte cierra tiempos abiertos, recalcula totales y fija el estado como completado.

## Preventivo

Una programación preventiva define cuándo debe generarse un parte. Bold exige coherencia entre programación y fecha de ocurrencia: ambas deben existir o ambas deben quedar vacías.

El planificador revisa programaciones habilitadas cuando llega su próxima fecha. Si la política evita duplicados mientras hay un parte abierto, omite esa ocurrencia y calcula la siguiente. Si ya existe un parte no cancelado para la misma programación y fecha, no duplica el parte y avanza la próxima generación.

| Política                    | Comportamiento                                                          |
| --------------------------- | ----------------------------------------------------------------------- |
| Generar cada ocurrencia     | Genera un parte para cada ocurrencia vencida.                           |
| Omitir si hay parte abierto | Omite la ocurrencia cuando ya hay un parte abierto de esa programación. |

Si una programación no genera un parte, revisa activo, frecuencia, fecha siguiente, estado de la programación, política de generación y posibles partes ya generados para la misma ocurrencia.

## Materiales y trazabilidad

Los materiales consumidos deben tener cantidades positivas. Si detallas lotes, no puedes duplicar el mismo lote para el mismo material y la suma de detalles no puede superar la cantidad del material.

## Guías relacionadas

* [Activos](/es/conceptos/mantenimiento/activos)
* [Causas y acciones](/es/conceptos/mantenimiento/causas-y-acciones)
* [Crear un parte de trabajo](/es/ayuda/mantenimiento/crear-parte-de-trabajo)
* [Programar mantenimientos preventivos](/es/ayuda/mantenimiento/mantenimiento-preventivo)
* [Coste teórico vs coste real](/es/conceptos/costes/coste-teorico-vs-real)
