www_site/docs/phase-4-report.md

36 lines
2.2 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# 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 回环端口。
- 建立模型:`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 生成的运行时迁移文件提交进仓库,测试数据库迁移已执行但交付还需固化迁移产物。
- 当前 `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、额度和音频服务也不涉及旧推理工程修改。