# Правила именования операций OpsRegistry

Код исполнимой операции имеет форму `domain.resource.action`.

- `domain` — устойчивая предметная область;
- `resource` — объект предметной области;
- `action` — глагол, выражающий наблюдаемый результат.

Правильные примеры: `logistics.shipment.quote`, `finance.merchantPayment.create`,
`manufacturing.workpiece.cut`, `it.identity.token.revoke`.

Код не содержит провайдера, имя его API, технологию, материал или тариф. Эти различия передаются
параметрами контракта, тегами capability и реализацией адаптера.

Новая операция нужна, когда меняются наблюдаемый результат, жизненный цикл, юридический смысл, контракт
данных или независимая политика доступа. Если меняется только способ выполнения, используется
параметр, тег или capability.

Канонические описания хранятся на английском, переводы — в `translations` по BCP 47 language tag.
Коды, версии, статусы и теги не переводятся.

Полная спецификация:
https://gitflic.ru/project/opsregistry/registry/blob?file=docs%2Foperation-naming.md

Операции охватывают бизнес, программы и оборудование и могут относиться к разным уровням.
Прямая и составная реализации через другие операции сохраняют один внешний контракт.
Разложение не требует нового кода операции. Не каждый пользовательский шаблон становится
канонической операцией. Не дробите осмысленное действие до SDK-вызовов; одна операция
не обещает общего rollback, а откат шагов не доказывает откат всей цепочки.
Общий декларативный формат композиции и resolver пока не реализованы.