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

@@ -1,12 +1,31 @@
 """Development settings for the teacher consultation website."""
+import os
 from pathlib import Path
 
+from dotenv import load_dotenv
+
 
 BASE_DIR = Path(__file__).resolve().parent.parent
 
-SECRET_KEY = "django-insecure-change-this-key-before-production"
+# Загружаем переменные из .env (если есть) — секреты не храним в коде.
-DEBUG = True
+load_dotenv(BASE_DIR / ".env")
-ALLOWED_HOSTS = ["127.0.0.1", "localhost"]
+
+# --- Секреты только из окружения: без env приложение не стартует ---
+SECRET_KEY = os.environ.get("DJANGO_SECRET_KEY")
+if not SECRET_KEY:
+    raise RuntimeError(
+        "DJANGO_SECRET_KEY не задан. Установите переменную окружения "
+        "(например: python -c \"from django.core.management.utils "
+        "import get_random_secret_key; print(get_random_secret_key())\")."
+    )
+
+DEBUG = os.environ.get("DJANGO_DEBUG") == "1"
+
+ALLOWED_HOSTS = [
+    host.strip()
+    for host in os.environ.get("DJANGO_ALLOWED_HOSTS", "127.0.0.1,localhost").split(",")
+    if host.strip()
+]
 
 INSTALLED_APPS = [
     "django.contrib.admin",
@@ -15,6 +34,7 @@ INSTALLED_APPS = [
     "django.contrib.sessions",
     "django.contrib.messages",
     "django.contrib.staticfiles",
+    "axes",
     "consultations",
 ]
 
@@ -24,10 +44,16 @@ MIDDLEWARE = [
     "django.middleware.common.CommonMiddleware",
     "django.middleware.csrf.CsrfViewMiddleware",
     "django.contrib.auth.middleware.AuthenticationMiddleware",
+    "axes.middleware.AxesMiddleware",
     "django.contrib.messages.middleware.MessageMiddleware",
     "django.middleware.clickjacking.XFrameOptionsMiddleware",
 ]
 
+# --- django-axes: защита от брутфорса логина ---
+AXES_FAILURE_LIMIT = 5
+AXES_COOLOFF_TIME = 1  # часы
+AXES_RESET_ON_SUCCESS = True
+
 ROOT_URLCONF = "config.urls"
 
 TEMPLATES = [
@@ -48,6 +74,12 @@ TEMPLATES = [
 WSGI_APPLICATION = "config.wsgi.application"
 ASGI_APPLICATION = "config.asgi.application"
 
+# django-axes: бэкенд аутентификации для защиты от брутфорса
+AUTHENTICATION_BACKENDS = [
+    "axes.backends.AxesStandaloneBackend",
+    "django.contrib.auth.backends.ModelBackend",
+]
+
 DATABASES = {
     "default": {
         "ENGINE": "django.db.backends.sqlite3",
@@ -55,7 +87,21 @@ DATABASES = {
     }
 }
 
-AUTH_PASSWORD_VALIDATORS = []
+AUTH_PASSWORD_VALIDATORS = [
+    {
+        "NAME": "django.contrib.auth.password_validation.UserAttributeSimilarityValidator",
+    },
+    {
+        "NAME": "django.contrib.auth.password_validation.MinimumLengthValidator",
+        "OPTIONS": {"min_length": 8},
+    },
+    {
+        "NAME": "django.contrib.auth.password_validation.CommonPasswordValidator",
+    },
+    {
+        "NAME": "django.contrib.auth.password_validation.NumericPasswordValidator",
+    },
+]
 
 LANGUAGE_CODE = "ru-ru"
 TIME_ZONE = "Europe/Astrakhan"

consultations/forms.py

@@ -73,3 +73,9 @@ class ConsultationRequestForm(forms.ModelForm):
         if slot and requested_format not in (ConsultationRequest.Format.ANY, slot.format):
             self.add_error("format", f"Для выбранного времени доступен формат: {slot.get_format_display()}.")
         return cleaned_data
+
+    def clean_consent_given(self):
+        consent = self.cleaned_data.get("consent_given")
+        if not consent:
+            raise forms.ValidationError("Необходимо согласие на обработку персональных данных.")
+        return consent

requirements.txt

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