from django.contrib import admin  # 导入Django Admin核心模块
from django.contrib.admin.models import DELETION  # 导入表示"删除"操作的常量
from django.contrib.contenttypes.models import ContentType  # 导入内容类型模型（用于关联不同模型）
from django.urls import reverse, NoReverseMatch  # 导入URL反向解析工具及异常
from django.utils.encoding import force_str  # 用于字符串编码转换（兼容Python 2/3）
from django.utils.html import escape  # 用于HTML转义（防止XSS攻击）
from django.utils.safestring import mark_safe  # 标记安全的HTML字符串（允许在模板中渲染）
from django.utils.translation import gettext_lazy as _  # 国际化翻译工具


class LogEntryAdmin(admin.ModelAdmin):
    """
    wr自定义LogEntry模型的Admin配置类
    LogEntry是Django自带的模型，用于记录管理员在后台的操作日志（如新增、修改、删除对象）
    此类控制日志在Admin后台的显示、搜索、过滤及操作权限
    """

    #wr 列表页的过滤条件（右侧过滤器）：按内容类型（即操作的模型类型）过滤
    list_filter = [
        'content_type'
    ]

    #wr 搜索字段：可通过对象名称（object_repr）和操作描述（change_message）搜索日志
    search_fields = [
        'object_repr',
        'change_message'
    ]

    #wr 列表页中可点击的字段（点击跳转到日志详情页）
    list_display_links = [
        'action_time',  #wr 操作时间
        'get_change_message',  #wr 操作描述（自定义方法）
    ]

    #wr 列表页显示的字段（按顺序排列）
    list_display = [
        'action_time',  #wr 操作时间
        'user_link',  #wr 操作人（带链接的自定义字段）
        'content_type',  #wr 操作的模型类型（如文章、用户等）
        'object_link',  #wr 操作的对象（带链接的自定义字段）
        'get_change_message',  #wr 操作描述（Django原生方法，返回格式化的操作信息）
    ]

    def has_add_permission(self, request):
        """
        wr控制是否允许添加日志条目：返回False，禁止手动添加日志
        原因：日志是系统自动记录的，不允许人工干预
        """
        return False

    def has_change_permission(self, request, obj=None):
        """
        wr控制是否允许修改日志条目：仅允许超级用户或有修改权限的用户以非POST方式访问（即仅查看）
        原因：日志记录应保持原始性，禁止修改
        """
        return (
                request.user.is_superuser or  #wr 超级用户有权限
                request.user.has_perm('admin.change_logentry')  #wr 有明确权限的用户
        ) and request.method != 'POST'  #wr 禁止POST请求（即禁止提交修改）

    def has_delete_permission(self, request, obj=None):
        """
        wr控制是否允许删除日志条目：返回False，禁止删除日志
        原因：日志是系统操作记录，需长期保存用于审计
        """
        return False

    def object_link(self, obj):
        """
        wr自定义字段：显示操作对象的链接（若存在）
        功能：如果操作不是删除，且能获取到内容类型，尝试生成对象的Admin修改页链接
        """
        object_link = escape(obj.object_repr)  #wr 转义对象名称（防止XSS）
        content_type = obj.content_type  #wr 获取操作的模型类型

        #wr 若操作不是删除，且内容类型存在（即有对应的模型）
        if obj.action_flag != DELETION and content_type is not None:
            try:
                #wr 生成对象在Admin中的修改页URL（格式：admin:应用名_模型名_change）
                url = reverse(
                    'admin:{}_{}_change'.format(content_type.app_label,
                                                content_type.model),
                    args=[obj.object_id]  #wr 传入对象ID
                )
                #wr 生成带链接的对象名称
                object_link = '<a href="{}">{}</a>'.format(url, object_link)
            except NoReverseMatch:
                #wr 若URL反向解析失败（如模型未注册到Admin），则仅显示对象名称
                pass
        return mark_safe(object_link)  #wr 标记为安全HTML，允许在页面渲染链接

    #wr 配置自定义字段的排序和显示名称
    object_link.admin_order_field = 'object_repr'  #wr 允许按对象名称排序
    object_link.short_description = _('object')  #wr 列表页表头显示名称（支持国际化）

    def user_link(self, obj):
        """
        wr自定义字段：显示操作人的链接（跳转到用户的Admin修改页）
        """
        #wr 获取操作人（User模型）的内容类型
        content_type = ContentType.objects.get_for_model(type(obj.user))
        user_link = escape(force_str(obj.user))  #wr 转义用户名并确保为字符串

        try:
            #wr 生成用户在Admin中的修改页URL
            url = reverse(
                'admin:{}_{}_change'.format(content_type.app_label,
                                            content_type.model),
                args=[obj.user.pk]  #wr 传入用户ID
            )
            #wr 生成带链接的用户名
            user_link = '<a href="{}">{}</a>'.format(url, user_link)
        except NoReverseMatch:
            #wr 若URL解析失败，仅显示用户名
            pass
        return mark_safe(user_link)  #wr 标记为安全HTML

    #wr 配置自定义字段的排序和显示名称
    user_link.admin_order_field = 'user'  #wr 允许按用户排序
    user_link.short_description = _('user')  #wr 列表页表头显示名称（支持国际化）

    def get_queryset(self, request):
        """
        wr优化查询集：预加载content_type关联数据，减少数据库查询次数
        提升列表页加载性能（避免N+1查询问题）
        """
        queryset = super(LogEntryAdmin, self).get_queryset(request)
        return queryset.prefetch_related('content_type')  #wr 预加载content_type

    def get_actions(self, request):
        """
        wr移除"删除选中项"操作：确保日志无法通过批量操作删除
        """
        actions = super(LogEntryAdmin, self).get_actions(request)
        if 'delete_selected' in actions:
            del actions['delete_selected']  #wr 删除批量删除操作
        return actions