zagrosi-code/zagrosi

## 为什么选择 Zagrosi 现代工程组织使用三种独立的工具来完成一项相互关联的工作： | 工具类别 | 示例 | 管理范围 | |---------------|----------|--------------| | 项目管理 | ClickUp, Asana, Linear | 日常任务、项目、文档 | | 问题跟踪 | Jira, Shortcut | 冲刺、史诗、敏捷工作流 | | 事件响应 | incident.io, PagerDuty, FireHydrant | 值班、响应、事后复盘 | **而且它们都无法与 AI 编辑器流畅对话。** ### 四个连贯的界面，一个统一的平台

#### 📋 任务 带有自定义字段、多视图（列表/看板/日历/甘特图）、嵌套层级、依赖关系的工作管理。

#### 🔄 问题 建立在任务之上的敏捷工作流：冲刺、史诗、故事点、看板/Scrum板、JQL 风格筛选。

#### 🚨 事件 基于严重级别的响应机制，包括值班轮班、升级策略、运行手册、状态页面和事后复盘。

#### 🤖 AI 原生 每个界面都作为 MCP 工具、资源和提示词。从 Claude Code 声明事件。从 Codex 呼叫值班人员。

这四个界面共享用户、权限、搜索、评论、审计日志和集成。**一流的 Slack 和 Microsoft Teams 桥接** 开箱即用：斜杠命令、自动创建事件频道、线程化待办事项、值班呼叫和双向通知路由。默认自托管。采用 AGPLv3 许可证以确保它保持这一特性。 ## 技术栈 | 层级 | 选择 | |-------|--------| | 后端 | **Rust**: axum, tokio, sqlx | | 前端 | **React + TypeScript**: Vite, TanStack Router/Query, Tailwind | | 数据库 | **PostgreSQL 18**: 行级安全用于多租户 | | 事件总线 | **NATS JetStream**: 实时、事件溯源、持久化流 | | 缓存 | **Valkey**: BSD 许可的 Redis 分支，OSI 批准（Redis Inc. 于 2024 年重新授权为非开源） | | 搜索 | **Tantivy**: 嵌入式，无 Elasticsearch 依赖 | | MCP 服务器 | **[rmcp](https://crates.io/crates/rmcp)** v1.5+: stdio + Streamable HTTP, MCP 规范 2025-11-25 | | 认证 | 内置邮箱/密码 **+** OIDC / SAML SSO | | 部署 | Docker Compose（单节点）**+** Helm chart（Kubernetes） | | 许可证 | **AGPLv3** | ## 架构 ``` ┌──────────────────────┐ ┌──────────────────────────────────────────┐ │ React Web App │ │ AI editors: Claude Code, Codex CLI, │ │ │ │ Cursor, Zed, Claude Desktop │ └──────────┬───────────┘ └──────────────────────┬───────────────────┘ │ HTTPS + WS │ MCP (stdio / HTTP) ▼ ▼ ┌──────────────────────────────┐ ┌─────────────────────────────┐ │ API Gateway (axum) │◄──►│ zagrosi-mcp (rmcp) │ │ REST + WS, NATS bridge │ │ tools / resources / prompts │ └──────────────┬───────────────┘ └─────────────────────────────┘ │ │ Bounded-context Rust crates routed via NATS JetStream: │ identity, RBAC, work-item core, tasks, agile, │ incidents, alerts, oncall, docs, chat, postmortems... │ ┌──────────┼──────────┐ ▼ ▼ ▼ ┌────────┐ ┌────────┐ ┌────────┐ │Postgres│ │NATS JS │ │ Valkey │ └────────┘ └────────┘ └────────┘ ``` 每个限界上下文都是 Cargo 工作区内的一个独立 Rust crate。跨服务调用通过 NATS 请求/应答或共享的 PostgreSQL 表进行，绝不直接使用 HTTP。MCP 服务器是从 MCP 原语到 api-gateway REST 调用的轻量级转换器；使用与 Web UI 相同的认证、相同的权限模型和相同的审计日志。 ## 路线图 个人构建。日期是期望值，非承诺。产品线和 AI 原生线并行推进；每个产品阶段都会启用相应的 MCP 功能。 | 阶段 | 状态 | 产品功能 | AI 原生（MCP + 插件） | 目标时间 | |:-----:|:------:|---------|---------------------------|:------:| | **0** | 📋 规划中 | 基础：monorepo、CI、身份、RBAC、多租户、Docker/Helm | `zagrosi-mcp` 骨架 (rmcp, stdio + HTTP, 认证握手) | ~2 个月 | | **1** | 📋 规划中 | 任务：工作项、自定义字段、列表/看板/日历视图 | MCP v0.1: `create_task`, `list_tasks`, `update_task`, `task://` 资源 | ~5 个月 | | **2** | 📋 规划中 | 敏捷：冲刺、史诗、Scrum/看板、故事点 | MCP v0.2: 冲刺/看板工具 + `sprint_planning` 提示词 | ~7 个月 | | **3** | 🎯 **MVP** | 事件：严重级别、值班、升级、运行手册 | MCP v0.3: `declare_incident`, `page_oncall`, `ack_incident`, `incident_kickoff` 提示词 | ~10 个月 | | **4** | 📋 规划中 | 文档：使用 Yjs 实时协作的 Wiki | MCP v0.4: 文档资源、全文搜索工具 | ~12 个月 | | **5** | 📋 规划中 | 聊天 + 通知 | 不适用 | ~14 个月 | | **6** | 📋 规划中 | 事后复盘：时间线、待办事项转任务、分析 | MCP v0.5: 时间线资源 + `postmortem_template` 提示词 | ~16 个月 | | **7** | ♾️ 持续进行 | 集成市场（WASM 插件运行时）、移动端、优化 | Cursor 扩展、Zed 插件、Codex 技能市场上架 | 持续 | 开放 issue 以收集想法、投诉和已有方案。 ## 快速开始 ### 自托管 ### 从你的 AI 编辑器使用 ### 作为 Claude Code 插件使用 ## Zagrosi 对比 | 功能 | Zagrosi | ClickUp + Jira + incident.io | |---------|:-------:|:----------------------------:| | 自托管 | ✅ 始终支持 | ❌ 仅 SaaS | | 开源 | ✅ AGPLv3 | ❌ 专有 | | 统一数据模型 | ✅ 任务 ↔ 问题 ↔ 事件在数据库层关联 | ❌ 三个数据库、三个 API、三个 Webhook | | 单一权限模型 | ✅ 跨所有界面的单一 RBAC | ❌ 三个独立的 RBAC 系统 | | MCP / AI 原生 | ✅ 第一方 MCP 服务器 | ❌ 目前无 MCP 实现 | | 按用户定价 | 🆓 零成本 | 💰 综合约 $30 至 $80 / 用户 / 月 | | 供应商锁定 | 🆓 可在任何地方运行 | 🔒 三重锁定 | ## 参与贡献 目前这是一个处于早期设计阶段的个人项目。目前最快的帮助方式： - ⭐ **给仓库点星**：表示兴趣 - 💬 **发起讨论**：分享用例、对现有工具的抱怨，或设计反馈 - 🐛 **在设计笔记发布后提交问题** 代码贡献将在基础阶段发布后开放。完整的工作流程请参阅 [CONTRIBUTING.md](CONTRIBUTING.md)：分支和提交约定、代码审查清单、测试要求和 DCO 签署。 ## 许可证 [**GNU Affero 通用公共许可证第 3.0 版**](LICENSE) Zagrosi 在设计上即采用 AGPLv3。你可以自由地自托管它。如果你修改了它并将其作为服务提供，则必须公开你的更改。这使得该项目成为一个真正的公共资源，而不是成为他人闭源 SaaS 的燃料。

Zagrosi 得名于贯穿库尔德斯坦的[扎格罗斯山脉](https://en.wikipedia.org/wiki/Zagros_Mountains)。 **层叠的山脊，层叠的模块。**

标签：AI-Powered, AI原生, AI集成, AI项目管理, ASN信息, Audit Log, Comments, Custom Fields, Epic Tracking, Escalation Policies, Gantt Charts, Incident Management, Issue Tracking, Kanban, Linux 内核安全, MCP, MCP Protocol, Microsoft Teams, On-call, On-Call Scheduling, Open Source Platform, Permissions, Postmortems, Project Management Tool, React, React Frontend, Runbooks, Rust, Rust Backend, Scrum, Search, Slack, SOC Prime, Sprint Planning, Status Pages, Story Points, Syscalls, 事件管理, 事后分析, 任务管理, 协作平台, 可视化界面, 团队协作, 工程管理, 开发工具, 开源, 敏捷开发, 数据管道, 测试用例, 状态页, 网络流量审计, 自托管, 自托管平台, 请求拦截, 软件工程, 通知系统, 问题跟踪, 问题追踪系统, 集成, 项目管理, 项目管理工具