# Comprendre le score

Chaque cas terminé porte un **`score`** — un entier de **0 à 100** qui évalue la qualité
d'accessibilité du résultat PDF/UA **corrigé**. Vous le lisez depuis
[`GET /job-status/{caseId}`](https://docs.accessful.de/fr/reference/job-status/) :

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

Plus c'est élevé, mieux c'est : **100** signifie qu'aucun problème d'accessibilité ne
subsiste après la correction.

## Quand le score est définitif

Le nombre n'a de sens qu'une fois la tâche **`completed`** (`stage: finished`). Avant
cela, c'est une valeur provisoire — un cas `queued` renvoie `"score": 0`, et pendant
[`revalidating`](https://docs.accessful.de/fr/reference/job-status/#phase-de-traitement) le score est encore
recalculé sur le fichier corrigé. Ne le lisez qu'après le statut terminal
[`completed`](https://docs.accessful.de/fr/reference/job-status/) ; ignorez-le dans tout autre état.

**Note:** Le score décrit le **résultat que nous produisons**, pas votre envoi. Il mesure ce qui ne
va toujours pas *après* qu'Accessful a corrigé tout ce qu'il pouvait — il répond donc à
« quelle est l'accessibilité du fichier que je m'apprête à télécharger », pas « à quel
point l'original était mauvais ».

## Comment il est calculé

Le score repose sur des **pénalités**. Chaque fichier part de **100**, et chaque problème
d'accessibilité qui **subsiste** dans le résultat en soustrait. Quatre facteurs façonnent
le nombre :

- **La gravité domine.** Un bloqueur structurel coûte bien plus qu'un constat cosmétique.
  Les gravités, de la plus lourde à la plus légère :

  | Gravité | Ce qu'elle couvre |
  | --- | --- |
  | Bloqueur | Structure de balises de base, images non balisées, langue du document manquante |
  | Majeur | Problèmes structurels importants pour les technologies d'assistance |
  | Mineur | Métadonnées, signets, numérotation des pages, artefacts |
  | Info | Constats de bonnes pratiques / informatifs |

- **Le corrigé ne coûte rien.** Seuls les constats **ouverts** comptent. Tout ce
  qu'Accessful a corrigé avec succès est gratuit — c'est tout l'objet de la conversion.
- **Les répétitions ne dominent pas.** De nombreux constats du *même* type sont atténués
  de façon logarithmique, de sorte que le même problème sur 200 pages n'est pas pénalisé
  200× plus que sur une seule page.
- **La revue manuelle est peu coûteuse.** Certains problèmes ne peuvent pas être corrigés
  automatiquement en toute confiance (p. ex. « ce texte alternatif est-il vraiment
  pertinent ? »). Ils portent une petite pénalité fixe au lieu du poids complet de la
  gravité et sont laissés à la confirmation d'un humain.

**Un signal de qualité, pas un certificat légal:** Un score élevé signifie qu'il reste peu de problèmes d'accessibilité — ce n'est **pas**
une garantie de conformité légale PDF/UA ni un substitut à un audit d'accessibilité
manuel. Considérez-le comme un indicateur fort, pas comme une validation de conformité.

La pondération exacte est ajustée au fil du temps à mesure que la correction s'améliore ;
seuls la **plage 0–100** et « plus c'est élevé, mieux c'est » font partie du contrat de
l'API.

## Lire un score

L'API ne renvoie que le nombre. En règle pratique :

| Score | Comment le lire | Action typique |
| --- | --- | --- |
| **90–100** | Excellent — quasiment irréprochable | Publiez-le. |
| **75–89** | Bon — des problèmes mineurs subsistent | Utilisable tel quel ; vérifiez les documents à fort enjeu. |
| **50–74** | Correct — des lacunes réelles subsistent | Vérifiez avant publication ; la source avait probablement des faiblesses structurelles. |
| **Moins de 50** | Faible | La source était difficile à corriger automatiquement ; améliorez-la et téléversez à nouveau. |

## Pourquoi un score n'est pas plus élevé

La raison la plus fréquente pour laquelle un score plafonne sous 100 est le **document
source** : un PDF numérisé sans couche de texte, des images impossibles à décrire avec
confiance, ou un contenu dont l'ordre de lecture ne peut être déduit en toute sécurité.
Accessful corrige la structure, les balises, les métadonnées, la langue et le texte
alternatif partout où il peut les déterminer de façon fiable, et laisse le reste en
constats ouverts ou à revue manuelle plutôt que de deviner.

Pour faire bouger le nombre, **améliorez la source** — ajoutez une vraie couche de texte,
fournissez de véritables titres — et téléversez le nouveau fichier. Renvoyer les *mêmes*
octets n'aide pas : un contenu identique est détecté comme [doublon](https://docs.accessful.de/fr/reference/upload/)
et ignoré.