from pathlib import Path
from django.contrib import admin
from django.db import models
from django.http import JsonResponse
from django.shortcuts import redirect, render
from django.urls import path, reverse
from django.utils.html import format_html
from django.contrib import messages
from django.views.decorators.http import require_POST
from django.core.exceptions import PermissionDenied
from ckeditor_uploader.widgets import CKEditorUploadingWidget
from .models import SiteSettings, Banner, DeployLog, MediaFile
from .deploy import start_deploy
from . import file_manager as fm
@admin.register(SiteSettings)
class SiteSettingsAdmin(admin.ModelAdmin):
list_display = ('id',)
formfield_overrides = {
models.TextField: {'widget': CKEditorUploadingWidget},
}
fieldsets = (
('基础信息', {
'fields': ('site_name_zh', 'site_name_en', 'site_logo',
'site_description_zh', 'site_description_en')
}),
('公司信息', {
'fields': ('company_name_zh', 'company_name_en',
'company_address_zh', 'company_address_en',
'company_phone', 'company_email')
}),
('关于我们', {
'fields': ('about_content_zh', 'about_content_en'),
}),
('社交媒体', {
'fields': ('wechat_qr', 'weibo_url'),
'classes': ('collapse',)
}),
('备案与版权', {
'fields': ('icp_number', 'copyright_zh', 'copyright_en'),
'classes': ('collapse',)
}),
('SEO设置', {
'fields': ('seo_title_zh', 'seo_title_en',
'seo_keywords_zh', 'seo_keywords_en',
'seo_description_zh', 'seo_description_en'),
'classes': ('collapse',)
}),
)
def has_add_permission(self, request):
return not SiteSettings.objects.exists()
def has_delete_permission(self, request, obj=None):
return False
@admin.register(Banner)
class BannerAdmin(admin.ModelAdmin):
list_display = ('title_zh', 'sort_order', 'is_active', 'created_at')
list_filter = ('is_active',)
list_editable = ('sort_order', 'is_active')
search_fields = ('title_zh', 'title_en', 'subtitle_zh', 'subtitle_en')
ordering = ('sort_order', '-id')
fieldsets = (
('标题', {
'fields': ('title_zh', 'title_en', 'subtitle_zh', 'subtitle_en')
}),
('图片', {
'fields': ('image', 'mobile_image')
}),
('链接与排序', {
'fields': ('link_url', 'sort_order', 'is_active')
}),
)
@admin.register(DeployLog)
class DeployLogAdmin(admin.ModelAdmin):
list_display = ('started_at', 'status', 'triggered_by', 'duration', 'view_output_link')
list_filter = ('status',)
readonly_fields = ('id', 'triggered_by', 'started_at', 'finished_at', 'status', 'output')
ordering = ('-started_at',)
list_per_page = 20
def has_add_permission(self, request):
return False
def has_change_permission(self, request, obj=None):
return False
def has_delete_permission(self, request, obj=None):
return request.user.is_superuser
def view_output_link(self, obj):
if not obj.id:
return '-'
url = reverse('admin:core_deploylog_detail', args=[obj.id])
return format_html('查看日志', url)
view_output_link.short_description = '输出日志'
def get_urls(self):
urls = super().get_urls()
custom_urls = [
path(
'deploy/',
self.admin_site.admin_view(self.deploy_view),
name='core_deploy_trigger',
),
path(
'/detail/',
self.admin_site.admin_view(self.detail_view),
name='core_deploylog_detail',
),
]
return custom_urls + urls
def deploy_view(self, request):
"""触发一次部署。"""
# 防止并发部署:检查是否有正在执行的任务
if DeployLog.objects.filter(status='running').exists():
messages.error(request, '已有部署任务正在执行,请等待其完成后再试。')
return redirect('admin:core_deploylog_changelist')
log = start_deploy(user=request.user)
messages.success(request, f'部署已启动(日志 ID: {str(log.id)[:8]}),请刷新页面查看进度。')
return redirect('admin:core_deploylog_detail', log_id=str(log.id))
def detail_view(self, request, log_id):
"""展示单条部署日志的实时输出。"""
try:
log = DeployLog.objects.get(id=log_id)
except (DeployLog.DoesNotExist, ValueError):
messages.error(request, '部署日志不存在。')
return redirect('admin:core_deploylog_changelist')
context = {
**self.admin_site.each_context(request),
'opts': self.model._meta,
'log': log,
'title': f'部署日志 - {log.started_at:%Y-%m-%d %H:%M:%S}',
'is_running': log.status == 'running',
}
return render(request, 'admin/core/deploylog/detail.html', context)
def changelist_view(self, request, extra_context=None):
"""在列表页顶部插入"一键部署"按钮。"""
extra_context = extra_context or {}
extra_context['deploy_url'] = reverse('admin:core_deploy_trigger')
extra_context['has_running'] = DeployLog.objects.filter(status='running').exists()
return super().changelist_view(request, extra_context)
# ---------------------------------------------------------------
# 媒体文件管理:通过一个 managed=False 的虚拟模型挂到左侧侧栏
# ---------------------------------------------------------------
@admin.register(MediaFile)
class MediaFileAdmin(admin.ModelAdmin):
"""媒体文件管理 Admin:覆写 changelist_view 渲染自定义文件管理器页面。
该模型 managed=False,不访问数据库,默认权限被禁用。
自定义的 delete/preview URL 通过 get_urls() 注册在 admin/core/mediafile/ 下。
"""
def has_module_permission(self, request):
return request.user.is_superuser or request.user.has_perm('core.manage_files')
def has_view_permission(self, request, obj=None):
return self.has_module_permission(request)
def has_add_permission(self, request):
return False
def has_change_permission(self, request, obj=None):
return False
def has_delete_permission(self, request, obj=None):
return False
def get_urls(self):
# 自定义 URL 必须放在前面,避免被默认的 changelist URL 拦截
urls = [
path('delete/', self.admin_site.admin_view(require_POST(self.delete_view)),
name='core_mediafile_delete'),
path('preview/', self.admin_site.admin_view(self.preview_view),
name='core_mediafile_preview'),
]
return urls + super().get_urls()
def changelist_view(self, request, extra_context=None):
"""覆写 changelist:直接渲染媒体文件管理页面。"""
if not (request.user.is_superuser or request.user.has_perm('core.manage_files')):
raise PermissionDenied
sub_path = request.GET.get('path', '').strip()
data = fm.list_media_files(sub_path)
usage = fm.get_storage_usage()
context = {
**admin.site.each_context(request),
'title': '媒体文件管理',
'data': data,
'usage': usage,
# changelist URL 就是当前 admin/core/mediafile/
'list_url': reverse('admin:core_mediafile_changelist'),
'delete_url': reverse('admin:core_mediafile_delete'),
'preview_url': reverse('admin:core_mediafile_preview'),
'opts': self.model._meta,
}
return render(request, 'admin/core/mediafile/change_list.html', context)
def delete_view(self, request):
"""删除文件的 AJAX/POST 接口。"""
if not (request.user.is_superuser or request.user.has_perm('core.manage_files')):
if request.headers.get('X-Requested-With') == 'XMLHttpRequest':
return JsonResponse({'ok': False, 'msg': '无权删除'}, status=403)
raise PermissionDenied
rel_path = request.POST.get('path', '').strip()
ok, msg = fm.delete_media_file(rel_path)
if request.headers.get('X-Requested-With') == 'XMLHttpRequest':
return JsonResponse({'ok': ok, 'msg': msg})
if ok:
messages.success(request, msg)
else:
messages.error(request, msg)
# 回到原目录
parent = str(Path(rel_path).parent) if rel_path else ''
if parent == '.':
parent = ''
return redirect(f"{reverse('admin:core_mediafile_changelist')}?path={parent}")
def preview_view(self, request):
"""预览文件信息的 JSON 接口。"""
rel_path = request.GET.get('path', '').strip()
data = fm.list_media_files(rel_path and str(Path(rel_path).parent) or '')
target = next((f for f in data['files'] if f['path'] == rel_path), None)
if not target:
return JsonResponse({'ok': False, 'msg': '文件不存在'}, status=404)
return JsonResponse({'ok': True, 'file': target})