chore(docs): разбор очереди POLL и правило прав опроса в плане B

Co-Authored-By: Claude Opus 5.5 <[email protected]>
This commit is contained in:
DenozordecandClaude Opus 5.5 committed 2026-11-20 02:54:37 +07:00
1 parent bd48368929
commit 7895e51855
2 files changed
+10

No files matched your search

+2
View File
@@ -31,6 +31,8 @@ RouterOS меняет link-local адреса (LL), connected-маршруты f
| 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 | Утвердить |
| 2.9 | (2026-11-19) | Опрос `servers.poll`: права свежие в начале этапа, перед каждой отправкой на RouterOS и перед `COMMIT` каждой пишущей транзакции данных приложения или DDL; журнал опроса и чтения — доказательство не старше 2 с. **Отличие от 2.2:** свежая проверка не перед каждым SQL-оператором записи и не после ACK, а перед `COMMIT`, который делает данные действующими (DDL транзакционный); журнал (учёт хода) — в окне 2 с, записи журнала MCP сами проверяют подключение и учётные данные в SQL | владелец (вариант 3 и «проверок ещё меньше»); формулировка правила — оркестратор | Отзыв, пришедший посреди транзакции, остановит её на `COMMIT`; изменения данных, DDL и отправки на RouterOS после отзыва не проходят; запись журнала о уже выполненном чтении может пройти в пределах 2 с. Проверок допуска за прогон в 112 раз меньше, операция в 6 раз быстрее | Утвердить |
| 2.10 | (2026-11-19) | Воркер разбирает очередь архивов POLL, пока писатель свободен (вариант 1); вариант 2 отклонён после чтения кода (см. план B) | владелец (1), оркестратор (отказ от 2) | Низкий: каждый архив — прежний двухтранзакционный цикл; уступает ждущему опросу | Утвердить |
Не сделано и требует твоего решения: держать ключ шифрования в памяти процесса (ещё ~8–20 с на тяжёлых приёмках) — сейчас ключ читается с диска при каждом использовании.
+8
View File
@@ -185,6 +185,14 @@
Любое исправление уводит прогон B с `7848e38a`: перед базовым снимком 1.3 нужно переразвернуть `mmapp-test` на новую сборку и повторить числа cold143.
### Решение владельца (2026-11-19): варианты 1, 2 и 3 — что сделано
- **Вариант 1 сделан.** Воркер вызывает `drainCompletedServerPollStorage` (`server-poll-terminal-compaction.ts`): прежний цикл «заявка → публикация» повторяется, пока писатель свободен, не дольше 20 с и не больше 64 архивов за тик; одиночный `compactCompletedServerPollStorage` и все его проверки не менялись. Каждый цикл заново берёт писателя через `pg_try_advisory_lock_shared`, поэтому опрос, уже ждущий исключительную блокировку, останавливает разбор (проверено на PostgreSQL). Тесты: модульный (повторный захват на цикл, остановка при занятом писателе), на PostgreSQL — очередь из трёх источников уходит за один вызов и за один тик, разбор уступает ждущему исключительному запросу, ёмкость 336 по-прежнему проходит.
- **Вариант 2 не сделан** (после чтения кода): почти все стадии тика (восстановление, хранение, компакция, снятие, сбор) требуют того же писателя и во время опроса всё равно отступили бы — выигрыша нет; а две стадии без него вредны: обнаружение дрейфа берёт `withConfigMutationLock`, которую опрос держит по всем серверам до 180 с (`server-poll-production.ts:156`, тик повис бы), профили маршрутизации пишут на роутеры.
- **Вариант 3 сделан, затем по просьбе владельца («проверок должно быть ещё меньше») сокращён ещё.** Итоговое правило для опроса: свежая проверка прав в начале каждого этапа (`prepare`/`execute`/`readExisting`), перед каждой отправкой на RouterOS и прямо перед `COMMIT` каждой пишущей транзакции, меняющей данные приложения или DDL (обслуживание разделов, публикация результатов); одна проверка на всю такую границу. Журнал опроса (учёт хода уже разрешённой операции) и чтения используют доказательство не старше 2 с; записи журнала MCP при этом сами проверяют подключение, учётные данные и область в SQL своей транзакции (`server-poll-journal.ts:104–111`). Отказ не переиспользуется. Точки: `server-poll-durable-session.ts` (кеш по набору серверов, сброс в начале этапа), `freshPollAuthority` в `server-poll-storage.ts`, `COMMIT` пишущей транзакции в аренде разделов и в запасной транзакции, `beforeDispatch` отправки на RouterOS. Функция допуска только читает (`BEGIN READ ONLY … ROLLBACK`); с задержкой до 2 с вне свежих границ замечаются: статус/режим/область/срок подключения, права, поколение доступа, защиты, каталог серверов, отзыв портала.
- **Замеры (Windows, локально), холодный опрос cold143.** Настоящих проверок допуска: ~3 700 → 32. Время самой операции (план → одобрение → применение → итог): 19,9 → 3,2 с (весь тест вместе с запуском приложения 27,5 → 6,8 с). SQL-запросов 62 783 → 2 272. Числа 143/22/54/4/151 прежние. Профиль CPU: собственная работа опроса теперь мала, остаток — ожидание PostgreSQL (полные перечитывания контекста перед эффектами ~0,8 с — защита от смены конфигурации, не трогалась — и сами DDL ~1 с). Тест устойчивого опроса: проверок за прогон 17 108 → 152 (в тест добавлена граница 300). Новый тест: отзыв прав при удержанных чтениях RouterOS — опрос отклоняется, после отзыва нет ни одного `COMMIT` обслуживания или публикации и нет итога, каждый дошедший до RouterOS запрос был разрешён и записан в журнал до отзыва (журнал самих чтений может записаться в пределах 2 с).
- **Длительность B2 пока не обещается**: ускорение 2,9× получено на Windows. Время операции на VPS измерить на этапе П1 до запуска B2.
## Прогон B2 по часовым этапам
B2 остаётся **одним непрерывным прогоном** (перезапуск посреди B2 по плану даёт `failed`/`unknown`, а отдельно запускаемые куски меняли бы критерий). Часовые этапы — это контрольные точки с решением «продолжать / остановить» по числам из `support.py monitor` (опрос не чаще раза в 10–15 минут, VPS не нагружается). Подготовка и B1 идут до B2.