# OXOAK · Headless CMS 入门指南

填写说明：用项目真实资料替换示例，给待确认事项安排负责人。请勿填写密码。

## 为什么选择 Headless

当同一份内容需要服务多个页面、语言或渠道时，可以把内容模型与展示层分开。先列出真实复用需求；只有一个简单网站时，也应比较传统 CMS 的编辑便利性。

## 内容模型与分类

为产品、服务、人物与资料分别定义字段、关联和必填条件。用真实长标题、缺图和中英文内容测试模型，避免把整页 HTML 当作唯一内容字段。

## 编辑、预览与审核

编辑需要知道当前修改对应哪个页面，以及保存、预览与发布的区别。让实际内容负责人完成一次建稿、修改和审核，记录无法独立完成的步骤。

## 接口与前端责任

内容接口只解决资料交付；路由、页面布局、搜索、表单与错误状态仍需各自实现。约定字段变化、接口失败和限流时由谁响应。

## 多语言与权限

说明哪些字段共享、哪些分别翻译，缺少译文时如何显示。按编辑、审核和管理员分配权限，使用测试账号验证越权操作会被拒绝。

## 搜索、地址与迁移

先盘点现有地址、文档和元信息，记录保留、合并与删除的处理方式。迁移样板要核对图片、链接、重定向和搜索可读的正文。

## 发布与缓存

发布后检查实际地址与预览是否一致，确认缓存多久更新以及失败如何重试。内容更新和代码发布分别记录，保留可用回退来源。

## 选型与维护成本

用同一组内容比较编辑任务、前端维护、托管和必要扩展。记录账号归属、订阅条件、备份方式与退出迁移成本，再决定是否采用。