Files
MikrotikManager/docs/mcp-stand-run-c-plan.md
T

47 KiB
Raw Blame History

Прогон C этапа 3: план стендовой приёмки внешнего интерфейса и БД на целевом Linux

Составлен 17 ноября 2026 года только чтением репозитория и tmp/. VPS, CHR и Gitea не затрагивались: SSH, Docker, REST и скрипты, включая режимы --check, не запускались. Пункты плана взяты из плана завершения, раздел «Этап 3», абзац «Прогон C». Форма документа повторяет план прогона A.

Обозначения: [ист.: файл] означает, что факт прочитан в указанном файле; [вывод] означает вывод автора плана, на стенде он не проверен. Пароли, ключи и токены в документе отсутствуют намеренно.

Главный вывод. Из четырёх пунктов прогона C готовый пакет есть только у одного: сквозного прогона на образах CI2736. Но он привязан к образам с 56 миграциями, которые на VPS, скорее всего, отсутствуют, а сам пакет ни разу не запускался. Приёмка подписанного защищённого восстановления и DB-4 сводятся к одному новому Linux-пакету на основе локального сценария --owned-restore58-ready, в котором подделка POSIX-проверки заменена реальной. DB-3 в текущем продукте выполнить нельзя. Единственный реальный legacy-артефакт — дамп с 12 миграциями. Контролируемый путь миграций отказывает непомеченной базе с префиксом 0. Цепочка legacy-* требует ровно 36 миграций и доступна только через тестовые раннеры. Нужно решение владельца (D-C4). Пункт «восстановить SSH к VPS» выполнен: вход по ключу через алиас mm-vps под root [ист.: постановка задачи].

1. Цель и критерий «принято» по пунктам

Цель: за одну или две сессии на mm-vps закрыть пункты прогона C. Каждый пункт пишет отдельную квитанцию; failed и unknown не перекрашиваются [ист.: mcp-completion-plan.md, этап 3]. Все сценарии работают в собственных изолированных проектах Docker и не меняют mmapp-test. CHR не затрагиваются: ни один сценарий не использует реальный маршрутизатор [ист.: ci2736-owned-portal-browser/README.md, шаг 4: «No real router or provider account is used»].

# Пункт «Принято» означает Квитанции
C0 EXTERNAL-UI: восстановить SSH к тестовому VPS Выполнено до плана: ssh mm-vps по ключу под root работает. В плане остаётся только сверка отпечатка ключа хоста в шаге 1.1 Отметка в mcp-completion-plan.md (владелец или координатор)
C1 EXTERNAL-UI: сквозной прогон на образах CI2736 (или преемнике по D-C1) Четыре сервиса (Manager backend и frontend, Portal, PostgreSQL) подняты из образов, привязанных к OCI-дайджестам, в новом пустом проекте; число миграций в базе равно заявленному. Браузер Edge через три SSH-проброса создаёт синтетического владельца Portal. Он подтверждает и исполняет одно глобальное изменение настроек логов, открывает шаг операции и перезагружает его URL. Затем отключение в Portal даёт подписанное HTTPS-событие. Проверяются точный HTTP 401 без деталей операции, одна навигация на вход Portal, отсутствие старого шага, аудит подписанного отзыва и отказ установленному SDK. Раннер подтвердил очистку проекта и томов, прежние контейнеры не изменились browser-result.json (неконфиденциальный), терминальная квитанция раннера. Сценарий: [ист.: ci2736-owned-portal-browser/README.md, шаги 1–6]
C2 EXTERNAL-UI: приёмка подписанного защищённого восстановления На целевом Linux, в собственном PostgreSQL 18 с TLS и пятью ролями (runtime, operator, capture, publisher, control), выполнена процедура «Подтверждённое восстановление с подписанным профилем source58». Утверждённые хеши архива и данных проходят через db:stage-restore-checkpoint, одноразовый допуск выдаётся через db:serve-restore-claims, одно восстановление доходит до applied-consumed. source-catalogue-inspect и upgrade (rebind) дают новую подписанную эпоху; затем выполняются db:seal-restore-checkpoint и db:complete-restore. Новый процесс отклоняется при consumed и до rebind; seal отклоняется до новой эпохи; запуск отклоняется до complete. После снятия карантина два новых процесса backend проходят штатный старт, и защищённая запись (PUT /api/logs/settings) возвращает новое значение. Подменённый архив отклоняется. Отличие от локальной приёмки: platformFilesVerified=true, то есть реальные POSIX-файлы вместо синтетического подтверждения. Плюс браузерная часть (по D-C8): само восстановление запускается из Edge (загрузка PGDMP, план с точным хешем, одно подтверждённое apply), как в принятой UI2-приёмке, но с заданными DATABASE_RESTORE_ARCHIVE_SHA256 и DATABASE_RESTORE_DATA_SHA256. Тогда служебный журнал database-maintenance.jsonl содержит записи с HMAC, и readMaintenanceRecoveryFacts(...).authenticated = true. Прежняя UI2-приёмка дала signedProtectedJournal:false, и передача прямо пишет, что «отдельная приёмка подписанного служебного журнала защищённого восстановления остаётся открытой» [ист.: tmp/mcp-ui2-restore-mounted-20261115/result-owned-Dt6pur.json; run.mjs:171–177; backend/src/services/database-maintenance-startup.ts:127–155; mcp-evidence-statistics-20261101.md, стр. 100] Новая квитанция по форме restore58-ready-verification.json с platformFilesVerified=true и fixtureSourceAttestor=false (если решено D-C3), плюс браузерная квитанция по форме result-owned-*.json с signedProtectedJournal:true, applySubmissions:1, automaticRetry:false. Процедура: [ист.: docs/mcp-database-maintenance.md, раздел «Подтверждённое восстановление…»]. Локальный образец и его ограничения: [ист.: tmp/mcp-writer-restore58-owned/restore58-ready-verification.json: platformFilesVerified:false, readyAuthorized:false, fixtureSourceAttestor:true]
C3 DB-3: перенос непустой legacy-базы По критерию DB-3: внутренний верификатор и операторская инспекция связаны с исходным поколением, подтверждённые записи переносятся под блокировками без фиктивных маркеров и MAC, остальные явно unresolved. Нужны положительное восстановление и отказ при подмене. Всё это на реальной непустой базе старой схемы, а не на тестовой fixture [ист.: mcp-remaining-work-20261026.md, таблица DB-1…DB-4]. Сейчас невыполнимо без решения D-C4, см. блокер CB5 Зависит от D-C4
C4 DB-4: настоящие POSIX-права целевой среды На той же Linux-среде образов, что в C2: операторские файлы (bootstrap.json, signing-private.pem, транспорт, CA, журнал, каталоги активации и реестра) созданы с правами 0600 и 0700 от фактического UID процесса. Отрицательные случаи отказывают до подключения к БД: группа или остальные имеют доступ, чужой владелец, символьная ссылка, существующий каталог при init. Ключи и журнал не восстанавливают прежний действующий доступ; архив с объектами mmapp_control отвергается; ошибка или перезапуск не запускают потребителей [ист.: mcp-remaining-work-20261026.md, DB-4; mcp-db-offline-bootstrap.md, «Файлы и повторный запуск»; backend/src/services/database-dump-connection.ts, стр. 169–184] Квитанция пакета C2/C4 (общий прогон) с отдельным разделом posix, плюс вывод database-writer-bootstrap-operator.mjs init (только публичный отпечаток)

2. Предусловия и решения владельца

2.1. Факты о стенде на 17 ноября

  • mm-vps: Debian 13, ядро 6.12, ОЗУ 2 ГиБ (доступно около 1,1 ГиБ), диск 25 ГБ (свободно около 11 ГБ), Docker 29.8.2. Установка /opt/mmapp-test на образах mcp-5ec95a7c (Gitea, запуск 2738). База обновлена с 12 до 57 миграций по legacy-пути, схема mmapp_control пуста. Дамп до обновления: /root/backups/mmapp-test-pre-mcp-20261116T032408Z.dump (46 МБ), копия .env в /root/backups [ист.: постановка задачи; mcp-completion-plan.md, журнал 2026-11-16].
  • 16 ноября на VPS удалены кэш сборки и неиспользуемые образы старше 7 дней [ист.: mcp-completion-plan.md, этап 3, D7 плана A]. Остались ли образы CI2736 и Portal CI2586, не проверялось [вывод: вероятно, удалены или никогда не загружались. Передача от 15.11 говорит «локально нет контейнерного runtime, последний строгий SSH BatchMode к тестовому VPS отклонил вход», ист.: mcp-handoff-20261115.md, строка Portal / EXTERNAL-UI].
  • В базе mmapp-test два сервера: оба CHR прогона A [ист.: постановка задачи]. Значит, дамп до обновления тоже содержит эти серверы и их зашифрованные учётные данные [вывод].
  • Образ backend не задаёт USER, а compose mmapp-test не задаёт user:. Значит, штатно backend работает от root внутри контейнера [вывод по backend/Dockerfile и deploy/docker-compose.test.yml; фактическое /opt/mmapp-test/docker-compose*.yml не читалось].
  • В образе backend есть только backend/dist, backend/dist-operator и производственные зависимости. tsx, src и embedded-postgres отсутствуют [ист.: backend/Dockerfile]. Скрипты db:* из package.json вызывают tsx src/scripts/… и в образе не запускаются. Скомпилированные аналоги ожидаются в dist/scripts/ [вывод].

2.2. Блокеры, найденные в файлах

# Блокер Где видно
CB1 Пакет CI2736 привязан к старому снимку. binding.json: Manager a3bf3574… и Portal ef7bb79d… (CI2586), 56 миграций, runtimeRun:false; закреплены дайджесты четырёх образов в git.shx.one/…. Раннер «never pull images»: если кэша нет, подготовка останавливается. Текущий HEAD 5ec95a7c собран в CI2738 с 57 миграциями ci2736-owned-portal-browser/binding.json, README.md, runner.py:119–124
CB2 Локальные требования браузера. browser.mjs требует ровно Node v22.23.4 и Edge (channel: 'msedge') с закреплёнными зависимостями Playwright и SDK; проверяется assert.equal(process.version,'v22.23.4'). Наличие этой версии Node на Windows не проверялось browser.mjs:13, 78
CB3 Память. Лимиты compose CI2736: postgres 384 МиБ, backend 512 МиБ, frontend 160 МиБ, portal 256 МиБ, в сумме 1312 МиБ. Это больше доступных ~1,1 ГиБ при работающем mmapp-test (≈565 МБ). Прежний похожий прогон CI2678 v5 на том же VPS дал минимум 870 МиБ доступной памяти при меньшем наборе [ист.: mcp-current-progress.json, currentWholeInstallationPreviewLocalReview] compose.json
CB4 Для C2 и C4 нет Linux-пакета. Локальный run-owned.mts --owned-restore58-ready использует EmbeddedPostgres, исходники через tsx и синтетическое подтверждение платформы (стр. 315–316: «Synthetic attestor for the Windows-only integration; no POSIX/source registry acceptance»). Режим --owned-linux-cli есть, но требует Linux, Node 22 и непривилегированного пользователя (getuid()>0, стр. 61). Он описан как «Local evidence builder against a disposable database and synthetic signing key» tmp/mcp-writer-restore58-owned/run-owned.mts, стр. 1–5, 56–61, 315; tmp/mcp-writer-current57-local-tls/run-owned.mts
CB5 DB-3: продуктового пути для реальной legacy-базы нет [вывод из кода]. (1) executeControlledSqlMigrations вызывается только тестовым legacy-probe-handoff-execute-owned.mjs; штатный старт (bootstrap.ts) использует legacy applySqlMigrations. (2) На пустой контрольной истории baseline(prefix 0) отказывает при любых объектах public: «Legacy or unmarked application state cannot be enrolled». (3) Цепочка legacy-handoff-* требует истории ровно 36 миграций (exactHistory(...) !== 36). Довести базу до 36 умеет только тестовая applyLegacyProbeFixtureMigrations, которая «Never imported by application startup; no caller-selected migration ceiling». (4) Реальный артефакт — дамп с 12 миграциями, а таблицы журнала проб (0035, 0036), которые переносит цепочка 0037, в нём отсутствуют [вывод: миграции 0035–0036 позже 0012]. Значит, при любом пути журнал проб пуст, и «подтверждённых записей» для переноса нет. (5) Сама установка mmapp-test уже обновлена до 57 по legacy-пути и тоже не может войти в контролируемый путь (та же причина (2)). Владелец уже принял пункт (2) этапа 2: существующая БД с маркерами и без контрольной истории контролируемым путём не принимается, «это уже открытый пункт DB-3 про перенос непустой legacy-БД» [ист.: mcp-completion-plan.md, стр. 23, вывод (5)] backend/src/db/controlled-migrations.ts:47–53, 75–105; controlled-migration-history.ts:8–12; database-schema-control.ts:64; legacy-probe-fixture.ts:7–15; db/bootstrap.ts:62
CB6 Цепочка подписанного профиля требует многих операторских входов. Ключи init с утверждённым запросом и хешем, пять ролей с OID, TLS (CA, SPKI), реестр источника, каталог активации, утверждённые определения и одобрения application-writer-upgrade57-to58-approval-v1 и …rebind58-after-restore-approval-v1. В локальном сценарии их выпускает тестовая fixture с синтетическим ключом. На стенде нужен выпуск теми же командами dist-operator, но с реальными файлами docs/mcp-database-maintenance.md, стр. 76–85; docs/mcp-db-offline-bootstrap.md; docs/mcp-db-connected-publisher.md
CB7 Дамп содержит действующие CHR. Если на восстановленной копии запустить backend с планировщиком, он начнёт опрашивать CHR1 и CHR2 и помешает прогону A [вывод] Факт о двух серверах (2.1)

2.3. Решения владельца (чек-лист)

  • D-C1. Какие образы для C1. (а) Буквально CI2736: a3bf3574, 56 миграций, Portal CI2586. Нужно загрузить четыре образа по дайджесту из git.shx.one, если реестр их ещё хранит. (б) Перепривязать тот же пакет к образам CI2738 (HEAD 5ec95a7c, 57 миграций). Backend и frontend уже есть на VPS; Portal взять по дайджесту установленного mmapp-test-portal или CI2586. Меняются binding.json, migrationCount и пины, сценарий браузера остаётся прежним. Рекомендация: (б). Приёмка нужна на финальном кандидате, а CI2736 уже устарел на одну миграцию и ряд исправлений. Решение меняет формулировку критерия, поэтому оно за владельцем. Если владелец выберет (а), загрузка образов — отдельный MUTATING-шаг с обращением к Gitea (шаг 1.4).

  • D-C2. Память на время C1 и C2. (а) Остановить mmapp-test (docker compose stop) на время каждого окна C и поднять после. (б) Не останавливать и принять риск OOM. Рекомендация: (а), с окном вне фаз прогона A, которые используют приложение на VPS, и вне прогона B (B закрепляет pid контейнеров mmapp-test, см. план B, BB7). Откат: docker compose up -d в /opt/mmapp-test и сверка четырёх сервисов как в 1.2.

  • D-C3. Каким путём выполнять C2 и C4. (а) Перенести run-owned.mts --owned-restore58-ready в Linux-пакет по образцу пакетов POLL: локальная компиляция в JS, загрузка, запуск в образе backend установки от UID 65534. Вместо EmbeddedPostgres использовать собственный контейнер PostgreSQL 18 с TLS, а синтетическое подтверждение платформы заменить реальной проверкой POSIX-метаданных. (б) Оркестровать производственные команды образа (dist-operator, dist/scripts/*) против собственного проекта compose. Рекомендация: (а) как основной путь, (б) как необязательное дополнение. Путь (а) повторяет уже принятый локальный сценарий и меняет только платформу, путь (б) потребует новый драйвер всей цепочки. Что (а) использует тестовую обвязку, а операторские команды остаются производственными, фиксируется в квитанции [вывод].

  • D-C4. DB-3. Варианты [вывод]:

    • (а) Признать, что текущий продукт не переносит legacy-базы старше 0036 по контролируемому пути. Записать DB-3 в этап 4 как ограничение: legacy-база обновляется прежним путём, контрольная история начинается пустой.
    • (б) Продуктовая доработка новым слоем: операторская команда, которая под блокировкой записей и с аттестацией исходного поколения поднимает реальную legacy-базу с N < 36 до 36 с проверкой маркеров, затем выполняет существующую цепочку legacy-* и контролируемый хвост 0038–0057. Затем приёмка на копии реального дампа (12 миграций) в собственном PostgreSQL на VPS. Нужны две продуктовые части: (1) шаг N → 36 и (2) производственная точка входа для хвоста 0038–0057. Сейчас executeControlledSqlMigrations вызывается только тестовым раннером, а в списке команд dist-operator команды миграции нет [ист.: backend/scripts/build-database-operator.test.mjs:84 — перечень команд; controlled-migrations.ts:75].
    • (в) Принять DB-3 по существующей цепочке legacy-* на тестовой 36-миграционной fixture, но на целевом Linux с реальными POSIX-файлами. Это не «реальная» legacy-база.

    Рекомендация: (б), если владелец считает перенос старых установок обязательным для релиза, иначе (а). Вариант (в) не выполняет критерий «реальный исторический артефакт» [ист.: mcp-db-remaining-blocks-20261031.md, «Источник, архив и legacy»]. При (б) нужно учесть: журнал проб в этом дампе пуст [вывод, CB5(4)], поэтому «подтверждённых записей» будет 0, а перенос проверяется на остальных данных (серверы, настройки, история). Решение меняет критерий и поведение продукта, это вопрос владельцу.

  • D-C5. Обращение с дампом mmapp-test. Рекомендация: использовать его только на VPS. Копию восстанавливать в собственный PostgreSQL во внутренней сети Docker без выхода наружу (internal: true). Backend на копии не запускать, либо запускать без планировщика и без маршрута к CHR (CB7). Дамп с VPS не выносить, содержимое строк не печатать; после шага копия удаляется. Нужна только при D-C4 = (б).

  • D-C6. Кто подтверждает в Portal и Manager. Рекомендация: агент по D8 прогона A. Учётные записи синтетические (@example.test), их генерирует runner.py --make-fixture [ист.: README.md, шаг 2].

  • D-C8. Что считать «приёмкой подписанного защищённого восстановления». (а) Только операторская цепочка source58 до READY (CLI). (б) Цепочка плюс запуск самого восстановления из Edge через UI/MCP с подписанным служебным журналом (signedProtectedJournal:true). Рекомендация: (б). Пункт стоит в разделе EXTERNAL-UI, а открытым остался именно подписанный журнал браузерного восстановления (стр. 100 реестра доказательств). Браузер работает через SSH-проброс к собственному стеку C2, как в C1. Харнесс tmp/mcp-ui2-restore-mounted-20261115/run.mjs локальный (remoteExecuted:false), его нужно перенести на проброшенные порты.

  • D-C7. Кто выпускает операторские одобрения C2 и C4 (approved-request.json и его SHA-256, одобрения upgrade и rebind). Рекомендация: агент выпускает их тестовым ключом этого прогона, ключ создаётся и уничтожается внутри собственного каталога. В квитанции указывается, что независимость утверждающего не проверялась.

3. Порядок шагов

Фаза 0 стенд не затрагивает. Для каждого стендового шага указаны режим (READ-ONLY или MUTATING) и откат. Пути ниже относительно tmp/, если не сказано иное.

Что переиспользуется

Артефакт Как есть? Что адаптировать
mcp-current-preview-local-review-20261111/ci2736-owned-portal-browser/ (runner.py, browser.mjs, compose.json, tls-forwarder.mjs, bind.py) + архив .zip При D-C1 = (а) да, если образы в кэше. Транспорт уже на SSH-сессии оператора, пароля в раннере нет При (б): новый binding.json (дайджесты CI2738 и Portal, migrationCount=57), пересчёт assets и offline-verification.json, повторная офлайн-проверка. Локально Node v22.23.4
verified-ci2736-manager-portal-pair/ (OCI-квитанции, preview-ci-status.json) Только как доказательство происхождения CI2736 При (б) аналогичная сверка OCI для CI2738 (запуск 2738 уже успешен, ист.: план A, D6)
mcp-writer-restore58-owned/run-owned.mts (--owned-restore58-ready) и mcp-writer-current57-local-tls/run-owned.mts (--owned-linux-cli) Нет База для пакета C2/C4 (D-C3 (а)): убрать синтетический attestor, заменить EmbeddedPostgres на собственный PG-контейнер с TLS, скомпилировать, упаковать
mcp-linux-maintenance-v2-20261103/ (Linux-прогон maintenance-inspect/resolve, 16 сценариев, nativePosixProtection:true) Нет (44 миграции) Образец Linux-пакета с реальной POSIX-защитой, loopback и TLS [ист.: docs/mcp-linux-maintenance-resolution-acceptance-20261103.json]
Пакеты POLL (cold_docker.py, durable.py) Нет Образец запуска собственного Node в образе backend установки от 65534:65534 с собственным PG-контейнером и меткой nonce
backend/scripts/legacy-probe-*-owned.mjs, source5{7,8}-*-owned.mjs Нет: тестовые раннеры на fixture Только для D-C4 (в) или как образец драйвера для (б)

Фаза 0. Локальная адаптация (без стенда, до сессии)

Шаг Действие Закрывает
0.1 Получить решения D-C1…D-C8. При D-C8 (б) перенести tmp/mcp-ui2-restore-mounted-20261115/{run.mjs,browser.mjs} на проброшенные порты собственного стека C2 с заданными хешами архива и данных —
0.2 C1: при D-C1 = (б) перепривязать пакет (bind.py) к CI2738 и Portal, прогнать офлайн-проверку (runner.py --check локально не исполняет Docker). Проверить node --version = v22.23.4 и наличие Edge и зависимостей browser.mjs CB1, CB2
0.3 C2/C4: Linux-пакет по D-C3 (а). Владелец процесса — UID 65534. Создаются каталоги 0700 и файлы 0600, затем проверяются отрицательные случаи (0640, 0604, чужой UID, символьная ссылка, существующий каталог init) и отказ до подключения к БД. Собственный контейнер PG 18 с TLS (самоподписанный серверный сертификат без права CA, по mcp-database-maintenance.md), пять ролей. Два процесса backend для старта после complete CB4, CB6
0.4 C2/C4: дополнительные проверки DB-4 в пакете: архив с объектами mmapp_control отвергается; повторный старт после ошибки посреди восстановления не запускает потребителей (планировщик, NetFlow, MCP) до complete; ключи и журнал из архива не возвращают прежний доступ. Офлайн-тесты пакета и печать хешей DB-4
0.5 Локальный прогон пакета C2/C4 в Linux-контейнере невозможен (на Windows нет контейнерного runtime [ист.: mcp-handoff-20261115.md]). Поэтому до стенда проверить только --owned-restore58-ready на Windows на HEAD (регрессия) и офлайн-тесты пакета —
0.6 DB-3: только по решению D-C4. При (б) — продуктовая работа отдельным слоем с тестами на fixture N=12, после неё отдельный пакет приёмки CB5

Фаза 1. Предпусковая проверка и базовый снимок (≈20 мин)

Шаг Режим Команда или действие Откат
1.1 READ-ONLY Отпечаток ключа хоста VPS, как в плане B 1.1 —
1.2 READ-ONLY `free -m; df -h /; cat /proc/vmstat grep -E 'pswp
1.3 READ-ONLY docker image inspect <ref@digest> для каждого из четырёх образов C1 (по D-C1); docker image inspect образа mmapp-test-postgres (PG_MAJOR); docker exec mmapp-test-backend id (фактический UID); ss -ltn на 55173–55175 свободны —
1.4 MUTATING (только если 1.3 нашёл отсутствие образов и D-C1 = (а)) docker pull по дайджесту из git.shx.one (нужен вход в реестр на VPS, отдельное разрешение: скачивание около 0,5–1 ГБ). Срок хранения образов в реестре не проверялся docker image rm <digest> после прогона, если владелец не решит оставить
1.5 MUTATING (по D-C2) cd /opt/mmapp-test && docker compose stop. Перед этим записать docker compose ps и .env SHA-256 (без вывода значений) docker compose up -d, проверка четырёх сервисов healthy

Фаза 2. C1: сквозной прогон на образах (≈30–45 мин; жёсткий предел раннера 360 с на браузерную часть [ист.: runner.py:23])

Шаг Режим Команда Откат
2.1 MUTATING (VPS: новый приватный каталог загрузки) Загрузить пакет (scp) и сверить хеш архива на обоих концах, извлечь только перечисленные файлы. python runner.py --check на VPS (Docker не вызывается) Удалить каталог загрузки
2.2 локально python runner.py --make-fixture <новый приватный файл>. Передать его на VPS, chmod 0600. Локальную копию хранить до конца браузерной части Удалить оба файла после 2.5
2.3 MUTATING (VPS: проект mm-mcp-owned-<id>, четыре контейнера, тома, сеть, порты 127.0.0.1:55173–55175) В SSH-сессии с тремя пробросами (-L 55173:127.0.0.1:55173 и т. д., StrictHostKeyChecking=yes, ExitOnForwardFailure=yes): python runner.py --run <fixture>. Раннер генерирует собственный CA на сутки, сверяет imageIds с запущенными контейнерами и проверяет migration_count. Затем печатает browser-ready Раннер сам очищает проект и тома при таймауте или сигнале TERM/HUP. При отказе очистки остаётся точный путь для ограниченного восстановления
2.4 локально (браузер) node browser.mjs <локальная fixture> <новый browser-result.json> —
2.5 MUTATING (VPS: удаление собственного проекта) Атомарно загрузить browser-result.json (и квитанцию отказа, если есть) в каталог выполнения. Раннер проверяет поля, удаляет проект и тома, сверяет ID и время старта ранее работавших контейнеров Повторная проверка 5.2
2.6 локально Закрыть пробросы, удалить загруженный пакет и fixture на VPS после проверки владельца, удалить локальную fixture. Сохранить неконфиденциальные квитанции —

Фаза 3. C2 + C4: подписанное защищённое восстановление и POSIX (≈60–90 мин [вывод])

Шаг Режим Команда Откат
3.1 MUTATING (VPS: каталог /var/lib/mm-restore58-<nonce> с владельцем 65534, права 0700) Загрузка пакета 0.3 и сверка хешей Удаление каталога по nonce
3.2 MUTATING (VPS: собственный контейнер PG 18 с TLS во внутренней сети, том) Старт PG. Пять ролей, bootstrap init от UID 65534 (создаёт signing-private.pem, operator-public.pem, bootstrap.json с правами 0600). В вывод попадает только публичный отпечаток Удаление контейнера и тома по метке nonce
3.3 MUTATING Отрицательные POSIX-проверки C4: каждая запускается на отдельной копии входа и отказывает до подключения к БД (счётчик соединений 0, как в build-database-operator.test.mjs) —
3.4 MUTATING Цепочка C2 по mcp-database-maintenance.md, шаги 1–4: archive + data SHA-256 → stage-restore-checkpoint → serve-restore-claims → одно восстановление (по D-C8 (б) — из Edge через проброс: загрузка PGDMP, план, одно apply; затем проверка signedProtectedJournal) → inspect-restore-checkpoint (applied-consumed) → source-catalogue-inspect → upgrade (rebind) → seal → complete → два процесса backend → PUT /api/logs/settings. Отрицательные: новый процесс при consumed, seal до rebind, старт до complete, подменённый архив, архив с mmapp_control Неопределённый ответ на любом шаге: только inspect-restore-checkpoint и maintenance-inspect, без повтора действия [ист.: mcp-database-maintenance.md, «Не повторяйте прежнее действие автоматически»]
3.5 MUTATING (VPS: удаление собственных ресурсов) Остановить процессы, удалить контейнеры, тома, сеть, каталог nonce. Ключ теста уничтожается вместе с каталогом Сверка 5.2

Фаза 4. C3: DB-3 (только по решению D-C4)

Вариант Шаги
(а) ограничение Без стенда. Запись в mcp-completion-plan.md этапа 4 и в манифест этапа 5
(б) доработка 4.1 READ-ONLY: pg_restore --list дампа на VPS (без вывода данных), сверка числа маркеров schema_migrations = 12 в восстановленной копии. 4.2 MUTATING: собственный PG 18 во внутренней сети, pg_restore дампа в него (D-C5). 4.3 MUTATING: новая операторская команда из 0.6 → цепочка legacy-export … legacy-handoff-release → контролируемый хвост → legacy-control-reference → legacy-source58-preflight. 4.4 MUTATING: отказ при подмене архива и при конкурирующем писателе. 4.5 MUTATING: удаление копии, тома и каталога. Backend на копии не запускать (CB7)
(в) fixture на Linux Как (б), но источником служит applyLegacyProbeFixtureMigrations в собственном PG. В квитанции явно realLegacyArtifact=false

Фаза 5. Завершающая сверка (≈15 мин)

Шаг Режим Действие
5.1 MUTATING (только если делали 1.5) cd /opt/mmapp-test && docker compose up -d, ожидание healthy
5.2 READ-ONLY Повтор 1.2: четыре контейнера mmapp-test работают на тех же образах. Если делали 1.5, pid новые, это ожидаемо и записывается. Собственных проектов, томов, сетей и каталогов нет. Свободное место и память вернулись к базовым
5.3 READ-ONLY docker image ls — образы, загруженные в 1.4, удалены или оставлены по решению владельца

4. Базовый снимок до прогона и сверка после

  1. Что снимается. Четыре контейнера mmapp-test (id, image, pid, StartedAt), docker volume ls, docker network ls, docker image ls --digests, free -m, df -h, /proc/vmstat (swap, OOM), SHA-256 файла /opt/mmapp-test/.env (без вывода), список /var/lib/mm-*.
  2. Когда. В шаге 1.2 до первой MUTATING-операции. Повторно в 5.2.
  3. Критерий. Нет собственных ресурсов, mmapp-test работает на тех же образах и с тем же .env. Если mmapp-test останавливали (D-C2), отличаются только pid и StartedAt. Раннер C1 сам проверяет ID и время старта ранее работавших контейнеров (runner.py, стр. 90–93), поэтому остановка по D-C2 делается до снятия его эталона, то есть до 2.3.
  4. CHR. Не затрагиваются; базовый снимок CHR не снимается. Копия дампа (только D-C4 (б)) работает во внутренней сети без маршрута к CHR.

5. Риски, условия остановки и откат

Остановить прогон немедленно, если:

  • Идёт прогон B или фаза 5 прогона A (общий VPS; B закрепляет pid mmapp-test).
  • MemAvailable < 500 МиБ или OOM у любого контейнера [вывод].
  • Ответ на любой шаг восстановления потерян. Дальше только инспекция, без повтора.
  • Любой контейнер mmapp-test изменился без шага 1.5.
  • Ключ хоста VPS не совпал.

Откат: собственные проекты и тома удаляются по меткам и nonce. Если mmapp-test останавливали, он поднимается через docker compose up -d. Прод-база mmapp-test-postgres в прогоне C не изменяется ни на одном шаге: восстановление в неё запрещено. Дамп /root/backups/…dump используется только на чтение.

Прочие риски [вывод]:

  • Образы CI2736 могли не сохраниться в реестре Gitea, тогда D-C1 (а) невыполним.
  • Браузер работает с Windows через три SSH-проброса. Обрыв сети оставляет раннер до таймаута 360 с; раннер очищает сам.
  • --owned-linux-cli и пакет C2/C4 ни разу не запускались на Linux. Первая сессия, вероятно, выявит дефекты пакета. По цели владельца это разбирается и повторяется с новым nonce.
  • Backend штатно работает от root. Проверка POSIX от UID 65534 доказывает поведение кода, но не текущую конфигурацию установки. Нужно ли менять user: в compose, решает отдельный пункт (раздел 7).

6. Оценка длительности [вывод]

  • Фаза 0: 1–2 рабочих дня (пакет C2/C4 — критический путь). DB-3 (б) — отдельная продуктовая работа, ещё 2–4 дня.
  • Стендовая сессия: фаза 1 ~20 мин, C1 30–45 мин, C2 + C4 60–90 мин, фаза 5 ~15 мин. Итого 2–3 ч без DB-3. С DB-3 (б) — ещё 1–1,5 ч, можно отдельной сессией.
  • Запас на одну остановку и повтор: +1–2 ч.

7. Что этим планом не проверяется

  • RAM-1: вся установка ≤2 ГиБ (отложено владельцем). Если mmapp-test останавливается на время окна, совместная нагрузка не измеряется.
  • Настоящий внешний Portal владельца и реальные учётные записи: используются синтетические @example.test и собственный Portal.
  • Изменение конфигурации действующей установки mmapp-test на подписанный профиль (source57/58, пять ролей, TLS). Установка остаётся на legacy-пути с пустой mmapp_control (CB5(5)). Это вопрос включения (этап 5, инструкция), а не прогона C.
  • Работа backend установки от непривилегированного пользователя: в продукте сейчас root.
  • Устойчивость файлов к сбою питания (fsync проверяется, отключение питания нет [ист.: mcp-db-offline-bootstrap.md]).
  • UI-1 в полном объёме: выдача ограниченного доступа, отказы, фильтры, пагинация. Сценарий C1 покрывает один поток подтверждения и отзыв.
  • Причины прежних отказов CI2678 v5 (real-logs-flow-sse, 429 на flow): сценарий C1 потоки логов и flow не открывает.