26 lines
2.6 KiB
Markdown
26 lines
2.6 KiB
Markdown
# Design
|
||
|
||
## Context
|
||
|
||
Связанный change arm-core — `use-installed-statements-library`; обновление аннотаций общей схемы одобрено пользователем 23.10.2026. Файл схемы в docs — источник истины для побайтовых копий сервисов.
|
||
|
||
## Goals / Non-Goals
|
||
|
||
**Goals:** согласовать descriptions и явно подтвердить отсутствие изменений валидируемой структуры.
|
||
|
||
**Non-Goals:** изменение версии/ограничений контракта, правка docs/source, запуск миграций, обновление runtime других сервисов.
|
||
|
||
## Decisions
|
||
|
||
Обновить только корневой description и description поля service.statements_version по согласованному тексту arm-core. Проверить глубокое равенство JSON до/после без этих двух аннотаций и точное совпадение файлов docs/arm-core. Использовать существующий валидатор примеров и тест сверки копий. Отдельные дельты требований не нужны (`skip_specs: true`), поскольку нормативный формат не меняется.
|
||
|
||
Контекст получает короткие заметки о переходе arm-core; они не объявляют переход остальных сервисов завершённым.
|
||
|
||
## Decisions made without discussion
|
||
|
||
23.10.2026: сохранить schema_version 2.0 при изменении только descriptions. Обоснование — множество валидных входов и структура результата неизменны. Цена ошибки — неверная маркировка релиза; проверяется сравнением JSON без двух изменённых аннотаций. Обновление общей схемы вместо отката локальной копии выбрано пользователем.
|
||
|
||
## Risks / Trade-offs
|
||
|
||
[Другие копии схем ещё содержат прежний текст] → перечислить производителей и потребителя в proposal; их копии могут быть синхронизированы отдельными изменениями. [Контекст по другим сервисам не проверялся] → заметки ограничены arm-core.
|