создан шаблон .env.example

docs/ARCHITECTURE.md

@@ -76,6 +76,13 @@
 
 ## Конфигурация (.env)
 
+Шаблон для нового инстанса: [`.env.example`](../.env.example).
+
+```bash
+cp .env.example .env
+# заполнить CHANGE_ME_*; секреты: python tools/ops/genkey.py
+```
+
 | Переменная | Назначение |
 |------------|------------|
 | `WORKMODE` | `ZILANT` или `VOLK` |
@@ -84,6 +91,9 @@
 | `WEBHOOK_URL`, `WEBHOOK_SECRET` | Доставка апдейтов боту |
 | `MDB_*`, `MDBASE` | MariaDB |
 | `POSTER_BOT_TOKEN`, `RESPONDER_BOT_TOKEN` | Токены ботов |
+| `PZK_PREFIX`, `EVT_PREFIX`, `DESC_PREFIX` | Ссылки ZILANT |
+| `VOLK_*` | API VOLK (при `WORKMODE=VOLK`) |
+| `RA_KEY`, `RA_MODEL` | RouterAI для shortname |
 
 ## Карта файлов
 

docs/CHANGELOG.md

@@ -3,6 +3,17 @@
 Формат основан на [Keep a Changelog](https://keepachangelog.com/ru/1.1.0/).
 Версия проекта — в файле [`VERSION`](../VERSION) (SemVer).
 
+## [1.0.2] - 2026-08-30
+
+### Added
+
+- Шаблон окружения [`.env.example`](../.env.example) для ZILANT и VOLK (секреты — плейсхолдеры).
+- `.env` добавлен в [`.gitignore`](../.gitignore).
+
+### Documentation
+
+- README и `docs/ARCHITECTURE.md`: копирование `.env.example` → `.env` при настройке инстанса.
+
 ## [1.0.1] - 2026-08-30
 
 ### Changed

docs/volk-mode.md

@@ -1,6 +1,6 @@
 # Режим VOLK
 
-Режим включается в `.env`:
+Режим включается в `.env` (скопируйте из [`.env.example`](../.env.example)):
 
 ```env
 WORKMODE = "VOLK"