Linear集成金蝶云星空解决方案
更新: 10/15/2026 字数: 0 字 时长: 0 分钟
业务背景
| 源系统 | 成集云 | 目标系统 |
|---|---|---|
| Linear研发协作平台 |  | 金蝶云星空ERP |
以软件研发、互联网、产品设计类企业为代表，研发与项目团队普遍使用 Linear 进行 Issue 缺陷/需求跟踪、Cycle（迭代周期）排期、Project 路线图与里程碑管理，并在 Issue 上登记预估工时（estimate）与负责人；而合同、收入、成本与财务核算集中在 金蝶云星空。系统割裂带来典型问题：
- 项目进度、Issue 完成状态、预估工时停留在 Linear，财务无法据此确认项目阶段收入与归集研发成本；
- 研发负责人在 Linear 登记的工时/估点无法自动同步金蝶，项目成本归集与项目毛利核算滞后；
- 团队成员（assignee）与金蝶员工/业务员档案割裂，项目工时与绩效、提成难以挂钩；
- 项目里程碑（Project Milestone / Issue 状态 Done）无法触发金蝶收入确认与开票，业财脱节。
通过 成集云 iPaaS 数据集成平台，将 Linear 与金蝶云星空打通，实现"项目/迭代/Issue 主数据统一、阶段验收触发收入确认、工时与估点自动归集"的研发项目业财一体。
解决方案
基于成集云数据集成平台，构建 Linear 与金蝶云星空之间的可视化自动同步任务：以 Linear 为研发执行与工时入口，金蝶为项目财务与核算中枢。成集云通过 Linear GraphQL API（Bearer Personal API Key / OAuth 2.0）与金蝶云星空 OpenAPI 双向编排，支持 Webhook 事件（Issue 创建/更新/删除、Project 更新、Cycle 变更）实时触发与定时增量，统一字段映射与单位换算，保障研发业财数据一致。
业务流程
一、基础资料同步流程
1. 团队与成员同步流程
Linear 的 Team（研发团队）与 User（成员）对齐金蝶部门与员工/业务员档案，确保 Issue 工时与责任人可正确归集。
2. 项目与迭代同步流程
Linear 的 Project（路线图）与 Cycle（迭代周期）映射到金蝶项目与项目阶段，使研发进度可在财务侧透视。
二、业务单据同步流程
1. 任务与工时归集流程
Linear Issue 状态变更与 estimate（估点）实时同步金蝶，生成项目任务单，并将估点/登记工时折算为研发工时单，自动归集项目成本。
2. 阶段验收与收入确认流程
Linear Project Milestone 完成或 Issue 标记为 Done（状态变更）触发金蝶项目阶段验收与收入确认/应收单，实现按研发进度确认收入。
3. 估点成本归集流程
Linear Issue 的 estimate（Story Points / 工时预估）与 cycle 实际消耗映射到金蝶，形成研发项目成本与毛利分析的数据基础。
对接说明
一、基础资料同步（Linear → 金蝶）
| 数据对象 | Linear | 金蝶云星空 | 方向 |
|---|---|---|---|
| 团队 | Teams（key、name） | 部门、项目组织 | Linear → 金蝶 |
| 成员 | Users（id、name、email） | 员工、业务员 | Linear → 金蝶 |
| 项目/迭代 | Projects、Cycles（name、status、dates） | 项目、项目阶段 | Linear → 金蝶 |
二、业务单据同步（Linear → 金蝶）
| 业务单据 | Linear | 金蝶云星空 | 方向 |
|---|---|---|---|
| 项目任务 | Issues（identifier、title、state、assignee） | 项目任务单 | Linear → 金蝶 |
| 工时/估点 | Issue estimate、startedAt/completedAt | 工时单、费用归集 | Linear → 金蝶 |
| 阶段验收 | Issue status=Done / Project Milestone | 阶段验收单、收入确认单 | Linear → 金蝶 |
| 研发成本 | estimate × 费率 / 实际工时 | 项目成本单、毛利分析 | Linear → 金蝶 |
三、同步规则与过滤条件
- 触发方式：Linear Webhook（Issue create/update/remove、Project update、Cycle 变更）实时触发；未覆盖对象采用每 15 分钟增量（按
updatedAt）兜底。 - 字段映射：Linear
issueId作为金蝶项目任务单关联主键；assignee.id映射员工/业务员；estimate按团队费率折算工时金额；project/cycle映射到项目与项目阶段。 - 去重与幂等：以 Linear
issueId+ 金蝶任务单号做幂等键，状态变更只更新不重复建单。 - 安全校验：Linear Webhook 启用
Linear-Signature（HMAC-SHA256）验签，按Linear-Timestamp防止重放；Bearer Token 统一托管于成集云密钥库，定期刷新。 - 单位与汇率：估点按团队标准费率折算；跨币种项目按金蝶币别折算。
- 异常处理：任务/工时写入失败自动重试并告警；无法匹配员工或项目的工时进入待处理队列，由项目经理补录。
业务价值
- 研发业财一体：Linear Issue、估点、里程碑实时同步金蝶，研发成本与收入确认不再滞后。
- 按进度确认收入：里程碑验收自动触发收入确认与应收，告别月底手工估算。
- 成本实时归集：估点与实际工时自动形成项目成本，项目毛利看板即时可得。
- 绩效可量化：Issue 责任人与工时挂钩金蝶员工/业务员档案，研发绩效与提成有据可依。
- 主数据统一：团队、成员、项目双向对齐，消除"两套组织、两个项目台账"的混乱。
接口文档
- Linear GraphQL API 与 Webhooks（Issues / Projects / Cycles / Comments / Users / Teams / Labels）：
https://developers.linear.app/ - 金蝶云星空 OpenAPI（项目、部门、员工、项目任务单、工时单、收入确认单、成本单）：金蝶云星空开放平台