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 diff --git a/chat.txt b/chat.txt new file mode 100644 index 0000000..75a8b5b --- /dev/null +++ b/chat.txt @@ -0,0 +1,78 @@ +Read [](file:///c%3A/Users/H280056/OneDrive%20-%20Halliburton/%E6%96%87%E6%A1%A3/PycharmProjects/wagtailcms/documents/%E8%AE%BE%E8%AE%A1%E6%96%B9%E6%A1%88%E5%88%86%E6%9E%90%E4%B8%8E%E5%AE%8C%E5%96%84%E7%89%88.md#1-1), lines 1 to 150 + +Searched for regex `已完成|Phase 1 详细进度|未完成(待规划排期)` (`**/documents/设计方案分析与完善版.md`), 7 results + +Read [](file:///c%3A/Users/H280056/OneDrive%20-%20Halliburton/%E6%96%87%E6%A1%A3/PycharmProjects/wagtailcms/documents/%E8%AE%BE%E8%AE%A1%E6%96%B9%E6%A1%88%E5%88%86%E6%9E%90%E4%B8%8E%E5%AE%8C%E5%96%84%E7%89%88.md#390-390), lines 390 to 425 + +基于目前仓库里已经落地的功能(§2.16 完成清单),可以把本项目包装成一款**面向中国大陆企业的"Headless CMS 官网解决方案"**产品。以下是一份可直接用于官网/销售材料的产品介绍框架。 + +## 一、产品定位(一句话) + +> **「一体化企业官网 CMS,内容与展示分离,开箱即用,合规可上线」** +> 基于 Wagtail + Next.js 的前后端分离官网系统,让内容运营团队像写文档一样管理官网,同时保留前端团队对视觉和性能的完全掌控。 + +## 二、目标客户 + +- 需要**频繁自主更新**官网内容(新闻、案例、产品页)、又不想每次改版都找开发的中大型 B2B 企业 +- 已经/计划做**多站点、多语言**扩展的集团型企业 +- 对**国内合规**(ICP 备案、PIPL、国内 CDN/存储)有硬性要求、不能直接套用海外 Headless CMS(Contentful/Sanity/Strapi 云版)方案的客户 +- 希望摆脱传统建站工具(如织梦/帝国 CMS)的老旧技术栈,但又不想重新造轮子自研 CMS 的客户 + +## 三、核心价值主张 + +1. **内容与展示彻底解耦**:编辑在 Wagtail 后台所见即所得地编辑,前端 Next.js 独立迭代视觉/性能,互不阻塞发布节奏。 +2. **组件化内容建模**:14 种可拖拽的页面组件(Hero/Stats/CTA/Pricing/FAQ/案例/时间线/团队/Logo 墙/技术栈/视频/表单等),编辑可自由编排页面而无需开发介入。 +3. **开箱即用的企业官网骨架**:首页、博客、产品、案例、解决方案、联系我们——六大页面类型及其列表/详情页已全部实现,接入即可用。 +4. **内置权限体系**:站点管理员/编辑/审核员/作者/查看者五级 RBAC,满足企业多角色协作审核流程,无需定制开发。 +5. **所见即所得预览**:编辑在后台点"预览"即可看到前端真实渲染效果(基于 Next.js Draft Mode),告别"盲改内容、发布了才知道样式对不对"。 +6. **国内合规与本地化前置**:ICP 备案展示、隐私政策与 Cookie 同意条、PIPL 数据删除权支持、国内 CDN/OSS/地图/验证码适配——这些其他方案往往上线前才发现要补的功能,本产品已内置。 + +## 四、功能亮点(可做成官网的 Feature 列表) + +| 分类 | 功能 | +|---|---| +| 内容管理 | StreamField 可视化编排、富文本、图片响应式裁切、草稿/发布工作流 | +| 页面类型 | 首页、博客、产品中心、案例中心、解决方案、联系我们(含线索表单) | +| 协作权限 | 五级角色 RBAC、页面级/collection 级权限隔离 | +| 表单与线索 | 可视化表单构建(FormDefinition)、线索自动入库、邮件通知、蜜罐反垃圾、限流 | +| SEO | 全页面可配置 meta/OG 字段、自动 sitemap、发布即失效前端缓存(revalidate webhook) | +| 预览协作 | 草稿预览(Draft Mode)、编辑/审核实时查看渲染效果 | +| 全局配置 | 导航菜单、站点设置(公司信息/备案号/社交账号)后台可视化配置,无需改代码 | +| 合规本地化 | ICP 备案展示、隐私政策、Cookie 同意、PIPL 数据删除申请流程 | +| 部署运维 | 健康检查探针(/healthz /readyz)、幂等部署引导命令(一键初始化管理员+权限组) | + +## 五、技术优势(给技术决策者/CTO看的部分) + +- **主流开源技术栈**:Django 6 + Wagtail 8(Python 生态最成熟的开源 CMS 之一)+ Next.js 16(React 19),均为活跃维护的主流框架,无厂商锁定风险。 +- **API 优先架构**:Wagtail REST API v2 + 自定义只读 API,前端可替换(未来可接入小程序/App 而不改后端)。 +- **可独立部署**:前后端两个独立代码仓库,可分别走各自的 CI/CD,互不影响发布节奏。 +- **测试保障**:pytest 自动化测试覆盖核心模型、API、工作流(目前 70+ 用例),降低改动回归风险。 +- **渐进式路线图**:Phase 2(GraphQL、OpenSearch 中文搜索、多语言)、Phase 3(AI 摘要/翻译/SEO 重写)已有明确规划,可作为后续付费升级/订阅功能卖点。 + +## 六、差异化卖点(vs 竞品) + +| 对比维度 | 本产品 | 传统建站 CMS(织梦/帝国) | 海外 Headless CMS SaaS(Contentful 等) | +|---|---|---|---| +| 技术栈 | 现代化前后端分离 | PHP 老旧耦合架构 | 现代但依赖海外云 | +| 国内合规 | 内置 ICP/PIPL/国内 CDN | 一般无此类设计 | 需要自行改造,访问速度差 | +| 数据自主权 | 代码+数据库私有部署 | 私有部署但技术债重 | 数据托管在海外 SaaS | +| 定制自由度 | 开源代码可深度定制 | 高度定制难(插件化) | 受限于 SaaS 平台能力 | +| 成本模型 | 一次性交付/自主可控 | 低价但维护成本高 | 按用量订阅,长期成本高 | + +## 七、如果要正式"产品化",建议补充的材料 + +这些目前代码里还没有,但做市场投放前通常需要: + +1. **演示站点/Demo 视频**:拿一个真实行业场景(如"制造业官网")跑通完整内容运营流程录屏。 +2. **产品手册 PDF**:把上面表格整理成带截图的 PDF,给销售/客户看。 +3. **定价与交付模式**:是"一次性买断+部署服务"、"订阅制 SaaS"、还是"开源免费+企业支持服务"?这决定了后续是否要做多租户(目前设计文档里明确 YAGNI,暂不做)。 +4. **安全/合规认证**:若面向大客户,可能需要等保测评、ISO27001 等资质背书。 +5. **案例背书**:至少 1-2 个真实客户案例,比空谈功能更有说服力。 + +需要的话,我可以帮你把以上内容整理成一份正式的 Markdown/PPT 大纲文档,或者先聚焦某一部分(比如写一版更简短的官网首页文案)? + + + + + + diff --git a/documents/世耀CMS产品手册.pdf b/documents/世耀CMS产品手册.pdf new file mode 100644 index 0000000..627ee7e Binary files /dev/null and b/documents/世耀CMS产品手册.pdf differ diff --git a/documents/产品手册.html b/documents/产品手册.html new file mode 100644 index 0000000..9459d6b --- /dev/null +++ b/documents/产品手册.html @@ -0,0 +1,386 @@ + + + + +世耀 CMS 是一套面向中国大陆企业的 Headless(前后端分离)官网内容管理系统。内容运营团队通过可视化后台自主编排页面、发布内容、管理线索;前端展示层基于 Next.js 独立构建,保证视觉效果与访问性能,两者通过标准 API 解耦,互不阻塞彼此的迭代节奏。
+基于成熟开源内核 Wagtail 构建,模块化页面组件、富文本编辑、素材库管理、权限分级、草稿预览,内容运营无需懂代码即可独立维护官网。
+基于 Next.js 构建,首屏渲染快、SEO 友好,支持响应式布局,视觉还原度完全由前端团队把控,不受后台模板限制。
+| 客户类型 | 典型痛点 | 世耀 CMS 的解决方式 |
|---|---|---|
| 中大型 B2B 企业 | +官网内容更新频繁(新闻/案例/产品),每次都要找开发排期改代码 | +内容运营在后台自主编辑发布,开发只需一次性搭建页面组件 | +
| 集团型企业 / 多品牌 | +未来需要多站点、多语言,传统建站工具扩展困难 | +基于标准化内容模型,天然支持多站点/多语言渐进式扩展 | +
| 有合规诉求的企业 | +需满足 ICP 备案、《个人信息保护法》(PIPL)、国内 CDN 等本地化合规要求 | +合规能力内置(见第三章),无需二次开发补齐 | +
| 希望摆脱老旧建站系统的企业 | +使用织梦/帝国等传统 CMS,技术栈老旧、安全隐患多、不支持现代前端体验 | +现代化前后端分离架构,兼顾安全性与体验,同时保留开源代码自主可控 | +
编辑在后台可视化编辑内容,前端团队独立迭代视觉与性能,两端互不阻塞发布节奏。
+14 种可拖拽页面组件(Hero、数据展示、CTA、定价、FAQ、案例、时间线、团队、Logo 墙、技术架构图、视频、表单等),编辑自由组合页面,无需开发介入。
+首页、博客、产品中心、案例中心、解决方案、联系我们——六大页面类型及列表/详情页均已实现,接入即可投入使用。
+站点管理员 / 编辑 / 审核员 / 作者 / 查看者五级角色,满足企业多部门协作审核流程,无需定制开发。
+编辑在后台点击"预览"即可看到前端真实渲染效果,告别"盲改内容、发布后才发现样式错位"。
+ICP 备案展示、隐私政策、Cookie 同意条、PIPL 数据删除权、国内 CDN/OSS/地图/验证码适配均已内置,省去上线前的合规补课。
+| 分类 | 功能点 |
|---|---|
| 内容管理 | 可视化页面组件编排、富文本编辑、图片响应式裁切、草稿 / 发布工作流 |
| 页面类型 | 首页、技术博客、产品中心、案例中心、解决方案、联系我们(含线索表单) |
| 协作权限 | 五级角色 RBAC、页面级 / 素材库级权限隔离、"仅自己可编辑"的作者权限模式 |
| 表单与线索 | 可视化表单构建、线索自动入库、邮件通知、蜜罐反垃圾过滤、提交频率限流 |
| SEO | 全页面可配置 meta / OG 字段、结构化数据(JSON-LD)、发布即自动失效前端缓存 |
| 预览协作 | 草稿预览模式,编辑 / 审核人员实时查看最终渲染效果后再发布 |
| 全局配置 | 导航菜单、公司信息、备案号、社交账号等站点设置,后台可视化配置,无需改代码 |
| 合规本地化 | ICP 备案展示、隐私政策页面、Cookie 同意条、PIPL 数据删除申请 / 确认流程 |
| 部署运维 | 健康检查探针、幂等部署引导命令(一键初始化管理员账号与权限组) |
架构说明:前后端两个独立代码库,可分别走各自的发布节奏;内容后台通过标准 API 对外暴露数据,未来可平滑接入小程序、App 等更多展示端,而无需改动后台。
+| 对比维度 | 世耀 CMS | 传统建站 CMS(织梦 / 帝国等) | 海外 Headless CMS SaaS |
|---|---|---|---|
| 技术栈 | 现代化前后端分离 | 老旧耦合架构 | 现代但依赖海外云服务 |
| 国内合规 | 内置 ICP 备案 / PIPL / 国内 CDN 适配 | 一般无此类设计 | 需自行改造,访问速度受限 |
| 数据自主权 | 代码与数据私有化部署,完全自主可控 | 私有部署但技术债较重 | 数据托管在海外 SaaS 平台 |
| 定制自由度 | 开源代码可深度定制 | 高度定制困难,依赖插件生态 | 受限于 SaaS 平台开放能力 |
| 成本模型 | 一次性交付 / 自主可控,长期成本低 | 采购低价但长期维护成本高 | 按用量持续订阅,长期成本高 |
| 阶段 | 内容 |
|---|---|
| ① 需求梳理 | 确认站点信息架构、品牌视觉风格、需要的页面类型与内容组件 |
| ② 环境搭建 | 部署内容后台与展示前端,完成域名、ICP 备案、SSL 证书、国内 CDN 接入 |
| ③ 内容建模与视觉定制 | 根据品牌视觉调整前端组件样式,按需扩展专属页面类型 |
| ④ 内容录入与培训 | 协助客户内容运营团队完成首批内容录入,并进行后台操作培训 |
| ⑤ 验收上线 | 功能验收、合规项复核(备案号 / 隐私政策 / Cookie 同意条)、正式上线 |
| ⑥ 运维支持 | 提供部署引导工具与健康检查探针,支持日常巡检与版本升级 |
| 阶段 | 规划内容 |
|---|---|
| 当前版本 | 内容管理后台、REST API、六大页面类型、五级权限、草稿预览、线索表单、合规本地化能力 |
| 规划中 | GraphQL 接口、中文全文搜索、正式内容审核工作流、多语言站点支持 |
| 远期规划 | AI 辅助能力(内容摘要 / 翻译 / SEO 文案优化),视业务发展评估多站点 SaaS 化方案 |
衡水世耀科技有限公司
+官网:www.shiytech.cn
+联系邮箱:support@shiytech.cn
+联系电话:132 6343 0196
+本手册内容如有更新,以最新版本为准。
+ +