add readme

Author: Tikrong

README_FILES/task_46.md

@@ -0,0 +1,20 @@
+# Задача #42: Настройка отправки email уведомлений
+
+### Описание
+В приложении `common` добавлен файл `utils.py` где размещена логика отправки уведомлений.
+В случае разрастания функционала, можно будет выделить в отдельный файл.
+
+#### Для отправки уведомлений необходимо:
+0. Прописать в `.env` значения переменных для отправки почту (SMTP сервер, логин, пароль).
+1. Создать шаблон и положить его в `src/common/templates/emails` для верстки письма. Для образца можно взять `registration_success.html`
+2. Из места, где необходимо отправить уведомление вызвать `create_and_send_email` и передать адрес получателя,
+название темплейта (с уканием папок, в которые он вложен), контекст для формирования темплейта и тему письма.
+
+#### Логика работы отправки:
+Метод `create_and_send_email` создает отдельный поток в котором будет производиться отправка письма.
+Это сделано для того, чтобы не блокировать вызывающий код и сразу вернуть контроль. В будущем можно заменить это
+на вызов `celery task`.
+Письмо формируется на основании шаблона и переданного контекста. Если письмо не персонализированно, то контект может быть пустой.
+
+#### Возможные улучшения:
+- добавить retry логику на случай проблем, чтобы повторить отправку через какое-то время. Можно реализовать при появлении `celery`