# 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}`](https://docs.accessful.de/de/reference/job-status/):

```json
{ "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`](https://docs.accessful.de/de/reference/job-status/#verarbeitungsphase) wird der Score noch gegen
die bearbeitete Datei neu berechnet. Lies ihn erst nach dem terminalen Status
[`completed`](https://docs.accessful.de/de/reference/job-status/); in jedem anderen Zustand ignorierst du ihn.

**Note:** 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](https://docs.accessful.de/de/reference/upload/)
erkannt und übersprungen.