Files
MikrotikManager/docs/mcp-completion-plan.md
T

6.8 KiB
Raw Blame History

MCP: план завершения работ (ветка codex/mcp-foundation)

Составлен 15 ноября 2026. Отмечать выполненное: - [x]. Источники остатка: передача от 15 ноября, именованный реестр, полный план MCP.

Исходное состояние

  • В ветке нет коммитов поверх main (HEAD 5efd0339). Вся работа в рабочем дереве: 257 изменённых и 1985 новых файлов.
  • tsc --noEmit для фронтенда и бэкенда проходит. Тесты при составлении плана не запускались.
  • По записям Codex: 368 MCP-инструментов, 202 из 265 REST-маршрутов покрыты, 63 исключены, необработанных нет. Миграции 0015–0057, веб-раздел /mcp, транспорты HTTP и stdio, OAuth.
  • Открыты 7 направлений приёмки: POLL, DB, ROUTING, NATIVE, PATHS, EXTERNAL-UI, FINAL.
  • Мусор вне .gitignore: 2048 tmp-* в корне, 12 каталогов backend/dist-installation-memory*, .next-poll-rest-route-v2-20261030 (442 МБ), .serena. В docs/ 965 файлов, в основном JSON-квитанции. tsconfig.tsbuildinfo отслеживается Git.

Критерий завершения

Этапы 0–2 и 5 выполнены, MCP и контроллер выключены по умолчанию, ветка слита в main. Этап 3 идёт отдельными задачами по мере доступности стенда, этап 4 оформлен как явные решения.

Этап 0. Зафиксировать работу

  • Сделать копию рабочего дерева вместе с tmp/ (на него ссылаются квитанции, в Git его нет)
  • Дополнить .gitignore: tmp-*, backend/dist-installation-memory*, .next-poll-*, .serena
  • Снять с отслеживания tsconfig.tsbuildinfo
  • Решить судьбу квитанций в docs/: оставить живые md, остальное в docs/mcp-evidence/ или архив вне Git (решение владельца)
  • Прогнать поиск секретов по всем новым файлам
  • Сверить число миграций: в документах линия профилей 58, в backend/drizzle 57 sql-файлов
  • Коммит: контракты и миграции
  • Коммит: ядро backend/src/modules/mcp
  • Коммит: адаптеры по разделам
  • Коммит: веб-раздел /mcp
  • Коммит: тесты и скрипты
  • Коммит: CI и deploy
  • Коммит: документация

Этап 1. Локальная заморозка (FINAL-1)

  • npm run lint
  • npm run build (корень и backend)
  • test:mcp (корень и backend)
  • test:mcp:pg:all
  • Playwright: playwright.mcp.config.ts, playwright.mcp-auth.config.ts
  • Сверка карты покрытия: 265 маршрутов, 368 инструментов
  • Починить нестабильные сценарии Edge (39 из 41 без повтора)
  • Починить нестабильные сценарии маршрутизации (203 из 205 без повтора)

Этап 2. Хвосты кода без стенда

  • VRF: перенести в исходники поправку сборщика для afi=link из tmp/vrf-r2-gre-activation-review/sampler-projection.mjs, добавить тест
  • VRF: проверить, что разбор keepalive 10s и допуск бита I есть в исходниках, а не только в tmp
  • ROUTING: добавить /ip/dhcp-client в сверку (причина отказа V63)
  • ROUTING: выдача одноразового допуска автоматическому возврату (RT-3)
  • POLL: установить причину unknown из CI2713 или оформить как неустановленную
  • Inspector: прямой HTTP и OAuth (принят только stdio)
  • NetFlow: точный локальный адрес при wildcard-привязке

Этап 3. Стендовые приёмки (CHR и VPS)

  • VRF: отпечаток стабильных полей при активации GRE
  • VRF: полный прогон на 56 записей и проверка трафика при смене участников
  • ROUTING: повтор A → B → A после правки сверки
  • POLL: 336 операций с естественным истечением на Linux (окно от 252 минут)
  • POLL: deadline целевого Linux
  • EXTERNAL-UI: восстановить SSH к тестовому VPS (блокер)
  • EXTERNAL-UI: сквозной прогон на образах CI2736
  • EXTERNAL-UI: приёмка подписанного защищённого восстановления
  • DB-3: перенос непустой legacy-базы
  • DB-4: настоящие POSIX-права целевой среды
  • NetFlow: захват IPFIX с реального RouterOS
  • WireGuard / IPsec / GRE: жизненный цикл с трафиком

Этап 4. Заблокировано или отложено

  • PATHS: нет третьего независимого узла — получить узел или записать как ограничение
  • RAM-1 (лимит 2 ГиБ): отложен владельцем — вернуть в работу или записать как ограничение
  • autoRecovery: нет источника событий RouterOS с обнаружением пропусков — оставить выключенным, записать решение

Этап 5. Закрытие (FINAL-2 и FINAL-3)

  • Манифест: критерий плана → доказательство → статус, без перекраски failed и unknown
  • Инструкция по включению: наблюдение → подтверждения → ограниченная автономность
  • Проверить, что MCP и контроллер выключены по умолчанию
  • Сократить docs/mcp.md (417 КБ) до пользовательской документации
  • PR в main

Журнал

Дата Что сделано
2026-11-15 План составлен, код не менялся