Техническое задание: Ограничения для сохранения совместимости store с OKF v0.2

Исторический документ из ревизии 61e75e9. План отражает работы, предложенные в этой ревизии, и не является актуальной инструкцией по реализации. Исходный документ.

1. Вывод

Независимый от конкретного хранилища store уже не зависит от спецификации. Миграция рабочего API не нужна. Эта задача служит проверкой и защитой от ненужных изменений и закрывается после интеграции.

2. Не менять

• Store, Snapshot, ChangeSet;
• ChangeSetFormatVersion;
• Preview, CommitReceipt, CommitReceiptFormatVersion;
• формат передачи диагностики;
• валидацию store.Actor.

Новые группы полей метаданных в начале документа относятся к bundle/validator/mutation.

3. Граница квитанций

store.CommitReceipt — свидетельство долговечности транзакции. executor.receipt — артефакт исполнения Attested Computation.

Запрещено:

• добавлять квитанцию или вердикт исполнителя в CommitReceipt;
• повышать версию формата из-за OKF v0.2;
• превращать store в кеш исполнения или аттестации;
• ограничивать store.Actor соглашением об акторах метаданных документа.

4. Защитные тесты

Все тесты следуют AAA.

• Новые коды валидатора проходят через Preview.Diagnostics без потери code/file/severity/message.
• Пакеты v0.1 и v0.2 используют один транзакционный протокол.
• Акторы документа и прежние акторы хранилища принимаются; политика пробелов, управляющих символов и UTF-8 не меняется.
• JSON, похожий на квитанцию исполнителя, не принимается как каноническая квитанция транзакции.
• Существующие канонические байты ChangeSet/Receipt неизменны.

5. Критерии приёмки

• Публичные интерфейсы и версии форматов не изменились.
• Интеграционная проверка go test ./store ./mutation ./store/fs проходит.
• Документация явно различает две квитанции.

6. Вне рамок задачи

Исполнение, хранение и кеширование аттестаций, а также произвольная операция с исходными ресурсами, если она не потребуется отдельному контракту миграции.