Document verified lab 5 grades and archive the versioned pipeline
This commit is contained in:
@@ -0,0 +1,51 @@
|
||||
# lab5-versioned-pipeline Specification
|
||||
|
||||
## Purpose
|
||||
|
||||
Определяет наблюдаемые гарантии versioned pipeline и воспроизводимое доказательство идемпотентности для трека 2 оценки «5» README лабораторной 5.
|
||||
|
||||
## Requirements
|
||||
|
||||
### Requirement: Явная постановка версии
|
||||
|
||||
Оператор SHALL иметь команду reprocess с attachment-id и pipeline-version 1 или 2. Повтор той же версии SHALL возвращать noop без новой job или outbox. Для неизвестного вложения возвращается not_found, для pending/failed — conflict без изменения состояния; failed восстанавливается существующим replay. Успех queued SHALL означать durable job и outbox. Требование трассируется на README, трек 2.
|
||||
|
||||
#### Scenario: Одновременные операторские запросы
|
||||
- **WHEN** несколько команд запрашивают версию 2 одного вложения
|
||||
- **THEN** ровно одна получает queued, остальные noop; создаётся одна job версии 2 и одно намерение доставки
|
||||
|
||||
#### Scenario: Ошибочный запрос
|
||||
- **WHEN** указана неподдерживаемая версия, неизвестный id или failed-вложение
|
||||
- **THEN** новая работа не создаётся, оператор получает явную ошибку/результат отказа
|
||||
|
||||
### Requirement: Монотонная публикация различимых версий
|
||||
|
||||
Версии 1 и 2 SHALL давать детерминированные варианты с различимыми recipe при сохранении форматов/размеров контракта. API SHALL отдавать только опубликованную версию, published_version SHALL возрастать, а ready SHALL NOT откатываться. Работа или ошибка старой версии SHALL NOT перезаписывать новую. Ошибка одной версии SHALL NOT завершать всё вложение в failed, пока остаётся активная версия. Требование трассируется на README, трек 2 и contracts/attachment-states.md.
|
||||
|
||||
#### Scenario: Новая версия завершилась первой
|
||||
- **WHEN** версия 2 достигла ready до доставки версии 1
|
||||
- **THEN** последующая версия 1 не меняет опубликованные варианты; оригинал и байты версии 2 сохраняются
|
||||
|
||||
#### Scenario: Старый держатель завершился позже
|
||||
- **WHEN** worker версии 1 задержан после записи объектов, а версия 2 опубликована
|
||||
- **THEN** завершение версии 1 не перезаписывает опубликованный результат версии 2
|
||||
|
||||
#### Scenario: Уборка при активной версии
|
||||
- **WHEN** новая версия уже готова, а старый worker задержан до или после side effect и запускается очистка staging
|
||||
- **THEN** исходник активного worker сохраняется до его завершения; последующая обработка ready-вложения использует устойчивый опубликованный оригинал и не зависит от незавершённой уборки
|
||||
|
||||
#### Scenario: Ошибка при нескольких версиях
|
||||
- **WHEN** одна версия завершилась ошибкой, другая ещё обрабатывается
|
||||
- **THEN** вложение не становится failed до завершения оставшейся работы, а уже ready продолжает скачиваться
|
||||
|
||||
### Requirement: Воспроизводимые инварианты при отказах
|
||||
|
||||
Одна команда make track2 SHALL запускать контроль без отказа и автоматические duplicate, reorder, crash до/после эффекта, SIGKILL и stale job после версии 2. Результат SHALL включать UTC/SHA, фактические контейнеры, отсутствие потери подтверждённых 202, лишних эффектов и отката ready/версии, соответствие байтов метаданным и объектов собственных вложений ожидаемым ключам. Исследование SHALL содержать три последовательных повтора, сравнение, ограничения и объяснение at-least-once доставки. Требование трассируется на README, трек 2; унаследованные негативные сценарии остаются в спецификациях уровней 3/4.
|
||||
|
||||
#### Scenario: Повтор после эффекта
|
||||
- **WHEN** worker падает после PUT либо после COMMIT до ack и получает ту же job снова
|
||||
- **THEN** итоговое вложение доступно, лишнего набора вариантов нет, принятая job не потеряна
|
||||
|
||||
#### Scenario: Проверяемая серия
|
||||
- **WHEN** три раза последовательно выполняется make track2 с разными output paths
|
||||
- **THEN** каждый отчёт проверяет собственные принятые IDs, содержит реальные результаты и не удаляет данные предыдущих прогонов
|
||||
Reference in New Issue
Block a user