核心概念
读完本文你将对 BangNiCMS 的词汇体系有清晰认识，后续章节出现的”内容类型”、“模型包”、“主题配置面板”等术语都能对应到具体功能。
站点（Site）
Section titled “站点（Site）”BangNiCMS 是单站点系统——一个 BangNiCMS 实例对应一个站点。站点的全局信息保存在 SiteConfig 表中，包括：
- 站点名称 / 副标题 / 默认语言
- 品牌 LOGO / 主色 / favicon
- SEO 默认（标题模板 / 描述 / og:image）
- 上传与媒体策略（文件大小限制、扩展名白名单）
- ICP 备案号 / 联系信息
这些信息可在「站点设置」中随时修改。
语言（Language）
Section titled “语言（Language）”BangNiCMS 是天生多语言的——不是装一个翻译插件，而是从数据模型层就为多语言服务。
- 每个站点可启用多个语言（如 zh-CN / en-US / es-ES），其中一个为默认语言
- 每条内容（产品 / 文章 / 页面 / 下载）都有多语言版本字段集，独立维护
- 后台「语言管理」实时显示翻译完成度与待翻译队列
- 支持从某语言一键复制翻译，亦可调用 AI 批量翻译（需配置 AI provider）
更深入了解请阅读 多语言（即将上线）。
内容类型（Content Type）
Section titled “内容类型（Content Type）”BangNiCMS 内置 4 种内容类型：
| 类型 | 用途 | 典型字段 |
|---|---|---|
| 页面（page） | 自定义页面，如”关于我们”、“服务条款” | 标题、正文、SEO 元信息、自定义 path |
| 产品（product） | 商品展示与询盘 | 标题、规格、图集、价格区间、关联下载、询盘表单 |
| 文章（article） | 博客 / 资讯 / 新闻 | 标题、节选、正文、作者、发布时间、阅读时长 |
| 下载（download） | 产品手册 / 案例研究 / 软件资源 | 标题、说明、附件、下载次数追踪 |
每种内容都支持：
- 多语言版本（每个启用语言独立编辑）
- 草稿 / 已发布 状态切换
- 发布检查（必填字段、SEO 完整度提醒）
- 分类与标签（见下文）
每种内容也可通过模型包扩展自定义字段（见下文）。
分类与 Taxonomy
Section titled “分类与 Taxonomy”分类系统是多分类法（multi-taxonomy）的：
- 一个站点可定义多个 taxonomy（如”产品分类”、“行业洞察”、“技术资源”）
- 每个 taxonomy 下是树形分类（支持多级）
- 一条内容可归属于多个分类（也可不属于任何分类）
- 支持分类重排与合并（合并会把所有内容迁移到目标分类）
菜单（Menu）
Section titled “菜单（Menu）”菜单是位置无关的——你定义”name=主导航”和”name=页脚导航”等，再在主题里指定哪个位置渲染哪个菜单。
- 每个菜单可包含多种来源的链接：内容（产品/文章/…）、自定义 URL、分类
- 每个菜单项支持多语言标签
- 支持克隆菜单快速创建变体（如桌面版/移动版）
主题（Theme）
Section titled “主题（Theme）”主题决定前台站点长什么样。
- 主题是
extensionType: "theme"的扩展包（zip 形式） - 每个站点同时只能启用一个主题
- 主题可声明配置面板（
marketingMeta.configPanels），后台 Sidebar 会自动出现”主题配置”折叠组 - 切换主题不会丢失内容，但样式与布局会立即变化
主题示例：商务级官网主题、极简博客主题（见 扩展市场）。
插件（Plugin）
Section titled “插件（Plugin）”插件给后台或前台添加新能力，不直接改变前台外观。
- 插件是
extensionType: "plugin"的扩展包 - 一个站点可同时启用多个插件
- 插件能力示例：SEO 工具集（sitemap / JSON-LD / 评分）、AI 翻译、备份增强等
- 部分插件可以”挂载”到主题的页面位置（slot），通过「页面组件」配置
模型包（Model Package）
Section titled “模型包（Model Package）”模型包扩展内容类型的字段，但不修改数据库 schema。
- 模型包形式：
packageKey标识 +targetEntity（绑定到 product/article/download/page 之一） - 字段值统一存到对应表的
customFieldsJSON 字段 - 安装后该内容类型的编辑页会出现新字段组
- 主题可在模板里通过
customFields直接调用 - 卸载安全：可选
archive（保留数据）或purge（清除）
模型包示例：产品评论模型（averageRating / topReviews 字段）、案例研究模型等。
媒体（Media）
Section titled “媒体（Media）”媒体库是统一的文件存储中心：
- 上传策略由
SiteConfig.uploadPolicy统一管理（大小限制 / 扩展名 / 视频上限） - 上传时自动生成 AI 描述（如已配置 AI），可在媒体库批量补描述
- 媒体可被产品图集 / 富文本插图 / 主题 Hero 背景等任意位置引用
询盘（Inquiry）
Section titled “询盘（Inquiry）”询盘是 BangNiCMS 的核心转化机制。
- 前台询盘表单可挂在任意内容上（产品 / 文章 / 下载 / 自定义页面）
- 提交时自动记录来源上下文（产品 ID / 文章 ID / 来源 URL / 用户 IP / UA）
- 后台「询盘管理」支持状态流转（new → reading → replied → closed）、批量操作、CSV 导出
- 与「数据统计」联动，可看每个产品 / 文章带来多少询盘
扩展中心 vs 扩展市场
Section titled “扩展中心 vs 扩展市场”容易混淆的两个词：
| 概念 | 在哪 | 含义 |
|---|---|---|
| 扩展中心 | 你的 BangNiCMS 后台 | 管理已安装的主题/插件：启用/禁用/配置/卸载 |
| 扩展市场 | cms.bonnei.com/extensions | 未安装的扩展浏览与下载，提供 zip 包 |
后续章节会分别详细介绍。
- 内置
super_admin与admin角色（详细权限规划在 P2 阶段，当前以 super_admin 为主） - 安装向导第 3 步创建首个
super_admin - 后台「用户管理」可创建更多账号、重置密码
理解了这些核心概念后，你可以：