From 4b33593a82374cc6932ff47c74119547014ea4a7 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=E2=80=9CNaeel=E2=80=9D?= <tazet@narod.ru>
Date: Mon, 31 Aug 2026 20:59:26 +0300
Subject: [PATCH] docs: document VM rsync sync

---
 History/README.md                             |  2 ++
 .../code-fixes/2026-08-31-vm-sync-readme.md   | 13 ++++++++
 README.md                                     | 30 +++++++++++++++++++
 3 files changed, 45 insertions(+)
 create mode 100644 History/code-fixes/2026-08-31-vm-sync-readme.md

diff --git a/History/README.md b/History/README.md
index c8f241e..63d4191 100644
--- a/History/README.md
+++ b/History/README.md
@@ -124,6 +124,8 @@
 
 ## code-fixes/ — исправления кода (по версиям)
 
+- **2026-08-31-vm-sync-readme.md** — документирован `rsync` текущего проекта на ВМ
+    в `/home/naeel/drhider`; legacy-каталог исключён.
 - **2026-08-31-api-bp-syntax-error.md** — v0.0.77: удалена случайная строка из `site/routes/api_bp.py`,
   вызывавшая `SyntaxError` при импорте приложения; задокументирован ответ Fable по архитектуре.
 - **2026-08-18-fix-review-bugs.md** — v0.0.32: фиксы по ревью обфускатора.
diff --git a/History/code-fixes/2026-08-31-vm-sync-readme.md b/History/code-fixes/2026-08-31-vm-sync-readme.md
new file mode 100644
index 0000000..36ae83f
--- /dev/null
+++ b/History/code-fixes/2026-08-31-vm-sync-readme.md
@@ -0,0 +1,13 @@
+# 2026-08-31 — документирован sync проекта на ВМ
+
+В README добавлен рабочий порядок синхронизации текущего checkout на ВМ:
+
+- источник: `/home/naeel/nubes/drhider`;
+- цель: `/home/naeel/drhider`;
+- инструмент: `rsync` через SSH;
+- исключены `.git`, кэши Python, `.venv` и `.pytest_cache`;
+- `--delete` не используется;
+- после копирования выполняются проверка версии и `py_compile`.
+
+Legacy-каталог `/home/naeel/contracts/drhider` явно отмечен как недопустимая цель:
+там работает старый standalone-сервис `contracts-drhider`.
\ No newline at end of file
diff --git a/README.md b/README.md
index 4a30334..f9f4108 100644
--- a/README.md
+++ b/README.md
@@ -139,3 +139,33 @@ git add -A && git commit -m "подробное описание" && git push
 Этот проект (`drhider.pythonk8s.dev.nubes.ru`) — **независимый managed Flask**, заменяет ВМ-версию.
 
 SSH к ВМ: `ssh -i ~/.ssh/naeel_vm_id_ed25519 naeel@5.172.178.213`
+
+## Синхронизация проекта на ВМ
+
+Текущий checkout проекта на ВМ находится в `/home/naeel/drhider`. Синхронизировать
+проект нужно через `rsync` из локального репозитория:
+
+```bash
+cd /home/naeel/nubes/drhider
+rsync -av \
+  --exclude='.git/' \
+  --exclude='__pycache__/' \
+  --exclude='*.pyc' \
+  --exclude='.venv/' \
+  --exclude='.pytest_cache/' \
+  -e 'ssh -o ConnectTimeout=10 -o BatchMode=yes -i ~/.ssh/naeel_vm_id_ed25519' \
+  ./ naeel@5.172.178.213:/home/naeel/drhider/
+```
+
+Проверка после синхронизации:
+
+```bash
+ssh -o ConnectTimeout=10 -o BatchMode=yes \
+  -i ~/.ssh/naeel_vm_id_ed25519 \
+  naeel@5.172.178.213 \
+  'cd /home/naeel/drhider && grep -m1 "^VERSION =" site/app.py && \
+   python3 -m py_compile site/app.py site/routes/api_bp.py'
+```
+
+`/home/naeel/contracts/drhider` — legacy standalone-сервис; его синхронизировать
+нельзя. `rsync` выполняется без `--delete`, поэтому файлы на ВМ не удаляются.