Оценка доступности

Каждый завершённый кейс несёт score (оценку) — целое число от 0 до 100, оценивающее качество доступности исправленного результата PDF/UA. Вы читаете её из GET /job-status/{caseId}:

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

Чем выше, тем лучше: 100 означает, что после исправления не осталось проблем доступности.

Когда оценка окончательна

Число имеет смысл только после того, как задача станет completed (stage: finished). До этого это заглушка — кейс в состоянии queued сообщает "score": 0, а во время revalidating оценка ещё пересчитывается по исправленному файлу. Читайте её только после терминального статуса completed; в любом другом состоянии игнорируйте.

Заметка

Оценка описывает результат, который мы создаём, а не вашу загрузку. Она измеряет то, что осталось неправильным после того, как Accessful исправил всё, что мог, — то есть отвечает на вопрос «насколько доступен файл, который я сейчас скачаю», а не «насколько плох был оригинал».

Как она рассчитывается

Оценка основана на штрафах. Каждый файл начинается со 100, и каждая проблема доступности, которая остаётся в результате, вычитается. Число формируют четыре фактора:

• Серьёзность доминирует. Структурный блокер стоит гораздо больше, чем косметическая находка. Уровни серьёзности, от самого тяжёлого к самому лёгкому:

  Серьёзность	Что охватывает
  Блокер	Базовая структура тегов, изображения без тегов, отсутствие языка документа
  Высокая	Значимые структурные проблемы для вспомогательных технологий
  Низкая	Метаданные, закладки, нумерация страниц, артефакты
  Инфо	Находки по лучшим практикам / информационные

• Исправленное ничего не стоит. Считаются только открытые находки. Всё, что Accessful успешно исправил, бесплатно — в этом и весь смысл преобразования.

• Повторы не доминируют. Множество находок одного типа сглаживаются логарифмически, поэтому одна и та же проблема на 200 страницах не штрафуется в 200 раз сильнее, чем на одной странице.

• Ручная проверка дешева. Некоторые проблемы нельзя надёжно исправить автоматически (например, «действительно ли этот альтернативный текст осмыслен?»). Они несут небольшой фиксированный штраф вместо полного веса серьёзности и оставляются на подтверждение человеку.

Сигнал качества, а не юридический сертификат

Высокая оценка означает, что осталось мало проблем доступности — это не гарантия юридического соответствия PDF/UA и не замена ручного аудита доступности. Считайте её сильным индикатором, а не подтверждением соответствия.

Точные веса со временем подстраиваются по мере улучшения исправления; частью контракта API являются только диапазон 0–100 и принцип «выше — лучше».

Как читать оценку

API возвращает только число. Практическое правило:

Оценка	Как читать	Типичное действие
90–100	Отлично — практически без замечаний	Публикуйте.
75–89	Хорошо — остаются незначительные проблемы	Пригодно как есть; выборочно проверьте важные документы.
50–74	Удовлетворительно — остаются реальные пробелы	Проверьте перед публикацией; у источника, вероятно, были структурные слабости.
Меньше 50	Слабо	Источник было трудно исправить автоматически; улучшите его и загрузите снова.

Почему оценка не выше

Самая частая причина, по которой оценка останавливается ниже 100, — это исходный документ: отсканированный PDF без текстового слоя, изображения, которые невозможно описать с уверенностью, или содержимое, порядок чтения которого нельзя безопасно вывести. Accessful исправляет структуру, теги, метаданные, язык и альтернативный текст везде, где может определить их надёжно, и оставляет остальное как открытые находки или находки для ручной проверки, вместо того чтобы гадать.

Чтобы сдвинуть число, улучшите источник — добавьте настоящий текстовый слой, дайте реальные заголовки — и загрузите новый файл. Повторная отправка тех же байтов не поможет: идентичное содержимое определяется как дубликат и пропускается.