From 16f715fd8a6dbd7d1553f0793005520e701f4008 Mon Sep 17 00:00:00 2001 From: Roman Buryan Date: Wed, 14 Oct 2026 19:26:45 +0300 Subject: [PATCH] =?UTF-8?q?docs:=20=D0=BF=D0=BB=D0=B0=D0=BD=20=D0=BD=D0=BE?= =?UTF-8?q?=D1=87=D0=BD=D0=BE=D0=B3=D0=BE=20=D1=81=D0=BF=D1=80=D0=B8=D0=BD?= =?UTF-8?q?=D1=82=D0=B0=20=D0=BF=D0=BE=20=D1=86=D0=B5=D0=BD=D1=82=D1=80?= =?UTF-8?q?=D0=B0=D0=BB=D0=B8=D0=B7=D0=B0=D1=86=D0=B8=D0=B8=20=D0=B1=D0=B0?= =?UTF-8?q?=D0=B7=20=D0=B8=20=D0=BF=D1=80=D0=B0=D0=B2=D0=B8=D0=BB=D0=B0=20?= =?UTF-8?q?=D0=B1=D0=B5=D0=B7=D0=BE=D0=BF=D0=B0=D1=81=D0=BD=D0=BE=D1=81?= =?UTF-8?q?=D1=82=D0=B8?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- docs/NIGHT-SPRINT-PLAN.md | 181 ++++++++++++++++++++++++++++++++++++++ 1 file changed, 181 insertions(+) create mode 100644 docs/NIGHT-SPRINT-PLAN.md diff --git a/docs/NIGHT-SPRINT-PLAN.md b/docs/NIGHT-SPRINT-PLAN.md new file mode 100644 index 0000000..ff5b2ba --- /dev/null +++ b/docs/NIGHT-SPRINT-PLAN.md @@ -0,0 +1,181 @@ +# Ночной спринт: централизация баз — план и правила + +**Дата создания:** 2026-10-14 +**Статус:** ожидает подтверждения владельцем + +--- + +## 1. Прямые ответы на два вопроса + +### Смогу ли я сделать это за ночь? + +**Да, работать ночью смогу — но не бесконечно и не «всё подряд».** + +Механика такая: я работаю не непрерывно, а **раундами**. Чтобы раунды шли +один за другим без вашего участия, в начале спринта я ставлю **цель** — она +включает автоматическое продолжение. Пока цель активна, я после каждого +раунда продолжаю сам. + +Но честно: **обещать, что я закончу весь список, я не могу.** Причины: + +- Перенос баз — это цепочка, где каждое звено зависит от предыдущего. + Ускорить её нельзя, не рискуя данными. +- Часть шагов требует остановки сервиса и проверки, что он поднялся. +- Если что-то пойдёт не так, я обязан остановиться и разобраться, а не идти + дальше по плану. + +**Я предпочту сделать пять пунктов полностью проверенными, чем двенадцать +недоделанными.** Для инфраструктуры второе хуже, чем ничего. + +### Что произойдёт, если закончится лимит? + +**Работа остановится на полуслове.** Это главный риск ночного спринта, +и защита от него — не надежда, а конструкция: + +| Риск | Защита | +|---|---| +| Остановка посреди переноса | Каждый шаг **атомарный**: либо выполнен и проверен, либо откачен. Незавершённых «наполовину» состояний быть не должно | +| Потеря памяти о сделанном | Журнал пишется **после каждого шага**, а не в конце. Контекст может сжаться — журнал останется | +| Сервис остался нерабочим | Пока цель не проверена, источник не трогается. Переключение конфигурации — последним шагом и обратимо | +| Невозможно понять, где остановились | Каждый пункт имеет статус: не начат / выполняется / **проверен**. Возобновление — с первого непроверенного | + +**При исчерпании лимита состояние будет ровно таким:** всё, что отмечено +проверенным, — работает; всё, что не отмечено, — не тронуто. +Именно ради этого журнал и атомарность. + +--- + +## 2. Что мне нужно от вас + +1. **Полный доступ** — да. +2. **Подтверждение списка работ** (раздел 4). +3. **Запреты** — что мне нельзя трогать ни при каких обстоятельствах (раздел 3). +4. **Правило остановки** — по какому признаку я обязан прекратить и ждать вас. +5. **Время на сон** — если вам нужно, чтобы в 8:00 всё работало, я должен + знать это заранее: незавершённый перенос базы может занять сервис + на несколько минут. + +--- + +## 3. Правила безопасности, которые я предлагаю + +Я буду соблюдать их без напоминаний. Если правило мешает выполнить задачу — +я останавливаюсь и спрашиваю, а не нарушаю его. + +1. **Ничего не удаляю без проверенной копии, снятой непосредственно перед этим.** + И «проверенной» означает: я открыл копию и убедился, что в ней есть данные, + а не что команда завершилась нулём. +2. **Ни один сервис не остаётся нерабочим.** Пока новая база не проверена, + старая цела. Переключение конфигурации — обратимо, прежний файл сохраняется. +3. **Один пункт за раз.** Следующий начинается только после проверки предыдущего. +4. **После каждого шага — запись в журнал и коммит.** Память спринта — это + журнал и репозиторий, а не мой контекст. +5. **Стоп-условия.** Я останавливаюсь и жду вас, если: + - пул томов выше 70%; + - проверка здоровья сервиса не прошла после отката; + - копия не создалась или не проверяется; + - обнаружилось расхождение между планом и фактическим состоянием; + - что-то пошло не так способом, которого нет в плане. +6. **Никаких необратимых действий ночью.** В отдельный список (раздел 5). +7. **Всё записывается в репозиторий**: что сделано, зачем, как проверено, + как откатить. + +--- + +## 4. Предлагаемый порядок работ + +### Этап 0. Аудит — до спринта, при вас + +Полная инвентаризация: сервисы, базы, копии, что работает и что нет. +Результат — этот план, уточнённый по фактам. Проверяю, что **каждый** пункт +имеет путь отката, и что откат действительно работает. + +### Этап 1. Уборка безопасного + +| Что | Размер | Условие | +|---|---|---| +| Мёртвые файловые базы n8n и mealie | 99 МБ | Подтверждено: сервисы работают с центральной базой, файлы не открыты | +| Осиротевшая база `gitea` в PostgreSQL | 30 МБ | Сначала доказать, что Gitea с ней не работает | +| Старый кластер PostgreSQL 14 | 381 МБ | Сначала убедиться, что в нём нет баз, которых нет в рабочем | + +Освободит около **500 МБ** и уберёт путаницу. + +### Этап 2. Кодировка: образец + +`buryan_monitoring` (16 МБ) — наша собственная база, риск минимальный. +Отрабатываю процедуру: выгрузка → создание с UTF8 → загрузка → сверка +числа строк и таблиц → проверка сервиса. + +**Без этого этапа дальше идти нельзя:** если процедура не отработана, +повторять её на боевых базах нельзя. + +### Этап 3. Кодировка: остальные базы + +По одной, от меньшей к большей. После каждой — проверка сервиса. + +### Этап 4. Перенос файловых баз в PostgreSQL + +| Сервис | Размер | Почему в таком порядке | +|---|---|---| +| Vaultwarden | 288 КБ | Маленькая, ценность высокая — проверка процедуры | +| Grafana | 1,5 МБ | Простая, отказ безболезненный | +| Gitea | 14 МБ | Главный сервис — **ближе к концу**, чтобы не потерять возможность фиксировать работу | +| Sonarr, Radarr, Prowlarr, Bazarr | 6 МБ | Однотипные, идут подряд | +| Uptime Kuma | 160 МБ | Самый крупный, отдельным этапом | + +**Paperless** — отдельный разговор: он развёрнут дважды и пуст. Сначала +решить, какой экземпляр остаётся, потом переносить. + +### Этап 5. Проверка восстановления + +Развернуть копию базы в отдельную базу и сверить число таблиц и строк. +Без этого копия не считается копией. + +### Этап 6. Отчёт + +Полный: что сделано, чем подтверждено, что не сделано и почему, что требует +внимания, цифры до и после. + +--- + +## 5. Что я НЕ буду делать без вас + +Даже при полном доступе. Это не обсуждается в ночном режиме: + +1. **Удалять резервные копии** — ни одной. +2. **Менять секреты и пароли** — включая ротацию из отдельного плана. +3. **Трогать сетевые правила, firewall, маршрутизацию.** +4. **Удалять данные, для которых нет проверенной копии.** +5. **Обновлять ядро, Proxmox, Docker или систему** на хосте. +6. **Пересоздавать контейнеры, состояние которых я не могу восстановить.** +7. **Работать с внешним VPS** — он вне зоны задачи. +8. **Принимать решения о железе** — это ваша часть. + +--- + +## 6. Формат отчёта в конце + +Таблица по каждому пункту: + +| Пункт | Что сделано | Чем подтверждено | Путь откатa | Состояние | +|---|---|---|---|---| + +Плюс отдельно: + +- **что не сделано и почему** — честно, без «почти получилось»; +- **что требует вашего решения**; +- **что я нашёл попутно** — за сегодня таких находок было больше, чем + выполненных задач, и они ценнее; +- **цифры до и после**: размеры, время, число проверок. + +--- + +## 7. Главный принцип спринта + +За сегодняшний день мы трижды видели одно и то же: **система сообщала +об успехе, ничего не сделав.** Пустой снимок внешней копии, старый образ +в обновлённом контейнере, задача, созданная только в журнале. + +Поэтому в ночном спринте **«сделано» означает «проверено»**, и ничто +другое. Каждый пункт отчёта будет содержать не «команда выполнена», а +**чем именно подтверждён результат**.