docs(course): 建立Agent学习路线并新增第一课

2026-08-28 15:44:21 +08:00
parent ddab9242c7
commit 38f1b15d1c
14 changed files with 870 additions and 142 deletions
@@ -0,0 +1,14 @@
+"""JobRadar生产ASGI入口的参考实现。"""
+
+import os
+
+from django.core.asgi import get_asgi_application
+
+
+# 部署入口默认选择生产配置，避免遗漏环境选择时启用DEBUG。
+os.environ.setdefault(
+    "DJANGO_SETTINGS_MODULE",
+    "JobRadar.settings.production",
+)
+
+application = get_asgi_application()
@@ -0,0 +1,24 @@
+#!/usr/bin/env python
+"""JobRadar本地管理命令入口的参考实现。"""
+
+import os
+import sys
+
+
+def main() -> None:
+    """默认使用开发配置执行Django管理命令。"""
+    os.environ.setdefault(
+        "DJANGO_SETTINGS_MODULE",
+        "JobRadar.settings.development",
+    )
+    try:
+        from django.core.management import execute_from_command_line
+    except ImportError as exc:
+        raise ImportError(
+            "无法导入Django，请确认已经激活JobRadar Conda环境。"
+        ) from exc
+    execute_from_command_line(sys.argv)
+
+
+if __name__ == "__main__":
+    main()
@@ -0,0 +1 @@
+"""JobRadar分环境配置包的参考入口。"""
@@ -0,0 +1,77 @@
+"""JobRadar所有运行环境共享的Django配置参考。"""
+
+from pathlib import Path
+
+
+# base.py比原settings.py多位于一层settings目录中，因此需要向上三级到达项目根目录。
+BASE_DIR = Path(__file__).resolve().parent.parent.parent
+
+INSTALLED_APPS = [
+    "django.contrib.admin",
+    "django.contrib.auth",
+    "django.contrib.contenttypes",
+    "django.contrib.sessions",
+    "django.contrib.messages",
+    "django.contrib.staticfiles",
+]
+
+MIDDLEWARE = [
+    "django.middleware.security.SecurityMiddleware",
+    "django.contrib.sessions.middleware.SessionMiddleware",
+    "django.middleware.common.CommonMiddleware",
+    "django.middleware.csrf.CsrfViewMiddleware",
+    "django.contrib.auth.middleware.AuthenticationMiddleware",
+    "django.contrib.messages.middleware.MessageMiddleware",
+    "django.middleware.clickjacking.XFrameOptionsMiddleware",
+]
+
+ROOT_URLCONF = "JobRadar.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 = "JobRadar.wsgi.application"
+ASGI_APPLICATION = "JobRadar.asgi.application"
+
+# 第一课保留SQLite，下一阶段学习PostgreSQL时再调整数据库配置。
+DATABASES = {
+    "default": {
+        "ENGINE": "django.db.backends.sqlite3",
+        "NAME": BASE_DIR / "db.sqlite3",
+    }
+}
+
+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",
+    },
+]
+
+LANGUAGE_CODE = "zh-hans"
+TIME_ZONE = "Asia/Shanghai"
+USE_I18N = True
+USE_TZ = True
+
+STATIC_URL = "static/"
+DEFAULT_AUTO_FIELD = "django.db.models.BigAutoField"
@@ -0,0 +1,16 @@
+"""JobRadar本地开发环境的Django配置参考。"""
+
+import os
+
+from .base import *  # noqa: F403
+
+
+# 默认值只能用于本机开发，生产环境不会导入本模块。
+SECRET_KEY = os.getenv(
+    "DJANGO_SECRET_KEY",
+    "django-insecure-jobradar-local-development-only",
+)
+
+DEBUG = True
+
+ALLOWED_HOSTS = ["127.0.0.1", "localhost"]
@@ -0,0 +1,40 @@
+"""JobRadar公网生产环境的Django配置参考。"""
+
+import os
+
+from django.core.exceptions import ImproperlyConfigured
+
+from .base import *  # noqa: F403
+
+
+def get_required_environment_value(name: str) -> str:
+    """读取必需的生产变量，缺失或空白时立即阻止应用启动。"""
+    value = os.getenv(name, "").strip()
+    if not value:
+        raise ImproperlyConfigured(f"缺少必需的环境变量：{name}")
+    return value
+
+
+def get_required_environment_list(name: str) -> list[str]:
+    """读取逗号分隔的必需列表，并去除每一项两侧的空白。"""
+    raw_value = get_required_environment_value(name)
+    values = [item.strip() for item in raw_value.split(",") if item.strip()]
+    if not values:
+        raise ImproperlyConfigured(f"环境变量没有有效配置项：{name}")
+    return values
+
+
+SECRET_KEY = get_required_environment_value("DJANGO_SECRET_KEY")
+DEBUG = False
+ALLOWED_HOSTS = get_required_environment_list("DJANGO_ALLOWED_HOSTS")
+CSRF_TRUSTED_ORIGINS = get_required_environment_list(
+    "DJANGO_CSRF_TRUSTED_ORIGINS"
+)
+
+# HTTPS在反向代理终止时，Django通过该请求头识别原始请求协议。
+SECURE_PROXY_SSL_HEADER = ("HTTP_X_FORWARDED_PROTO", "https")
+SECURE_SSL_REDIRECT = True
+SESSION_COOKIE_SECURE = True
+CSRF_COOKIE_SECURE = True
+SECURE_CONTENT_TYPE_NOSNIFF = True
+X_FRAME_OPTIONS = "DENY"
@@ -0,0 +1,14 @@
+"""JobRadar生产WSGI入口的参考实现。"""
+
+import os
+
+from django.core.wsgi import get_wsgi_application
+
+
+# 部署入口默认选择生产配置，避免遗漏环境选择时启用DEBUG。
+os.environ.setdefault(
+    "DJANGO_SETTINGS_MODULE",
+    "JobRadar.settings.production",
+)
+
+application = get_wsgi_application()
				`@@ -0,0 +1 @@`
				`"""JobRadar分环境配置包的参考入口。"""`