README.md

@@ -1,9 +1,9 @@
-# Автоотклик на hh.ru (полуавтоматический, безопасный)
+# Автоотклик на hh.ru (полуавтоматический)
 
 Скрипт ищет вакансии на hh.ru по ключевым словам, генерирует персонализированный
 текст отклика через ИИ (на основе вашего резюме и описания вакансии), открывает
-страницу в браузере и подставляет текст. **Кнопку «Отправить» всегда нажимаете вы** —
-это не нарушает правила hh.ru и не рискует аккаунтом.
+страницу в браузере, подставляет текст и резюме. Отправка — в один клик
+(«Отправить отклик»), либо с проверкой текста перед отправкой.
 
 ## Установка
 
@@ -25,17 +25,30 @@ PLAYWRIGHT_DOWNLOAD_HOST=https://cdn.npmmirror.com/binaries/playwright .venv/bin
 .venv/bin/python webui.py
 ```
 
-Откройте **http://localhost:5000** — там можно:
+Откройте **http://localhost:18091** (порт меняется через `PORT`) — там можно:
 
+- регистрироваться и входить (открытая регистрация, отключается `ALLOW_REGISTRATION=0`)
 - создавать аккаунты (имя, регион, поисковые запросы, стиль)
 - загружать резюме файлом (**txt, md, docx, pdf**)
 - сохранять **ключ сессии hh.ru** (cookies из браузера) — нужен для поиска и списка резюме
 - выбирать **резюме на hh.ru** — оно автоматически подставляется в модалке отклика
 - искать вакансии и видеть их списком (название, компания, зарплата, опыт)
 - генерировать тексты откликов через ИИ (редактируются перед отправкой)
+- отправлять отклик в один клик: кнопка «Отправить отклик» в колонке действий —
+  браузер открывает вакансию, вставляет текст, жмёт «Отправить» и закрывается
+  (скриншот результата показывается в модалке)
 - открывать вакансию в браузере с уже вставленным текстом и выбранным резюме
+  для ручной проверки перед отправкой
 - отмечать отправленные — они больше не предлагаются
 
+### Регистрация
+
+При первом запуске откройте `/register` и создайте логин с паролем (минимум
+6 символов) — вы сразу войдёте. Каждый пользователь работает со своими
+аккаунтами и лимитом генераций. Открытая регистрация отключается
+`ALLOW_REGISTRATION=0` (пользователей тогда создаёт администратор через
+`manage_users.py`).
+
 ### Ключ сессии hh.ru
 
 Чтобы скрипт мог искать вакансии и видеть ваши резюме, нужны cookies из браузера:
@@ -89,13 +102,30 @@ accounts/
 1. Скрипт парсит страницу поиска hh.ru по вашим запросам
 2. Для каждой новой вакансии получает описание
 3. ИИ генерирует текст отклика (вакансия + ваше резюме + стиль)
-4. Браузер открывает вакансию, жмёт «Откликнуться», вставляет текст
-5. **Вы проверяете текст и нажимаете «Отправить»**
-6. Отмечаете отправленное — скрипт переходит к следующей
+4. **Один клик**: кнопка «Отправить отклик» — браузер открывает вакансию,
+   жмёт «Откликнуться», вставляет текст, выбирает резюме, жмёт «Отправить»
+   и автоматически закрывается (скриншот результата — в модалке)
+5. **С проверкой**: «Открыть в браузере» — вы проверяете текст и отправляете
+   сами, либо жмёте «Отправить отклик» в модалке скриншота
+6. Отправленные вакансии отмечаются и больше не предлагаются
+
+## Переменные окружения (.env)
+
+| Переменная | По умолчанию | Описание |
+|---|---|---|
+| `LLM_API_KEY` | — | Ключ API для генерации текстов откликов |
+| `SESSION_SECRET` | `dev-secret-change-me` | Секрет сессий Flask (обязательно сменить) |
+| `PORT` | `18091` | Порт веб-интерфейса |
+| `HOST` | `127.0.0.1` | Адрес прослушивания |
+| `ALLOW_REGISTRATION` | `1` | Открытая регистрация (`0` — выключить) |
+| `REGISTER_LLM_LIMIT` | `50` | Лимит генераций для новых пользователей |
+| `HH_HEADLESS` | `0` | `1` — браузер без окна (для сервера без дисплея) |
+| `PROXY_URL` | — | Прокси для браузера: `http://LOGIN:PASS@HOST:PORT` |
 
 ## Важно
 
-- Скрипт не нарушает правила hh.ru: финальное действие всегда за человеком
+- Отправка в один клик автоматически жмёт «Отправить» — используйте с осторожностью
+  и не чаще, чем позволяет hh.ru (паузы между страницами уже стоят)
 - Не запускайте поиск слишком часто — между страницами есть паузы
 - Если hh.ru покажет капчу — скрипт остановится, решите капчу вручную и запустите снова
 - `.env` содержит API-ключ — не коммитьте его в git (уже добавлен в `.gitignore`)