USEE: Software que se ensambla como piezas de LEGO

Un protocolo abierto para crear piezas de software intercambiables,
comprensibles y resilientes al paso del tiempo.

El software actual está enfermo

⚠️

COMPLEJIDAD INNECESARIA

Programas que deberían hacer una cosa, hacen cien.

OBSOLESCENCIA ACELERADA

Sistemas que deberían durar décadas se rompen en meses.

🚧

BARRERA DE ENTRADA ALTA

Herramientas que deberían ser accesibles requieren años.

🔒

DEPENDENCIA DE CONTEXTO

Soluciones que deberían ser universales solo funcionan en lugares específicos.

"Cada proyecto reinventa la rueda. Login, QR, analytics, validaciones...
una y otra vez, con los mismos errores."

USEE: Cuatro principios, software que perdura

U

ÚTIL

Resuelve un problema concreto que personas tienen hoy

S

SIMPLE

Pocas piezas, poca complejidad, fácil de entender

E

ESENCIAL

Hace una sola cosa completamente sin extra

E

ESTABLE

Resiliente a cambios, funciona años después

Piezas que hablan el mismo idioma

Comunicación universal via texto plano

(Formato de Texto USEE)

Terminal
APIs
Web
Legado
Cada pieza recibe texto → procesa → devuelve texto
Sin dependencias complejas, sin configuración obligatoria
Funciona con cualquier lenguaje: JavaScript, Python, Go, Rust, etc.

Anatomía de una pieza USEE

Estructura de archivos:

generar-qr/
├── PIEZA.usee ← Metadatos
├── LEEME.md ← Documentación
├── ejecutar ← Punto entrada
├── ENTRADA.ejemplo
└── SALIDA.ejemplo

Ejemplo de uso:

# Entrada
texto: https://mi-sitio.com
ancho: 256
# Salida
estado: ok
formato: png
imagen: iVBORw0KGgo... (base64)

"Una pieza = Un problema resuelto. Documentada, probada, lista para usar."

El poder está en la composición

extraer datos

Obtiene info de una fuente

analytics temporal

Calcula métricas por período

generar reporte

Produce el documento final
./extraer-datos | ./analytics-temporal | ./generar-reporte

"Arma soluciones complejas conectando piezas simples.
Sin código extra, sin configuración, sin dolor de cabeza."

Explora el protocolo

📄

Manifiesto USEE

Los 4 principios y filosofía del protocolo

Descargar
📄

Anatomía de Pieza

Estructura y archivos obligatorios de cada pieza

Descargar
📄

Especificación FTU

Formato de Texto USEE - sintaxis completa

Descargar
📄

Guía de Adaptadores

Cómo exponer piezas vía JSON y HTTP

Descargar
📄

Guía del Verificador

Sistema de validación automática de piezas

Descargar

Primeros pasos

Aprende a ejecutar y conectar piezas USEE en minutos

📚

Guía Rápida: Ejecutar y Unir Piezas USEE

Todo lo que necesitas saber para usar piezas USEE: formato FTU, ejecución básica, conexión con pipes, adaptadores JSON/HTTP, y ejemplos prácticos completos.

  • Formato de Texto USEE (FTU)
  • Cómo ejecutar una pieza
  • Conectar piezas con pipes
  • Adaptadores JSON y HTTP
  • Debug y errores comunes
Descargar

Scripts de integración

Herramientas y ejemplos listos para usar

ejemplo-pipeline.sh

Pipeline que conecta analytics-temporal → generar-qr

🔄

transformar-ftu.sh

Utilidad para transformar campos FTU entre piezas

Piezas de ejemplo

Explora piezas USEE reales para entender la estructura del protocolo

imagenes v1.0.0

generar-qr

Genera códigos QR personalizables a partir de texto

qr imagen png
reportes v1.0.0

analytics-temporal

Procesa datos de visitas en períodos temporales con agregaciones

analytics estadisticas metricas