---
id: artifacts-library
title: Biblioteca de artefactos binarios
category: artifacts
version: 1.0
status: stable
audience:
  - user
  - administrator
  - developer
  - ai
updated_at: 2026-07-14
related:
  - user-guide-firmware-management
  - architecture-database
tags:
  - artifact
  - sha256
  - deduplication
  - clone
---

# Biblioteca de artefactos binarios

Un artifact es contenido binario independiente de cualquier firmware. Su identidad es el SHA-256 y puede ser compartido.

## Relación

firmware 1 -> N firmware_segment N -> 1 artifact

La ficha describe producto y compatibilidad. El segmento describe cómo usar un archivo dentro de esa ficha. El artifact representa los bytes.

## Deduplicación

Al subir un archivo se calcula SHA-256 antes de almacenarlo. Si existe, se reutiliza. Clonar firmware crea nuevas relaciones sin copiar bytes. Dos paquetes pueden compartir bootloader o tabla de particiones.

## Sustitución

Editar un segmento no muta el artifact. Se crea o reutiliza otro artifact y la relación cambia de forma transaccional. Los demás firmwares continúan apuntando al contenido anterior.

## Eliminación

Eliminar firmware borra ficha y segmentos. Nunca borra directamente el archivo compartido. Un artifact sin relaciones queda huérfano. La limpieza explícita verifica de nuevo referencias, elimina el archivo y luego su registro.

## Riesgos evitados

Este modelo impide que borrar el original rompa clones, evita duplicación física, conserva checksums, permite trazabilidad y mantiene integridad referencial.