Files
mtusi2026lab5/experiments/docs/HYPOTHESIS.md
T

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`: такой исходник
не позволяет различить версии по содержимому.