OpenToggl 是什么

OpenToggl 是一个开源时间追踪平台，以 Toggl 当前的公开接口作为自身产品的实现目标。

它不是一个模糊的"类 Toggl"克隆。目标很明确：

• 覆盖 Track API v9
• 覆盖 Reports API v3
• 覆盖 Webhooks API v1
• 提供配套的 Web 界面
• 同时支持托管和自托管部署形态
• 支持导入 Toggl 导出数据

为什么要做 OpenToggl

本项目以公开的产品定义、OpenAPI 合约和 Web 界面作为唯一的事实来源。

这让承诺变得具体：

• 不搞含糊的"类似 Toggl"定位
• 不做仅有 API 的首发版本
• SaaS 和自托管的功能范围不会有隐性差异
• 文档、合约与实现之间不会出现漂移

仓库里有什么

• docs/ 下的产品定义
• openapi/ 下的公开和 OpenToggl 特有的 OpenAPI 合约
• apps/ 下的前后端源码
• docs/self-hosting/ 和 docs/testing/evidence/ 下的自托管手册和冒烟测试证据

产品边界

首个正式范围包括：

• 通过 Track API v9 进行时间追踪和工作区操作
• 通过 Reports API v3 进行报表查询
• 通过 Webhooks API v1 管理 Webhook 生命周期和投递
• 上述功能对应的 Web UI
• Toggl 导出数据导入
• 面向实例运维的托管/运行时能力

OpenToggl 不声称有独立的 AI 原生产品线。它的 AI 故事是合约清晰和自动化友好，而不是藏在营销语言后面的第二个产品。