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} :

{ "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 le score est encore recalculé sur le fichier corrigé. Ne le lisez qu’après le statut terminal completed ; 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 et ignoré.