chore(docs): исправления C2 — JIT, отметки попытки и maintenance-resolve после MCP
Решения владельца от 21.11 и порядок для оператора: после complete MCP-восстановления с внешней контрольной точкой — maintenance-inspect и maintenance-resolve; захваты каталога выключают JIT; квитанции без .used не закрывают старт при отсутствующем журнале. Образ backend Gitea 2746. Co-Authored-By: Claude Opus 5.5 <[email protected]>
This commit is contained in:
1 parent
11537c9944
commit
9ebbf036c8
3 files changed
+22
No files matched your search
@@ -85,6 +85,7 @@
|
||||
- [ ] EXTERNAL-UI: приёмка подписанного защищённого восстановления
|
||||
- 2026-11-21, диагностика на `29998815` (пакет `tmp/mcp-c2c4-restore58-29998815-20261120/`): операторская цепочка на Linux от `init` до двух реплик backend пройдена при двух отступлениях — JIT PostgreSQL выключен, восстановление через REST вместо MCP.
|
||||
- Ждёт решения владельца по двум находкам: JIT против лимита 5 с захвата каталога; MCP-восстановление под карантином на свежем журнале всегда `blocked`. Подробности в `mcp-stand-run-c-plan.md`, раздел 2.7.
|
||||
- 2026-11-21: обе исправлены в продукте по решению владельца (`11537c99`, образ backend Gitea 2746 `fed349a6…`); после `complete` по MCP добавлен штатный `maintenance-resolve`. Приёмочный прогон ждёт доставки образа на VPS.
|
||||
- [x] DB-3: перенос непустой legacy-базы — **закрыто как ограничение (решение владельца 2026-11-17): контрольный путь не принимает старые установки, обновление идёт legacy-путём (проверено на `mmapp-test`, 12 → 57 миграций, данные целы).** Продуктовый путь не разрабатывается; см. раздел «Решения владельца 2026-11-17 по прогонам B и C»
|
||||
- [ ] DB-4: настоящие POSIX-права целевой среды
|
||||
- 2026-11-21, диагностика C4 на `29998815`: 0640, 0604, каталог чужого UID, символьная ссылка и `init` в существующий каталог отклонены до подключения к БД (0 подключений по журналу PostgreSQL), точные причины записаны. Засчитывается вместе с приёмочным прогоном C2 (`mcp-stand-run-c-plan.md`, раздел 2.7).
|
||||
|
||||
@@ -81,5 +81,10 @@ node backend/dist-operator/database-writer-profile-operator.mjs maintenance-insp
|
||||
2. Зафиксируйте допуск командой `db:stage-restore-checkpoint <sha256-файла-sealed>`. Операторский `db:serve-restore-claims` выдаёт одноразовый допуск уже работающему backend через локальный сокет. Выполните одно утверждённое восстановление. Проверьте `db:inspect-restore-checkpoint` и дождитесь состояния `applied-consumed` перед дальнейшими действиями. При неопределённом ответе начните с инспекции.
|
||||
3. На остановленном backend выполните `source-catalogue-inspect` в защищённом операторском процессе. Используйте те же `--bootstrap`, `--transport` и `--definition` с соответствующими SHA-256, а также `--ca`, `--source-registry`, `--source-spki-sha256`, `--activation-directory` и `--activation-sha256`. Команда возвращает `headSha256`, `previousCatalogSha256` из подписанной записи и `catalogSha256` фактического каталога. Утвердите результаты отдельно. Передайте их в `upgrade` с разрешением `application-writer-rebind58-after-restore-approval-v1`, используя `headSha256` как `expectedHeadSha256`. Публикация создаёт новый подписанный head на том же источнике и сохраняет предыдущую запись.
|
||||
4. С тем же UUID операции и SHA-256 применённого журнала выполните `db:seal-restore-checkpoint`, затем `db:complete-restore`. Запустите backend штатно и проверьте готовность. Сверка данных, новый подписанный head и завершение контрольной точки подтверждаются независимо.
|
||||
5. Если восстановление выполнялось через MCP, после `db:complete-restore` старт backend остаётся закрытым (`EXTERNAL_OPERATION_UNRESOLVED`). Причина: внешняя квитанция `applied` содержит предупреждение `maintenanceError` о сохранённом до внешней записи карантине. На остановленном backend выполните `maintenance-inspect`, проверьте результат, оформите одобрение формата `database-maintenance-current-state-approval-v1` и выполните `maintenance-resolve`. Только после этого запускайте backend. Восстановление через REST внешней квитанции не создаёт, и этот шаг для него не нужен.
|
||||
|
||||
Захваты каталога продукта (runtime и операторские команды) выключают JIT PostgreSQL на время своего сеанса. На PostgreSQL 18 с настройками по умолчанию одна компиляция запросов каталога могла превысить фиксированный лимит 5 с. Настраивать `jit` на сервере для этого не нужно.
|
||||
|
||||
Первая отклонённая MCP-попытка восстановления (`blocked`) или прерванная до захвата архива (`running` без `.used`) не блокирует старт при отсутствующем журнале. Отметкой попытки при отсутствии журнала считаются только `.used` и квитанции `applied`/`unknown`.
|
||||
|
||||
Локальная приёмка на одноразовой PostgreSQL подтверждает конкретные SQL- и TLS-проверки. Для рабочей установки отдельно сверяются источник, операторская активация, учётные записи и журнал.
|
||||
@@ -152,6 +152,22 @@
|
||||
- **Побочный эффект:** после такого отказа в хранилище остаётся отметка `blocked`. Без инспекции (`maintenance-inspect`/`resolve`) повтор, в том числе через REST, тоже отказывает.
|
||||
- **Обхода через UI нет:** у UI нет восстановления в обход MCP, а маршрут `app/api/system/database/restore` ни один компонент не вызывает.
|
||||
|
||||
**Решения владельца (2026-11-21) и исправление.**
|
||||
|
||||
- **Находка 1:** исправить в продукте. Захваты каталога выключают JIT: runtime ставит `SET LOCAL jit = off` в снимке каталога (`database-runtime-schema.ts`) и в контролируемой схеме, оператор передаёт `-c jit=off` в `STARTUP_OPTIONS` (все операторские сеансы, включая `maintenance-resolve`).
|
||||
- **Находка 2:** исправить в продукте шире. На фикстуре подтвердилось, что одна квитанция `blocked` (или `running` после сбоя) без `.used` при отсутствующем журнале навсегда закрывает старт backend любой установки, и `maintenance-resolve` это не снимает. Теперь отметкой попытки при отсутствии журнала считаются только `.used` и квитанции `applied`/`unknown`.
|
||||
- **После `complete` по MCP:** штатные `maintenance-inspect` и `maintenance-resolve`, без изменения продукта. Квитанция `applied` с `maintenanceError` по замыслу (есть тест) закрывает старт до принятия оператором. Порядок описан в `mcp-database-maintenance.md`, шаг 5.
|
||||
- **Коммит и проверки:** `11537c99`.
|
||||
- Тесты: стартовая инспекция 20/20 (новый случай), оператор 8/8, `maintenance-resolution` 17/17, новый тест снимка каталога, все 24 файла профиля `test:system-database` по отдельности. Зависающий на Windows `database-background-work.test.ts` к правке не относится.
|
||||
- `tsc --noEmit` проходит.
|
||||
- Сопровождаемый сценарий `--owned-source58-publication` даёт тот же каталог `4bac0202…`.
|
||||
- **Образ:** Gitea 2746, backend `git.shx.one/denozord/mikrotikmanager-backend-mcp-acceptance@sha256:fed349a6…`. Frontend остаётся `921ba5e2`, он не менялся.
|
||||
- **Пакет C2/C4 для приёмки:**
|
||||
- на сервере PostgreSQL JIT по умолчанию, без фазы `jit-off`, `prepare` без `ANALYZE`;
|
||||
- восстановление из Edge через MCP;
|
||||
- три проверки отказа старта: `checkpoint`, `state`, `maintenance`;
|
||||
- `maintenance-resolve`, затем две реплики и C4.
|
||||
|
||||
**Мелкие находки:**
|
||||
|
||||
- `inspect-database-schema.js` при отказе печатает необработанный стек вместо одного сообщения.
|
||||
|
||||
Reference in new issue
Block a user