makeplane/plane

Plane

从现代项目管理平台学习复杂领域、共享前端包与自托管

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

先判断要不要学

这个项目值得拆什么?

Plane 是采用 AGPL-3.0 的开源项目管理平台,覆盖工作项、Cycles、Modules、Views、Pages 与 Analytics。当前默认分支为 preview,仓库以 pnpm/Turbo 组织多个 TypeScript 前端应用和共享包,同时在 apps/api 提供 Django 后端,并给出 Docker、Kubernetes 等自托管入口。它很适合研究复杂产品如何拆分领域、状态和编辑器能力,但应从单个工作项切片开始,避免在庞大单仓中失去主线。

  1. 01

    工作项、周期、视图和文档展示了复杂项目管理领域如何逐层组合。

  2. 02

    apps 与 packages 边界清楚,可对照 API、Web、共享状态、编辑器与 UI 包。

  3. 03

    AGENTS.md、测试指引和部署目录为阅读与验证提供了真实入口。

可以学什么

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

  • 学产品结构
  • 学数据库
  • 学用户登录
  • 学界面
  • 学部署
  • 学完整项目组织
01

从工作项扩展出的领域组合

先识别工作项这一核心对象,再观察 Cycle、Module、View 和 Analytics 如何引用它,学习避免为每个页面复制一套业务模型。

apps/api/plane · apps/web · packages/types
02

多前端共享能力

比较 Web、Admin 与 Space 应用怎样复用状态、编辑器、UI 和服务包,理解共享包的收益与耦合成本。

apps/web · apps/admin · apps/space · packages/shared-state · packages/editor · packages/ui
03

API、实时层与部署边界

从 Django API、live 服务和 deployments 目录区分事务写入、协作更新与运行基础设施。

apps/api · apps/live · deployments · docker-compose.yml

三段学习路径

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

0130 分钟先跑通

建立 Plane 的系统地图

  1. 读 README 的 Features、Installation 与 License
  2. 按 AGENTS.md 标出 apps/api、apps/web 和共享包
  3. 以 Work Item 为中心连到 Cycle、Module、View 与 Page

完成标志:一张领域、运行时应用和共享包三层地图。

022 小时动手改

复刻最小工作项看板

  1. 定义 workspace、project、work item 和 state 最小模型
  2. 实现按状态读取与拖动更新
  3. 在客户端做乐观更新并处理失败回滚
  4. 测试跨项目越权与并发覆盖

完成标志:一个含权限、排序和失败回滚的最小看板切片。

031 天做变体

为看板增加可保存视图

  1. 设计过滤与排序的可序列化表达
  2. 在 API 校验字段和租户范围
  3. 在共享状态中缓存视图并支持撤销
  4. 补过滤组合、权限、并发和迁移测试

完成标志:一个可复用、可持久化且有租户边界的视图能力。

评分解释

每一分都要说清楚为什么

可复刻性11 / 25
11 / 25

具备自托管方案,但服务数量与领域规模显著提高复刻成本。

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

根目录、AGENTS.md 与应用/包边界清楚,README 对具体技术说明较少。

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

适合有前后端经验者拆切片学习。

产品完整度15 / 15
15 / 15

项目、工作项、周期、文档、视图和分析闭环丰富。

vibe coding 代表性5 / 10
5 / 10

适合借鉴单个看板或视图能力,不适合整仓生成式改写。

活跃度5 / 5
5 / 5

仓库持续活跃且社区规模大。

新颖性4 / 5
4 / 5

项目管理与协作文档的组合提供多种复杂交互案例。