前后端第一版提交

2025-11-11 17:21:59 +08:00
commit 96e9a6d396
241 changed files with 197906 additions and 0 deletions
--- a/hertz_server_django/init.py
+++ b/hertz_server_django/init.py
--- a/hertz_server_django/asgi.py
+++ b/hertz_server_django/asgi.py
@@ -0,0 +1,49 @@
+"""
+ASGI config for hertz_server_django project.
+
+It exposes the ASGI callable as a module-level variable named ``application``.
+
+For more information on this file, see
+https://docs.djangoproject.com/en/5.2/howto/deployment/asgi/
+"""
+
+import os
+from django.core.asgi import get_asgi_application
+from django.conf import settings
+from channels.routing import ProtocolTypeRouter, URLRouter
+from channels.auth import AuthMiddlewareStack
+from channels.security.websocket import AllowedHostsOriginValidator
+
+os.environ.setdefault('DJANGO_SETTINGS_MODULE', 'hertz_server_django.settings')
+
+# Initialize Django ASGI application early to ensure the AppRegistry
+# is populated before importing code that may import ORM models.
+django_asgi_app = get_asgi_application()
+
+# Import websocket routing AFTER Django setup to avoid AppRegistryNotReady
+from hertz_demo import routing as demo_routing
+from hertz_studio_django_yolo import routing as yolo_routing
+
+# Merge websocket routes
+websocket_urlpatterns = (
+    demo_routing.websocket_urlpatterns +
+    yolo_routing.websocket_urlpatterns
+)
+
+# 在开发环境下放宽Origin校验，便于第三方客户端（如 Apifox、wscat）调试
+websocket_app = AuthMiddlewareStack(
+    URLRouter(
+        websocket_urlpatterns
+    )
+)
+
+if getattr(settings, 'DEBUG', False):
+    application = ProtocolTypeRouter({
+        "http": django_asgi_app,
+        "websocket": websocket_app,
+    })
+else:
+    application = ProtocolTypeRouter({
+        "http": django_asgi_app,
+        "websocket": AllowedHostsOriginValidator(websocket_app),
+    })
--- a/hertz_server_django/settings.py
+++ b/hertz_server_django/settings.py
@@ -0,0 +1,340 @@
+"""
+Django settings for hertz_server_django project.
+
+Generated by 'django-admin startproject' using Django 5.2.6.
+
+For more information on this file, see
+https://docs.djangoproject.com/en/5.2/topics/settings/
+
+For the full list of settings and their values, see
+https://docs.djangoproject.com/en/5.2/ref/settings/
+"""
+
+import os
+from pathlib import Path
+from decouple import config
+
+# 修复DRF的ip_address_validators函数
+def fix_drf_ip_validators():
+    """
+    修复DRF的ip_address_validators函数返回值问题
+    """
+    try:
+        from rest_framework import fields
+        
+        # 保存原始函数
+        original_ip_address_validators = fields.ip_address_validators
+        
+        def fixed_ip_address_validators(protocol, unpack_ipv4):
+            """
+            修复后的ip_address_validators函数，确保返回两个值
+            """
+            validators = original_ip_address_validators(protocol, unpack_ipv4)
+            # 如果只返回了validators，添加默认的error_message
+            if isinstance(validators, list):
+                return validators, 'Enter a valid IP address.'
+            else:
+                # 如果已经返回了两个值，直接返回
+                return validators
+        
+        # 应用猴子补丁
+        fields.ip_address_validators = fixed_ip_address_validators
+        
+    except ImportError:
+        # 如果DRF未安装，忽略错误
+        pass
+
+# 应用修复
+fix_drf_ip_validators()
+
+# Build paths inside the project like this: BASE_DIR / 'subdir'.
+BASE_DIR = Path(__file__).resolve().parent.parent
+
+
+# Quick-start development settings - unsuitable for production
+# See https://docs.djangoproject.com/en/5.2/howto/deployment/checklist/
+
+# SECURITY WARNING: keep the secret key used in production secret!
+SECRET_KEY = config('SECRET_KEY', default='django-insecure-0a1bx*8!97l^4z#ml#ufn_*9ut*)zlso$*k-g^h&(2=p@^51md')
+
+# SECURITY WARNING: don't run with debug turned on in production!
+DEBUG = config('DEBUG', default=True, cast=bool)
+
+ALLOWED_HOSTS = config('ALLOWED_HOSTS', default='localhost,127.0.0.1', cast=lambda v: [s.strip() for s in v.split(',')])
+
+# Database switch configuration
+USE_REDIS_AS_DB = config('USE_REDIS_AS_DB', default=True, cast=bool)
+
+# Application definition
+
+INSTALLED_APPS = [
+    'django.contrib.admin',
+    'django.contrib.auth',
+    'django.contrib.contenttypes',
+    'django.contrib.sessions',
+    'django.contrib.messages',
+    'django.contrib.staticfiles',
+    
+    # Third party apps
+    'rest_framework',
+    'corsheaders',
+    'channels',
+    'drf_spectacular',
+    
+    # Local apps
+    'hertz_demo',
+    'hertz_studio_django_captcha',
+    'hertz_studio_django_auth',  # 权限管理系统
+    'hertz_studio_django_notice',  # 通知公告模块
+    'hertz_studio_django_ai',
+    'hertz_studio_django_system_monitor',  # 系统监测模块
+    'hertz_studio_django_log',  # 日志管理模块
+    'hertz_studio_django_wiki',  # 知识管理模块
+    'hertz_studio_django_codegen',  # 代码生成模块
+    'hertz_studio_django_yolo',  # YOLO目标检测模块
+
+]
+
+MIDDLEWARE = [
+    'corsheaders.middleware.CorsMiddleware',
+    'django.middleware.security.SecurityMiddleware',
+    'django.contrib.sessions.middleware.SessionMiddleware',
+    'django.middleware.common.CommonMiddleware',
+    'django.middleware.csrf.CsrfViewMiddleware',
+    'django.contrib.auth.middleware.AuthenticationMiddleware',
+    'hertz_studio_django_auth.utils.middleware.AuthMiddleware',  # 权限认证中间件
+    'django.contrib.messages.middleware.MessageMiddleware',
+    'django.middleware.clickjacking.XFrameOptionsMiddleware',
+]
+
+ROOT_URLCONF = 'hertz_server_django.urls'
+
+TEMPLATES = [
+    {
+        'BACKEND': 'django.template.backends.django.DjangoTemplates',
+        'DIRS': [BASE_DIR / 'templates']
+        ,
+        'APP_DIRS': True,
+        'OPTIONS': {
+            'context_processors': [
+                'django.template.context_processors.request',
+                'django.contrib.auth.context_processors.auth',
+                'django.contrib.messages.context_processors.messages',
+            ],
+        },
+    },
+]
+
+WSGI_APPLICATION = 'hertz_server_django.wsgi.application'
+
+
+# Database
+# https://docs.djangoproject.com/en/5.2/ref/settings/#databases
+
+if USE_REDIS_AS_DB:
+    # Redis as primary database (for caching and session storage)
+    DATABASES = {
+        'default': {
+            'ENGINE': 'django.db.backends.sqlite3',
+            'NAME': BASE_DIR / 'data/db.sqlite3',
+        }
+    }
+    
+    # Use Redis for sessions
+    SESSION_ENGINE = 'django.contrib.sessions.backends.cache'
+    SESSION_CACHE_ALIAS = 'default'
+    
+else:
+    # MySQL database configuration
+    DATABASES = {
+        'default': {
+            'ENGINE': 'django.db.backends.mysql',
+            'NAME': config('DB_NAME', default='hertz_server'),
+            'USER': config('DB_USER', default='root'),
+            'PASSWORD': config('DB_PASSWORD', default='root'),
+            'HOST': config('DB_HOST', default='localhost'),
+            'PORT': config('DB_PORT', default='3306'),
+            'OPTIONS': {
+                'charset': 'utf8mb4',
+            },
+        }
+    }
+    
+# Redis
+CACHES = {
+    'default': {
+        'BACKEND': 'django_redis.cache.RedisCache',
+        'LOCATION': config('REDIS_URL', default='redis://127.0.0.1:6379/0'),
+        'OPTIONS': {
+            'CLIENT_CLASS': 'django_redis.client.DefaultClient',
+        }
+    }
+}
+
+
+# Password validation
+# https://docs.djangoproject.com/en/5.2/ref/settings/#auth-password-validators
+
+AUTH_PASSWORD_VALIDATORS = [
+    {
+        'NAME': 'django.contrib.auth.password_validation.UserAttributeSimilarityValidator',
+    },
+    {
+        'NAME': 'django.contrib.auth.password_validation.MinimumLengthValidator',
+    },
+    {
+        'NAME': 'django.contrib.auth.password_validation.CommonPasswordValidator',
+    },
+    {
+        'NAME': 'django.contrib.auth.password_validation.NumericPasswordValidator',
+    },
+]
+
+
+# Internationalization
+# https://docs.djangoproject.com/en/5.2/topics/i18n/
+
+LANGUAGE_CODE = 'en-us'
+
+TIME_ZONE = 'UTC'
+
+USE_I18N = True
+
+USE_TZ = True
+
+
+# Static files (CSS, JavaScript, Images)
+# https://docs.djangoproject.com/en/5.2/howto/static-files/
+
+STATIC_URL = 'static/'
+STATICFILES_DIRS = [
+    BASE_DIR / 'static',
+]
+
+# Media files (User uploaded files)
+MEDIA_URL = '/media/'
+MEDIA_ROOT = BASE_DIR / 'media'
+
+# Default primary key field type
+# https://docs.djangoproject.com/en/5.2/ref/settings/#default-auto-field
+
+DEFAULT_AUTO_FIELD = 'django.db.models.BigAutoField'
+
+# Django REST Framework configuration
+# 使用自定义AuthMiddleware进行认证，不使用DRF的认证和权限系统
+REST_FRAMEWORK = {
+    'DEFAULT_SCHEMA_CLASS': 'drf_spectacular.openapi.AutoSchema',
+    'DEFAULT_AUTHENTICATION_CLASSES': [],  # 不使用DRF认证类
+    'DEFAULT_PERMISSION_CLASSES': [
+        'rest_framework.permissions.AllowAny',  # 所有接口默认允许访问，由AuthMiddleware控制权限
+    ],
+    'DEFAULT_PAGINATION_CLASS': 'rest_framework.pagination.PageNumberPagination',
+    'PAGE_SIZE': 20,
+    'DEFAULT_RENDERER_CLASSES': [
+        'rest_framework.renderers.JSONRenderer',
+        'rest_framework.renderers.BrowsableAPIRenderer',
+    ],
+}
+
+# Spectacular (OpenAPI 3.0) configuration
+SPECTACULAR_SETTINGS = {
+    'TITLE': 'Hertz Server API',
+    'DESCRIPTION': 'API documentation for Hertz Server Django project',
+    'VERSION': '1.0.0',
+    'SERVE_INCLUDE_SCHEMA': False,
+    'COMPONENT_SPLIT_REQUEST': True,
+    'SCHEMA_PATH_PREFIX': '/api/',
+}
+
+# CORS configuration
+CORS_ALLOWED_ORIGINS = config(
+    'CORS_ALLOWED_ORIGINS',
+    default='http://localhost:3000,http://127.0.0.1:3000',
+    cast=lambda v: [s.strip() for s in v.split(',')]
+)
+
+CORS_ALLOW_CREDENTIALS = True
+
+CORS_ALLOW_ALL_ORIGINS = config('CORS_ALLOW_ALL_ORIGINS', default=False, cast=bool)
+
+# Captcha settings
+CAPTCHA_IMAGE_SIZE = (
+    config('CAPTCHA_IMAGE_SIZE_WIDTH', default=120, cast=int),
+    config('CAPTCHA_IMAGE_SIZE_HEIGHT', default=50, cast=int)
+)
+CAPTCHA_LENGTH = config('CAPTCHA_LENGTH', default=4, cast=int)
+CAPTCHA_TIMEOUT = config('CAPTCHA_TIMEOUT', default=5, cast=int)  # minutes
+CAPTCHA_FONT_SIZE = config('CAPTCHA_FONT_SIZE', default=40, cast=int)
+CAPTCHA_BACKGROUND_COLOR = config('CAPTCHA_BACKGROUND_COLOR', default='#ffffff')
+CAPTCHA_FOREGROUND_COLOR = config('CAPTCHA_FOREGROUND_COLOR', default='#000000')
+# 验证码词典文件路径
+CAPTCHA_WORDS_DICTIONARY = str(BASE_DIR / 'captcha_words.txt')
+# 验证码挑战函数配置
+CAPTCHA_CHALLENGE_FUNCT = 'captcha.helpers.random_char_challenge'  # 默认使用随机字符
+# 数学验证码配置
+CAPTCHA_MATH_CHALLENGE_OPERATOR = '+-*'
+# 验证码噪声和过滤器
+CAPTCHA_NOISE_FUNCTIONS = (
+    'captcha.helpers.noise_arcs',
+    'captcha.helpers.noise_dots',
+)
+CAPTCHA_FILTER_FUNCTIONS = (
+    'captcha.helpers.post_smooth',
+)
+
+# Email configuration
+EMAIL_BACKEND = config('EMAIL_BACKEND', default='django.core.mail.backends.smtp.EmailBackend')
+EMAIL_HOST = config('EMAIL_HOST', default='smtp.qq.com')
+EMAIL_PORT = config('EMAIL_PORT', default=465, cast=int)
+EMAIL_USE_SSL = config('EMAIL_USE_SSL', default=True, cast=bool)
+EMAIL_USE_TLS = config('EMAIL_USE_TLS', default=False, cast=bool)
+EMAIL_HOST_USER = config('EMAIL_HOST_USER', default='563161210@qq.com')
+EMAIL_HOST_PASSWORD = config('EMAIL_HOST_PASSWORD', default='')
+DEFAULT_FROM_EMAIL = config('DEFAULT_FROM_EMAIL', default='563161210@qq.com')
+
+# 注册邮箱验证码开关（0=关闭，1=开启）
+REGISTER_EMAIL_VERIFICATION = config('REGISTER_EMAIL_VERIFICATION', default=0, cast=int)
+
+# Channels configuration for WebSocket support
+ASGI_APPLICATION = 'hertz_server_django.asgi.application'
+
+# Channel layers configuration
+CHANNEL_LAYERS = {
+    'default': {
+        'BACKEND': 'channels_redis.core.RedisChannelLayer',
+        'CONFIG': {
+            "hosts": [config('REDIS_URL', default='redis://127.0.0.1:6379/2')],
+        },
+    },
+}
+
+# 自定义用户模型
+AUTH_USER_MODEL = 'hertz_studio_django_auth.HertzUser'
+
+# JWT配置
+JWT_SECRET_KEY = config('JWT_SECRET_KEY', default=SECRET_KEY)
+JWT_ALGORITHM = 'HS256'
+JWT_ACCESS_TOKEN_LIFETIME = config('JWT_ACCESS_TOKEN_LIFETIME', default=60 * 60 * 24, cast=int)  # 24小时
+JWT_REFRESH_TOKEN_LIFETIME = config('JWT_REFRESH_TOKEN_LIFETIME', default=60 * 60 * 24 * 7, cast=int)  # 7天
+
+# 权限系统配置
+HERTZ_AUTH_SETTINGS = {
+    'SUPER_ADMIN_PERMISSIONS': ['*'],  # 超级管理员拥有所有权限
+    'DEFAULT_PERMISSIONS': [],  # 默认权限
+}
+
+# AuthMiddleware配置 - 不需要登录验证的URL模式（支持正则表达式）
+NO_AUTH_PATTERNS = config(
+    'NO_AUTH_PATTERNS',
+    default=r'^/api/auth/login/?$,^/api/auth/register/?$,^/api/auth/email/code/?$,^/api/auth/send-email-code/?$,^/api/auth/password/reset/?$,^/api/captcha/.*$,^/api/docs/.*$,^/api/redoc/.*$,^/api/schema/.*$,^/admin/.*$,^/static/.*$,^/media/.*$,^/demo/.*$,^/websocket/.*$,^/api/system/.*$',
+    cast=lambda v: [s.strip() for s in v.split(',')]
+)
+
+# 密码加密配置
+PASSWORD_HASHERS = [
+    'hertz_studio_django_utils.crypto.MD5PasswordHasher',  # 使用MD5加密
+    'django.contrib.auth.hashers.PBKDF2PasswordHasher',
+    'django.contrib.auth.hashers.PBKDF2SHA1PasswordHasher',
+    'django.contrib.auth.hashers.Argon2PasswordHasher',
+    'django.contrib.auth.hashers.BCryptSHA256PasswordHasher',
+]
--- a/hertz_server_django/urls.py
+++ b/hertz_server_django/urls.py
@@ -0,0 +1,68 @@
+"""
+URL configuration for hertz_server_django project.
+
+The `urlpatterns` list routes URLs to views. For more information please see:
+    https://docs.djangoproject.com/en/5.2/topics/http/urls/
+Examples:
+Function views
+    1. Add an import:  from my_app import views
+    2. Add a URL to urlpatterns:  path('', views.home, name='home')
+Class-based views
+    1. Add an import:  from other_app.views import Home
+    2. Add a URL to urlpatterns:  path('', Home.as_view(), name='home')
+Including another URLconf
+    1. Import the include() function: from django.urls import include, path
+    2. Add a URL to urlpatterns:  path('blog/', include('blog.urls'))
+"""
+from django.urls import path, include
+from django.conf import settings
+from django.conf.urls.static import static
+from drf_spectacular.views import SpectacularAPIView, SpectacularRedocView, SpectacularSwaggerView
+from . import views
+
+urlpatterns = [
+    # 首页路由
+    path('', views.index, name='index'),
+    
+    # Hertz Captcha routes
+    path('api/captcha/', include('hertz_studio_django_captcha.urls')),
+    
+    # Hertz Auth routes
+    path('api/', include('hertz_studio_django_auth.urls')),
+    
+    # Demo app routes
+    path('', include('hertz_demo.urls')),
+    
+    # Hertz AI routes
+    path('api/ai/', include('hertz_studio_django_ai.urls')),
+    
+    # Hertz System Monitor routes
+    path('api/system/', include('hertz_studio_django_system_monitor.urls')),
+    
+    # Hertz System Notification routes
+    path('api/notice/', include('hertz_studio_django_notice.urls')),
+    
+    # Hertz Log routes
+    path('api/log/', include('hertz_studio_django_log.urls')),
+    
+    ## Hertz Wiki routes
+    path('api/wiki/', include('hertz_studio_django_wiki.urls')),
+    
+    # Hertz Codegen routes
+    path('api/codegen/', include(('hertz_studio_django_codegen.urls', 'hertz_studio_django_codegen'), namespace='codegen')),
+       
+    # Hertz YOLO routes
+    path('api/yolo/', include('hertz_studio_django_yolo.urls')),
+    
+
+    
+    # API documentation routes
+    path('api/docs/', SpectacularSwaggerView.as_view(url_name='schema'), name='swagger-ui'),
+    path('api/redoc/', SpectacularRedocView.as_view(url_name='schema'), name='redoc'),
+    path('api/schema/', SpectacularAPIView.as_view(), name='schema'),
+]
+
+# 在开发环境下提供媒体文件服务
+if settings.DEBUG:
+    urlpatterns += static(settings.MEDIA_URL, document_root=settings.MEDIA_ROOT)
+    urlpatterns += static(settings.STATIC_URL, document_root=settings.STATICFILES_DIRS[0])
--- a/hertz_server_django/views.py
+++ b/hertz_server_django/views.py
@@ -0,0 +1,13 @@
+from django.contrib.auth.models import Permission
+from django.shortcuts import render
+
+from hertz_studio_django_auth.utils.decorators import no_login_required
+
+
+@no_login_required
+def index(request):
+    """
+    系统首页视图
+    展示系统的基础介绍和功能特性
+    """
+    return render(request, 'index.html')
--- a/hertz_server_django/wsgi.py
+++ b/hertz_server_django/wsgi.py
@@ -0,0 +1,16 @@
+"""
+WSGI config for hertz_server_django project.
+
+It exposes the WSGI callable as a module-level variable named ``application``.
+
+For more information on this file, see
+https://docs.djangoproject.com/en/5.2/howto/deployment/wsgi/
+"""
+
+import os
+
+from django.core.wsgi import get_wsgi_application
+
+os.environ.setdefault('DJANGO_SETTINGS_MODULE', 'hertz_server_django.settings')
+
+application = get_wsgi_application()