fix: быстрое развёртывание — PGDG, /opt/shop/shop10, без placeholder URL

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

wiki/Troubleshooting.md

@@ -8,6 +8,28 @@ bash /opt/shop/shop10/scripts/diagnose-502.sh
 
 (замените путь на каталог вашего клона — где есть `package.json`)
 
+## Ошибки при «быстром развёртывании»
+
+| Ошибка | Причина | Решение |
+|--------|---------|---------|
+| `Unable to locate package postgresql-17` | В Ubuntu нет PG 17 без PGDG | `sudo bash /opt/shop/shop10/scripts/install-postgresql-ubuntu.sh` |
+| `URL_РЕПОЗИТОРИЯ: No such file` | Скопирован placeholder из README | Используйте реальный URL: `git clone https://git.evilfox.cc/test/shop10.git /opt/shop/shop10` |
+| `package.json` в `/opt/shop` | Неверный каталог | Репозиторий в `/opt/shop/shop10` |
+| Изменения не применились | `git pull` не в том каталоге | `bash /opt/shop/shop10/scripts/server-update.sh` |
+
+Полное развёртывание / обновление:
+
+```bash
+cd /opt/shop/shop10 && git pull
+sudo bash scripts/quick-deploy-ubuntu.sh
+```
+
+Только обновление кода (сайт уже работает):
+
+```bash
+bash /opt/shop/shop10/scripts/server-update.sh
+```
+
 ## scripts/server-update.sh: No such file or directory
 
 Вы не в каталоге репозитория или клон в подпапке (например `/opt/shop/shop10`):
@@ -40,7 +62,7 @@ journalctl -u shop -n 30 --no-pager
 PostgreSQL не запущен или не установлен.
 
 ```bash
-bash /opt/shop/scripts/fix-db-connection.sh
+bash /opt/shop/shop10/scripts/fix-db-connection.sh
 ```
 
 Или вручную:
@@ -51,7 +73,7 @@ pg_isready -h 127.0.0.1 -p 5432
 bash scripts/setup-postgres-ubuntu.sh
 ```
 
-Проверьте `DATABASE_URL` в `/opt/shop/.env`.
+Проверьте `DATABASE_URL` в `/opt/shop/shop10/.env`.
 
 ---
 
@@ -60,7 +82,7 @@ bash scripts/setup-postgres-ubuntu.sh
 В логе только «База уже содержит товары» без строки `Магазин: http://...`:
 
 ```bash
-cd /opt/shop && git pull   # нужен исправленный seed.js (v0.10.0+)
+bash /opt/shop/shop10/scripts/server-update.sh
 systemctl restart shop
 ```