Phabricator 管理员手册/项目

Phabricator 中项目的通用图标。

在 Phabricator 中，几乎所有内容都可以组织或与项目相关联。

在这里，您将了解有关它们的更多信息。

用例

一些具有不同颜色和用途的 Phabricator 项目。

安装 Phabricator 后，您可能要做的第一件事就是创建一些项目。例如，使用项目，您可以

• 描述兴趣领域以组织您的工作
• 对公司和组织的成员进行分组
• 创建权限和策略（例如：需要成为项目的成员才能推送到存储库）

此外，但不限于

• 一个项目可以有子项目来组织层次结构
• 一个项目可以有许多里程碑来组织发布、冲刺等。

创建新项目

打开收藏夹菜单，其中包含创建项目条目。

您可以打开收藏夹菜单，从主页顶部创建项目，然后单击创建项目。

您可以在以下 URL 找到所有项目

example.com/project/

表单字段

名称

将在所有地方显示的项目名称，可以在任何搜索表单中使用。理想情况下，应该使用一个词。为了方便从评论中链接，多个词应使用连字符连接。

描述

将在项目主页中显示的描述。您可以使用Remarkup语法编写。第一句话很重要，它将显示在“浏览项目”结果中，因此您可以避免不必要的序言，例如这是一个项目，作为项目，它跟踪...等。

图标

一个可能更能说明该项目用途的图标。

颜色

见上文。还有一个适合截止日期的棋盘格颜色。

附加标签

用逗号分隔的“备用”名称，这些名称可能在从评论或搜索字段等处引用该项目时有用。

初始成员

要成为该项目成员的已注册用户列表。

可见范围

谁有权仅查看该项目。

可编辑范围

谁有权编辑该项目（更改描述、添加成员等）。

可加入范围

谁有权仅加入该项目。

请注意，这些策略不会影响与该项目相关的任何内容。在 Phabricator 中，每个元素都设计有自己的策略。

关于项目策略

关于项目的一个重要规则是，按照设计，向对象添加或删除项目永远不会影响谁可以看到该对象。

如果您需要在项目中工作时保留某些策略，您可能会对#空间策略感兴趣。

空间策略

空间（上游文档）允许使用相同的查看策略配置对象（如任务）组。一些组可能在其项目中具有特定类型的任务，这些任务只能对组成员可见。在这种情况下，可以为该组设置一个空间。

空间将其“可见范围”策略应用于空间内的所有对象（如任务）。空间的策略是绝对的，比任何其他策略规则都强。如果用户无法看到空间，用户也永远无法看到空间内的对象，即使它们是该空间中任务的作者、分配者或订阅者。（要允许不是空间成员的用户查看或编辑空间中的对象，需要在对象上应用自定义策略，而不是空间。）除了空间的策略之外，特定对象/任务上的查看策略仍然适用。

默认情况下，对象位于公共空间（S1）中。任何其他空间都对其对象应用了更严格的“可见范围”策略。

关于附加到私有空间中任务的文件附件，只有当您使用拖放上传到任务时，该文件才受与附加到它的任务相同的策略保护。如果您改为通过 file/upload 直接将文件上传到“文件”应用程序，然后将其附加到任务，则您不会获得相同的保护。

空间和有限项目的示例

空间不是项目。因此，空间本身不提供看板。为了拥有具有看板和其他功能的 Phabricator 项目，以及限制对项目内任务和其他对象的访问权限，可以在 Phabricator 中创建三个独立的实体

• 一个 Phabricator 项目。该项目本身是公开的。
• 一个 Phabricator 空间。可以在空间内创建公共项目中的任务，在这种情况下，它们对不在空间内的任何人都不可见且不可访问。
• 一个“ACL 项目”。由于直接管理空间的访问列表需要管理员访问权限，因此可以将空间配置为使用“ACL 项目”的访问列表。这是一个普通的 Phabricator 项目，可能遵循特殊命名约定以供跟踪，其成员资格可能由非管理员控制。它不应该用于任务。

重命名项目

当您重命名项目时，您可能需要确保在更改名称后不会留下断开的链接。

检查以前的标签是否保留为“附加标签”（目前会自动执行）。否则，人们在评论和描述中添加的对您项目的引用将断开。

提示：如果您的项目有一个易变的名称，请使用带有项目编号而不是其名称的 URL。这会在项目重命名时为您节省麻烦，因为项目编号保持不变。

这是一个唯一的项目 URL 示例

https://example.com/project/board/5/

这是一个带有项目名称的项目 URL 示例

https://example.com/tag/awesome-project-name/

另请参阅

• 项目用户指南 - 官方文档