diff --git a/.env.example b/.env.example
index 9090058a..b51234eb 100644
--- a/.env.example
+++ b/.env.example
@@ -4,35 +4,35 @@
 # ======================================================================
 
 # --- Обязательно: секреты ---
-AUTH_SECRET_KEY=                    # JWT-ключ подписи токенов (обязательно, без него сервер не стартует)
-ENCRYPTION_KEY=                     # Fernet-ключ шифрования (обязательно)
+AUTH_SECRET_KEY=change-me-to-a-random-secret   # JWT-ключ подписи токенов (обязательно)
+ENCRYPTION_KEY=                                 # Fernet-ключ шифрования (обязательно)
 
 # --- Обязательно: базы данных ---
-DATABASE_URL=                       # Основная БД (обязательно для production)
-AUTH_DATABASE_URL=                  # БД аутентификации (если не задан — требуется явно)
-TASKS_DATABASE_URL=                 # БД задач (если не задан — fallback на DATABASE_URL)
+DATABASE_URL=postgresql+psycopg2://postgres:postgres@localhost:5432/ss_tools   # Основная БД
+AUTH_DATABASE_URL=postgresql+psycopg2://postgres:postgres@localhost:5432/ss_tools  # БД аутентификации
+TASKS_DATABASE_URL=postgresql+psycopg2://postgres:postgres@localhost:5432/ss_tools  # БД задач
 
 # --- ADFS SSO (опционально) ---
-ADFS_CLIENT_ID=                     # Client ID для ADFS (если не задан — ADFS отключён)
+ADFS_CLIENT_ID=                     # Client ID для ADFS (оставьте пустым, если не используется)
 ADFS_CLIENT_SECRET=                 # Client Secret для ADFS
 ADFS_METADATA_URL=                  # URL метаданных ADFS
 
 # --- Администратор (первый запуск) ---
-INITIAL_ADMIN_CREATE=false          # true — создать администратора при старте
+INITIAL_ADMIN_CREATE=false          # true — создать администратора при старте (только для первого запуска)
 INITIAL_ADMIN_USERNAME=admin        # Логин администратора
-INITIAL_ADMIN_PASSWORD=             # Пароль (обязателен при INITIAL_ADMIN_CREATE=true)
-INITIAL_ADMIN_EMAIL=                # Email администратора (опционально)
+INITIAL_ADMIN_PASSWORD=admin123     # Пароль (обязателен при INITIAL_ADMIN_CREATE=true)
+INITIAL_ADMIN_EMAIL=admin@example.com  # Email администратора (опционально)
 
 # --- Порты (Docker) ---
 BACKEND_HOST_PORT=8001              # Внешний порт бэкенда на хосте
 FRONTEND_HOST_PORT=8000             # Внешний порт фронтенда на хосте
 
 # --- PostgreSQL (прямое подключение, без DATABASE_URL) ---
-POSTGRES_HOST=localhost
-POSTGRES_PORT=5432
-POSTGRES_DB=ss_tools
-POSTGRES_USER=postgres
-POSTGRES_PASSWORD=
+POSTGRES_HOST=localhost             # Хост PostgreSQL
+POSTGRES_PORT=5432                  # Порт PostgreSQL
+POSTGRES_DB=ss_tools                # Имя БД
+POSTGRES_USER=postgres              # Пользователь
+POSTGRES_PASSWORD=postgres          # Пароль
 
 # --- Docker Compose ---
-COMPOSE_PROJECT_NAME=superset-tools
+COMPOSE_PROJECT_NAME=superset-tools # Имя Docker Compose проекта
diff --git a/backend/.env.example b/backend/.env.example
index 99f60d7d..2403816b 100644
--- a/backend/.env.example
+++ b/backend/.env.example
@@ -13,7 +13,7 @@ AUTH_SECRET_KEY=change-me-to-a-random-secret
 ENCRYPTION_KEY=
 
 # ── Обязательно: база данных ──
-# PostgreSQL
+# PostgreSQL (пример для локальной разработки через docker-compose)
 DATABASE_URL=postgresql+psycopg2://postgres:postgres@localhost:5432/ss_tools
 # Отдельная БД для аутентификации (если не задана — требуется явно)
 AUTH_DATABASE_URL=postgresql+psycopg2://postgres:postgres@localhost:5432/ss_tools