Score verstehen

Jeder abgeschlossene Case trägt einen score — eine ganze Zahl von 0 bis 100, die die Barrierefreiheits-Qualität des bearbeiteten PDF/UA-Ergebnisses bewertet. Du liest ihn aus GET /job-status/{caseId}:

{ "jobStatus": "completed", "stage": "finished", "score": 87 }

Höher ist besser: 100 bedeutet, dass nach der Remediation keine Barrierefreiheits-Probleme übrig geblieben sind.

Wann der Score endgültig ist

Die Zahl ist erst aussagekräftig, sobald der Job completed ist (stage: finished). Vorher ist sie ein Platzhalter — ein queued-Case meldet "score": 0, und während revalidating wird der Score noch gegen die bearbeitete Datei neu berechnet. Lies ihn erst nach dem terminalen Status completed; in jedem anderen Zustand ignorierst du ihn.

Hinweis

Der Score beschreibt das Ergebnis, das wir erzeugen, nicht deinen Upload. Er misst, was nach der Bearbeitung durch Accessful noch falsch ist — er beantwortet also „wie barrierefrei ist die Datei, die ich gleich herunterlade“, nicht „wie schlecht war das Original“.

Wie er berechnet wird

Der Score ist strafbasiert. Jede Datei startet bei 100, und jedes Barrierefreiheits-Problem, das im Ergebnis verbleibt, zieht davon ab. Vier Dinge prägen die Zahl:

• Die Schwere dominiert. Ein struktureller Blocker kostet weit mehr als ein kosmetischer Befund. Die Schweregrade, vom schwersten zum leichtesten:

  Schwere	Was abgedeckt ist
  Blocker	Kern-Tag-Struktur, untaggte Bilder, fehlende Dokumentsprache
  Major	Bedeutende strukturelle Probleme für assistive Technik
  Minor	Metadaten, Lesezeichen, Seitennummerierung, Artefakte
  Info	Best-Practice- / informative Befunde

• Behoben kostet nichts. Nur offene Befunde zählen. Alles, was Accessful erfolgreich behoben hat, ist kostenlos — genau das ist der Sinn der Umwandlung.

• Wiederholungen dominieren nicht. Viele Befunde des gleichen Typs werden logarithmisch gedämpft, sodass dasselbe Problem über 200 Seiten nicht 200× stärker bestraft wird als auf einer einzigen Seite.

• Manuelle Prüfung ist günstig. Einige Probleme lassen sich nicht zuverlässig automatisch beheben (z. B. „ist dieser Alternativtext wirklich sinnvoll?“). Diese tragen eine kleine Pauschalstrafe statt des vollen Schwere-Gewichts und bleiben einem Menschen zur Bestätigung überlassen.

Ein Qualitätssignal, kein rechtliches Zertifikat

Ein hoher Score bedeutet, dass wenige Barrierefreiheits-Probleme verbleiben — er ist keine Garantie für rechtliche PDF/UA-Konformität und kein Ersatz für ein manuelles Accessibility-Audit. Behandle ihn als starken Indikator, nicht als Konformitäts-Freigabe.

Die genaue Gewichtung wird mit besser werdender Remediation laufend nachjustiert; nur der Bereich 0–100 und „höher ist besser“ sind Teil des API-Vertrags.

Einen Score lesen

Die API liefert nur die Zahl. Als praktische Faustregel:

Score	So liest du ihn	Typische Reaktion
90–100	Exzellent — im Wesentlichen sauber	Veröffentlichen.
75–89	Gut — kleinere Probleme verbleiben	Direkt nutzbar; bei wichtigen Dokumenten stichprobenartig prüfen.
50–74	Ausreichend — echte Lücken verbleiben	Vor der Veröffentlichung prüfen; die Quelle hatte vermutlich strukturelle Schwächen.
Unter 50	Schwach	Die Quelle war automatisch schwer zu bearbeiten; verbessern und neu hochladen.

Warum ein Score nicht höher ist

Der häufigste Grund, warum ein Score unter 100 stagniert, ist das Quelldokument: ein gescanntes PDF ohne Textebene, Bilder, die sich nicht zuverlässig beschreiben lassen, oder Inhalte, deren Lesereihenfolge sich nicht sicher ableiten lässt. Accessful behebt Struktur, Tags, Metadaten, Sprache und Alternativtexte überall dort, wo es sie zuverlässig bestimmen kann, und lässt den Rest als offenen oder manuell zu prüfenden Befund stehen, statt zu raten.

Um die Zahl zu verbessern, verbessere die Quelle — füge eine echte Textebene hinzu, liefere echte Überschriften — und lade die neue Datei hoch. Dieselben Bytes erneut einzureichen hilft nicht: identischer Inhalt wird als Duplikat erkannt und übersprungen.