45 lines
4.5 KiB
Markdown
45 lines
4.5 KiB
Markdown
# Гипотеза и критерии
|
|
|
|
## Гипотеза H1
|
|
|
|
При повторной доставке, перестановке сообщений и остановке процессов система
|
|
сохраняет принятые задания, завершает последнюю запрошенную версию обработки
|
|
и предотвращает замену её результата устаревшей задачей или попыткой.
|
|
|
|
Область проверки: один Docker-host, три профиля синтетических PNG, версии
|
|
обработки v1/v2 и девять сценариев из [методики](METHODOLOGY.md).
|
|
Параметры серии заданы в [protocol.json](../config/protocol.json).
|
|
|
|
## Инварианты
|
|
|
|
| Инвариант | Условие выполнения |
|
|
| --- | --- |
|
|
| Сохранность задания | Ответу upload 202 соответствуют записи вложения и задания в PostgreSQL. Принятому обновлению версии соответствуют новое задание и запись аудита. |
|
|
| Завершение обработки | Последняя запрошенная версия достигает `ready` за 180 секунд после восстановления процессов или снятия паузы. |
|
|
| Учёт предыдущей версии | Предыдущее задание сохраняется. Статус `superseded` связан с существующим заданием новой версии, которое в итоге завершилось. |
|
|
| Монотонность публикации | Версии в журнале публикаций не убывают. После публикации v2 доставка v1 и продолжение старой попытки не меняют доступный результат. |
|
|
| Целостность данных | Оригинал побайтно совпадает с принятым файлом. MIME, размеры, длины и SHA-256 вариантов соответствуют метаданным и содержимому S3. |
|
|
| Идемпотентность результата | На опубликованную версию приходится три ключа: `thumbnail`, `crop`, `optimized`. Повтор завершённого задания не создаёт новую попытку или публикацию. |
|
|
|
|
Ключи вариантов разделены по версиям. SHA-256 опубликованной v2 сравниваются
|
|
до и после доставки старых сообщений. Повторная запись тех же байтов по тому же
|
|
ключу после сбоя допустима.
|
|
|
|
## Оценка результата
|
|
|
|
Основной показатель — число случаев с нарушением хотя бы одного инварианта.
|
|
|
|
| Итог | Критерий |
|
|
| --- | --- |
|
|
| `supported_in_tested_conditions` | Выполнены все 135 случаев; нарушения, невалидные случаи, OOM и пропуски обязательных артефактов отсутствуют. |
|
|
| `refuted` | Обнаружено нарушение инварианта или непредусмотренный OOM при заданных лимитах ресурсов. |
|
|
| `inconclusive` | Серия неполна, отказ не был введён, нарушена изоляция, изменились исходники или данных недостаточно для проверки. |
|
|
|
|
Переход допустимого изображения в `failed`, потеря записи и превышение 180 секунд
|
|
считаются нарушениями. Ошибки и неудачные случаи сохраняются вместе с успешными.
|
|
Автоматическое восстановление после OOM не отменяет зарегистрированную ошибку.
|
|
|
|
Ошибка настройки до приёма задания относится к невалидному случаю. Совпадение
|
|
контрольных сумм вариантов v1/v2 также помечается как `invalid`: такой исходник
|
|
не позволяет различить версии по содержимому.
|