CreatorFlow 内容排期与数据平台

内容流程

CreatorFlow 的主状态固定为：待选题 → 写作中 → 制作中 → 待审核 → 已发布 → 已复盘。选题创建后由负责人填写脚本，第二次保存脚本进入制作中；制作完成提交审核，主编确认发布时间后发布，运营再记录阅读量、点赞、评论和分享完成复盘。每次推进都写入 actor、动作、前后状态和时间，重复写操作通过 Idempotency-Key 返回首次结果，不重复追加事件。

API 与模块边界

• 查询：GET /api/v1/content-items（支持 status、owner、plannedAt、publishedAt、分页）、GET /api/v1/content-items/:id、GET /api/v1/content-items/:id/events。
• 选题与脚本：POST /api/v1/content-items（标题、渠道、负责人必填）、POST /api/v1/content-items/:id/script（保存脚本并推进写作/制作）。
• 审核与发布：POST /api/v1/content-items/:id/submit-review（审核人）、POST /api/v1/content-items/:id/publish（发布时间、发布人）。
• 复盘：POST /api/v1/content-items/:id/metrics（views、likes、comments、shares 均不可为负）。

后台 Kanban 负责按状态查看和筛选内容，详情页提供脚本、发布确认、指标卡和事件时间线；移动端提供高频的创建、编辑、提交审核、发布和复盘动作。MySQL 8.4 保存主实体、脚本、发布记录、指标和事件，Redis 8 负责写操作幂等键与短锁；未配置外部依赖时使用内存演示数据。

仓库关联与运行范围

creatorflow-miniapp 面向创作者与编辑，creatorflow-admin 提供内容运营、Go Gin API、MySQL 8.4 与 Redis 8。两端共享选题、脚本、审核、发布和数据复盘状态；账号、内容、发布记录和指标均为虚构演示数据。可在对应仓库本地启动 Go API 与 Vite 页面，博客只展示源码边界和可复现的本地流程，不提供公网 API。