docs(mcp): добавить документацию, аудиты вызовов и квитанции приёмки MCP

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
This commit is contained in:
DenozordecandClaude Sonnet 5.5 committed 2026-11-15 20:36:15 +07:00
1 parent 531d822338
commit 1d519b1734
945 files changed
+384627

No files matched your search

+87
View File
@@ -0,0 +1,87 @@
# MCP: план завершения работ (ветка `codex/mcp-foundation`)
Составлен 15 ноября 2026. Отмечать выполненное: `- [x]`. Источники остатка: [передача от 15 ноября](mcp-handoff-20261115.md), [именованный реестр](mcp-evidence-statistics-20261101.md), [полный план MCP](mcp-implementation-plan.md).
## Исходное состояние
- В ветке нет коммитов поверх `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 | План составлен, код не менялся |