chore(docs): сводка решений по MCP и стенду для ревью владельца

Co-Authored-By: Claude Opus 5.5 <[email protected]>
This commit is contained in:
DenozordecandClaude Opus 5.5 committed 2026-11-19 18:27:31 +07:00
1 parent 67d592d105
commit 6b6410fe57
1 file changed
+57
+57
View File
@@ -0,0 +1,57 @@
# Ревью решений по MCP и стенду (2026-11-19)
Сводка решений, принятых по ходу этапа 3, которые меняют поведение продукта или смысл приёмки. По каждому: что сделано, на чём основано, риск и рекомендация. Колонка «Кто решил»: **владелец** — решение уже принято тобой, нужна только финальная проверка; **оркестратор** — принято мной по цели, нужно твоё утверждение.
Контекст: A2 пройден на слое v28 (продукт `1e96ddac`), `docs/mcp-stand-run-a-plan.md`, раздел «A2, слои v26–v28».
## 1. Продукт: допуски VRF к поведению RouterOS
RouterOS меняет link-local адреса (LL), connected-маршруты fe80 и состояние GRE не атомарно и не мгновенно, а продукт читает адреса и маршруты отдельными запросами. Без этих правок запись VRF отклонялась, хотя на роутере всё было верно.
| # | Коммит | Что | Кто решил | Риск | Рекомендация |
|---|---|---|---|---|---|
| 1.1 | `bffa3086` | Перечитывать роутер, если GRE мигнул после записи VRF | оркестратор | Низкий: принимается только состояние, прошедшее ту же проверку | Утвердить |
| 1.2 | `2a11ea3b` | Пропажа LL у GRE без MAC временная и для неизменяемых участников | оркестратор | Низкий: только перечитывание, не принятие | Утвердить |
| 1.3 | `680c888a` | Перечитывать при пропаже LL и маршрута у любого участника | оркестратор | Низкий: то же | Утвердить |
| 1.4 | `eec984f3` | Предел перечитываний 8, пауза 2 с | оркестратор | Низкий: операция может ждать до ~30 с перед отказом | Утвердить |
| 1.5 | `782d1d52` | **Принять пропажу автоматического LL пустого моста при выходе из VRF** | владелец («принимаю пропажу») | **Средний**: на CHR2 LL возвращается за ~6 с, не возвращался только на CHR1 после нештатной перезагрузки. Возможно, это аномалия CHR1, а продукт теперь принимает её для любого пустого моста | Утвердить, но проверить на CHR1 после штатной перезагрузки (`exp-bridge-ll.mjs`); если LL вернётся, сузить допуск |
| 1.6 | `ca82dade` | Принять однократный возврат LL моста при сверке с запечатанной точкой | оркестратор (следствие 1.5) | Низкий | Утвердить вместе с 1.5 |
| 1.7 | `0dc1f7c9` | Перечитывать, если маршрут fe80 моста вернулся раньше его LL | оркестратор | Низкий: принятие только без «висящего» маршрута | Утвердить |
| 1.8 | `1efc265e` | Перечитывать, если маршрут fe80 задержался после ухода LL | оркестратор | Низкий | Утвердить |
## 2. Продукт: скорость при той же итоговой защите
| # | Коммит | Что | Кто решил | Риск | Рекомендация |
|---|---|---|---|---|---|
| 2.1 | `4e4c8717` | REST к RouterOS переиспользует соединение, закрывает его через 2 с простоя (RouterOS держит 30 с), лимит 2 сессии на роутер сохранён | оркестратор | Низкий: замер на CHR, тесты транспорта | Утвердить |
| 2.2 | `65846441` | **Права раз на этап**: свежая проверка в начале шага, прямо перед отправкой, после ACK и перед каждой записью; чтения внутри этапа используют доказательство не старше 2 с | владелец | Отзыв прав замечается не мгновенно, а в пределах 2 с — но только для чтений; ни одна запись без свежей проверки не уходит | Утвердить |
| 2.3 | `65846441` | Параллельное чтение каталогов (не больше 2 соединений на роутер) | владелец | Низкий: порядок снимка прежний | Утвердить |
| 2.4 | `65846441` | **Отказ VRF только повторный**: отказ классификатора окончательный, если тот же отказ повторился на свежем чтении | владелец | Настоящее изменение на роутере остаётся и отклоняется на втором чтении (+2 с к отказу). Единое правило вместо точечных заплаток 1.1–1.8 | Утвердить; позже упростить 1.1–1.8 до этого правила |
| 2.5 | `65846441` | Конфликт каталога перед отправкой помечает операцию «не отправлено» (`rejected`, а не `unknown`) | оркестратор | Низкий: следует контракту `beforeDispatch` (запись не уходит) | Утвердить |
| 2.6 | `af4203d9` | Сервисы WireGuard: собственная проверка раз на этап для чтений; перед записью свежая. `assertVerifiedConfigurationReadAccess` только для чтений | владелец (как 2.2) | Как 2.2 | Утвердить |
| 2.7 | `af4203d9` | `access-generation` и отметки отзыва портала проверяются через `stat` и перечитываются при изменении файла (замена видна сразу) | оркестратор | Низкий на NTFS/ext4; на ФС с грубой точностью времени изменение в ту же секунду с тем же размером было бы не замечено | Утвердить |
| 2.8 | `171c0e61` | scoped-маршрутизация и IPsec: проверка раз на этап для чтений; сверка IPsec осталась строгой | владелец (как 2.2) | Как 2.2 | Утвердить |
Не сделано и требует твоего решения: держать ключ шифрования в памяти процесса (ещё ~8–20 с на тяжёлых приёмках) — сейчас ключ читается с диска при каждом использовании.
## 3. Стенд: смысл приёмки A2 (доказательство раннера)
| # | Слой | Что | Кто решил | Риск | Рекомендация |
|---|---|---|---|---|---|
| 3.1 | v3 | Стабильная проекция `/routing/route` без полей FIB (`active`, `debug.fwp-ptr`, `nexthop-id`, …) | владелец (16.11) | — | Решено |
| 3.2 | v5 | link-маршрут интерфейса VRF принадлежит VRF | владелец (16.11) | — | Решено |
| 3.3 | v7 | FIB-внутренности динамические на своих доменах `/routing/route` только в шагах VRF | **оркестратор** | Низкий: это состояние таблицы пересылки, не конфигурация | Утвердить |
| 3.4 | v8 | Финальная сверка без полей выполнения: счётчики `/interface`, история линка, статус DHCP, счётчики fast-path, uptime BGP, netwatch, динамические сессии `/ip/service` | **оркестратор** | Низкий: конфигурационные поля сверяются строго | Утвердить |
| 3.5 | v14–v15 | Пинг при изоляции: допустимы статусы `timeout`, `net unreachable`, `host unreachable`, `no route to host` (по документации MikroTik это и есть отсутствие маршрута), у строк `net unreachable` допустимы поля `host`/`time` (роутер, приславший ICMP-ошибку); 0 ответов, 100 % потерь и GRE-контроль 3/3 строгие | **оркестратор** (по документации; в журнале помечено «требуется решение владельца») | Низкий | Утвердить |
| 3.6 | v16/v20 | Пропажа LL пустого моста при `DELETE VRF` и при PATCH членства, одно последующее появление тех же ключей | владелец | Связано с 1.5 | Решено; пересмотреть вместе с 1.5 |
| 3.7 | v17 | Окно ожидания операции 300 с | владелец | — | Решено |
| 3.8 | v26 | Стоимость 68, `mutationsPerHour` 80 | владелец | — | Решено |
| 3.9 | v28 | Проверка после записи перечитывает каждые 2 с (до 8 раз) | владелец | Низкий | Решено |
| 3.10 | v28 | **Стабильность**: принятый снимок не должен меняться ещё 2 чтения | **оркестратор** | Строже 3.9; цена ~10–15 с на запись в проверках стенда | Утвердить |
| 3.11 | v28 | Каждая попытка начинает с одного сохранённого долга допущения 3.6 | **оркестратор** (исправление ошибки) | Нет: без этого повтор ломал утверждённое допущение | Утвердить |
## 4. Что ещё стоит знать
- Прогоны A2 до v28 шли на backend, собранном 15.11: слои подменяли только 4 файла VRF. v28 — первый прогон на текущем продукте (21 файл подменён, связывание и сценарии проверены).
- `verifyMcpHostFiles` один раз из четырёх упал (`rejected` до отправки), причина не установлена; в тест добавлен `error_code`.
- Ожидают решения вне ревью: скачивание `autosupout.rif` с CHR1 (нужен твой OK), пункты этапа 4.