Два режима работы и выбор базы из списка

Интерактивное меню (Dump+Restore / Dump / Restore) и CLI-команды
sync/dump/restore/list/dumps. База и файл дампа выбираются из списка
с фильтрацией по вводу, имя базы больше не зашито в конфиг.

Пароль берётся из конфига, переменной окружения или спрашивается с
терминала; без пароля утилиты вызываются с --no-password, иначе psql
подвисает на приглашении.
@

README.md

@@ -3,6 +3,8 @@
 Перенос базы PostgreSQL со стенда на локальный сервер: `pg_dump -Fc` → пересоздание локальной БД → `pg_restore -j`.
 Только stdlib Python 3.10+, внешних зависимостей нет. Утилиты берутся из поставки pgAdmin 4.
 
+Работает в двух режимах: интерактивное меню (запуск без аргументов) и команды CLI.
+
 ## Быстрый старт
 
 ```bash
@@ -15,16 +17,51 @@ copy config.example.json config.json
 python pg_stand_sync.py
 ```
 
+Появится меню:
+
+```
+  стенд:    postgres@postgresql.lan:5432
+  локально: postgres@localhost:5432
+  1. Dump + Restore — снять со стенда и залить локально
+  2. Dump           — только снять дамп со стенда
+  3. Restore        — залить локально готовый дамп
+  0. Выход
+```
+
+После выбора пункта показывается список: для Dump — базы стенда, для Restore — файлы из `dumps`.
+Ввод в списке работает так:
+
+| Ввод | Что делает |
+|---|---|
+| текст | фильтрует список по подстроке (регистр не важен) |
+| номер | выбирает пункт; в Dump можно `2,5,7` — несколько баз |
+| пусто | сбрасывает фильтр |
+| `q` | назад в меню |
+
 `config.json` в `.gitignore` — пароли в репозиторий не попадают.
 
-## Ключи
+## CLI
 
-| Ключ | Что делает |
+```bash
+python pg_stand_sync.py list                          # базы на стенде
+python pg_stand_sync.py dumps                         # локальные дампы
+python pg_stand_sync.py dump zpas                     # только дамп
+python pg_stand_sync.py sync zpas --target-db zpas_l  # дамп + restore
+python pg_stand_sync.py restore dumps/zpas-20260820-031332.dump
+```
+
+Имя базы (или файла) можно не указывать — тогда откроется тот же список с фильтрацией.
+
+| Команда / ключ | Что делает |
 |---|---|
-| `-c, --config PATH` | другой конфиг (несколько стендов — несколько json) |
-| `--dump-only` | снять дамп со стенда и остановиться |
-| `--restore-only FILE` | залить готовый `.dump` локально, без обращения к стенду |
+| `sync [DB…]` | dump со стенда + restore локально |
+| `dump [DB…]` | только снять дампы со стенда (можно несколько баз) |
+| `restore [FILE]` | залить готовый `.dump` локально, без обращения к стенду |
+| `list` / `dumps` | базы стенда / файлы дампов |
+| `menu` | интерактивное меню (то же, что запуск без команды) |
+| `--target-db NAME` | имя локальной базы (по умолчанию как на стенде) |
 | `--no-recreate` | не делать DROP/CREATE DATABASE, накатить поверх (`pg_restore --clean --if-exists`) |
+| `-c, --config PATH` | другой конфиг (несколько стендов — несколько json) |
 | `--dry-run` | напечатать команды, ничего не выполнять |
 
 ## Конфиг
@@ -34,16 +71,25 @@ python pg_stand_sync.py
 | `pg_bin_dir` | из `PATH` | каталог с `pg_dump.exe`, `pg_restore.exe`, `psql.exe` |
 | `dump_dir` | `dumps` | куда складывать дампы (относительный путь — от каталога скрипта) |
 | `keep_dumps` | `5` | сколько последних дампов хранить, `0` — не чистить |
+| `source.maintenance_database` | `postgres` | база, к которой подключаться для чтения списка баз |
 | `source.password_env` | — | имя переменной окружения с паролем вместо `password` в файле |
+| `target.database` | `null` | имя локальной базы; `null` — как на стенде |
 | `target.recreate` | `true` | DROP + CREATE локальной базы перед восстановлением |
 | `dump.schemas` / `exclude_*` | `[]` | ограничение состава: схемы, таблицы, данные таблиц |
 | `restore.jobs` | `4` | параллельные воркеры `pg_restore` |
 | `restore.exit_on_error` | `false` | падать на первой ошибке восстановления |
 | `post_restore_sql` | `[]` | список SQL, выполняемых в целевой базе после восстановления |
 
-Пароли можно не хранить в файле: задать `password_env` и передать значение через окружение
-(`$env:STAND_PGPASSWORD = '...'`). Пароль всегда уходит в дочерний процесс через `PGPASSWORD`,
-в командной строке не появляется.
+Пароль ищется в три шага: `password` в конфиге → переменная окружения из `password_env` →
+запрос с терминала (один раз за запуск, ввод скрыт). В неинтерактивном запуске третьего шага
+нет — либо `password_env`, либо `pgpass.conf`. Пароль всегда уходит в дочерний процесс через
+`PGPASSWORD`, в командной строке не появляется; если пароля нет вовсе, утилиты вызываются с
+`--no-password`, чтобы скрипт не подвисал на приглашении.
+
+```powershell
+$env:STAND_PGPASSWORD = '...'
+python pg_stand_sync.py sync zpas
+```
 
 ## Как это работает