diff --git a/docs/architecture/14-api-contract/README.md b/docs/architecture/14-api-contract/README.md index d2ef3401..f109cb15 100644 --- a/docs/architecture/14-api-contract/README.md +++ b/docs/architecture/14-api-contract/README.md @@ -976,6 +976,15 @@ first built format»), и условие наступило. Набор — то формами внутри. `book_id` при `run_in_flight` — ЭТА ЖЕ книга: место, где пользователь может действовать, — карточка её собственного прогона, а не чужой. +⛔ **ЭРРАТА В ПРЕДЕЛАХ ТОГО ЖЕ МИНОРА (11.09, нашёл адверсариальный верификатор приёмки, не я).** Минор +довёз прозу только до ПОЛОВИНЫ носителей: схему `Blocked` расширили, а описание свойства +`RunOptions.blocked`, которое на неё ссылается, осталось прежним — «почему шкала МЕНЬШЕ, чем аккаунт мог бы +себе позволить». Для `run_in_flight` оба его утверждения ЛОЖНЫ: названа ЭТА книга, а не другая, и шкала не +укорочена (`verdict` остаётся `covers_all`). А правило канона о себе (§«The rule binds the PROSE too») +говорит, что каждое описание здесь компилируется в исходник генерённого клиента. ⇒ проза довезена тем же +номером версии, потому что построенного клиента на 0.14.0 ещё нет и потреблена она не была; бампа это не +требует, но умолчания — тем более. ⚠ Гейт словаря зоны проверяет ENUM и прозы не видит по построению. + **Порядок.** Форма ратифицирована ДО стройки (как `D39.235` п.6 для кадра остановки): иначе сессия зоны либо ставит константу версии и красит собственный гейт, либо строит механизм, объявляя старую версию. Константа `httpapi.ContractVersion` уезжает ТЕМ ЖЕ лендингом, что и код. diff --git a/docs/architecture/14-api-contract/openapi.yaml b/docs/architecture/14-api-contract/openapi.yaml index 21513a41..e797c576 100644 --- a/docs/architecture/14-api-contract/openapi.yaml +++ b/docs/architecture/14-api-contract/openapi.yaml @@ -2744,9 +2744,13 @@ components: - $ref: '#/components/schemas/Blocked' - type: 'null' description: | - Why the scale is smaller than the account could otherwise afford, or `null`. Without it - an account's second book shows a shrunken scale with no way to learn that its own first - book is the reason. + Why a start is not offered the way the balance alone would promise, or `null`. Two shapes + of that, and they differ in WHICH book is named: the scale is SHORTER than the account + could otherwise afford — without it an account's second book shows a shrunken scale with + no way to learn that its own FIRST book is the reason; or a start is impossible right now + however much credit there is, and then the book named is THIS one, whose own run is in + flight. In the second shape the scale is NOT shrunk and `verdict` may still be + `covers_all`: the two fields answer different questions and a client reads them together. OrderOptions: type: object