# FRR：该模块提供评论相关的邮件通知功能，
# 当用户提交评论或收到回复时，自动发送自动发送邮件通知，提升用户交互体验。

import logging  # 导入日志模块，用于记录记录发送邮件过程中的错误信息

from django.utils.translation import gettext_lazy as _  # 导入国际化翻译函数

from djangoblog.utils import get_current_site  # 导入获取当前站点信息的工具函数
from djangoblog.utils import send_email  # 导入发送邮件的工具函数

# FRR：创建日志记录器，用于记录当前模块的日志信息
logger = logging.getLogger(__name__)


def send_comment_email(comment):
    """
    FRR：发送评论相关邮件通知
    1. 向评论作者发送评论提交成功的感谢邮件
    2. 若当前评论是回复（有父评论），向父评论作者发送回复通知邮件
    :param comment: 评论对象（Comment实例）
    """
    # FRR：获取当前网站域名（用于构建文章链接）
    site = get_current_site().domain
    # FRR：邮件主题（支持国际化）
    subject = _('Thanks for your comment')
    # FRR：构建文章详情页的完整URL（包含协议和域名）
    article_url = f"https://{site}{comment.article.get_absolute_url()}"
    
    # FRR：1. 向当前评论作者发送感谢邮件
    # 构建HTML格式的邮件内容（支持国际化和变量替换）
    html_content = _("""<p>Thank you very much for your comments on this site</p>
                    You can visit <a href="%(article_url)s" rel="bookmark">%(article_title)s</a>
                    to review your comments,
                    Thank you again!
                    <br />
                    If the link above cannot be opened, please copy this link to your browser.
                    %(article_url)s""") % {'article_url': article_url, 'article_title': comment.article.title}
    tomail = comment.author.email  # 收件人邮箱（当前评论作者的邮箱）
    send_email([tomail], subject, html_content)  # 调用工具函数发送邮件
    
    # FRR：2. 若当前评论是回复（有父评论），通知父评论作者
    try:
        if comment.parent_comment:  # 判断当前评论是否有父评论（即是否为回复）
            # 构建回复通知的HTML邮件内容
            html_content = _("""Your comment on <a href="%(article_url)s" rel="bookmark">%(article_title)s</a><br/> has 
                   received a reply. <br/> %(comment_body)s
                    <br/>   
                    go check it out!
                     <br/>
                     If the link above cannot be opened, please copy this link to your browser.
                     %(article_url)s
                    """) % {'article_url': article_url, 'article_title': comment.article.title,
                            'comment_body': comment.parent_comment.body}
            tomail = comment.parent_comment.author.email  # 收件人邮箱（父评论作者的邮箱）
            send_email([tomail], subject, html_content)  # 发送回复通知邮件
    except Exception as e:
        # FRR：捕获发送过程中的异常并记录日志（不中断主流程）
        logger.error(e)