# 项目

**项目**是 Work 的交付容器：包含人员、Agent、仓库、工单、待办、决策和 Agent 运行。发布（`Iteration`）只挂在 `kind` 为 `product` 或 `ops` 的项目上。团队仍是 git 访问控制的边界。

在顶栏打开「项目」。侧边栏在「迭代」和「待办」之间切换。「迭代」按显示顺序列出项目，每个项目带有其当前迭代（规划中、进行中或受阻），已归档的项目归在末尾。项目页面以卡片显示当前聚焦的迭代，其他当前迭代以行显示，附带排期和进度。「待办」显示跨项目的待办视图。组织管理员和 Work 管理员可以在侧边栏中拖动项目，为所有人调整顺序。

![合成示例工作区中的项目总览](/images/projects.png "项目总览：当前迭代及其燃起图、状态计数和成员。")

## 总览

项目打开时显示总览，数据来自一次 `planning_brief` 读取：

- 当前迭代（进行中的；没有则取受阻的；再没有则取下一个规划中的）及其燃起图；
- 未完成、进行中、受阻和已逾期待办的数量，点击可打开筛选后的列表；
- 「风险」：已逾期、受阻或截止日改动过两次及以上的待办；
- 「负载与容量」：每个负责人的未完成待办和预估工作量，对比迭代截止日前剩余的工作日；本周的完成数和登记工时；没有预估的待办和没有工时的已完成待办；
- 最新的交付和项目的「变更记录」（例如某个迭代被删除、由谁删除，以及有多少待办因此变为未规划）。

「让 Aidy 写进展」把项目交给 Aidy，它读取同一份简报并写出状态更新：健康度（正常、有风险或偏离）及其依据、进度、风险和范围变更（附链接）、负载，以及下一步。

| 字段 | 含义 |
|---|---|
| `id` | 工单/待办上使用的稳定标识。 |
| `en` / `zh` | 本地化名称。 |
| `kind` | `product`、`ops`、`platform` 或 `internal`。 |
| `status` | `active`、`paused`、`done`、`archived` |
| `owner_login` / `members` / `repos` | 负责人、成员和相关仓库。 |
| `position` | 显示顺序。Work 管理员通过 `project_reorder`（`POST /work/projects/order`，`{"ids":[...]}`）设置；列出的项目按该顺序排在前面，其余项目保持原有顺序排在后面。 |

`project_list` 返回每个项目及其 `members`（按顺序排列的登录名）、`repos_count`、`open_todos` 和 `current_iteration`（`{id, version, title, status, done, total}`，优先取进行中的，其次受阻的，再次规划中的）。`iteration_list` 的各行和 `iteration_get` 带有 `deliveries_count` 以及迭代的 `done`/`total` 待办数。

```bash
acahti mcp call project_list '{}'
acahti mcp call project_context '{"id":"turbomesh"}'
acahti mcp call iteration_create '{"project_id":"turbomesh","version":"1.4","title":"Autumn delivery","owner":"alice"}'
```