
Giveback 推出 GitHub App,统计员工对开源项目的贡献
来源标题:Giveback: Measure what your company gives back to open source
Giveback 发布一款 GitHub App,通过员工自愿安装并验证公司邮箱后,统计其以个人账号提交的公开 PR。仪表盘展示谁在向哪些项目贡献、合并速度及月度趋势,数据仅限公开仓库、不涉及私有内容。
以下正文由 AI 翻译自 Hacker News 最新(原文版权归原站所有),可能存在偏差,重要内容请以原文为准。
衡量你的公司对开源的回馈。
一个 GitHub App,将工程师的公开 pull request 转化为公司开源贡献的实时图景:谁在贡献、贡献给哪些项目、合并速度如何。每位员工自愿加入,且绝不触碰任何私有内容。
你的工程师在 Kubernetes 里修 bug、为 Kafka 写文档、给产品依赖的库交付功能。这些几乎不会出现在任何地方。他们用的是个人 GitHub 账号,在不是你公司拥有的仓库里工作,而 GitHub 的洞察止步于组织边界。
giveback 在每个人同意的前提下跨越这条边界。员工在自己的账号上安装 App,并验证一个企业邮箱地址。此后,他们的公开贡献会被收集、持续更新,并展示在每位已加入员工都能查看的仪表盘上。
🙋 你自己的贡献记录 每位加入的工程师都有一个个人页面:合并了什么、什么还在等待审查、合并耗时与其他人相比如何、以及自己的排名。每个 pull request 都链接回 GitHub。
逐月趋势,将公司自有仓库与其他所有仓库分开统计。合并率、合并耗时、pull request 大小,以及等待时间最长的开放 pull request。
查看你的员工被合并进的最大上游项目及贡献者,以及你贡献最多的项目排名。
运维人员可以看到任务、队列、检测延迟和每个已加入的账号,并可一键强制同步。出问题时,页面会显示什么失败了以及原因。
发生在别处的工作同样计入。运维人员粘贴一个 GitHub pull request 或 GitLab merge request 的地址,giveback 会自动填充标题、日期和计数,运维人员选择把功劳记给谁。
不访问代码。该 App 不请求任何仓库和组织权限。它看不到源代码、私有仓库、issue 或任何组织数据。它收集的一切都已在 github.com 上公开。
一个邮箱地址,只读取一次。它唯一的权限 emails: read,仅在加入时用于在允许的域名下查找已验证地址。该地址被存储,token 随即丢弃。
同意即安装。在安装 App 之前,没有人被追踪;卸载即停止收集。
个人项目保持私密。对个人自有仓库的贡献不计入,机器人(Dependabot、Renovate……)打开的 pull request 也不计入。
轻量运行 一个 Node.js 进程和一个 PostgreSQL 数据库。不需要容器、消息代理、缓存或对象存储。想跑更多进程也可以:它们通过数据库共享工作,不会重复执行。
保持新鲜而不过度调用 API。活跃贡献者的数据在 15 分钟内保持最新。不活跃账号检查频率更低,最低每 4 小时一次。开放的 pull request 会持续复查直到关闭,因此六周后的合并仍然计入。
让它成为你自己的。代码中没有任何内容绑定到 Michelin。设置你的邮箱域名和 GitHub 组织,换上你的 logo,就完成了。
工作原理 员工在个人 GitHub 账号上安装 App。 giveback 用允许的域名校验其已验证邮箱,并将其加入。 它跟踪其公开活动:对非自有仓库的每个 pull request 和 push,持续复查直到每个 pull request 被合并或关闭。 仪表盘呈现这些数据:个人视图、公司视图和运维控制台。 详情见:docs/architecture.md。
你需要 Node.js >=24、Docker,以及一个拥有已验证邮箱地址的 GitHub 账号。 mise install && npm install # Node from mise.toml, then dependencies docker compose up -d --wait # PostgreSQL 16, schema applied cp .env.example .env.local # then fill it in, see the guide npm run start:local
在运行 npm run start:local 之前,你需要自己的开发用 GitHub App 和一个用于 webhook 的 smee.io 频道。入门指南用七个步骤带你完成,附有预填的 App 注册表单和故障排查表。
要上生产?请阅读 docs/deployment.md。
以下变更均为外观性调整,不影响行为: 什么算作你的仓库以及谁可以加入是配置项而非代码:docs/configuration.md 中的 OWN_GITHUB_ORGS 和 ALLOWED_EMAIL_DOMAINS。
入门 在本地运行,从克隆到拥有自己的仪表盘 部署 生产需要什么、GitHub App、数据库 配置 所有环境变量 架构 加入流程、四个任务、自适应调度、端点 仪表盘 谁可以查看、三个标签页、每个数字如何计算 数据库 表结构,以及 schema 变更涉及什么 日志 级别、消息语法、任务报告行 贡献 欢迎 bug 报告、问题和 pull request:见 CONTRIBUTING.md。 要报告漏洞,请遵循 SECURITY.md。 Apache-2.0。版权所有 Manufacture Française des Pneumatiques Michelin;见 NOTICE。
正文由 探How 从来源站点 RSS 同步,内容未经改写;遇到排版缺失或需要图片、视频时请以原文为准。