diff --git a/apps/core/management/commands/bootstrap_deployment.py b/apps/core/management/commands/bootstrap_deployment.py index cc81c61..9cd0d56 100644 --- a/apps/core/management/commands/bootstrap_deployment.py +++ b/apps/core/management/commands/bootstrap_deployment.py @@ -12,6 +12,10 @@ - 若三个环境变量未完整设置,跳过此步骤并给出提示(适用于已手动创建过超管、 或本地开发环境无需自动建号的场景)。 2. 调用 `setup_rbac_groups` 命令初始化/重置 RBAC 权限组(详见该命令的说明)。 + 3. 调用 `seed_homepage` 命令:若尚无 home.HomePage 实例,创建首页并将默认 Site + 指向它,同时清理 Wagtail 自带的占位欢迎页(已存在则跳过创建,仅确认站点绑定)。 + 4. 调用 `seed_privacy_policy` 命令:在首页下创建/更新隐私政策页面(依赖第 3 步 + 已存在的 HomePage)。 安全说明: - 密码只应通过环境变量/密钥管理服务注入,不会被写入日志。 @@ -25,11 +29,16 @@ from django.core.management.base import BaseCommand class Command(BaseCommand): - help = "部署引导:按需创建首个超级管理员账号 + 初始化 RBAC 权限组,可重复执行。" + help = ( + "部署引导:按需创建首个超级管理员账号 + 初始化 RBAC 权限组 + " + "初始化首页与隐私政策页面,可重复执行。" + ) def handle(self, *args, **options): self._bootstrap_superuser() call_command("setup_rbac_groups") + call_command("seed_homepage") + call_command("seed_privacy_policy") def _bootstrap_superuser(self): username = os.environ.get("DJANGO_SUPERUSER_USERNAME") diff --git a/apps/core/tests.py b/apps/core/tests.py index 4dfc141..aed410c 100644 --- a/apps/core/tests.py +++ b/apps/core/tests.py @@ -520,6 +520,48 @@ def test_bootstrap_deployment_does_not_overwrite_existing_superuser_password(mon assert user.check_password("new-pass") is False +def test_bootstrap_deployment_seeds_homepage_and_privacy_policy(monkeypatch): + """bootstrap_deployment 应联动创建首页并将默认站点指向它,同时初始化隐私政策页面, + 避免每次部署都要人工登录后台手动建首页。""" + from django.core.management import call_command + from wagtail.models import Site + + from apps.home.models import HomePage + + monkeypatch.delenv("DJANGO_SUPERUSER_USERNAME", raising=False) + monkeypatch.delenv("DJANGO_SUPERUSER_EMAIL", raising=False) + monkeypatch.delenv("DJANGO_SUPERUSER_PASSWORD", raising=False) + + call_command("bootstrap_deployment") + + home_page = HomePage.objects.first() + assert home_page is not None + assert home_page.slug == "home" + + site = Site.objects.get(is_default_site=True) + assert site.root_page_id == home_page.pk + + assert SimpleContentPage.objects.child_of(home_page).filter(slug="privacy-policy").exists() + + +def test_bootstrap_deployment_is_idempotent_for_homepage_seeding(monkeypatch): + """重复执行 bootstrap_deployment 不应重复创建首页或隐私政策页面。""" + from django.core.management import call_command + + from apps.home.models import HomePage + + monkeypatch.delenv("DJANGO_SUPERUSER_USERNAME", raising=False) + monkeypatch.delenv("DJANGO_SUPERUSER_EMAIL", raising=False) + monkeypatch.delenv("DJANGO_SUPERUSER_PASSWORD", raising=False) + + call_command("bootstrap_deployment") + call_command("bootstrap_deployment") + + assert HomePage.objects.count() == 1 + home_page = HomePage.objects.first() + assert SimpleContentPage.objects.child_of(home_page).filter(slug="privacy-policy").count() == 1 + + def test_bootstrap_deployment_also_initializes_rbac_groups(monkeypatch): from django.contrib.auth.models import Group from django.core.management import call_command