www_site/docs/phase-4-report.md

2.2 KiB
Raw Blame History

Phase 4 CMS 基础报告

日期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 回环端口。
  • 建立模型:UsersProductsMediaSiteSettingsHomeContent
  • Product 支持 draftpublishedunpublishedslug、分类、摘要、描述、媒体、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 生成的运行时迁移文件提交进仓库,测试数据库迁移已执行但交付还需固化迁移产物。
  • 当前 kaotings_cms 已生成受控 custom-format 备份,备份脚本为 infra/scripts/backup-cms-db.sh;现有数据库未清空。

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、额度和音频服务也不涉及旧推理工程修改。