From 9bbebbc4e2fb899798ca1db73c4eb0b21fbe229d Mon Sep 17 00:00:00 2001
From: vitya <vitya.kuznetsov@gmail.com>
Date: Wed, 26 Aug 2026 21:06:18 +0300
Subject: [PATCH] =?UTF-8?q?docs(runbook):=20mappa=20=E2=80=94=20gotcha=207?=
 =?UTF-8?q?=20E2=20backfill=20=D0=BF=D1=80=D0=BE=D0=B3=D0=BE=D0=BD=20?=
 =?UTF-8?q?=D1=81=20=D0=B2=D0=BE=D1=80=D0=BA=D1=81=D1=82=D0=B5=D0=B9=D1=88?=
 =?UTF-8?q?=D0=B5=D0=BD=D0=B0=20(task:1274)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 .wiki/concepts/mappa-vds-deploy-runbook.md | 7 +++++++
 1 file changed, 7 insertions(+)

diff --git a/.wiki/concepts/mappa-vds-deploy-runbook.md b/.wiki/concepts/mappa-vds-deploy-runbook.md
index b1f96f0..cc33e21 100644
--- a/.wiki/concepts/mappa-vds-deploy-runbook.md
+++ b/.wiki/concepts/mappa-vds-deploy-runbook.md
@@ -100,3 +100,10 @@ ssh vds.kzntsv.site 'docker ps --filter name=mappa --format "{{.Status}}"'
 5. **Внешний DATABASE_URL** — контейнерный `@postgres:5432` валиден только внутри docker-сети;
    для импорта с воркстейшена — `postgres.vds.kzntsv.site:5432` (+ TLS-verify-skip, self-signed).
 6. **Закрытие деплоя** — всегда пара «таска + письмо mappa» (канон `mappa-deploy-workflow`).
+7. **E2 backfill с воркстейшена (task:1274, 2026-08-26)** — скрипт `scripts/backfill-frontmatter-tags.ts`
+   в репо (tsx). Нужен ВНЕШНИЙ DATABASE_URL (не docker-сетевой):
+   `postgres://mappa:<MAPPA_DB_PASS>@postgres.vds.kzntsv.site:5432/mappa?sslmode=require` +
+   `NODE_TLS_REJECT_UNAUTHORIZED=0` (self-signed, gotcha 5). dry-run → `--apply`.
+   Идемпотентен (ON CONFLICT DO NOTHING); повторный прогон добавляет только новые страницы.
+   Первый прогон: 2539 тегов / 6555 рёбер; проверку «секреты не стали тегами» — скан имён
+   на sk-/AKIA/JWT перед apply (имена password/token — теги-темы, не значения).