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

.cursor/rules/version-and-docs.mdc

@@ -20,4 +20,4 @@ alwaysApply: true
 
 5. Не поднимать версию за косметические правки без изменения поведения.
 
-Текущая базовая версия: **1.0.1**.
+Текущая базовая версия: **1.0.2**.

.gitignore

@@ -1,3 +1,8 @@
 __pycache__/
 *.py[cod]
 *$py.class
+
+# Секреты инстанса — только шаблон .env.example в репозитории
+.env
+.env.local
+.env.*.local

README.md

@@ -1,6 +1,6 @@
 # Zilant / VOLK — Telegram poster и подписки
 
-**Версия:** 1.0.1 ([`VERSION`](VERSION))
+**Версия:** 1.0.2 ([`VERSION`](VERSION))
 
 Автоматическая публикация постов и событий в Telegram-канал, веб-редактор, бот подписок с сезонными deep link.
 
@@ -23,7 +23,9 @@ sudo systemctl status testedit-git.service  # UI  :5006
 sudo systemctl status runner.timer          # hourly pipeline
 ```
 
-Конфигурация — `.env` (не коммитится). Ключевые переменные: `RELAY_URL`, `WEBHOOK_URL`, `SEASON`, `MDB_*`.
+Конфигурация — скопируйте [`.env.example`](.env.example) в `.env` и заполните значения
+(файл `.env` в git не коммитится). Ключевые переменные: `WORKMODE`, `RELAY_URL`, `WEBHOOK_URL`, `SEASON`, `MDB_*`.
+Генерация секретов: `python tools/ops/genkey.py`.
 
 ## Пайплайн (ZILANT)
 

VERSION

@@ -1 +1 @@
-1.0.1
+1.0.2

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"