Files
MikrotikManager/docs/mcp-poll-retained-capacity.md
T

33 lines
5.6 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# Журнал полного опроса: наблюдение и эксплуатационная ёмкость
MCP → Обзор показывает заполнение журнала полных опросов. Личная квота учитывает сохранённые admissions одного владельца во всех его подключениях; общая — admissions всех владельцев. Это **не concurrency**. Успешное завершение, отказ, отключение MCP и повторное обращение не возвращают квоту сами по себе.
Текущая политика из `SERVER_POLL_STORAGE_POLICY` и штатной миграции 0039:
| Резерв | Личный лимит | Общий лимит |
| --- | ---: | ---: |
| Admissions | 8 | 128 |
| Строк на одну admission | 4019 | 4019 |
| Байт на одну admission | 8421376 | 8421376 |
Полный фиксированный резерв сохраняется до штатной retention GC. Интерфейс показывает текущий срок для **новых** admissions из MCP settings; более ранние admissions сохраняют собственный срок. Освобождение требует завершения/допустимого terminal state исходной операции, истечения исходного допуска, полного срока после последней учитываемой активности, защитного интервала и обработки worker. Карточка не прогнозирует точное время GC и не запускает очистку.
## Практическая оценка
При стандартных 14 сутках даже восемь успешно завершённых опросов подряд исчерпывают личную квоту. Номинальная верхняя оценка равномерного расхода составляет `8 / 14 ≈ 0,57` admission в сутки на владельца и `128 / 14 ≈ 9,14` на всех владельцев; исходный expiry, более поздняя активность и интервал GC могут уменьшить фактическую доступность. Например, для одного опроса в час за 14 суток потребовалось бы не менее 336 личных admissions; текущий лимит 8 такой режим не поддерживает.
Следовательно, нынешняя политика подходит для редких ручных полных опросов и **не принята как достаточная ёмкость для частого автономного polling**. UI и оценка устраняют неясность лимита; широкая активация требует отдельного пересмотра demand/capacity/retention с учётом storage budgets и новых SQL/restore-тестов. Эта правка не повышает лимиты и не уменьшает сроки хранения.
## UI, приватность и отказ
- Владелец видит свои used/limit/remaining. Только MCP administrator получает числовую общую квоту; остальные видят лишь признак её заполнения, без чужих ID или счётчиков.
- Заполненная личная либо общая квота даёт явное сообщение и пояснение автоматической очистки. Свободная личная квота не отменяет заполненную общую.
- Недоступные таблицы/settings, некорректные bigint, неполные/несогласованные reservations и ошибка запроса дают `unavailable`, а не нули или зелёный статус. Старый API без нового поля также считается unavailable.
- При ошибке обновления интерфейс скрывает прежний положительный статус. Любое наблюдение остаётся снимком: окончательный admission выполняется исходным SQL-механизмом при запуске.
Существующий `/api/mcp/overview` получает поле `pollStorageCapacity`. Отдельного endpoint, нового MCP tool или разрешения на исполнение не добавлено. Owner/admin выводятся из актуального portal actor. Одно read-only SQL statement читает settings и ровно два scope counters; нет обхода admissions, вызова GC, блокировок строк или записей. Backend использует ограниченный трёхсекундный owned connector и уничтожает опоздавшее соединение.
## Приёмка
[Отчёт](mcp-poll-retained-capacity-acceptance-20261026.json): actual PostgreSQL `READ ONLY` с owner 8/global 128, privacy и unchanged counters, весь storage/restore-профиль, unit/contract tests, MCP Playwright desktop/mobile и визуальная проверка. UI использует существующие ReUI Badge/Button и стиль MCP-раздела. Изменения production/CHR, ручная очистка и deploy не выполнялись.