Entwickler-FAQ

Häufige Fragen vor und während der Implementierung

Diese Seite beantwortet die Fragen, die meist auftauchen, wenn ein Team EEV in eine Software integrieren will, ohne sich zwischen öffentlichem Vertrag, Architekturentscheidungen, Legacy-Kompatibilität und Produkt-Rollout zu verlieren.

Muss man EEV auf einmal vollständig implementieren?

Nein. Eine glaubwürdige erste Version kann sich auf einen klaren Teilbereich konzentrieren, zum Beispiel auf das Lesen von ENTRY in .eev und .eevz, mit ehrlicher Validierung und einem kanonischen Writer, der auf die Felder beschränkt ist, die die Software wirklich versteht. Entscheidend ist nicht, sofort alles abzudecken, sondern genau zu dokumentieren, was unterstützt wird.

Womit sollte man technisch beginnen?

Der sauberste Einstieg ist der einfache Textpfad: den Container erkennen, den Rohtext erhalten, ein ENTRY parsen, ein internes Modell aufbauen und anschließend wieder stabilen Text ausgeben. Kompression und Zertifizierung kommen später als zusätzliche Schichten hinzu, nicht als zweiter Kern.

Wie sollten Legacy-Varianten behandelt werden?

Beim Lesen darf der Parser tolerant sein und bestimmte Legacy-Formen in das moderne interne Modell überführen, wobei Warnungen ausgegeben werden. Beim Schreiben sollte der kanonische Writer diese alten Formen nicht automatisch wiederverwenden. Breites Lesen und sauberes Schreiben bleibt die sicherste Regel.

Sollten ENTRY und LIB als zwei getrennte Formate behandelt werden?

Nicht wirklich. Es sind zwei Containerstrukturen derselben Familie. ENTRY beschreibt einen einzelnen Fingerabdruck. LIB fügt einen Bibliotheksrahmen hinzu, der mehrere Einträge aufnehmen kann. Sinnvoll ist es, die Behandlung der inneren Blöcke möglichst weitgehend zu teilen und anschließend eine Bibliotheksschicht darum herum zu legen.

Was sollte ein kanonischer Writer garantieren?

Er sollte deterministischen, geordneten, lesbaren Text erzeugen, der mit der angestrebten Version des öffentlichen Vertrags übereinstimmt. Zwei identische Exporte sollten dieselbe Ausgabe liefern. Felder sollten in stabiler Reihenfolge erscheinen, mit vorhersehbarer Normalisierung von Werten und Abschnitten.

Sollten die ursprünglichen Rohzeilen erhalten bleiben?

Nur wenn das Produkt sie wirklich für Inspektion oder Diff-Werkzeuge benötigt. Für die Kernlogik ist es besser, schnell zu einem sauberen internen Modell zu konvergieren. Sich zu lange auf Rohzeilen zu stützen, macht die Weiterentwicklung von Parser und Writer deutlich fragiler.

Betrifft Hashing nur komprimierte Dateien?

Nein. Hashing gehört zur dokumentarischen Integrität, nicht zum komprimierten Transport. Eine Datei kann komprimiert sein oder nicht; die eigentliche Frage ist, welche Teile des Dokuments geschützt sind und wie geprüft wird, dass sie nicht verändert wurden.

Soll mein Tool EEVC-Dateien unterstützen?

Es ist sinnvoll, das Lesen bereits ausgestellter EEVC- oder EEVCZ-Dateien zu unterstützen, wenn Ihr Produkt zertifiziertes Material prüfen oder verifizieren muss. Diese Website dokumentiert nicht die lokale Erstellung von EEVC; für zertifizierte Verifikationsabläufe nutzen Sie eevc.link.

Welche Produktbotschaft sollte vermieden werden?

EEV sollte nicht als einfache „angereicherte Note“ dargestellt werden und auch nicht als magisches Versprechen, das allein sagt, was ein Klang „bewirkt“. Das Format beschreibt und strukturiert ein Schwingungsverhalten sehr fein; es ersetzt weder das Hören noch menschliches Urteil oder Interpretationsrahmen.

Benötigt die Open-EEV-Website selbst eine Datenbank?

Nein. Die hier gelieferte Website ist eine leichte PHP-Seite mit einfacher i18n-Struktur. Sie kann direkt auf den Hosting-Speicher kopiert werden. Es wird weder eine MySQL-Datenbank benötigt noch müssen SQL-Befehle ausgeführt werden.