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

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

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

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

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

Число имеет смысл только после того, как задача станет **`completed`**
(`stage: finished`). До этого это заглушка — кейс в состоянии `queued` сообщает
`"score": 0`, а во время [`revalidating`](https://docs.accessful.de/ru/reference/job-status/#этап-обработки) оценка
ещё пересчитывается по исправленному файлу. Читайте её только после терминального статуса
[`completed`](https://docs.accessful.de/ru/reference/job-status/); в любом другом состоянии игнорируйте.

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

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

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

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

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

- **Исправленное ничего не стоит.** Считаются только **открытые** находки. Всё, что
  Accessful успешно исправил, бесплатно — в этом и весь смысл преобразования.
- **Повторы не доминируют.** Множество находок *одного* типа сглаживаются логарифмически,
  поэтому одна и та же проблема на 200 страницах не штрафуется в 200 раз сильнее, чем на
  одной странице.
- **Ручная проверка дешева.** Некоторые проблемы нельзя надёжно исправить автоматически
  (например, «действительно ли этот альтернативный текст осмыслен?»). Они несут небольшой
  фиксированный штраф вместо полного веса серьёзности и оставляются на подтверждение
  человеку.

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

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

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

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

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

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

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

Чтобы сдвинуть число, **улучшите источник** — добавьте настоящий текстовый слой, дайте
реальные заголовки — и загрузите новый файл. Повторная отправка *тех же* байтов не
поможет: идентичное содержимое определяется как [дубликат](https://docs.accessful.de/ru/reference/upload/) и
пропускается.