docs: add product brochure and positioning notes

This commit is contained in:
2026-10-19 22:40:44 +08:00
parent c602a26d1b
commit bd150f810f
3 changed files with 464 additions and 0 deletions
+78
View File
@@ -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 大纲文档,或者先聚焦某一部分(比如写一版更简短的官网首页文案)?
Binary file not shown.
+386
View File
@@ -0,0 +1,386 @@
<!DOCTYPE html>
<html lang="zh-CN">
<head>
<meta charset="UTF-8">
<title>世耀CMS 产品手册</title>
<style>
@page {
size: A4;
margin: 18mm 16mm 20mm 16mm;
}
* { box-sizing: border-box; }
body {
font-family: "Microsoft YaHei", "PingFang SC", "Segoe UI", sans-serif;
color: #1f2937;
font-size: 13px;
line-height: 1.7;
margin: 0;
}
h1, h2, h3, h4 { color: #1e3a8a; margin-top: 0; }
h1 { font-size: 26px; }
h2 {
font-size: 19px;
border-left: 5px solid #2563eb;
padding-left: 10px;
margin-top: 0;
margin-bottom: 14px;
}
h3 { font-size: 15px; color: #2563eb; }
.section { page-break-before: always; padding-top: 4px; }
.section:first-of-type { page-break-before: auto; }
table {
width: 100%;
border-collapse: collapse;
margin: 10px 0 18px 0;
font-size: 12px;
}
th, td {
border: 1px solid #d1d5db;
padding: 6px 8px;
text-align: left;
vertical-align: top;
}
th {
background: #eff6ff;
color: #1e3a8a;
}
tr:nth-child(even) td { background: #f9fafb; }
.tag {
display: inline-block;
background: #dbeafe;
color: #1e40af;
border-radius: 3px;
padding: 1px 8px;
font-size: 11px;
margin-right: 4px;
}
.cover {
height: 257mm;
display: flex;
flex-direction: column;
justify-content: center;
align-items: center;
text-align: center;
background: linear-gradient(160deg, #1e3a8a 0%, #2563eb 55%, #3b82f6 100%);
color: #fff;
margin: -18mm -16mm -20mm -16mm;
padding: 18mm 16mm 20mm 16mm;
}
.cover .badge {
letter-spacing: 4px;
font-size: 13px;
opacity: 0.85;
margin-bottom: 18px;
}
.cover h1 {
color: #fff;
font-size: 42px;
margin-bottom: 6px;
letter-spacing: 2px;
}
.cover .subtitle {
font-size: 16px;
opacity: 0.92;
margin-bottom: 40px;
}
.cover .divider {
width: 60px;
height: 3px;
background: #fff;
opacity: 0.7;
margin: 20px 0;
}
.cover .meta {
font-size: 12px;
opacity: 0.8;
margin-top: 60px;
line-height: 2;
}
.toc { padding-top: 4px; }
.toc ol { padding-left: 22px; }
.toc li { margin-bottom: 8px; font-size: 14px; }
.toc .no { color: #6b7280; font-size: 12px; }
.callout {
background: #eff6ff;
border-left: 4px solid #2563eb;
padding: 10px 14px;
margin: 14px 0;
border-radius: 2px;
}
.highlight-box {
background: #f0fdf4;
border: 1px solid #bbf7d0;
border-radius: 6px;
padding: 12px 16px;
margin: 12px 0;
}
.grid-2 {
display: grid;
grid-template-columns: 1fr 1fr;
gap: 12px;
margin: 14px 0;
}
.card {
border: 1px solid #e5e7eb;
border-radius: 6px;
padding: 12px 14px;
}
.card h4 { margin-bottom: 6px; font-size: 14px; color: #1e3a8a; }
.arch-diagram {
border: 1px solid #d1d5db;
border-radius: 8px;
padding: 16px;
background: #f8fafc;
font-size: 12px;
}
.arch-row {
display: flex;
justify-content: center;
gap: 10px;
margin: 8px 0;
flex-wrap: wrap;
}
.arch-box {
border: 1px solid #93c5fd;
background: #fff;
border-radius: 6px;
padding: 8px 12px;
text-align: center;
min-width: 110px;
}
.arch-box.dark { background: #1e3a8a; color: #fff; border-color: #1e3a8a; }
.arrow-down { text-align: center; color: #93c5fd; font-size: 16px; margin: 2px 0; }
footer.page-footer {
margin-top: 30px;
padding-top: 8px;
border-top: 1px solid #e5e7eb;
font-size: 10px;
color: #9ca3af;
text-align: center;
}
ul { margin: 6px 0; padding-left: 20px; }
li { margin-bottom: 3px; }
</style>
</head>
<body>
<!-- 封面 -->
<div class="cover">
<div class="badge">PRODUCT BROCHURE · 产品手册</div>
<h1>世耀 CMS</h1>
<div class="subtitle">一体化企业官网内容管理平台 · 内容与展示分离 · 合规可上线</div>
<div class="divider"></div>
<div style="font-size:13px; opacity:0.9;">Headless CMS for Modern Corporate Websites</div>
<div class="meta">
衡水世耀科技有限公司<br>
www.shiytech.cn<br>
2026 年 10 月
</div>
</div>
<!-- 目录 -->
<div class="section toc">
<h2>目录</h2>
<ol>
<li>产品概述 <span class="no"></span></li>
<li>目标客户与适用场景</li>
<li>核心价值与解决的问题</li>
<li>功能特性一览</li>
<li>技术架构</li>
<li>技术优势</li>
<li>与同类方案对比</li>
<li>实施与交付流程</li>
<li>产品路线图</li>
<li>联系我们</li>
</ol>
</div>
<!-- 1. 产品概述 -->
<div class="section">
<h2>一、产品概述</h2>
<p><strong>世耀 CMS</strong> 是一套面向中国大陆企业的 Headless(前后端分离)官网内容管理系统。内容运营团队通过可视化后台自主编排页面、发布内容、管理线索;前端展示层基于 Next.js 独立构建,保证视觉效果与访问性能,两者通过标准 API 解耦,互不阻塞彼此的迭代节奏。</p>
<div class="callout">
与"所见即所得建站工具"不同,世耀 CMS 把"内容结构"和"页面呈现"分开管理:编辑负责填写结构化内容(标题、图文、表单、案例等),前端工程师负责把这些内容渲染成品牌化的视觉效果。内容一次管理,可以同时服务官网、小程序、App 等多个展示端。
</div>
<div class="grid-2">
<div class="card">
<h4>内容管理后台</h4>
<p>基于成熟开源内核 Wagtail 构建,模块化页面组件、富文本编辑、素材库管理、权限分级、草稿预览,内容运营无需懂代码即可独立维护官网。</p>
</div>
<div class="card">
<h4>展示前端</h4>
<p>基于 Next.js 构建,首屏渲染快、SEO 友好,支持响应式布局,视觉还原度完全由前端团队把控,不受后台模板限制。</p>
</div>
</div>
</div>
<!-- 2. 目标客户 -->
<div class="section">
<h2>二、目标客户与适用场景</h2>
<table>
<tr><th>客户类型</th><th>典型痛点</th><th>世耀 CMS 的解决方式</th></tr>
<tr>
<td>中大型 B2B 企业</td>
<td>官网内容更新频繁(新闻/案例/产品),每次都要找开发排期改代码</td>
<td>内容运营在后台自主编辑发布,开发只需一次性搭建页面组件</td>
</tr>
<tr>
<td>集团型企业 / 多品牌</td>
<td>未来需要多站点、多语言,传统建站工具扩展困难</td>
<td>基于标准化内容模型,天然支持多站点/多语言渐进式扩展</td>
</tr>
<tr>
<td>有合规诉求的企业</td>
<td>需满足 ICP 备案、《个人信息保护法》(PIPL)、国内 CDN 等本地化合规要求</td>
<td>合规能力内置(见第三章),无需二次开发补齐</td>
</tr>
<tr>
<td>希望摆脱老旧建站系统的企业</td>
<td>使用织梦/帝国等传统 CMS,技术栈老旧、安全隐患多、不支持现代前端体验</td>
<td>现代化前后端分离架构,兼顾安全性与体验,同时保留开源代码自主可控</td>
</tr>
</table>
</div>
<!-- 3. 核心价值 -->
<div class="section">
<h2>三、核心价值与解决的问题</h2>
<div class="grid-2">
<div class="card">
<h4>① 内容与展示彻底解耦</h4>
<p>编辑在后台可视化编辑内容,前端团队独立迭代视觉与性能,两端互不阻塞发布节奏。</p>
</div>
<div class="card">
<h4>② 组件化内容编排</h4>
<p>14 种可拖拽页面组件(Hero、数据展示、CTA、定价、FAQ、案例、时间线、团队、Logo 墙、技术架构图、视频、表单等),编辑自由组合页面,无需开发介入。</p>
</div>
<div class="card">
<h4>③ 开箱即用的官网骨架</h4>
<p>首页、博客、产品中心、案例中心、解决方案、联系我们——六大页面类型及列表/详情页均已实现,接入即可投入使用。</p>
</div>
<div class="card">
<h4>④ 内置五级权限体系</h4>
<p>站点管理员 / 编辑 / 审核员 / 作者 / 查看者五级角色,满足企业多部门协作审核流程,无需定制开发。</p>
</div>
<div class="card">
<h4>⑤ 所见即所得草稿预览</h4>
<p>编辑在后台点击"预览"即可看到前端真实渲染效果,告别"盲改内容、发布后才发现样式错位"。</p>
</div>
<div class="card">
<h4>⑥ 国内合规前置内置</h4>
<p>ICP 备案展示、隐私政策、Cookie 同意条、PIPL 数据删除权、国内 CDN/OSS/地图/验证码适配均已内置,省去上线前的合规补课。</p>
</div>
</div>
</div>
<!-- 4. 功能特性 -->
<div class="section">
<h2>四、功能特性一览</h2>
<table>
<tr><th>分类</th><th>功能点</th></tr>
<tr><td>内容管理</td><td>可视化页面组件编排、富文本编辑、图片响应式裁切、草稿 / 发布工作流</td></tr>
<tr><td>页面类型</td><td>首页、技术博客、产品中心、案例中心、解决方案、联系我们(含线索表单)</td></tr>
<tr><td>协作权限</td><td>五级角色 RBAC、页面级 / 素材库级权限隔离、"仅自己可编辑"的作者权限模式</td></tr>
<tr><td>表单与线索</td><td>可视化表单构建、线索自动入库、邮件通知、蜜罐反垃圾过滤、提交频率限流</td></tr>
<tr><td>SEO</td><td>全页面可配置 meta / OG 字段、结构化数据(JSON-LD)、发布即自动失效前端缓存</td></tr>
<tr><td>预览协作</td><td>草稿预览模式,编辑 / 审核人员实时查看最终渲染效果后再发布</td></tr>
<tr><td>全局配置</td><td>导航菜单、公司信息、备案号、社交账号等站点设置,后台可视化配置,无需改代码</td></tr>
<tr><td>合规本地化</td><td>ICP 备案展示、隐私政策页面、Cookie 同意条、PIPL 数据删除申请 / 确认流程</td></tr>
<tr><td>部署运维</td><td>健康检查探针、幂等部署引导命令(一键初始化管理员账号与权限组)</td></tr>
</table>
</div>
<!-- 5. 技术架构 -->
<div class="section">
<h2>五、技术架构</h2>
<div class="arch-diagram">
<div class="arch-row">
<div class="arch-box">浏览器 / 移动端</div>
</div>
<div class="arrow-down">&#8595;</div>
<div class="arch-row">
<div class="arch-box">国内 CDN 加速</div>
</div>
<div class="arrow-down">&#8595;</div>
<div class="arch-row">
<div class="arch-box dark">Next.js 展示前端</div>
</div>
<div class="arrow-down">&#8595;&#8593;(标准 REST API)</div>
<div class="arch-row">
<div class="arch-box dark">世耀 CMS 内容后台</div>
</div>
<div class="arrow-down">&#8595;</div>
<div class="arch-row">
<div class="arch-box">数据库</div>
<div class="arch-box">对象存储(图片/文件)</div>
<div class="arch-box">邮件服务</div>
</div>
</div>
<p style="margin-top:14px;">架构说明:前后端两个独立代码库,可分别走各自的发布节奏;内容后台通过标准 API 对外暴露数据,未来可平滑接入小程序、App 等更多展示端,而无需改动后台。</p>
</div>
<!-- 6. 技术优势 -->
<div class="section">
<h2>六、技术优势</h2>
<ul>
<li><strong>主流开源技术栈</strong>:内容后台与展示前端均采用活跃维护的主流开源框架,无厂商锁定风险,可长期自主演进。</li>
<li><strong>API 优先架构</strong>:所有内容通过标准化只读 API 对外提供,前端可替换、可扩展(未来接入小程序 / App 不需要改动后台)。</li>
<li><strong>可独立部署</strong>:前后端代码相互独立,可分别配置各自的持续集成与发布流程,互不影响上线节奏。</li>
<li><strong>自动化测试保障</strong>:核心模型、接口与业务流程均有自动化测试覆盖,变更前后可快速回归验证,降低上线风险。</li>
<li><strong>渐进式能力演进</strong>:后续可平滑扩展全文搜索(中文分词)、多语言站点、内容审核工作流等能力,无需推倒重来。</li>
</ul>
</div>
<!-- 7. 对比 -->
<div class="section">
<h2>七、与同类方案对比</h2>
<table>
<tr><th>对比维度</th><th>世耀 CMS</th><th>传统建站 CMS(织梦 / 帝国等)</th><th>海外 Headless CMS SaaS</th></tr>
<tr><td>技术栈</td><td>现代化前后端分离</td><td>老旧耦合架构</td><td>现代但依赖海外云服务</td></tr>
<tr><td>国内合规</td><td>内置 ICP 备案 / PIPL / 国内 CDN 适配</td><td>一般无此类设计</td><td>需自行改造,访问速度受限</td></tr>
<tr><td>数据自主权</td><td>代码与数据私有化部署,完全自主可控</td><td>私有部署但技术债较重</td><td>数据托管在海外 SaaS 平台</td></tr>
<tr><td>定制自由度</td><td>开源代码可深度定制</td><td>高度定制困难,依赖插件生态</td><td>受限于 SaaS 平台开放能力</td></tr>
<tr><td>成本模型</td><td>一次性交付 / 自主可控,长期成本低</td><td>采购低价但长期维护成本高</td><td>按用量持续订阅,长期成本高</td></tr>
</table>
</div>
<!-- 8. 实施交付 -->
<div class="section">
<h2>八、实施与交付流程</h2>
<table>
<tr><th>阶段</th><th>内容</th></tr>
<tr><td>① 需求梳理</td><td>确认站点信息架构、品牌视觉风格、需要的页面类型与内容组件</td></tr>
<tr><td>② 环境搭建</td><td>部署内容后台与展示前端,完成域名、ICP 备案、SSL 证书、国内 CDN 接入</td></tr>
<tr><td>③ 内容建模与视觉定制</td><td>根据品牌视觉调整前端组件样式,按需扩展专属页面类型</td></tr>
<tr><td>④ 内容录入与培训</td><td>协助客户内容运营团队完成首批内容录入,并进行后台操作培训</td></tr>
<tr><td>⑤ 验收上线</td><td>功能验收、合规项复核(备案号 / 隐私政策 / Cookie 同意条)、正式上线</td></tr>
<tr><td>⑥ 运维支持</td><td>提供部署引导工具与健康检查探针,支持日常巡检与版本升级</td></tr>
</table>
</div>
<!-- 9. 路线图 -->
<div class="section">
<h2>九、产品路线图</h2>
<table>
<tr><th>阶段</th><th>规划内容</th></tr>
<tr><td>当前版本</td><td>内容管理后台、REST API、六大页面类型、五级权限、草稿预览、线索表单、合规本地化能力</td></tr>
<tr><td>规划中</td><td>GraphQL 接口、中文全文搜索、正式内容审核工作流、多语言站点支持</td></tr>
<tr><td>远期规划</td><td>AI 辅助能力(内容摘要 / 翻译 / SEO 文案优化),视业务发展评估多站点 SaaS 化方案</td></tr>
</table>
</div>
<!-- 10. 联系方式 -->
<div class="section">
<h2>十、联系我们</h2>
<div class="highlight-box">
<p><strong>衡水世耀科技有限公司</strong></p>
<p>官网:www.shiytech.cn</p>
<p>联系邮箱:support@shiytech.cn</p>
<p>联系电话:132 6343 0196</p>
</div>
<p style="margin-top:20px; color:#6b7280; font-size:11px;">本手册内容如有更新,以最新版本为准。</p>
<footer class="page-footer">衡水世耀科技有限公司 · 世耀 CMS 产品手册 · 2026</footer>
</div>
</body>
</html>