Files
company_website/apps/core/admin.py
T
2026-08-10 22:33:04 +08:00

280 lines
10 KiB
Python
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
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('<a href="{}" target="_blank">查看日志</a>', 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(
'<path:log_id>/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:点击侧栏"媒体文件"时跳转到自定义文件管理器页面。
该模型 managed=False,不访问数据库,默认权限被禁用。
"""
def has_module_permission(self, request):
# 只有超级管理员或明确有 core.manage_files 权限才可见
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 changelist_view(self, request, extra_context=None):
# 访问 admin/core/mediafile/ 时跳转到自定义页面
return redirect(reverse('admin:core_mediafile_changelist'))
# ---------------------------------------------------------------
# 媒体文件管理器(无模型,自定义 URL + 视图)
# ---------------------------------------------------------------
class MediaFileManagerAdmin:
"""伪 Admin 入口:只用来注入 URL 和渲染页面。
我们直接通过 admin_site 注册 custom_urls,而不是注册一个 ModelAdmin,
因为这个功能不需要数据库模型。
"""
model_name = 'mediafile'
app_label = 'core'
@classmethod
def get_custom_urls(cls, admin_site):
view = admin_site.admin_view(cls.changelist_view)
delete_view = admin_site.admin_view(require_POST(cls.delete_view))
preview_view = admin_site.admin_view(cls.preview_view)
return [
path('mediafiles/', view, name='core_mediafile_changelist'),
path('mediafiles/delete/', delete_view, name='core_mediafile_delete'),
path('mediafiles/preview/', preview_view, name='core_mediafile_preview'),
]
@staticmethod
def changelist_view(request):
# 权限校验:只有超级管理员或有 manage_files 权限者可访问
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,
'list_url': reverse('admin:core_mediafile_changelist'),
'delete_url': reverse('admin:core_mediafile_delete'),
'preview_url': reverse('admin:core_mediafile_preview'),
'opts': type('FakeOpts', (), {
'verbose_name_plural': '媒体文件',
'app_label': 'core',
'model_name': 'mediafile',
})(),
}
return render(request, 'admin/core/mediafile/change_list.html', context)
@staticmethod
def delete_view(request):
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}")
@staticmethod
def preview_view(request):
rel_path = request.GET.get('path', '').strip()
# 返回 JSON:文件 URL、路径、大小
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})
# 注入 MediaFile 的 URL 到 admin.site
# 做法:覆写 AdminSite 的 get_urls 时追加
_original_admin_get_urls = admin.AdminSite.get_urls
def _patched_admin_get_urls(self):
urls = _original_admin_get_urls(self)
urls.extend(MediaFileManagerAdmin.get_custom_urls(self))
return urls
admin.AdminSite.get_urls = _patched_admin_get_urls