docs: рекомендуемое обновление через SHOP_ROOT и server-update.sh

Co-authored-by: Cursor <cursoragent@cursor.com>

README.md

@@ -125,12 +125,15 @@ cd "$SHOP_ROOT"
 sudo SHOP_INSTALL_DIR="$SHOP_ROOT" SHOP_GIT_URL="$SHOP_GIT_URL" bash scripts/quick-deploy-ubuntu.sh
 ```
 
-**Обновление** (сайт уже работает):
+**Обновление** (сайт уже работает) — **лучше так** (из любого каталога):
 
 ```bash
+export SHOP_ROOT=/opt/shop/shop10
 bash "$SHOP_ROOT/scripts/server-update.sh"
 ```
 
+`SHOP_ROOT` — путь к клону с `package.json` (у вас может быть `/opt/shop` вместо `/opt/shop/shop10`).
+
 Не копируйте в shell шаблоны вроде `<URL_РЕПОЗИТОРИЯ>` — это подсказки в тексте, не команды.
 
 Подробно: **[wiki/Server-Operations.md](wiki/Server-Operations.md)** (PostgreSQL PGDG, git, systemd, порт 3000).
@@ -203,14 +206,14 @@ journalctl -u shop -n 5 --no-pager
 
 См. **[wiki/Server-Operations.md](wiki/Server-Operations.md)**.
 
+**Рекомендуемый способ** (надёжнее, чем вручную `cd` и `git pull`):
+
 ```bash
-export SHOP_ROOT=/opt/shop
+export SHOP_ROOT=/opt/shop/shop10
-cd "$SHOP_ROOT"
+bash "$SHOP_ROOT/scripts/server-update.sh"
-bash scripts/git-sync.sh      # если detached HEAD
-bash scripts/server-update.sh
 ```
 
-`WorkingDirectory` в `deploy/shop.service` = ваш `$SHOP_ROOT`.
+`WorkingDirectory` в `deploy/shop.service` должен совпадать с `$SHOP_ROOT`.
 
 Скрипт: `git pull` → `npm install` → проверка PostgreSQL → `restart shop` → `curl /health` → `reload caddy`.
 

wiki/Home.md

@@ -49,12 +49,15 @@ cd "$SHOP_ROOT"
 sudo bash scripts/quick-deploy-ubuntu.sh
 ```
 
-Обновление:
+Обновление (рекомендуется):
 
 ```bash
+export SHOP_ROOT=/opt/shop/shop10
 bash "$SHOP_ROOT/scripts/server-update.sh"
 ```
 
+Путь `SHOP_ROOT` — ваш каталог клона (см. [Server-Operations](Server-Operations)).
+
 ## Проверка
 
 ```bash

wiki/Server-Operations.md

@@ -37,18 +37,36 @@ sudo SHOP_INSTALL_DIR="$SHOP_ROOT" SHOP_GIT_URL="$GIT_REPO_URL" \
 
 ## Обновление кода (сайт уже работает)
 
+**Рекомендуется** — две команды (можно из любого каталога, не нужен `cd`):
+
+```bash
+export SHOP_ROOT=/opt/shop/shop10
+bash "$SHOP_ROOT/scripts/server-update.sh"
+```
+
+Подставьте свой путь к клону (где лежит `package.json`). Часто это `/opt/shop` или `/opt/shop/shop10`.
+
+Почему так надёжнее, чем `cd /opt/shop && git pull`:
+
+- явно задан каталог репозитория (`SHOP_ROOT`);
+- внутри выполняются `git-sync` (ветка `main`), `npm install`, перезапуск `shop`, проверка `/health`;
+- не перепутаете родительскую папку без `package.json` и скриптов.
+
+Проверка после обновления:
+
+```bash
+systemctl status shop
+curl -s http://127.0.0.1:3000/health
+```
+
+Если git в detached HEAD отдельно:
+
 ```bash
 cd "$SHOP_ROOT"
 bash scripts/git-sync.sh
 bash scripts/server-update.sh
 ```
 
-Или одной строкой (путь к скриптам в вашем клоне):
-
-```bash
-bash "$SHOP_ROOT/scripts/server-update.sh"
-```
-
 ---
 
 ## Скрипты в `scripts/`