项目
把相关工单聚合为项目，整体跟踪进度，项目交付后归档。
项目
项目把相关工单聚合到一起，对应一个完整的交付物——一次数据库迁移、一个季度容量规划、一次架构升级。如果说工单回答的是「下一步要做什么」，项目回答的是「我们要交付什么」。
项目按工作区隔离。一张工单同一时间最多属于一个项目。
创建项目
- 在侧边栏打开 项目
- 点击 新建项目
- 填写表单：
- 名称——必填，自由文本
- 描述——可选的 Markdown 简介，说明范围和成功标准
- 负责人——可选的项目所有者
- 优先级——可选，与工单相同（低 / 普通 / 高 / 紧急；普通为默认值）
- 图标——可选的 emoji 或图标，用于直观识别项目
- 颜色——视觉标识，会显示在属于该项目的工单行旁
- 开始 / 目标日期——可选日期，用于进度组件
- 点击 创建
新项目会出现在侧边栏的 进行中 分组里。
项目状态
| 状态 | 说明 |
|---|---|
| 进行中 | 正在积极推进。新建项目的默认状态。 |
| 已暂停 | 暂时停工——等待依赖、关键人员到位或外部输入。 |
| 已完成 | 所有工作已完成。项目结束，但保留可见用于参考。 |
| 已归档 | 在默认视图中隐藏。用于清理侧边栏而不丢失历史记录。 |
在项目的操作菜单中更改状态。已完成 或 已暂停 状态的项目在侧边栏各自的分组下仍然可见；只有 已归档 状态才会移入归档分组。
把工单加入项目
将工单加入项目有三种方式：
- 从工单详情面板——打开 项目 字段并选择
- 从项目详情页——点击 添加工单 批量选择已有工单，或点击 新建工单 创建已自动归属本项目的工单
- 创建工单时直接关联——在新建工单表单中填写 项目 字段
移除工单做的是反向操作：清空工单上的 项目 字段，或者在项目页用工单行的操作菜单移除。
项目视图
每个项目页都自带三个视图：
| 视图 | 显示内容 |
|---|---|
| 列表 | 展开式列出项目内所有工单，列与筛选器与工作区工单列表一致。适合分诊和批量编辑。 |
| 看板 | 按状态分组的看板，拖动卡片切换状态。适合每日巡检。 |
| 时间线 | 工单根据开始与目标日期画在时间轴上。一眼看出项目是否按计划推进。 |
页头还会显示聚合进度——按状态统计的数量，以及基于 已完成 工单的完成度百分比。
归档项目
项目上线（或被取消）后归档，可以让侧边栏干净，但保留全部历史。
- 打开项目
- 点击页头的操作菜单
- 选择 归档项目
归档项目会移到侧边栏的 归档 分组。其中的工单不会被删除，归档项目本身不会改变工单状态。可以随时通过同一菜单取消归档。
归档是可逆的。如果要永久删除项目（同时解除所有工单与该项目的关联），使用同一菜单中的 删除 操作——这一步不可逆。
权限
项目的操作受 RBAC 权限 scope 控制：
| 操作 | 所需 Scope | 所有权规则 |
|---|---|---|
| 创建项目 | projects:write | — |
| 编辑项目（名称、描述、优先级、负责人） | projects:write | 仅自己：只有项目负责人可以编辑 |
| 删除项目 | projects:delete | 仅自己：只有项目负责人可以删除 |
当角色的所有权规则设为 任意 时，拥有该角色的成员可以编辑或删除工作区内的任何项目。设为 仅自己 时，只能操作自己拥有的项目。
项目 负责人 默认为创建者，可由拥有工作区级 projects:write 权限的成员在项目详情页修改。
命令行参考
把工单关联到项目
ticket create / ticket update 的 --project 参数接受的是项目 UUID，而不是 slug。可以用 mopheus project list（或加上 --full-id 查看完整 UUID）找到项目 UUID。
# 创建工单时直接关联到项目
mopheus ticket create --title "添加只读副本" --project <project-uuid>管理项目
project 命令组用于在 CLI 中直接管理项目。状态名取值为 active、paused、completed、archived。
# 列出项目（可按状态筛选，用 --full-id 显示完整 UUID）
mopheus project list
mopheus project list --status active --full-id
# 查看单个项目
mopheus project get <project-id>
# 创建项目（--name 必填）
mopheus project create --name "Q3 容量规划" --description "扩容相关工作"
# 更新项目（仅传入的参数会被修改）
mopheus project update <project-id> --name "新名称" --color "#3b82f6"
mopheus project update <project-id> --status paused
# 只修改状态（等同于 update --status 的简写）
mopheus project status <project-id> active
# 删除项目（会解除其下工单的关联；加 --yes 跳过确认）
mopheus project delete <project-id> --yes管理项目内的工单
# 把工单加入 / 移出项目
mopheus project ticket add <project-id> <ticket-id>
mopheus project ticket remove <project-id> <ticket-id>