Especificación v1

Esta es la versión web de la especificación. Lengua de referencia: español (se publicará también en inglés). Licencia del documento: CC BY 4.0.

1. Principios de diseño

• Degradación elegante. Si Yodechique desaparece, el archivo sigue siendo útil: fotos JPG, vídeos MP4, cartas Markdown, datos JSON. Nada queda en formatos propietarios.
• Autocontenido. Todo lo necesario para leer la historia va dentro, incluido un lector offline (index.html).
• Legible por humanos y máquinas. Documentos para personas (PDF, HTML) y datos estructurados para software futuro (JSON).
• Verificable. Un manifiesto con versión, conteos e integridad (SHA-256).
• Abierto. Especificación pública; cualquiera puede escribir herramientas que lean o generen archivos .yodechique.

2. El contenedor

Un archivo .yodechique es, internamente, un ZIP estándar con formatos abiertos y metadatos legibles. La extensión es solo una pista de asociación: cualquier herramienta de ZIP puede abrirlo.

Lucas_2004_2035.yodechique        (= ZIP)

Convención de nombre: {Nombre}_{añoInicio}_{añoExportación}.yodechique.

3. Estructura

/manifest.json                 ← versión del formato, integridad, conteos
/index.html                    ← lector offline (sin login, sin servidor)
/assets/                       ← JS/CSS del lector (vendados)

/metadata/   family.json · children.json · people.json
/timeline/   events.json       ← índice cronológico
/memories/   memories.json     ← recuerdos + relaciones + etiquetas
/emotions/   emotions.json     ← mapa emocional
/messages/   carta_18_anios.md ← cartas y mensajes (Markdown)
/media/      fotos/ · videos/ · audios/   (originales)
/export/     libro_familiar.pdf · resumen.md

Rutas relativas con / como separador. UTF-8 en todos los textos.

4. Formatos permitidos

5. manifest.json

{
  "format": "yodechique-archive",
  "version": "1.0",
  "generatedAt": "2035-03-15T10:00:00Z",
  "child": { "name": "Lucas", "birthDate": "2004-03-15" },
  "range": { "from": "2004", "to": "2035" },
  "counts": { "memories": 2735, "media": 4120, "emotions": 1380 },
  "integrity": { "algorithm": "sha-256", "files": { "...": "9f86d0…" } },
  "spec": "https://yodepeque.com/archive-format-v1.html"
}

version sigue semver. Un lector debe abrir cualquier archivo cuyo major conozca, ignorando campos desconocidos (compatibilidad hacia delante).

6. Lector offline (index.html)

Cada archivo incluye un lector estático que, abierto en cualquier navegador, permite sin conexión, sin login y sin servidores: navegar la timeline, ver recuerdos, reproducir vídeos y audios, leer cartas, consultar el mapa emocional y explorar la historia completa. Es la prueba tangible del principio de degradación elegante.

7. Exportación dual

• Para humanos: libro PDF, index.html, álbumes, vídeo resumen, cartas en Markdown.
• Para máquinas: los *.json con relaciones, etiquetas, metadatos e información de IA (incl. embeddings opcionales), para reinterpretar la historia con tecnologías futuras.

8. Niveles de exportación

9. Copias externas

El archivo es un único fichero portátil para guardarse donde el usuario quiera: Google Drive, iCloud, Dropbox, OneDrive, Amazon S3 o un NAS doméstico.

10. Compromisos de compatibilidad

• Esta especificación se publica en https://yodepeque.com/archive-format-v1.html.
• Se publicará un lector de referencia open-source (Yodechique Archive Reader) capaz de abrir cualquier archivo .yodechique.
• Los cambios major mantendrán siempre una herramienta de migración.

← Volver a Permanencia y legado