From c602a26d1bdf2482bb4109c72b2b3f9a2baec18b Mon Sep 17 00:00:00 2001 From: Zhengen TANG Date: Fri, 16 Oct 2026 21:19:43 +0800 Subject: [PATCH] =?UTF-8?q?feat:=20=E6=96=B0=E5=A2=9E=20seed=5Fown=5Fshowc?= =?UTF-8?q?ase=20=E5=91=BD=E4=BB=A4=EF=BC=8C=E5=88=9B=E5=BB=BA=E4=BA=A7?= =?UTF-8?q?=E5=93=81=E9=A1=B5=E2=80=9C=E4=B8=96=E8=80=80CMS=E2=80=9D?= =?UTF-8?q?=E4=B8=8E=E5=AE=98=E7=BD=91=E8=87=AA=E8=BA=AB=E6=A1=88=E4=BE=8B?= =?UTF-8?q?=E9=A1=B5?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit - apps/core/management/commands/seed_own_showcase.py:幂等地在生产已有的 ProductIndexPage/CaseStudyIndexPage 下创建/更新“世耀CMS”产品页与衡水世耀 科技官网建设案例页;产品/栏目页缺失时 CommandError 退出,不自动创建栏目。 - apps/core/tests.py:新增 3 个用例(缺栏目页报错、创建成功、重复执行幂等), pytest 75 -> 78,全部通过。 --- .../management/commands/seed_own_showcase.py | 190 ++++++++++++++++++ apps/core/tests.py | 50 +++++ 2 files changed, 240 insertions(+) create mode 100644 apps/core/management/commands/seed_own_showcase.py diff --git a/apps/core/management/commands/seed_own_showcase.py b/apps/core/management/commands/seed_own_showcase.py new file mode 100644 index 0000000..8d537c7 --- /dev/null +++ b/apps/core/management/commands/seed_own_showcase.py @@ -0,0 +1,190 @@ +""" +创建/更新"自家产品与案例展示"内容:把本 CMS 产品本身作为一条 ProductPage 挂载在 +产品栏目(products.ProductIndexPage)下,并把本官网项目本身作为一条 CaseStudyPage +挂载在客户案例栏目(cases.CaseStudyIndexPage)下。 + +背景:公司希望把"世耀 CMS"本身作为产品展示,并把官网自身的建设过程作为一条客户 +案例展示,这是一次性的内容录入需求,不是每次部署都需要的通用初始化步骤,因此 +**没有**接入 bootstrap_deployment,需要在需要时手动运行一次。 + +前置条件:产品栏目页(ProductIndexPage)与客户案例栏目页(CaseStudyIndexPage) +必须已存在(由内容运营在 Wagtail 后台创建,或已随站点内容初始化创建),否则报错 +退出。 + +用法: + python manage.py seed_own_showcase + +行为(幂等,可安全重复执行):按固定 slug 查找页面,存在则更新内容,不存在则创建 +并发布。 +""" +from django.core.management.base import BaseCommand, CommandError +from django.utils import timezone + +from apps.cases.models import CaseStudyIndexPage, CaseStudyPage +from apps.products.models import ProductIndexPage, ProductPage + +PRODUCT_SLUG = "shiyao-cms" +PRODUCT_TITLE = "世耀CMS" +PRODUCT_SUMMARY = ( + "一体化企业官网 Headless CMS:内容与展示分离,组件化编排,内置五级权限、" + "草稿预览与国内合规能力,开箱即用,合规可上线。" +) +PRODUCT_BODY = [ + ( + "richtext", + "

世耀 CMS 是一套面向中国大陆企业的 Headless(前后端分离)官网内容管理" + "系统。内容运营团队通过可视化后台自主编排页面、发布内容、管理线索;前端展示" + "层独立构建,保证视觉效果与访问性能,两者通过标准 API 解耦,互不阻塞彼此的" + "迭代节奏。

", + ), + ( + "feature_grid", + { + "heading": "核心能力", + "items": [ + { + "icon": "", + "title": "组件化内容编排", + "description": "14 种可复用页面组件(Hero、数据展示、CTA、定价、" + "FAQ、案例、时间线、团队等),编辑自由排版,无需开发介入。", + }, + { + "icon": "", + "title": "开箱即用页面类型", + "description": "首页、博客、产品、案例、解决方案、联系我们六大" + "页面类型及列表/详情页均已实现,接入即可投入使用。", + }, + { + "icon": "", + "title": "五级权限体系", + "description": "站点管理员/编辑/审核员/作者/查看者五级角色,满足" + "企业多部门协作审核流程。", + }, + { + "icon": "", + "title": "草稿预览", + "description": "编辑在后台点击“预览”即可查看前端真实渲染效果," + "发布前所见即所得。", + }, + { + "icon": "", + "title": "国内合规内置", + "description": "ICP 备案展示、隐私政策、Cookie 同意条、PIPL 数据" + "删除权等合规能力均已内置。", + }, + { + "icon": "", + "title": "API 优先架构", + "description": "标准 REST API 对外提供内容,可平滑扩展小程序、" + "App 等更多展示端,无需改动后台。", + }, + ], + }, + ), + ( + "cta", + { + "heading": "了解世耀 CMS 如何助力企业官网建设", + "description": "欢迎联系我们,获取产品演示与定制化部署方案。", + "button": {"text": "联系我们", "link": "/contact/"}, + }, + ), +] + +CASE_SLUG = "shiytech-website" +CASE_TITLE = "衡水世耀科技官网建设案例" +CASE_CLIENT_NAME = "衡水世耀科技有限公司" +CASE_INDUSTRY = "软件与信息技术服务" +CASE_SUMMARY = ( + "基于世耀 CMS 打造的衡水世耀科技官网,实现内容自主更新、草稿预览与多终端展示。" +) +CASE_BODY = [ + ( + "richtext", + "

衡水世耀科技有限公司官网(www.shiytech.cn)基于自研的世耀 CMS 构建:" + "后端采用 Headless CMS 管理首页、产品、案例、解决方案、博客等全部内容,前端" + "独立渲染展示层。内容运营团队可自主编排页面组件、发布线索表单、管理团队与" + "客户案例展示,无需开发介入即可持续更新官网内容。

项目同时落地了 ICP " + "备案展示、隐私政策、Cookie 同意条等国内合规能力,满足企业官网上线的合规" + "要求。

", + ), + ( + "tech_stack", + { + "heading": "技术架构", + "items": [ + {"icon": "", "label": "Django"}, + {"icon": "", "label": "Wagtail"}, + {"icon": "", "label": "Next.js"}, + {"icon": "", "label": "PostgreSQL"}, + {"icon": "", "label": "Waitress"}, + ], + }, + ), +] + + +class Command(BaseCommand): + help = "创建或更新“世耀 CMS”产品页与官网自身案例页(可重复执行)。" + + def handle(self, *args, **options): + product_index = ProductIndexPage.objects.first() + if product_index is None: + raise CommandError( + "未找到 ProductIndexPage 实例,请先在 Wagtail 后台创建产品栏目页。" + ) + case_index = CaseStudyIndexPage.objects.first() + if case_index is None: + raise CommandError( + "未找到 CaseStudyIndexPage 实例,请先在 Wagtail 后台创建客户案例栏目页。" + ) + + self._seed_product_page(product_index) + self._seed_case_page(case_index) + + def _seed_product_page(self, product_index): + page = ProductPage.objects.child_of(product_index).filter(slug=PRODUCT_SLUG).first() + if page is None: + page = ProductPage( + title=PRODUCT_TITLE, + slug=PRODUCT_SLUG, + summary=PRODUCT_SUMMARY, + body=PRODUCT_BODY, + seo_title_override=PRODUCT_TITLE, + seo_description_override=PRODUCT_SUMMARY, + ) + product_index.add_child(instance=page) + page.save_revision().publish() + self.stdout.write(self.style.SUCCESS(f"已创建产品页:{page.url}")) + else: + page.summary = PRODUCT_SUMMARY + page.body = PRODUCT_BODY + page.save() + page.save_revision().publish() + self.stdout.write(self.style.SUCCESS(f"已更新产品页:{page.url}")) + + def _seed_case_page(self, case_index): + page = CaseStudyPage.objects.child_of(case_index).filter(slug=CASE_SLUG).first() + if page is None: + page = CaseStudyPage( + title=CASE_TITLE, + slug=CASE_SLUG, + client_name=CASE_CLIENT_NAME, + industry=CASE_INDUSTRY, + published_at=timezone.now(), + summary=CASE_SUMMARY, + body=CASE_BODY, + seo_title_override=CASE_TITLE, + seo_description_override=CASE_SUMMARY, + ) + case_index.add_child(instance=page) + page.save_revision().publish() + self.stdout.write(self.style.SUCCESS(f"已创建案例页:{page.url}")) + else: + page.client_name = CASE_CLIENT_NAME + page.industry = CASE_INDUSTRY + page.summary = CASE_SUMMARY + page.body = CASE_BODY + page.save() + page.save_revision().publish() + self.stdout.write(self.style.SUCCESS(f"已更新案例页:{page.url}")) diff --git a/apps/core/tests.py b/apps/core/tests.py index c853d53..5712fd8 100644 --- a/apps/core/tests.py +++ b/apps/core/tests.py @@ -617,3 +617,53 @@ def test_bootstrap_deployment_also_initializes_rbac_groups(monkeypatch): expected_names = {"站点管理员", "编辑", "审核员", "作者", "查看者"} assert expected_names <= set(Group.objects.values_list("name", flat=True)) + + +def test_seed_own_showcase_requires_product_and_case_index(home_page): + """未创建产品栏目/客户案例栏目时应直接报错退出,而不是静默跳过。""" + from django.core.management import CommandError, call_command + + with pytest.raises(CommandError): + call_command("seed_own_showcase") + + +def test_seed_own_showcase_creates_product_and_case_pages(home_page): + """应在产品栏目下创建“世耀CMS”产品页,在客户案例栏目下创建官网自身案例页。""" + from django.core.management import call_command + + from apps.cases.models import CaseStudyIndexPage, CaseStudyPage + from apps.products.models import ProductIndexPage, ProductPage + + product_index = ProductIndexPage(title="产品", slug="products-test") + home_page.add_child(instance=product_index) + case_index = CaseStudyIndexPage(title="客户案例", slug="cases-test") + home_page.add_child(instance=case_index) + + call_command("seed_own_showcase") + + product_page = ProductPage.objects.child_of(product_index).get(slug="shiyao-cms") + assert product_page.title == "世耀CMS" + assert product_page.live is True + + case_page = CaseStudyPage.objects.child_of(case_index).get(slug="shiytech-website") + assert case_page.client_name == "衡水世耀科技有限公司" + assert case_page.live is True + + +def test_seed_own_showcase_is_idempotent(home_page): + """重复执行不应创建重复页面,仅更新已有内容。""" + from django.core.management import call_command + + from apps.cases.models import CaseStudyIndexPage, CaseStudyPage + from apps.products.models import ProductIndexPage, ProductPage + + product_index = ProductIndexPage(title="产品", slug="products-test") + home_page.add_child(instance=product_index) + case_index = CaseStudyIndexPage(title="客户案例", slug="cases-test") + home_page.add_child(instance=case_index) + + call_command("seed_own_showcase") + call_command("seed_own_showcase") + + assert ProductPage.objects.child_of(product_index).filter(slug="shiyao-cms").count() == 1 + assert CaseStudyPage.objects.child_of(case_index).filter(slug="shiytech-website").count() == 1