docs+chore: .env.example, загрузка .env, README по настройке окружения (PRJ-5)

- settings.py: load_dotenv из .env (python-dotenv)
- requirements.txt: + python-dotenv
- .env.example: DJANGO_SECRET_KEY / DJANGO_DEBUG / DJANGO_ALLOWED_HOSTS с инструкциями
- README: секция настройки окружения, миграции (в т.ч. таблицы django-axes)
- проверено: manage.py check без ошибок, migrate создал таблицы axes

.env.example

@@ -0,0 +1,12 @@
+# Скопируйте этот файл в .env и заполните реальными значениями.
+# .env никогда не должен попадать в git (уже в .gitignore).
+
+# Обязательно. Секретный ключ Django.
+# Сгенерировать: python -c "from django.core.management.utils import get_random_secret_key; print(get_random_secret_key())"
+DJANGO_SECRET_KEY=
+
+# Включить режим отладки (ТОЛЬКО для разработки!): 1 = да, пусто/0 = нет
+DJANGO_DEBUG=1
+
+# Разрешённые хосты через запятую (для продакшена: ваш домен)
+DJANGO_ALLOWED_HOSTS=127.0.0.1,localhost

README.md

@@ -67,16 +67,34 @@
 .\.venv\Scripts\python.exe -m pip install -r requirements.txt
 ```
 
-### 2. Подготовка базы
+### 2. Настройка окружения
+
+Скопируйте `.env.example` в `.env` и заполните:
+
+```powershell
+Copy-Item .env.example .env
+```
+
+Обязательные переменные (без них приложение не стартует):
+
+| Переменная | Описание |
+| --- | --- |
+| `DJANGO_SECRET_KEY` | Секретный ключ Django. Сгенерировать: `python -c "from django.core.management.utils import get_random_secret_key; print(get_random_secret_key())"` |
+| `DJANGO_DEBUG` | `1` для разработки, пусто/`0` для продакшена |
+| `DJANGO_ALLOWED_HOSTS` | Разрешённые хосты через запятую (в проде — домен) |
+
+`.env` в git не попадает (уже в `.gitignore`).
+
+### 3. Подготовка базы
 
 ```powershell
 .\.venv\Scripts\python.exe manage.py migrate
 .\.venv\Scripts\python.exe manage.py createsuperuser
 ```
 
-Команда `createsuperuser` попросит придумать логин и пароль для кабинета преподавателя.
+`migrate` создаст таблицы проекта и django-axes (защита от брутфорса).
 
-### 3. Запуск
+### 4. Запуск
 
 ```powershell
 .\.venv\Scripts\python.exe manage.py runserver

config/settings.py

@@ -2,9 +2,14 @@
 import os
 from pathlib import Path
 
+from dotenv import load_dotenv
+
 
 BASE_DIR = Path(__file__).resolve().parent.parent
 
+# Загружаем переменные из .env (если есть) — секреты не храним в коде.
+load_dotenv(BASE_DIR / ".env")
+
 # --- Секреты только из окружения: без env приложение не стартует ---
 SECRET_KEY = os.environ.get("DJANGO_SECRET_KEY")
 if not SECRET_KEY:

requirements.txt

@@ -1,3 +1,4 @@
 Django>=5.0,<6.0
 django-axes>=8.3.1
+python-dotenv>=1.0