Biblioteca de artefactos binarios
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.
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.
Información técnica del documento
- Ruta lógica
- artifacts/artifact-library.md
- Commit Git
a83cef9e1ee0c5b0b22662fe3493139d77c23570- SHA-256
e39ea379c7a5487f247bf74a50b878d1d5ae220aa9f10ac1558219ad1a106e74- Regeneración
scripts/build-documentation.sh