gitroomhq/postiz-app

Postiz

从内容日历到 Temporal 发布流,学习跨平台自动化

难度
较难
适合
进阶
主要语言
TypeScript
GitHub
34.4k
许可证
AGPL-3.0
快照日期
2026年8月9日

先判断要不要学

这个项目值得拆什么?

Postiz 是支持 28+ 渠道的社交媒体策划与发布平台。它将 Vite/React 前端、NestJS API、Temporal 编排器与共享 libraries 放在 pnpm monorepo 中,把“定时”实现为可重试、可观测的工作流,而不是单个 cron 脚本。

  1. 01

    CLAUDE.md 明确列出 frontend/backend/orchestrator/libraries 边界。

  2. 02

    社交平台 OAuth、媒体和发布结果构成真实集成案例。

  3. 03

    适合对比用户日历与耐久后台任务的不同状态。

可以学什么

不只是看代码,而是找到产品的骨架

  • 学产品结构
  • 学用户登录
  • 学 Agent 工作流
  • 学数据库
  • 学部署
  • 学完整项目组织
01

耐久发布工作流

跟踪预定内容从 API 进入 Temporal workflow/activity,再回写结果。

apps/backend · apps/orchestrator · libraries
02

渠道适配层

对比两个平台的认证、媒体限制与发布响应,提炼统一契约。

libraries · apps/backend
03

前端预期与后台真相

区分日历上的 scheduled 与工作流实际成功,设计中间和失败状态。

apps/frontend/src/app · apps/orchestrator · apps/backend

三段学习路径

从理解、修改到做出你的版本

0130 分钟先跑通

画出一次定时发布链路

  1. 读 README 与 CLAUDE.md
  2. 标出三个 apps 责任
  3. 列出状态与失败点

完成标志:一张 UI/API/workflow/provider 链路图。

022 小时动手改

设计一个假渠道适配器

  1. 定义媒体和文本限制
  2. 实现幂等 publish
  3. 模拟限流与超时
  4. 记录外部 post id

完成标志:一个可重试的渠道契约。

031 天做变体

构建双渠道发布样片

  1. 用两个 mock provider
  2. 实现定时、取消和重试
  3. 在 UI 展示每渠道状态
  4. 测试 token 过期、部分成功和重放

完成标志:一个不连真实账号的耐久发布原型。

评分解释

每一分都要说清楚为什么

可复刻性13 / 25
13 / 25

可 Docker 体验,真实集成成本高。

文档与代码清晰度17 / 20
17 / 20

CLAUDE.md 分层非常清晰。

新手学习价值11 / 20
11 / 20

适合进阶者学工作流。

产品完整度15 / 15
15 / 15

内容、日历、发布、分析和团队完整。

vibe coding 代表性8 / 10
8 / 10

Agent CLI 与自动化场景相关。

活跃度5 / 5
5 / 5

仓库当前活跃。

新颖性4 / 5
4 / 5

Temporal+多社交渠道有辨识度。