"""
Отправка писем — решение заказчика от 16.09.2026.

«Логин и пароль создаёт учётка Администрации ООУРЦ при заполнении карточки
сотрудника, указывается почтовый ящик, на который при записи логина и пароля
должно быть отправлено письмо. В котором ссылка, логин и пароль».

Почта — Яндекс; данные подключения заказчик вставит, когда их доработают.
Поэтому модуль устроен так, что **отсутствие настроек не ломает работу**:
приложение всё равно создаёт учётную запись, а пароль показывает на экране
один раз с пометкой «письмо не отправлено, передайте лично». Иначе до
настройки почты выдать доступ было бы нечем.

Чего здесь намеренно нет:

*  очереди и повторов. Письмо — уведомление, а не документ: если оно не ушло,
   пароль всё равно на экране у того, кто его выдал, и передать его можно
   голосом. Очередь с повторами — это отдельная служба, которую придётся
   поднимать и сторожить;
*  пароля в журнале. В `operation_log` пишется только факт отправки и адрес;
   само письмо нигде не сохраняется.
"""

from __future__ import annotations

import os
import re
import smtplib
import ssl
from dataclasses import dataclass
from email.message import EmailMessage
from email.utils import formataddr

#  Десять секунд: письмо уходит внутри запроса, и человек ждёт ответа экрана.
#  Недоступный сервер не должен подвешивать выдачу доступа
TIMEOUT = 10


@dataclass(frozen=True)
class Settings:
    host: str
    port: int
    user: str
    password: str
    sender: str
    sender_name: str
    app_url: str
    ssl_mode: str          # 'ssl' | 'starttls'

    @property
    def ready(self) -> bool:
        return bool(self.host and self.sender)


def settings() -> Settings:
    """
    Настройки из окружения. Пустой `MAIL_HOST` означает «почта не настроена» —
    это не ошибка, а состояние, в котором приложение живёт до её настройки.
    """
    return Settings(
        host=os.environ.get("MAIL_HOST", "").strip(),
        port=int(os.environ.get("MAIL_PORT", "465") or 465),
        user=os.environ.get("MAIL_USER", "").strip(),
        password=os.environ.get("MAIL_PASSWORD", ""),
        sender=os.environ.get("MAIL_FROM", "").strip()
               or os.environ.get("MAIL_USER", "").strip(),
        sender_name=os.environ.get("MAIL_FROM_NAME", "Управление ООУРЦ"),
        app_url=os.environ.get("APP_URL", "").strip(),
        ssl_mode=os.environ.get("MAIL_SSL", "ssl").strip().lower(),
    )


def configured() -> bool:
    return settings().ready


#  Простая проверка адреса: не для безопасности, а чтобы не пытаться слать на
#  «нет почты» и не получать невнятную ошибку сервера
ADDRESS = re.compile(r"^[^@\s]+@[^@\s]+\.[^@\s]+$")


def valid(address: str) -> bool:
    return bool(ADDRESS.match((address or "").strip()))


def send(to: str, subject: str, body: str) -> tuple[bool, str]:
    """
    Отправить письмо. Возвращает (ушло ли, что сказать человеку).

    Исключения наружу не выпускает: выдача доступа не должна падать из-за
    недоступного почтового сервера.
    """
    cfg = settings()
    if not cfg.ready:
        return False, "почта не настроена"
    if not valid(to):
        return False, "у сотрудника не указан почтовый ящик"

    msg = EmailMessage()
    msg["Subject"] = subject
    msg["From"] = formataddr((cfg.sender_name, cfg.sender))
    msg["To"] = to.strip()
    msg.set_content(body)

    try:
        if cfg.ssl_mode == "starttls":
            with smtplib.SMTP(cfg.host, cfg.port, timeout=TIMEOUT) as s:
                s.starttls(context=ssl.create_default_context())
                if cfg.user:
                    s.login(cfg.user, cfg.password)
                s.send_message(msg)
        else:
            with smtplib.SMTP_SSL(cfg.host, cfg.port,
                                  context=ssl.create_default_context(),
                                  timeout=TIMEOUT) as s:
                if cfg.user:
                    s.login(cfg.user, cfg.password)
                s.send_message(msg)
    except (OSError, smtplib.SMTPException) as e:
        #  Текст ошибки показываем человеку: «не удалось отправить» без
        #  причины заставляет гадать, в почте дело или в адресе
        return False, f"{type(e).__name__}: {e}"
    return True, "письмо отправлено"


# ---------------------------------------------------------------------------
#  Письма приложения
# ---------------------------------------------------------------------------

def access_letter(full_name: str, login: str, password: str) -> tuple[str, str]:
    """Письмо о выдаче доступа: ссылка, логин, пароль."""
    cfg = settings()
    where = cfg.app_url or "адрес приложения спросите у администрации"
    body = (
        f"{full_name}, здравствуйте.\n\n"
        f"Вам выдан доступ в приложение «Управление ООУРЦ».\n\n"
        f"Адрес:  {where}\n"
        f"Логин:  {login}\n"
        f"Пароль: {password}\n\n"
        "Письмо с паролем лучше удалить после первого входа.\n"
        "Если пароль забудется — на странице входа есть «Забыли пароль?»: "
        "заявка придёт в Администрацию ООУРЦ, и вам пришлют новый.\n"
    )
    return "Доступ в приложение «Управление ООУРЦ»", body


def new_password_letter(full_name: str, login: str, password: str) -> tuple[str, str]:
    """Письмо со сменённым паролем — по заявке «Забыли пароль?»."""
    cfg = settings()
    where = cfg.app_url or "адрес приложения спросите у администрации"
    body = (
        f"{full_name}, здравствуйте.\n\n"
        f"Пароль для входа в приложение «Управление ООУРЦ» изменён.\n\n"
        f"Адрес:  {where}\n"
        f"Логин:  {login}\n"
        f"Пароль: {password}\n\n"
        "Прежний пароль больше не работает.\n"
    )
    return "Новый пароль для входа в «Управление ООУРЦ»", body
