www_site/docs/phase-4-report.md

35 lines
2.1 KiB
Markdown
Raw Normal View History

# Phase 4 CMS 基础报告
2026-09-09 11:30:54 +00:00
日期2026-09-09
范围P4-01 至 P4-03
状态CMS 数据边界、模型和公共内容 API 已部署CMS 管理入口前缀集成仍受阻,草稿/发布/下架尚未验收通过。
## 1. 已完成
- 新增独立 Payload CMS 应用:`apps/cms`。
- CMS 使用独立 PostgreSQL 数据库 `kaotings_cms` 和独立数据库账号,不读取业务 API 用户表。
- 已配置 systemd 服务 `kaotings-cms`,仅监听 `127.0.0.1:3001`
- Caddy 保留 `/cms` 外部边界,不向公网开放 CMS 回环端口。
- 建立模型:`Users`、`Products`、`Media`、`SiteSettings`、`HomeContent`。
- Product 支持 `draft`、`published`、`unpublished`slug、分类、摘要、描述、媒体、features、specs、SEO 和排序字段。
- Media 为受控上传集合,普通访客只读媒体,写入需要 CMS 用户。
- Website 内容适配器已从集中占位数据切换为 CMS 公共 Products APICMS 未发布产品时显示明确空状态。
- 公共 Products API 已验证返回 `200` 和空集合,未泄露草稿。
## 2. 尚未通过
- `/cms/admin` 当前仍发生前缀重定向/404Payload Admin 的 Next basePath 与 Caddy 前缀集成尚未稳定。
- 因管理入口未通过,尚未建立 CMS 管理员、创建 Product、上传 Media 或执行发布/下架验收。
- 草稿不可读、发布可读、下架失效的完整端到端矩阵待 Admin 路由修复后执行。
- 当前没有把 CMS 生成的运行时迁移文件提交进仓库,测试数据库迁移已执行但交付还需固化迁移产物。
## 3. 范围边界
- CMS 不管理业务用户、Role/Plan、额度、TTS 任务或认证会话。
- P4-04 至 P4-07 的用户、VIP、额度、TTS 管理界面尚未开始。
- 旧 Big-TTS Web 不参与 CMS推理服务继续由新网站 API 调用。
## 4. 当前阻断
需要先修复 Payload Admin 的 `/cms/admin` 外部路径和可复现迁移产物,再执行 P4-02/P4-03 的真实内容操作验收。该阻断不影响 Phase 3 已部署的认证、TTS、额度和音频服务也不涉及旧推理工程修改。