feat: 新增 seed_own_showcase 命令,创建产品页“世耀CMS”与官网自身案例页
- apps/core/management/commands/seed_own_showcase.py:幂等地在生产已有的 ProductIndexPage/CaseStudyIndexPage 下创建/更新“世耀CMS”产品页与衡水世耀 科技官网建设案例页;产品/栏目页缺失时 CommandError 退出,不自动创建栏目。 - apps/core/tests.py:新增 3 个用例(缺栏目页报错、创建成功、重复执行幂等), pytest 75 -> 78,全部通过。
This commit is contained in:
@@ -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",
|
||||
"<p>世耀 CMS 是一套面向中国大陆企业的 Headless(前后端分离)官网内容管理"
|
||||
"系统。内容运营团队通过可视化后台自主编排页面、发布内容、管理线索;前端展示"
|
||||
"层独立构建,保证视觉效果与访问性能,两者通过标准 API 解耦,互不阻塞彼此的"
|
||||
"迭代节奏。</p>",
|
||||
),
|
||||
(
|
||||
"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",
|
||||
"<p>衡水世耀科技有限公司官网(www.shiytech.cn)基于自研的世耀 CMS 构建:"
|
||||
"后端采用 Headless CMS 管理首页、产品、案例、解决方案、博客等全部内容,前端"
|
||||
"独立渲染展示层。内容运营团队可自主编排页面组件、发布线索表单、管理团队与"
|
||||
"客户案例展示,无需开发介入即可持续更新官网内容。</p><p>项目同时落地了 ICP "
|
||||
"备案展示、隐私政策、Cookie 同意条等国内合规能力,满足企业官网上线的合规"
|
||||
"要求。</p>",
|
||||
),
|
||||
(
|
||||
"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}"))
|
||||
@@ -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
|
||||
|
||||
Reference in New Issue
Block a user