Skip to content

Navigation Menu

Sign in
Sign up

Repository files navigation

MENELAO

Icono MENELAO X/A/B

Herramienta local y no destructiva para ingesta audiovisual redundante X/A/B y verificación de integridad

English version

Build portable MENELAO artifacts

MENELAO es un MVP local de escritorio que copia una tarjeta o carpeta de origen hacia dos destinos independientes y verifica que las tres ubicaciones contengan los mismos archivos y bytes antes de que el operador considere reutilizar el medio original.

El nombre público de la aplicación es MENELAO. Su modelo de seguridad y verificación se llama Triángulo Dorado.

Proyecto personal de Guillermo Barbeito: definición del problema, diseño del flujo de operador, desarrollo en Python, interfaz de escritorio, pruebas, documentación de seguridad y empaquetado multiplataforma.

Vista rápida

Problema Reducir el riesgo de pérdida de material al descargar una tarjeta durante una producción audiovisual.
Solución Copia redundante X/A/B con verificación independiente por ruta, tamaño y SHA-256.
Criterio de diseño Comportamiento local, conservador y no destructivo; ante cualquier duda, NO FORMATEAR.
Evidencia técnica Aplicación Tkinter, reportes JSON/CSV/TXT, pruebas automatizadas y builds portables para Linux y Windows.
Valor profesional Convierte una necesidad de set en un producto documentado, verificable y pensado para un operador real.

Estado del proyecto

  • MVP local de escritorio funcional.
  • Flujo principal para el operador: aplicación de escritorio con Tkinter.
  • Python 3.10+ y Linux como entorno principal de operación.
  • GitHub Actions construye y prueba artefactos portables para Linux y Windows.
  • Verificación de archivos y manifests mediante SHA-256.
  • Pruebas automatizadas con pytest.
  • Decisión de licencia todavía pendiente.
  • La aplicación no está certificada para producción y no sustituye procedimientos establecidos de manejo de datos ni la revisión humana independiente.

Qué demuestra técnicamente

  • Escaneo de fuente en modo lectura y manejo no destructivo del sistema de archivos.
  • Copia redundante hacia dos destinos independientes.
  • Verificación por cantidad, ruta, tamaño y SHA-256.
  • Fingerprints estables de manifests y detección de ingestas duplicadas.
  • Salidas JSON/CSV y reportes legibles para personas.
  • Estados explícitos de falla y mensajes conservadores para el operador.
  • Metadata técnica opcional mediante ffprobe.
  • Interfaz Tkinter, lanzador para Linux y builds portables multiplataforma.
  • Pruebas automatizadas y empaquetado con GitHub Actions.

Flujo X/A/B

  • X — fuente/tarjeta: medio original seleccionado por el operador.
  • A — copia local/master: destino local principal.
  • B — copia externa/backup: destino de respaldo independiente.

Una ingesta completa se considera verificada únicamente cuando pasan las tres comparaciones:

  1. X vs A.
  2. X vs B.
  3. A vs B.

La verificación compara cantidad de archivos, rutas relativas, tamaños y hashes SHA-256.

Modelo de seguridad

MENELAO está diseñado como una herramienta no destructiva:

  • nunca formatea medios;
  • nunca borra ni modifica archivos de origen;
  • nunca sustituye el criterio del operador;
  • cualquier ingesta incompleta, incierta, interrumpida o con diferencias significa NO FORMATEAR.

Un mensaje de "seguro para formatear" es solamente una indicación para la decisión del operador después de una verificación local X/A/B exitosa. La decisión final continúa siendo responsabilidad del operador.

Leé el modelo completo de seguridad del Triángulo Dorado.

Inicio rápido en Linux

Desde la raíz del repositorio:

python -m venv .venv
source .venv/bin/activate
python -m pip install -e .
python -m project_isosceles.local_app

En algunas distribuciones, Tkinter debe instalarse por separado:

sudo apt install python3-tk

Para instalar el lanzador de escritorio del usuario:

python scripts/install_desktop_launcher.py

Pruebas

python -m pytest -q

El workflow de GitHub Actions ejecuta las pruebas antes de construir artefactos portables para Linux y Windows.

Evidencia generada

Las ingestas de escritorio exitosas escriben reportes en la carpeta REPORTES de A y B, incluyendo:

  • manifest.json
  • files_index.json
  • files_index.csv
  • reporte_ingesta.txt
  • log_motor.txt
  • technical_clip_log.json
  • technical_clip_log.csv
  • menelao_technical_handoff.txt

La metadata de handoff técnico es complementaria. No sustituye la verificación X/A/B ni una planilla final de cámara o sonido.

Limitaciones actuales

  • MENELAO es un MVP funcional, no un producto certificado.
  • Linux continúa siendo el entorno principal para el operador.
  • La detección de fuentes es una ayuda y puede no identificar todos los dispositivos o estructuras de carpetas.
  • Las copias y verificaciones largas todavía ofrecen información básica de progreso.
  • El almacenamiento en nube y la sincronización remota están fuera del modelo actual X/A/B.
  • El operador debe confirmar que las rutas de fuente y destinos sean correctas y suficientemente independientes.
  • Todavía no se eligió una licencia pública de reutilización.

Documentación

Historial de nombres

  • MENELAO es el nombre público de la aplicación.
  • Triángulo Dorado es el modelo de verificación X/A/B.
  • project-isosceles continúa como nombre interno del repositorio y del paquete Python.
  • dataloading.exe es un nombre clave interno temprano, conservado solamente donde la compatibilidad lo requiere.

Autor

Guillermo Barbeito — Ingeniero en Informática enfocado en IT Support, Product Support, Technical Operations, automatización y herramientas prácticas.

Licencia

Todavía no se eligió una licencia de reutilización. No asumas permiso para reutilizar, redistribuir o modificar el proyecto hasta que se agregue una licencia.

About

MENELAO — local desktop MVP for redundant X/A/B ingest and SHA-256 integrity verification.

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages

AltStyle によって変換されたページ (->オリジナル) /