Preguntas frecuentes para desarrolladores

Preguntas habituales antes y durante la implementación

Esta página responde a las preguntas que suelen surgir cuando un equipo quiere integrar EEV en un software sin perderse entre el contrato público, las decisiones de arquitectura, la compatibilidad heredada y el despliegue del producto.

¿Hay que implementar todo EEV de una sola vez?

No. Una primera versión creíble puede centrarse en un subconjunto claro, por ejemplo la lectura de ENTRY en .eev y .eevz, con una validación honesta y un writer canónico limitado a los campos que el software entiende de verdad. Lo importante no es cubrirlo todo desde el principio, sino documentar exactamente lo que se soporta.

¿Por dónde empezar técnicamente?

El punto de partida más limpio es la ruta de texto simple: detectar el contenedor, obtener el texto bruto, parsear un ENTRY, construir un modelo interno y luego volver a emitir un texto estable. La compresión y la certificación llegan después como capas adicionales, no como un segundo núcleo.

¿Cómo deben manejarse las variantes legacy?

En lectura, el parser puede mantenerse tolerante y convertir ciertas formas legacy al modelo interno moderno, mostrando advertencias. En escritura, el writer canónico no debe reciclar automáticamente esas formas antiguas. Leer de forma amplia y escribir de forma limpia sigue siendo la regla más segura.

¿Deben tratarse ENTRY y LIB como dos formatos distintos?

No exactamente. Son dos estructuras de contenedor de la misma familia. ENTRY describe una sola huella. LIB añade un marco de biblioteca capaz de incluir varias entradas. Lo preferible es compartir al máximo el tratamiento de los bloques internos y luego añadir una capa de biblioteca alrededor.

¿Qué debe garantizar un writer canónico?

Debe producir un texto determinista, ordenado, legible y coherente con la versión del contrato público a la que apunta. Dos exportaciones idénticas deben dar la misma salida. Los campos deben aparecer en un orden estable, con una normalización previsible de valores y secciones.

¿Hay que conservar las líneas brutas de origen?

Solo si el producto realmente las necesita para inspección o herramientas de diff. Para la lógica principal conviene converger rápidamente hacia un modelo interno limpio. Apoyarse demasiado tiempo en líneas brutas vuelve mucho más frágil la evolución del parser y del writer.

¿El hash solo se refiere a archivos comprimidos?

No. La lógica del hash pertenece a la integridad documental, no al transporte comprimido. Un archivo puede estar comprimido o no; la cuestión es qué partes del documento están protegidas y cómo verificar que no han sido alteradas.

¿Mi herramienta debe gestionar archivos EEVC?

Es útil soportar la lectura de archivos EEVC o EEVCZ ya emitidos si su producto debe inspeccionar o verificar material certificado. Este sitio no documenta la creación local de EEVC; para los flujos de verificación certificada, use eevc.link.

¿Qué mensaje de producto conviene evitar?

Es mejor evitar presentar EEV como una simple “nota enriquecida” o como una promesa mágica que por sí sola diría lo que un sonido “hace”. El formato describe y estructura con precisión un comportamiento vibratorio; no sustituye ni la escucha, ni el juicio humano, ni los marcos de interpretación.

¿El sitio Open EEV necesita una base de datos?

No. El sitio entregado aquí es un sitio PHP ligero con i18n simple. Puede copiarse directamente al alojamiento. No se requiere ninguna base MySQL ni hay que ejecutar comandos SQL.